jtxa-ui 1.1.3 → 1.1.4

package/README.md

@@ -26,6 +26,7 @@
   - [TableBigData 大数据表](#8-tablebigdata-大数据增量表-table-big-data)
   - [TreeTable 虚拟树表](#9-treetable-虚拟树表-tree-table)
 - [共享表格属性 publicProps](#共享表格属性-publicprops)
+- [渲染器清单（cellRender / editRender）](#渲染器清单cellrender--editrender)
 - [工具函数](#工具函数)
 - [已知问题与注意事项](#已知问题与注意事项)
 - [相关文档](#相关文档)
@@ -152,6 +153,22 @@ app.use(TreeTable)
 
 **Events**：`switchChange` · `focus` · `blur` · `casChange` · `cusBtn`
 
+**`rules` 字符串语法**：`rules` 为对象，`key` 是 `modelKey`，`value` 是规则字符串数组，由内置 `Validate`（`packages/form/validate.js`）转换为 Element Plus 规则：
+
+```js
+const rules = {
+  name:   ['required', 'phone'],    // 必填 + 手机号
+  age:    ['num'],                  // 必须是数字
+  email:  ['email'],                // 邮箱格式
+  code:   ['idCard'],               // 身份证
+  remark: ['range-2-10'],           // 长度 2~10（用 “-” 传参）
+  ename:  ['letters'],              // 仅英文字母
+  tags:   ['requireSelect'],        // 至少选一个（数组）
+}
+```
+
+内置校验类型：`required` · `requiredFocus` · `range-min-max` · `len-n` · `num` · `email` · `idCard` · `phone` · `letters` · `requireAll` · `requireSelect`。
+
 **Slots**：
 
 - `upload`：当字段 `type: 'upload'` 时，使用 `item.slotName`（默认 `upload`）具名插槽渲染上传区；
@@ -349,6 +366,24 @@ const conditions = searchTypeRef.value.getData()
 | `isLastLoad` | Boolean | `true` | 是否末次加载 |
 | `slotConfig` | Array | `[]` | 自定义插槽组件配置（传入业务子组件） |
 
+**`mode` 与面板组件映射**：`mode`（或 `pageMode`）决定渲染哪种版式，内部按值派发到 `mtt-panel-*` 子组件：
+
+| mode | 面板组件 | 版式形态 |
+| --- | --- | --- |
+| `0` | `jt-page-manager-tree-table` | 默认树表 |
+| `1` | `mtt-panel` | 左右看板 |
+| `2` | `mtt-panel-1` | 上下看板 |
+| `3` | `mtt-panel-2` | 展开形式看板 |
+| `5` | `mtt-panel-5` | 左侧 Tab + 右侧 tree-list |
+| `7` | `mtt-panel-7` | 左侧树 + 右侧普通清单 |
+| `8` | `mtt-panel-8` | 左侧 Tab + 右侧分组表格 |
+| `10` | `mtt-panel-10` | 左侧 Tab + 右侧 TreeTable |
+| `11` | `mtt-panel-11` | 左侧 Tab + 右侧 TreeTable（变体） |
+| `12` | `mtt-panel-12` | 左侧 Tab + 右侧 TreeTable（变体） |
+| `13` | `mtt-panel-13` | 左侧 Tab + 右侧 TreeTable（变体） |
+
+> `mode` 还可由 `config.radioData` 中某项 `style` 字段在运行时切换（见 `radioChange`）。
+
 **Events**：`getBaseParams`
 
 **Slots**：透传父级所有插槽；向面板透传 `#cusComp`。
@@ -621,6 +656,35 @@ VxeTable 基础封装：工具栏、表尾统计、虚拟滚动、单选 / 多
 
 ---
 
+## 渲染器清单（cellRender / editRender）
+
+表格列通过 `header[].cellRender` / `header[].editRender` 指定渲染器名称，对应 `packages/tables/hooks/cell-render/cell-render.js` 与 `edit-render/edit-render.js` 中 `VxeUI.renderer.add(...)` 的注册名。
+
+**单元格渲染器（cellRender）**
+
+| 名称 | 说明 |
+| --- | --- |
+| `TabsBtn` | 单元格内按钮组 |
+| `TabsCheckbox` | 单元格内复选框组 |
+| `TabsSwitch` | 单元格内开关 |
+| `Select` | 单元格内下拉（表单型，由 `CellForm` 承载） |
+| `Input` | 单元格内输入框（表单型） |
+| `Number` | 单元格内数字输入（表单型） |
+| `Rate` | 单元格内评分（表单型） |
+
+> `Select` / `Input` / `Number` / `Rate` 共用 `CellForm`，通过列配置 `props`（枚举 `enum`、功能码 `funcode`、占位 `placeholder`、最大值 `max` 等）区分形态。
+
+**编辑渲染器（editRender，双击进入编辑态时生效）**
+
+| 名称 | 说明 |
+| --- | --- |
+| `cascader` | 级联选择器 |
+| `cascader-select` | 级联 + 选择组合 |
+| `cus-select` | 自定义下拉 |
+| `cus-input` | 自定义输入 |
+
+---
+
 ## 工具函数
 
 随默认导出（`import jtui from 'jtxa-ui'`）一并暴露的工具方法：

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jtxa-ui",
   "private": false,
-  "version": "1.1.3",
+  "version": "1.1.4",
   "type": "module",
   "description": "jtui组件库vite版本",
   "scripts": {