bricks/docs/zh/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 事件封装后的自定义事件。
  • 携带原始记录数据，便于业务逻辑响应。