Label

点击查看Label的Demo

继承关系

Label extends View

简介

文本展示控件

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

构造方法

Label() 创建文本展示控件

API

text(string a)

设置文本内容

text()

获取当前文本内容

textAlign(TextAlign a)

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

textAlign()

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

fontSize(number a)

设置字体大小

fontSize()

获取字体大小

textColor(Color a)

设置文字颜色

textColor()

获取文字颜色

lines(number a)

设置展示的最大行数，默认只展示一行 ⚠️ 0代表最大行数不限制。当lines传入0时，Label的BreakMode会强制改为Clipping切割模式

lines()

获取展示的最大行数

breakMode(BreakMode a)

设置文字截断样式，参见BreakMode的枚举值 ⚠️ 在多行情况下，当设置Start或Middle时，会强制改为Clipping切割模式

breakMode()

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

styleText(StyleString a)

设置富文本，详情参见StyleString ⚠️ iOS设置该属性会清空之前设置的属性

styleText()

获取富文本，详情参见StyleString

padding(number a, number b, number c, number d)

设置文字内容距边界距离

setTextBold() ❌

设置文字粗体 ⚠️ 弃用, 请使用setTextFontStyle方法

setTextFontStyle(FontStyle a)

设置字体样式

fontNameSize(string a, number b)

设置自定义字体

setAutoFit(boolean a) ❌

是否使用文本自适应 ⚠️ 该已弃用，请使用新布局的WrapContent

setWrapContent(boolean a)

包裹内容，即大小按照文本内容自适应, 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 a)

开启自适应时最大宽度的限制 ⚠️ 该方法仅在自适应布局下有效, 即width(MeasurementType.WRAP_CONTENT)或width(MeasurementType.MATCH_PARENT)

setMinWidth(number a)

开启自适应时最小宽度的限制 ⚠️ 该方法仅在自适应布局下有效, 即width(MeasurementType.WRAP_CONTENT)或width(MeasurementType.MATCH_PARENT)

setMaxHeight(number a)

开启自适应时最大高度的限制 ⚠️ 该方法仅在自适应布局下有效, 即height(MeasurementType.WRAP_CONTENT)或height(MeasurementType.MATCH_PARENT)

setMinHeight(number a)

开启自适应时最小高度的限制 ⚠️ 该方法仅在自适应布局下有效, 即height(MeasurementType.WRAP_CONTENT)或height(MeasurementType.MATCH_PARENT)

setLineSpacing(number a)

设置多行文本之间行间距 @version 1.1.5

addTapTexts(Array a, function b, Color c, Color d) ❌

设置文本点击回调，可设置点击文本颜色以及高亮背景色 ⚠️ iOS 该方法已弃用； Android 暂未支持 @version 2.0.0

addView(View a) ❌

添加子视图 ⚠️ local修饰的子视图在iOS会被不定时释放,具体参考UI组件消失问题

a_setIncludeFontPadding(boolean a)

设置是否在文字上面和下面添加一点额外的padding ⚠️ 仅android有效，ios空实现 @version SDK>=1.4.1