Bixby Developer Center

Guides
References

paragraph

optionalmultiple allowedvalue optional

vParagraph of text, providing a summary of information for the user. For example, the paragraph can contain a summary of a show, a restaurant review, or an address of a hotel. You can add a line break in paragraph text using \n.

The parent key determines how many lines of the paragraph will display. The recommended text style is Detail_L and Detail_M. Default alignment is left, except for watch, which is center-aligned.

Examples

Here are some examples of how to use paragraph within a layout:

layout {
match: Hotel (hotel)
mode (Details)

content {
section {
content {
image-carousel {
images (hotel.images)
}
title-area {
halign (Start)
slot1 {
text {
value ("#{value(hotel.name)}")
style (Title_S)
}
}
slot2 {
paragraph {
value ("From #{value(hotel.lowRate)} • #{value(hotel.rating)} stars")
style (Detail_L)
}
}
slot3 {
layout-macro (hotel-rating) {
param (rating) {
expression (hotel.rating)
}
param (reviewCount) {
if (exists(hotel.reviewCount)) {
expression (hotel.reviewCount)
}
}
}
}
}
}
}
section {
title ("Description")
content {
paragraph {
value ("It is a low-rise boutique hotel that features a pool in the back side of the building, although it's empty.")
style (Detail_L)
}
divider
paragraph {
value ("This is a great place to stay for your visit to San Andreas!")
}
attribution-link {
label {
template ("Open Bixby Developer Center")
}
url {
template ("https://bixbydevelopers.com/")
}
}
}
}
}
}

View on GitHub

This is the shorthand method of creating a paragraph:

paragraph ("#{value(hotel.description)}") {
style (Detail_M)
}

Here is how paragraph appears within a details layout on different devices:

MobileWatch
paragraph
Here are some variations of how paragraph appears:
Paragraph Variations
paragraph
Here are some variations of how paragraph appears:
Paragraph Variations
TV (Expanded View)Fridge
paragraphparagraph
Note

The look and feel of this Views component might differ between devices, specifically with respect to spacing. Mobile, tablet, and fridge devices are similar in design, for example, but have varying resolution and spacing specifications.

Design Considerations

This component is applicable to these moments:

You can find design specifications for this component in the Components Spec download under Design Resources.

Child Keys

style
optional
Determines the text style
value
optional
Plain text that is rendered