跳到主要内容

文本样式属性

示例​

参考

Props​

color​

类型
color

fontFamily​

类型
string

iOS 支持通用字体系列 system-ui、ui-sans-serif、ui-serif、ui-monospace 和 ui-rounded


fontSize​

类型
number

fontStyle​

类型
enum('normal'、'italic')

fontWeight​

指定字体粗细。大多数字体支持值 'normal' 和 'bold'。并非所有字体都具有每个数值对应的变体,在这种情况下会选择最接近的变体

类型默认值
enum('normal'、'bold'、'100'、'200'、'300'、'400'、'500'、'600'、'700'、'800'、'900') 或 number'normal'

includeFontPadding
Android
​

设置为 false 可移除用于为某些上伸部/下伸部留出空间的额外字体内边距。对于某些字体,此内边距可能会导致文本在垂直居中时看起来略微错位。为了获得最佳效果,还应将 textAlignVertical 设置为 center

类型默认值
booltrue

fontVariant​

允许你设置字体的所有变体。可以使用枚举数组或以空格分隔的字符串进行设置,例如 'small-caps common-ligatures'

类型默认值
enum('small-caps'、'oldstyle-nums'、'lining-nums'、'tabular-nums'、'proportional-nums') 数组或 string[]

letterSpacing​

增加或减少字符之间的间距。默认情况下没有额外的字符间距

类型
number

lineHeight​

控制文本元素内文本行之间垂直间距的数值。它指定连续文本行基线之间的距离

类型
number

textAlign​

指定文本对齐方式。在 Android 上,值 justify 仅在 Oreo(8.0)或更高版本(API level >= 26)上受支持。在较低版本的 Android 上,该值将回退为 left

类型默认值
enum('auto'、'left'、'right'、'center'、'justify')'auto'

textAlignVertical
Android
​

这是样式属性 verticalAlign 的别名,如果同时使用这两个属性,verticalAlign 将优先于 textAlignVertical

类型默认值
enum('auto'、'top'、'bottom'、'center')'auto'

textDecorationColor
iOS
​

类型
color

textDecorationLine​

类型默认值
enum('none'、'underline'、'line-through'、'underline line-through')'none'

textDecorationStyle
iOS
​

类型默认值
enum('solid'、'double'、'dotted'、'dashed')'solid'

textShadowColor​

类型
color

textShadowOffset​

类型
对象:{width?: number, height?: number}

textShadowRadius​

类型
number

textTransform​

类型默认值
enum('none'、'uppercase'、'lowercase'、'capitalize')'none'

verticalAlign
Android
​

类型默认值
enum('auto'、'top'、'bottom'、'middle')'auto'

writingDirection
iOS
​

类型默认值
enum('auto'、'ltr'、'rtl')'auto'

userSelect​

允许用户选择文本并使用原生复制和粘贴功能。其优先级高于 selectable 属性

类型默认值
enum('auto'、'text'、'none'、'contain'、'all')none