Text widget

Display and style text within your application.

Test in Kitchen Sink (opens in a new tab)

Properties

PropertyTypeDescription
textstringYour text content
visiblebooleanToggle a widget visibility on/off. Note that an invisible widget will not occupy UI space, unless the visibilityTransitionDuration is specified.
stylesobjectSee properties

Styles

PropertyTypeDescription
textStyleobjectAn opaque object that determines the size, color, and decoration of text. see properties
textAlignstringWhether and how to align text horizontally. start end center justify
fontstringDefault built-in style for this text. heading title subtitle
lineHeightstring or integerThe line height of the text, which determines the vertical spacing between lines. It can be specified as, a number, or a string chosen from a set of predefined values: default 1.0 1.15 1.25 1.5 2.0 2.5
borderRadiusstring or integerThe border radius of the widget.This can be specified using CSS-like notation with 1 to 4 integers. Minimum value: 0.
borderColorinteger or stringSets the border color, starting with '0xFF' for full opacity. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange
borderWidthintegerThickness of the border. Minimum value should be 0.
shadowColorinteger or stringSets the box shadow color starting with '0xFF' for full opacity. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange
shadowOffsetarrayThe values in array define the horizontal and vertical offset of the shadow. Example: if the shadowOffset is set to [2, 4], the shadow will be offset by 2 pixels horizontally and 4 pixels vertically from its original position.
shadowRadiusstring or integerThe border radius of the widget.This can be specified using CSS-like notation with 1 to 4 integers. Minimum value: 0.
shadowStylestringThe blur style to apply on the shadow normal, solid, outer, inner
stackPositionTopintegerThe distance of the child's top edge from the top of the stack. This is applicable only for Stack's children.
stackPositionBottomintegerThe distance that the child's bottom edge from the bottom of the stack. This is applicable only for Stack's children.
stackPositionLeftintegerThe distance that the child's left edge from the left of the stack. This is applicable only for Stack's children.
stackPositionRightintegerThe distance that the child's right edge from the right of the stack. This is applicable only for Stack's children.
captureWebPointerbooleanApplicable for Web only. When overlaying widgets on top of certain HTML container (e.g. Maps), the mouse click is captured by the HTML container, causing issue interacting with the widget. Use this to capture and maintain the mouse pointer on your widget.
marginstring or integerMargin with CSS-style notation
paddingstring or integerPadding with CSS-style value
widthintegerThe width property determines the horizontal size of an element, allowing control over its width dimension within the layout.
heightintegerThe height property determines the vertical size of an element, allowing control over its height dimension within the layout.
backgroundImageobjectBackground image of the box. see properties
backgroundGradientobjectBackground gradient of the box see properties
expandedbooleanIf the parent is a Row or Column, this flag will stretch this widget in the appropriate direction. (e.g. stretch horizontally for parent of type Row)
visibilityTransitionDurationnumberSpecify the duration in seconds when a widget animates between visible and not visible state. Note that setting this value will cause the widget to still occupy the UI space even when it is not visible.
elevationintegerThe z-coordinate at which to place this material relative to its parent. A non-zero value will show a shadow, with its size relative to the elevation value. Minimum value: 0, Maximum value: 24
elevationShadowColorinteger or stringThe shadow color for the elevation, which can be represented in different formats. It can be specified as a number, a predefined color name, or a hexadecimal value starting with '0x'. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange
elevationBorderRadiusstring or integerThe border radius of the widget.This can be specified using CSS-like notation with 1 to 4 integers. Minimum value: 0.
alignmentstringThe alignment of the widget relative to its parent. topLeft, topCenter, topRight, centerLeft, center, centerRight, bottomLeft, bottomCenter, bottomRight
maxLinesintegerThe maximum number of lines a text will have.

styles.textStyles

PropertyTypeDescription
fontFamilystringSet the font family applicable for all widgets inside this container, see the list of all available font families here (opens in a new tab).
fontSizeintegerSets the size of the text.
fontWeightstringThe thickness of the glyphs used to draw the text. light normal bold w100 w200 w300 w400 w500 w600 w700 w800``w900
colorinteger or stringThe color specification for the text, icons, divider etc, which can be represented in different formats. It can be specified as a number, a predefined color name, or a hexadecimal value starting with '0x'. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange
overflowstringSet treatment of text longer than available space wrap visible clip ellipsis
backgroundColorinteger or stringBackground color of the box. which can be represented in different formats. It can be specified as a number, a predefined color name, or a hexadecimal value starting with '0x'. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange
fontfamilystringAllows users to chose a specific font-family other than the default one.
decorationstringA linear decoration to draw near the text or whether to slant the glyphs in font. none lineThrough underline overline
decorationStylestringThe style in which to paint the text decorations (e.g., dashed). solid double dotted dashed wavy
isItalicbooleanWhether the text should be italic or not
lineHeightMultipleintegerA multiple of the fontSize to determine the line height. (e.g. 2.0 means the line height is double the height the font size occupies). Default null. (note that 1.0 is not the default depending on the font)
letterSpacingintegerThe amount of space (in logical pixels) to add between each letter. A negative value can be used to bring the letters closer.
wordSpacingintegerThe amount of space (in logical pixels) to add at each sequence of white-space (i.e. between each word). A negative value can be used to bring the words closer.
gradientobjectUsing this property we can apply gradient to our text

styles.gradient

PropertyTypeDescription
colorsarrayThe list of colors used for the gradient, which can be represented in different formats. It can be specified as a number, a predefined color name, or a hexadecimal value starting with '0x'. transparent black blue white red grey teal amber pink purple yellow green brown cyan indigo lime orange
stopsarrayThe list of color stops, each is a number between 0.0 (where the gradient starts) and 1.0 (where the gradient ends). The number of stops should match the number of colors.
startstringThe starting position of the gradient,topLeft, topCenter, topRight, centerLeft, center, centerRight, bottomLeft, bottomCenter, bottomRight
endstringThe ending position of the gradient, topLeft, topCenter, topRight, centerLeft, center, centerRight, bottomLeft, bottomCenter, bottomRight

styles.backgroundGradient

PropertyTypeDescription
colorsarrayThe list of colors used for the gradient. Colors can be represented in different formats. It can be specified as a number, a predefined color name, or a hexadecimal value starting with '0x'.
startstringThe starting position of the gradient,
endstringThe ending position of the gradient

styles.backgroundImage

PropertyTypeDescription
sourcestringThe Image URL to fill the background
fitstringHow to fit the image within our width/height or our parent (if dimension is not specified) . see options
alignmentstringAlignment of the background image

Fit options for styles.backgroundImage

OptionDescription
fillStretch our image to fill the dimension, and distorting the aspect ratio if needed
containScale the image such that the entire image is contained within our dimension
coverScale the image to fill our dimension, clipping the image as needed
fitWidthScale the image to fit the width, and clipping the height if needed
fitHeightScale the image to fit the height, and clipping the width if needed
noneCenter-Align the original image size, clipping the content if needed
scaleDownCenter-Align the image and only scale down to fit. Image will not be scaled up to bigger dimension.