2.0 KiB
2.0 KiB
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: 0 和 border: 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); });