bricks/docs/ai/tabular.md

# Tabular

控件功能：用于以表格形式展示数据，支持行选择、复选框状态变化事件、动态内容展开等功能，适用于数据列表展示与交互。  
类型：普通控件（容器型数据展示控件）  
父类控件：`bricks.DataViewer`

## 初始化参数

- `opts` {Object}：初始化选项对象，继承自 `DataViewer` 的参数，并扩展以下特有属性：
  - `row_options` {Object}：定义每行数据渲染的配置，包括字段（`fields`）、高度（`cheight`）等。
  - `content_view` {Object|undefined}：可选，指定点击行时展开的详细内容视图描述（JSON 结构），若存在则启用折叠面板功能。
  - `editexclouded` {Array}：可选，包含不应在编辑模式中显示的字段名数组。
  - `data_params` {Object}：用于生成隐藏字段的数据参数，在表单提交等场景下使用。

## 主要事件

- `row_selected`  
  触发时机：当某一行被点击选中时触发。  
  携带参数：当前选中行对应的数据记录（`record` 对象）。  
  示例：可用于更新详情面板或外部控件的状态。

- `row_check_changed`  
  触发时机：当某行的复选框状态发生变化时触发。  
  携带参数：该行对应的用户数据（`user_data`）。  
  注意：通过绑定 `DataRow` 的 `check_changed` 事件派发而来，常用于多选操作处理。

- 自定义事件转发（通过 `record_event_handle`）  
  支持将子组件（如工具栏按钮）的事件冒泡到父级，例如：
  - `click`, `dblclick` 等 DOM 事件封装后的自定义事件。
  - 携带原始记录数据，便于业务逻辑响应。