3.5.2.1.24. 链接按钮

在线示例

API 文档

LinkButton 组件外观类似超链接,本质是一个按钮。

该组件的 XML 名称是: linkButton

LinkButton 可以包含文本或图标(或二者均有)。下图展示了不同类型的按钮:

gui linkButtonTypes

默认情况,LinkButton 的标题如果超出了width的值,会被分成多行展示。因此,要展示多行的链接按钮,指定其 width 为绝对值即可。如果链接按钮的标题过长,而 width 又没有设置,此时标题会被截断。

用户可以修改默认行为将 LinkButton 的标题展示在一行:

  1. 创建 主题扩展自定义主题

  2. 定义 SCSS 变量 $cuba-link-button-caption-wrap:

    1. $cuba-link-button-caption-wrap: false

LinkButton 与普通 Button 的不同仅在于外观。所有的属性和行为都与 Button 中描述的一样。

以下是一个 LinkButton 的 XML 描述示例,它调用了控制器的 someMethod() 方法。还设置了caption属性,description属性(做为提示)和icon属性:

  1. <linkButton id="linkButton"
  2. caption="msg://linkButton"
  3. description="Press me"
  4. icon="SAVE"
  5. invoke="someMethod"/>

LinkButton 的属性列表

action - align - caption - captionAsHtml - css - description - descriptionAsHtml - enable - box.expandRatio - icon - id - invoke - stylename - visible - width