按钮

引导您在应用程序中逐页浏览,或调用操作。

数据绑定

常规属性选项卡中设置或修改“按钮”的数据绑定。 该视图将与 Boolean 变量绑定在一起。

配置属性

在“配置”下,设置或修改视图的外观和行为属性。 在“事件”下,设置公式配置属性。

屏幕大小
在属性名称旁边具有 "屏幕大小" 图标 "屏幕大小" 图标 的配置属性对于每个屏幕大小可以具有不同的值。 如果您未设置值,那么屏幕大小会继承下一个更大的屏幕大小值来作为其缺省值。
主题定义
主题定义指定视图的颜色和样式,并确定视图的外观。 您可以在主题编辑器中预览视图的外观。 请参阅 主题
下表中列出了“按钮”的外观配置属性:
表 1. “按钮”的外观配置属性
外观配置属性 描述 数据类型
颜色样式 “按钮”的颜色样式。 颜色与所指定主题中的变量相对应。 可用选项包括 DefaultPrimarySuccessDangerDark String
形状 “按钮”的形状。 String
Size 按钮的大小。 String
仅轮廓 仅在将鼠标指针悬停在该控件上时,“按钮”才显示其基于颜色的样式。 缺省情况下未选中此属性。 布尔型
图标 "屏幕大小" 图标 位于按钮上文本前面的图标的名称。 例如: calendarclock-ocameracloud-uploadbellinfofile-text

请参阅 Font Awesome V4.7.0 ,以获取完整的图标列表。

String
宽度 "屏幕大小" 图标 这是视图的宽度。 您可以指定宽度,以 px(像素)、%(百分比)或 em 为单位。 例如,50px、20% 或 0.4em。 如果未指定单元类型,那么假定为 px。 String
图标位置 图标相对于按钮文本的位置。 可用选项包括:
  • 左侧 (缺省值)
  • Right
InputGroupButtonLoc
仅轮廓 显示轮廓并以所选颜色样式隐藏按钮的实心填充。 在悬停时显示实心填充。 Boolean
Ghost 样式 以所选颜色样式显示按钮,没有轮廓且没有实心填充。 在悬停时 Ghost 按钮以浅灰色背景显示。 Boolean
下表中列出了“按钮”的行为配置属性:
表 2. “按钮”的行为配置属性
行为配置属性 描述 数据类型
跳进索引 跳进顺序索引。 跳进索引从 1 开始,可稀疏地进行设置。 例如,您可以使用 1、5、10。 当您通过按 Tab 键在 UI 区域之间移动时,“跳进索引”属性将控制跳进顺序。 Integer
阻止多次单击 阻止用户多次单击按钮。 Boolean

示例

例如,假设您需要添加一个验证按钮,用于从客户端人员服务中的一个页面进入到另一个页面。 要向人员服务流添加按钮,请向第一个页面的布局中添加“按钮”视图,并为此按钮设置以下配置属性:
  1. 公式下,将按钮名称指定为用双引号括起的静态文本,例如 "OK"
  2. 在 " 行为" 下,选择 防止多次单击
  3. 外观下,将 颜色样式 设置为 Success,并将 形状样式大小样式 设置为 Default。 对于 图标,输入 check
  4. 保存您的更改。

结果为在绿色背景上显示 OK 的矩形按钮。 按钮上文本的前面有一个复选标记。

事件

在“事件”属性中设置或修改该视图的公式配置属性和事件处理程序。 可以将事件设置为以编程方式或在用户与该视图交互时触发。 有关如何定义和编码事件的信息,请参阅 用户定义的事件

下表中显示了“按钮”的公式配置属性:
表 3. “按钮”的公式配置属性
公式配置属性 描述 数据类型
标签公式 用于为“按钮”视图设置标签的表达式或公式。 可以使用静态 string 来设置标签,也可以使用公式动态地设置标签。 例如:
  • 用双引号括起的静态文本:
    "Static Button Text"
  • 用于动态计算标签的公式:
    ${"Text1"}.getText()

有关公式的更多信息,请参阅 公式

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 属性) 的信息,请参阅 查看属性