Label

继承关系

Label extends View

简介

文本展示控件

⚠️ 非容器视图，不可以添加子视图。注意：由于iOS Label在固定高度情况下渲染空间不足时，不会渲染剩下的行数，Android会继续渲染并存在截断现象，故，如果出现iOS和Android行数不一致情况，请将高度设置为能够容下足够行数的高度

构造方法

Label() 创建文本展示控件

API

text(string content)

设置文本内容

text()

获取当前文本内容

textAlign(TextAlign align)

设置文字对齐方式，参见TextAlign

textAlign()

获取文字对齐方式，参见TextAlign

fontSize(number size)

设置字体大小

fontSize()

获取字体大小

textColor(Color color)

设置文字颜色

textColor()

获取文字颜色

lines(number num)

设置展示的最大行数，默认只展示一行

⚠️ 0代表最大行数不限制。当lines传入0时，Label的BreakMode会强制改为Clipping切割模式

lines()

获取展示的最大行数

breakMode(BreakMode mode)

设置文字截断样式，参见BreakMode的枚举值

⚠️ 在多行情况下，当设置Start或Middle时，会强制改为Clipping切割模式

breakMode()

获取文字截断样式，参见BreakMode的枚举值

styleText(StyleString styleString)

设置富文本，详情参见StyleString

⚠️ iOS设置该属性会清空之前设置的属性

styleText()

获取富文本，详情参见StyleString

padding(number top, number right, number bottom, number left)

设置文字内容距边界距离

setTextBold() ❌

设置文字粗体

⚠️ 弃用, 请使用setTextFontStyle方法

setTextFontStyle(FontStyle style)

设置字体样式

fontNameSize(string name, number size)

设置自定义字体

setAutoFit(boolean isFit) ❌

是否使用文本自适应

⚠️ 该已弃用，请使用新布局的WrapContent

setWrapContent(boolean isWrap)

包裹内容，即大小按照文本内容自适应, setWrapContent(true)与width(MeasurementType.WRAP_CONTENT) && height(MeasurementType.WRAP_CONTENT)等效

⚠️ 当label同时设置setWrapContent方法及width(10):height(10)的情况下，展示效果取决于设置的先后顺序。如：当label设置了setWrapContent(true)之后设置width(10):height(10)，label宽度为10、高度为10；当设置width(10):height(10)固定宽高后设置WrapContent,即以setWrapContent设置为准

setMaxWidth(number maxWidth)

开启自适应时最大宽度的限制

⚠️ 该方法仅在自适应布局下有效, 即width(MeasurementType.WRAP_CONTENT)或width(MeasurementType.MATCH_PARENT)

setMinWidth(number minWidth)

开启自适应时最小宽度的限制

⚠️ 该方法仅在自适应布局下有效, 即width(MeasurementType.WRAP_CONTENT)或width(MeasurementType.MATCH_PARENT)

setMaxHeight(number maxHeight)

开启自适应时最大高度的限制

⚠️ 该方法仅在自适应布局下有效, 即height(MeasurementType.WRAP_CONTENT)或height(MeasurementType.MATCH_PARENT)

setMinHeight(number minHeight)

开启自适应时最小高度的限制