Label

简介

Label 控件,它是一个文本标签控件,它支持显示一条文本。

Label 的基类是 widget , widget 属性及接口详细请查看 widget 控件介绍。基础属性中某些属性在 Label 控件中无效(可以设置这类接口属性,但并无效果,显示状态上并无任何变化,因此可以忽略此类属性),不可用属性有:

  • gesture:手势监听属性

控件属性:包含基础控件所有属性。

属性名 类型 描述
ellipsis String 文本超长显示后缀隐码内容
scroll Object 文本超长滚动显示功能配置
adapt Bool 文本超长自适应更新控件宽度
adaptAlign String 文本超长自适应功能对齐方式
bindWidget String 用来绑定的控件 ID
bindAlign String 绑定控件对齐方式
value String 设置文本内容

setData 功能

ellipsis 属性功能

主要用于使能 Label 控件文本超长显示后缀隐码内容的功能。

属性 类型 说明
ellipsis String 文本超长显示后缀隐码内容
this.setData({ label1: { ellipsis: "..." } });

scroll 属性功能

主要用于使能 Label 控件文本超长滚动显示的功能。

属性 类型 说明
scroll Object 文本超长滚动显示功能配置

scroll 说明:

属性 类型 说明
pitch Number 滚动像素值
time Number 滚动帧间隔 (ms)
this.setData({ label1: { scroll: {pitch: 20, time: 50} } });

adapt 属性功能

主要用于配置 Label 使能文本超长自适应更新控件宽度。

属性 类型 说明
adapt Bool 文本超长自适应更新控件宽度,true 使能,false 关闭
this.setData({ label1: { adapt: true } });

adaptAlign 属性功能

主要用于配置 Label 文本超长自适应对齐方式。

属性 类型 说明
adaptAlign String 文本超长自适应功能对齐方式,默认ALIGN_LEFT(ALIGN_LEFT/ALIGN_CENTER/ALIGN_RIGHT)
this.setData({ label1: { adaptAlign: "ALIGN_RIGHT" } });

bindWidget 属性功能

主要用于配置 Label 绑定控件支持文本超长自适应跟随移动。

属性 类型 说明
bindWidget String 用来绑定的控件 ID
this.setData({ label1: { bindWidget: "label2" } });

bindAlign 属性功能

主要用于配置 Label 绑定控件对齐方式。

属性 类型 说明
bindAlign String 绑定控件对齐方式,默认 ALIGN_RIGHT(ALIGN_LEFT/ALIGN_RIGHT)
this.setData({ label1: { bindAlign: "ALIGN_LEFT" } });

value 属性功能

主要用于配置 Label 文本内容。

属性 类型 说明
value String 设置文本内容
this.setData({ label1: { value: "label1" } });
this.setData({ label1: "label1" });