# 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` 方法时派发。
示例监听:
```js
button.bind('click', function(opts) {
console.log('Button clicked with options:', opts);
});
```