小组件的通用属性、服务和事件

如果您想要查找的小组件属性未包含在表中，请参阅与该小组件相关的帮助主题。

属性名称

JavaScript

类型

说明

对齐

imageAlign

string

小组件的水平对齐。

各个小组件的下拉菜单中的可用选项有所不同。

背景颜色

backgroundColor

string

小组件的背景颜色。

该字段支持 RGB 颜色、十六进制颜色或颜色名称。

类

class

string

分配给小组件的类。可对每个小组件分配一个具有自定义 CSS 规则的类。

内容换行

wrap

string

当设备的屏幕尺寸发生变化时，“网格布局”或“重复器”小组件内的小组件放置方式。如果设置为不换行，则小组件将显示在一行中。

在大多数情况下，建议保留默认的换行设置以保持功能性。

数据

data

infotable

数据的绑定目标。

已取消选择

当某个项被取消选择时，将触发此事件。

已禁用

disabled

boolean

禁用小组件的单击并更改状态。

友好名称

friendlyName

string

小组件在项目树中的名称。

高度

height

number

小组件的高度。输入一个数字，后面紧跟着 % 或 px。

正当理由

justification

string

小组件的对齐。从下拉菜单中选择下列选项之一：

• 起始

• 结束

• 居中

• 等距排列

• 等距环绕

标签

label

string

显示在小组件上的标签。

列表

list

object

数据的绑定目标。通常情况下，将服务的“所有项”与本属性绑定。

边距

margin

string

与内边距属性类似，它可定义小组件或项周围的空间。此属性可直接转换为 CSS。输入一个数字，后面紧跟着受支持的格式 (例如，10px)：

• px

• %

• in

• mm

• cm

• ex

• em

• pt

• pc

多选

multiselect

boolean

允许您在小组件中选择多个项。

内边距

padding

string

小组件周围的内边距。输入一个数字，后面紧跟着受支持的格式 (例如，10px)：

• px

• %

• in

• mm

• cm

• ex

• em

• pt

• pc

占位符

placeholder

string

出现在小组件中的占位符文本。

Studio ID

widgetName

string

每个小组件在运行时都会被分配一个唯一的 ID 属性，可对该属性进行编辑。

文本

text

string

出现在小组件中的文本。

值

value

string

小组件的值。

可见

visible

boolean

设置运行时的小组件可见性。默认选中此属性。

宽度

width

number

设置小组件的宽度。输入一个数字，后面紧跟着 % 或 px。

X 轴字段

labelsField

string

显示图表 X 轴的数据。手动输入字段名称。例如，输入“name”。

Y 轴字段

valuesField

string

显示图表 Y 轴的数据。手动输入字段名称。例如，输入“user”。

服务	JavaScript	说明
更新图表	updateChart	可用于更新图表的可绑定服务。

事件	JavaScript	说明
单击	click	将“单击”事件拖动到树中的其他视图，以便在单击时导航到该视图，或者也可将其拖动到服务上，以便在单击时触发该服务。单击“单击”事件旁边的 JS 图标以输入表达式。
单击项	itemclick	将“单击项”属性拖放到项目树的视图上，以便在单击列表或重复器的某个项时导航到绑定的视图。例如，如果将“列表”小组件的“单击项”属性与“详细信息”视图绑定，则单击列表中的某个项时，“详细信息”页面将打开。
已按下	pressed	当按下小组件时，将触发此事件。
已选择	selected	当选中小组件或项时，将触发此事件。
未按下	unpressed	当小组件未按下时，将触发此事件。
值已更改	change	当值发生更改时，将触发此事件。