bricks/docs/ai/button.md
2025-11-18 16:01:43 +08:00

2.0 KiB
Raw Blame History

Button

控件功能:一个可点击的按钮控件,支持图标、文本标签和自定义动作响应,常用于触发事件或执行操作。
类型:普通控件
父类控件:bricks.Layout

初始化参数

参数名 类型 说明
orientation string 布局方向,可选值为 'horizontal' 或垂直(默认为垂直),影响内部元素排列方式。
height string 控件高度,默认为 100%
width string 控件宽度,默认为 100%
item_rate number 图标和文本的尺寸缩放比例,默认为 1
tooltip string 鼠标悬停时显示的提示文字。
color string 文本颜色CSS 颜色值。
bgcolor string 背景颜色CSS 颜色值。
nonepack boolean 是否去除内边距和边框,若为 true 则设置 padding: 0border: 0
name string 控件唯一标识名称,用于设置 DOM 元素 ID。
icon string 图标资源 URL如果指定则在按钮中创建并显示一个 Icon 控件。
label string 按钮上显示的文本标签内容。
css object 自定义 CSS 样式对象,将被合并到按钮样式中。
action object 点击按钮时触发的动作配置,包含以下子属性:
- target: 目标组件/路径
- datawidget: 数据源控件
- datamethod: 获取数据的方法名
- datascript: 自定义脚本逻辑
- dataparams: 传递给动作的参数
- rtdata: 是否实时获取数据
- actiontype: 动作类型(如跳转、提交等)

主要事件

  • click
    当按钮被点击时触发。事件回调会接收到 opts 配置对象作为参数。
    触发时机:用户点击按钮(包括图标或文本部分)后,调用 target_clicked 方法时派发。
    示例监听:
    button.bind('click', function(opts) {
        console.log('Button clicked with options:', opts);
    });