LayoutElementBuilders.FontStyle
@RequiresSchemaVersion(major = 1, minor = 0)
public final class LayoutElementBuilders.FontStyle
The styling of a font (e.g. font size, and metrics).
Summary
Nested types |
|---|
public final class LayoutElementBuilders.FontStyle.BuilderBuilder for |
Constants |
|
|---|---|
static final String |
@RequiresSchemaVersion(major = 1, minor = 400)Font family name that uses Roboto Flex variable font. |
static final String |
@RequiresSchemaVersion(major = 1, minor = 400)Font family name that uses Roboto font. |
Public methods |
|
|---|---|
@Nullable ColorBuilders.ColorProp |
getColor()Gets the text color. |
@Nullable TypeBuilders.BoolProp |
Gets whether the text should be rendered in a italic typeface. |
@Nullable DimensionBuilders.EmProp |
Gets the text letter-spacing. |
@NonNull List<String> |
Gets the prioritized collection of font family names describing which font should be used for this |
@NonNull List<LayoutElementBuilders.FontSetting> |
Gets the collection of font settings to be applied. |
@Nullable DimensionBuilders.SpProp |
getSize()Gets the size of the font, in scaled pixels (sp). |
@NonNull List<DimensionBuilders.SpProp> |
Gets the available sizes of the font, in scaled pixels (sp). |
@Nullable TypeBuilders.BoolProp |
Gets whether the text should be rendered with an underline. |
@Nullable LayoutElementBuilders.FontVariantProp |
Gets the variant of a font. |
@Nullable LayoutElementBuilders.FontWeightProp |
Gets the weight of the font. |
@NonNull String |
toString() |
Constants
ROBOTO_FLEX_FONT
@RequiresSchemaVersion(major = 1, minor = 400)
public static final String ROBOTO_FLEX_FONT = "roboto-flex"
Font family name that uses Roboto Flex variable font. Supported in renderers supporting 1.4, but the actual availability of this font is dependent on the devices.
ROBOTO_FONT
@RequiresSchemaVersion(major = 1, minor = 400)
public static final String ROBOTO_FONT = "roboto"
Font family name that uses Roboto font. Supported in renderers supporting 1.4, but the actual availability of this font is dependent on the devices.
Public methods
getColor
public @Nullable ColorBuilders.ColorProp getColor()
Gets the text color. If not defined, defaults to white.
While this field is statically accessible from 1.0, it's only bindable since version 1.2 and renderers supporting version 1.2 will use the dynamic value (if set).
getItalic
public @Nullable TypeBuilders.BoolProp getItalic()
Gets whether the text should be rendered in a italic typeface. If not specified, defaults to "false".
getLetterSpacing
public @Nullable DimensionBuilders.EmProp getLetterSpacing()
Gets the text letter-spacing. Positive numbers increase the space between letters while negative numbers tighten the space. If not specified, defaults to 0.
getPreferredFontFamilies
public @NonNull List<String> getPreferredFontFamilies()
Gets the prioritized collection of font family names describing which font should be used for this FontStyle and its fallback values if not available. For example, preferring default system variable font with default non variable system font as a fallback.
getSettings
public @NonNull List<LayoutElementBuilders.FontSetting> getSettings()
Gets the collection of font settings to be applied.
Supported settings depend on the font used and renderer version.
getSize
public @Nullable DimensionBuilders.SpProp getSize()
Gets the size of the font, in scaled pixels (sp). If more than one size was originally added, it will return the last one.
getSizes
@ProtoLayoutExperimental
public @NonNull List<DimensionBuilders.SpProp> getSizes()
Gets the available sizes of the font, in scaled pixels (sp).
getUnderline
public @Nullable TypeBuilders.BoolProp getUnderline()
Gets whether the text should be rendered with an underline. If not specified, defaults to "false".
getVariant
@ProtoLayoutExperimental
public @Nullable LayoutElementBuilders.FontVariantProp getVariant()
Gets the variant of a font. Some renderers may use different fonts for title and body text, which can be selected using this field. If not specified, defaults to "body".
getWeight
public @Nullable LayoutElementBuilders.FontWeightProp getWeight()
Gets the weight of the font. If the provided value is not supported on a platform, the nearest supported value will be used. If not defined, or when set to an invalid value, defaults to "normal".