An instance or array of text style properties that you can apply conditionally, and the conditions that cause Apple News to apply them.
fontFamily
(string | string("system"))
The font family, such as GillSans, to use for text rendering. Using a combination of fontFamily, fontWeight, fontWidth, and fontStyle, you can define the appearance of the text. Apple News automatically selects the appropriate font variant from the available variants in that family.
The fontName, such as GillSans-Bold, that refers to an explicit font variant’s PostScript name. Alternatively, you can use a combination of fontFamilys, fontWeight, fontWidth, and/or fontStyle to have News automatically select the appropriate variant depending on the text formatting used.
The size of the font, in points. By default, Apple News uses the font size of the containing component or a default style. As a best practice, try not to go below 16 points for body text. Apple News may automatically resize the fontSize for different device sizes or for iOS and iPadOS devices with Larger Accessibility Sizes enabled.
fontStyle
string
The font style to apply for the selected font.
Valid values:
normal. Selects from the font family a font that’s defined as normal.
italic. Selects from the font family a font that’s defined as italic. If the family doesn’t contain an italic font variant, but contains an oblique variant, then Apple News selects oblique instead.
oblique. Selects from the font family a font that’s defined as oblique. If the family doesn’t contain an oblique font variant, but contains an italic variant, then Apple News selects italic.
fontWeight
(integer | string)
The font weight to apply for font selection. In addition to explicit weights (named or numerical), you can use lighter and bolder to set text in a lighter or bolder font as compared to its surrounding text.
If there’s no font variant with the given specifications in the provided font family, the system selects an alternative that has the closest match. If there’s no bold/bolder font, the system doesn’t create a bold alternative, but falls back to the closest match. Similarly, if there’s no italic or oblique font variant, the system won’t slant text to make it appear italicized.
Valid values:
thin or 100. Thin/hairline weight.
extra-light, ultra-light, or 200. Extra-light/ultra-light weight.
light or 300. Light weight.
regular, normal, book, roman, or 400. Regular weight. This is the default weight if no weight is defined or inherited.
medium or 500. Medium weight.
semi-bold, demi-bold, or 600. Semi-bold/demi-bold weight.
bold or 700. Bold weight. This is the default when using <strong> or <b> tags in HTML formatted text with default fontWeight.
extra-bold, ultra-bold, or 800. Extra-bold/ultra-bold weight.
black, heavy, or 900. Black/heavy weight.
lighter. A weight lighter than its surrounding text. When surrounding text is made bold, a value of lighter makes it medium.
bolder. A weight heavier than its surrounding text. When surrounding text is made light, a value of bolder makes it regular.
fontWidth
string
The font width for font selection (known in CSS as font-stretch). Defines the width characteristics of a font variant between normal, condensed, and expanded. Some font families have separate families assigned for different widths (for example, Avenir Next and Avenir Next Condensed), so make sure that the fontFamily you select supports the specified fontWidth.
Valid values:
ultra-compressed. Specifies the most compressed variant.
extra-compressed. Specifies a very compressed variant.
compressed. Specifies a compressed variant.
ultra-condensed. Specifies the most condensed variant.
extra-condensed. Specifies a very condensed variant.
semi-condensed. Specifies a semi-condensed variant.
condensed. Specifies a condensed variant.
normal (default). Specifies the font variant classified as normal.
semi-expanded. Specifies a semi-expanded variant.
expanded. Specifies an expanded variant.
extra-expanded. Specifies a very expanded variant.
ultra-expanded. Specifies the most expanded variant.
An object for use with text components with HTML markup. You can create text styles containing an orderedListItems definition to configure how Apple News displays list items inside <ol> tags.
Use the none value for conditional design elements. Adding it here has no effect.
The text strikethrough. Set strikethrough to true to use the text color inherited from the textColor property as the strikethrough color, or provide a text decoration definition with a different color. By default strikethrough is omitted (false).
Use the none value for conditional design elements. Adding it here has no effect.
textTransform
string
The transform to apply to the text.
Valid values:
uppercase
lowercase
capitalize. Capitalizes the first letter of all words in the string.
smallcaps. Capitalizes the lowercase letters as small capital letters.
none (default)
tracking
number
The amount of tracking (spacing between characters) in text, as a percentage of the fontSize. The actual spacing between letters is determined by combining information from the font and font size.
Example: Set tracking to 0.5 to make the distance between characters increase by 50 percent of the fontSize. With a font size of 10, the additional space between characters is 5 points.
The text underlining. You can use this style for links. Set underline to true to use the text color as the underline color, or provide a text decoration with a different color. By default underline is omitted (false).
An object for use with text components with HTML markup. You can create text styles containing an unorderedListItems definition to configure how Apple News displays list items inside <ul> tags.
Use the none value for conditional design elements. Adding it here has no effect.
verticalAlignment
string
The vertical alignment of the text. You can use this property for superscripts and subscripts.
Overrides values specified in parent text styles.
Default value: baseline when unspecified, or the value you specify in a TextStyle object applied to the same range.
The values superscript and subscript also adjust the font size to two-thirds of the size defined for that character range.
A TextStyle object defines a style that you can apply to ranges of text. Include a property, with a name that you define and a TextStyle object for the value, in the ArticleDocument.textStyles object. Then, you can use that property’s name string together with HTML, Markdown, or InlineTextStyle to apply the style to a range of text.