按钮
引导您在应用程序中逐页浏览,或调用操作。
数据绑定
在常规属性选项卡中设置或修改“按钮”的数据绑定。 该视图将与 Boolean 变量绑定在一起。
配置属性
在“配置”下,设置或修改视图的外观和行为属性。 在“事件”下,设置公式配置属性。
- 屏幕大小
- 在属性名称旁边具有 "屏幕大小" 图标
的配置属性对于每个屏幕大小可以具有不同的值。 如果您未设置值,那么屏幕大小会继承下一个更大的屏幕大小值来作为其缺省值。
- 主题定义
- 主题定义指定视图的颜色和样式,并确定视图的外观。 您可以在主题编辑器中预览视图的外观。 请参阅 主题。
下表中列出了“按钮”的外观配置属性:
| 外观配置属性 | 描述 | 数据类型 |
|---|---|---|
| 颜色样式 | “按钮”的颜色样式。 颜色与所指定主题中的变量相对应。 可用选项包括 Default, Primary, Success, Danger和 Dark。 | String |
| 形状 | “按钮”的形状。 | String |
| Size | 按钮的大小。 | String |
| 仅轮廓 | 仅在将鼠标指针悬停在该控件上时,“按钮”才显示其基于颜色的样式。 缺省情况下未选中此属性。 | 布尔型 |
图标 ![]() |
位于按钮上文本前面的图标的名称。 例如: calendar, clock-o, camera, cloud-upload, bell, info和 file-text。 请参阅 Font Awesome V4.7.0 ,以获取完整的图标列表。 |
String |
宽度 ![]() |
这是视图的宽度。 您可以指定宽度,以 px(像素)、%(百分比)或 em 为单位。 例如,50px、20% 或 0.4em。 如果未指定单元类型,那么假定为 px。。 | String |
| 图标位置 | 图标相对于按钮文本的位置。 可用选项包括:
|
InputGroupButtonLoc |
| 仅轮廓 | 显示轮廓并以所选颜色样式隐藏按钮的实心填充。 在悬停时显示实心填充。 | Boolean |
| Ghost 样式 | 以所选颜色样式显示按钮,没有轮廓且没有实心填充。 在悬停时 Ghost 按钮以浅灰色背景显示。 | Boolean |
下表中列出了“按钮”的行为配置属性:
| 行为配置属性 | 描述 | 数据类型 |
|---|---|---|
| 跳进索引 | 跳进顺序索引。 跳进索引从 1 开始,可稀疏地进行设置。 例如,您可以使用 1、5、10。 当您通过按 Tab 键在 UI 区域之间移动时,“跳进索引”属性将控制跳进顺序。 | Integer |
| 阻止多次单击 | 阻止用户多次单击按钮。 | Boolean |
示例
例如,假设您需要添加一个验证按钮,用于从客户端人员服务中的一个页面进入到另一个页面。 要向人员服务流添加按钮,请向第一个页面的布局中添加“按钮”视图,并为此按钮设置以下配置属性:
- 在公式下,将按钮名称指定为用双引号括起的静态文本,例如 "OK"。
- 在 " 行为" 下,选择 防止多次单击。
- 在 外观下,将 颜色样式 设置为 Success,并将 形状样式 和 大小样式 设置为 Default。 对于 图标,输入 check。
- 保存您的更改。
结果为在绿色背景上显示 OK 的矩形按钮。 按钮上文本的前面有一个复选标记。
事件
在“事件”属性中设置或修改该视图的公式配置属性和事件处理程序。 可以将事件设置为以编程方式或在用户与该视图交互时触发。 有关如何定义和编码事件的信息,请参阅 用户定义的事件。
下表中显示了“按钮”的公式配置属性:
| 公式配置属性 | 描述 | 数据类型 |
|---|---|---|
| 标签公式 | 用于为“按钮”视图设置标签的表达式或公式。 可以使用静态 string 来设置标签,也可以使用公式动态地设置标签。 例如:
有关公式的更多信息,请参阅 公式。 |
String |
“按钮”具有以下类型的事件处理程序:
- On load:装入 coach 或页面时激活。 例如:
console.log("Button loaded") - On click: 在单击链接时激活,然后离开页面。 如果求值的表达式返回
false,那么单击不会触发边界事件。 例如:return ${Text1}.isValid(); - On boundary event:在通过“链接”视图触发边界事件后,在流到达“停留在页面上”事件时激活。 有关更多信息,请参阅 Coach 视图上下文对象 主题中的 context.trigger() 属性。 例如:
alert("Stay on Page status '" + status + "'")
根据特定事件,您可以使用 JavaScript 逻辑来修改视图的效果。 可在 用户定义的事件主题中找到有关将事件与视图配合使用的更多信息。
方法
有关 "按钮" 的可用方法的详细信息,请参阅 按钮 JavaScript API 。
其他资源
有关如何创建 Coach 或页面的信息,请参阅 构建 Coach。
有关标准属性 (常规, 配置, 定位, 可视性和 HTML 属性) 的信息,请参阅 查看属性。