3.5.2.1.24. 链接按钮

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

该组件的 XML 名称是: linkButton

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

gui linkButtonTypes

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

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

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

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

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

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

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

<linkButton id="linkButton"
            caption="msg://linkButton"
            description="Press me"
            icon="SAVE"
            invoke="someMethod"/>