WidgetDate¶
Date element shown in a widget.
A date shown in a widget. Dates will update periodically when shown in a widget.
You do not create instances of this element directly. Instead you should call addDate() on an instance of a ListWidget.
date¶
Date to show in a widget.
date: Date
textColor¶
Color of the text.
textColor: Color
font¶
Font and text size of the text.
font: Font
textOpacity¶
Opacity of the text.
Opacity of the text. This must be a value between 0 and 1. Defaults to 1.
textOpacity: number
lineLimit¶
Maximum number of lines.
Maximum number of lines to display. The limit is disabled when the value is 0 or less. Defaults to 0.
lineLimit: number
minimumScaleFactor¶
Minimum amount the text scales down to.
Sets the minimum amount that text scales down to fit in the available space. For example, a text with a minimum scale factor of 0.5 allows the widget to draw the text in a font size half the size of the actual font. The scale factor should be a fraction between 0 and 1, both inclusive. Defaults to 1.
minimumScaleFactor: number
shadowColor¶
Color of the shadow.
Sets the color of the shadow cast by the text. The shadowRadius property must have a value greater than zero for this property to have an effect. Defaults to black.
shadowColor: Color
shadowRadius¶
Size of the shadow.
Sets the size of the shadow cast by the text. Defaults to 0.
shadowRadius: number
shadowOffset¶
Offset of the shadow.
Sets the offset of the shadow cast by the text. The shadowRadius property must have a value greater than zero for this property to have an effect. Defaults to (0, 0).
shadowOffset: Point
url¶
URL to open.
The URL will be opened when the text is tapped. This is only supported in medium and large widgets. Small widgets can only have a single tap target, which is specified by the url on the widget.
url: string
-leftAlignText¶
Left aligns the text.
leftAlignText()
Specifies that text should be left aligned. This is the default.
This does not affect texts placed in stacks. Use spacers instead when aligning text in stacks. To align the text to left right in a horizontal stack, you should place a spacer after the text.
-centerAlignText¶
Center aligns the text.
centerAlignText()
Specifies that text should be center aligned.
This does not affect texts placed in stacks. Use spacers instead when aligning text in stacks. To align the text in the center of a horizontal stack, you should place a spacer both before and after the text.
-rightAlignText¶
Right aligns the text.
rightAlignText()
Specifies that text should be right aligned.
This does not affect texts placed in stacks. Use spacers instead when aligning text in stacks. To align the text to the right in a horizontal stack, you should place a spacer before the text.
-applyTimeStyle¶
Display time component of the date.
applyTimeStyle()
Example output: 11:23PM
-applyDateStyle¶
Display entire date.
applyDateStyle()
Example output: June 3, 2019
This is the default.
-applyRelativeStyle¶
Display date as relative to now.
applyRelativeStyle()
Example output: 2 hours, 23 minutes 1 year, 1 month
-applyOffsetStyle¶
Display date as offset from now.
applyOffsetStyle()
Example output: +2 hours -3 months
-applyTimerStyle¶
Display date as timer counting from now.
applyTimerStyle()
Example output: 2:32 36:59:01