neo-cmp-cli 1.13.18 → 1.13.20

package/docs//345/217/257/347/224/250/345/261/236/346/200/247/351/205/215/347/275/256/351/241/271.md

@@ -1,801 +0,0 @@
-# 可用属性配置项
-
-本文档汇总可在自定义组件 **属性配置面板**（`model.ts` 的 `propsSchema`）中使用的配置项类型，包括 **NeoCRM 自定义表单配置项**（平台封装的属性面板表单项）与 **NeoCRM 平台数据源相关配置项**。
-
-基础 UI 控件的 API、示例与交互说明请以 Neo Design 官方文档为准：**[Data Entry 数据录入](https://ui.neocrm.com/web/#/web/common-ui/data-entry)**。
-
-## 目录
-
-- [一、NeoCRM 自定义表单配置项](#一neocrm-自定义表单配置项)
-  - [panelInput - 属性面板文本输入](#panelinput---属性面板文本输入)
-  - [panelSelect - 属性面板下拉选择](#panelselect---属性面板下拉选择)
-  - [panelSwitch - 属性面板开关](#panelswitch---属性面板开关)
-  - [panelNumber - 属性面板数字输入](#panelnumber---属性面板数字输入)
-  - [panelColor - 属性面板颜色选择器](#panelcolor---属性面板颜色选择器)
-  - [neoCascader - 级联选择](#neocascader---级联选择)
-  - [neoRadio - 单选框](#neoradio---单选框)
-  - [neoCheckbox - 多选框](#neocheckbox---多选框)
-  - [neoDatePicker - 日期选择框](#neodatepicker---日期选择框)
-  - [neoTimePicker - 时间选择框](#neotimepicker---时间选择框)
-  - [neoRate - 评分](#neorate---评分)
-  - [neoSlider - 滑动输入条](#neoslider---滑动输入条)
-  - [neoTransfer - 穿梭框](#neotransfer---穿梭框)
-  - [neoTreeSelect - 树选择](#neotreeselect---树选择)
-  - [neoUpload - 上传](#neoupload---上传)
-- [二、NeoCRM 平台数据源相关配置项](#二neocrm-平台数据源相关配置项)
-  - [xObjectEntityList - 实体列表数据源](#xobjectentitylist---实体列表数据源)
-  - [xObjectDataApi - 实体业务数据列表数据源](#xobjectdataapi---实体业务数据列表数据源)
-  - [xObjectDetailApi - 实体详情数据源](#xobjectdetailapi---实体详情数据源)
-  - [selectFieldsApi - 字段 apiKey 多选（穿梭框）](#selectfieldsapi---字段-apikey-多选穿梭框)
-  - [selectFieldDescApi - 字段描述选择（下拉单选/多选）](#selectfielddescapi---字段描述选择下拉单选多选)
-  - [dataViewIdSelect - 实体视图选择](#dataviewidselect---实体视图选择)
-
----
-
-## 一、NeoCRM 自定义表单配置项
-
-### panelInput - 属性面板文本输入
-
-用于在属性配置面板中配置短文本（标题、占位说明、尺寸类字符串等），能力上与 Neo Design **Input** 一致，详见 [Input 输入框](https://ui.neocrm.com/web/#/web/common-ui/input)。
-
-**功能特性：**
-
-1. **单行输入**：适合标题、高度、提示文案等字符串配置  
-2. **占位提示**：可通过 `placeholder` 引导填写  
-3. **数据存储**：输入内容写入对应 `name` 的 `value`（string）  
-4. **条件展示**：可配合 `visibleOn` / `hiddenOn` 与其他配置项联动  
-
-**使用方法：**
-
-在属性配置面板（`propsSchema`）中使用：
-
-```json
-{
-  "type": "panelInput",
-  "name": "height",
-  "label": "高度",
-  "placeholder": "例如 500px 或 100%",
-  "visibleOn": "!autoHeight"
-}
-```
-
-**组件属性：**
-
-- `name`: 字段名称  
-- `label`: 标签文本  
-- `value`: 当前值或初始值（string）  
-- `placeholder`: 占位文案  
-- `disabled`: 是否禁用  
-- `visibleOn` / `hiddenOn`: 与其他字段联动显示（见上文）  
-- `onChange`: 值变化回调  
-
----
-
-### panelSelect - 属性面板下拉选择
-
-用于在有限选项中单选，能力上与 Neo Design **Select** 一致（选项结构、禁用项等概念相同），详见 [Select 选择器](https://ui.neocrm.com/web/#/web/common-ui/select)。
-
-**功能特性：**
-
-1. **下拉单选**：从 `options` 中选择一项  
-2. **选项结构**：`options` 为 `{ label, value }[]`  
-3. **数据存储**：选中项的 `value` 写入表单 `value`  
-4. **占位与禁用**：支持 `placeholder`、`disabled`  
-
-**使用方法：**
-
-```json
-{
-  "type": "panelSelect",
-  "name": "columnCount",
-  "label": "表单列数",
-  "value": 1,
-  "placeholder": "请选择表单列数",
-  "options": [
-    { "label": "单列", "value": 1 },
-    { "label": "双列", "value": 2 },
-    { "label": "三列", "value": 3 }
-  ]
-}
-```
-
-**组件属性：**
-
-- `name`: 字段名称  
-- `label`: 标签文本  
-- `value`: 当前选中值（与 `options[].value` 类型一致）  
-- `options`: 选项列表，`{ label: string; value: unknown }[]`  
-- `placeholder`: 占位文案  
-- `disabled`: 是否禁用  
-- `visibleOn` / `hiddenOn`: 联动显示  
-- `onChange`: 值变化回调  
-
----
-
-### panelSwitch - 属性面板开关
-
-用于布尔型配置（是否显示、是否禁用等），对应 Neo Design **Switch**，详见 [Switch 开关](https://ui.neocrm.com/web/#/web/common-ui/switch)。
-
-**功能特性：**
-
-1. **开关展示**：支持选中/未选中文案（`checkedChildren`、`unCheckedChildren`）  
-2. **数据存储**：布尔值写入 `value`  
-3. **设计器集成**：通过 ScopedContext 注册，可与设计器表单联动  
-
-**使用方法：**
-
-```json
-{
-  "type": "panelSwitch",
-  "name": "disableSearch",
-  "label": "禁用搜索",
-  "defaultChecked": false,
-  "hiddenOn": "hiddenHeader"
-}
-```
-
-**组件属性：**
-
-- `name`: 字段名称  
-- `label`: 标签文本  
-- `value` / `defaultChecked`: 当前值或默认是否选中（boolean）  
-- `checkedChildren`: 选中时展示文案，可为字符串或返回 ReactNode 的函数  
-- `unCheckedChildren`: 未选中时展示文案，可为字符串或返回 ReactNode 的函数  
-- `disabled`: 是否禁用  
-- `size`: 尺寸，`small` \| `default`  
-- `visibleOn` / `hiddenOn`: 联动显示  
-- `onChange`: 值变化回调  
-
----
-
-### panelNumber - 属性面板数字输入
-
-用于数值类配置（条数、精度、步长等），对应 Neo Design **InputNumber**，详见 [InputNumber 数字输入框](https://ui.neocrm.com/web/#/web/common-ui/input-number)。
-
-**功能特性：**
-
-1. **数字输入**：支持最小值、最大值、步长、精度  
-2. **数据存储**：`number \| null` 写入 `value`  
-3. **设计器集成**：通过 ScopedContext 注册  
-
-**使用方法：**
-
-```json
-{
-  "type": "panelNumber",
-  "name": "paginationPageSize",
-  "label": "每页展示条数",
-  "value": 20,
-  "min": 1,
-  "max": 500,
-  "visibleOn": "!disablePagination"
-}
-```
-
-**组件属性：**
-
-- `name`: 字段名称  
-- `label`: 标签文本  
-- `value` / `defaultValue`: 当前值或默认值（number \| null）  
-- `min` / `max`: 最小值、最大值  
-- `step`: 步长（number 或 string）  
-- `precision`: 小数位数  
-- `disabled`: 是否禁用  
-- `size`: `large` \| `middle` \| `small`  
-- `visibleOn` / `hiddenOn`: 联动显示  
-- `onChange`: 值变化回调  
-
----
-
-### panelColor - 属性面板颜色选择器
-
-用于配置颜色（含透明度），基于 `react-color` 的 `SketchPicker`，适用于背景色、边框色等。
-
-**功能特性：**
-
-1. **弹层选色**：点击色块打开选择器，支持透明度  
-2. **数据存储**：`#RRGGBB` 或 `rgba(r,g,b,a)` 字符串写入 `value`  
-3. **清除颜色**：可清空为 `undefined`  
-4. **禁用态**：禁用时仅展示色块，不可编辑  
-5. **设计器集成**：ScopedContext 注册  
-
-**使用方法：**
-
-```json
-{
-  "type": "panelColor",
-  "name": "backgroundColor",
-  "label": "背景颜色",
-  "defaultValue": "rgba(255, 255, 255, 1)"
-}
-```
-
-**组件属性：**
-
-- `name`: 字段名称  
-- `label`: 标签文本  
-- `value` / `defaultValue`: 颜色字符串  
-- `disabled`: 是否禁用  
-- `className`: 自定义类名  
-- `onChange`: 回调参数为 `string \| undefined`  
-
----
-
-以下类型与 **[Neo Design · Data Entry 数据录入](https://ui.neocrm.com/web/#/web/common-ui/data-entry)** 中的同名组件一致；交互细节、受控与非受控写法、各 API 的完整说明请以该索引页进入的各子文档为准（若设计器对 `type` 使用 `panel` 前缀，以实际设计器解析为准）。
-
-### neoCascader - 级联选择
-
-用于多级关联选项的单选（或可配置为多选），能力上与 Neo Design **Cascader** 一致，详见 [Cascader 级联选择](https://ui.neocrm.com/web/#/web/common-ui/Cascader)。
-
-**功能特性：**
-
-1. **级联结构**：通过 `options` 的树形结构（含 `children`）展示多级菜单  
-2. **选中值**：通常为各级选中项 `value` 组成的数组（选中路径）  
-3. **搜索与异步**：支持过滤展示；可按文档使用动态加载子级（`loadData` 等，以线上 API 为准）  
-4. **数据存储**：选中结果写入对应 `name` 的 `value`  
-5. **条件展示**：可配合 `visibleOn` / `hiddenOn` 联动  
-
-**使用方法：**
-
-```json
-{
-  "type": "neoCascader",
-  "name": "region",
-  "label": "地区",
-  "placeholder": "请选择省 / 市 / 区",
-  "options": [
-    {
-      "label": "浙江省",
-      "value": "zj",
-      "children": [{ "label": "杭州市", "value": "hz" }]
-    }
-  ]
-}
-```
-
-**常用属性（与 Neo Design 文档一致）：**
-
-- `name` / `label`  
-- `value` / `defaultValue`：选中路径，一般为 `string[]` 或 `number[]`  
-- `options`：级联数据源  
-- `placeholder`、`disabled`、`allowClear`  
-- `multiple`（若版本支持多选级联）  
-- `visibleOn` / `hiddenOn`、`onChange`  
-
----
-
-### neoRadio - 单选框
-
-用于在少量互斥选项中单选，能力上与 Neo Design **Radio** 一致，详见 [Radio 单选框](https://ui.neocrm.com/web/#/web/common-ui/radio)。
-
-**功能特性：**
-
-1. **互斥单选**：同一组内只能选中一项  
-2. **选项展示**：常用 `Radio.Group` 配合 `options` 或子节点渲染多个 `Radio`  
-3. **数据存储**：当前选中项的 `value` 写入表单  
-4. **布局**：支持按钮样式、排列方向等（见文档）  
-
-**使用方法：**
-
-```json
-{
-  "type": "neoRadio",
-  "name": "layoutMode",
-  "label": "布局",
-  "options": [
-    { "label": "横向", "value": "horizontal" },
-    { "label": "纵向", "value": "vertical" }
-  ]
-}
-```
-
-**常用属性：**
-
-- `name` / `label`  
-- `value` / `defaultValue`  
-- `options`：`{ label, value }[]`（若设计器支持）  
-- `disabled`、`optionType`（如 `button`）  
-- `visibleOn` / `hiddenOn`、`onChange`  
-
----
-
-### neoCheckbox - 多选框
-
-用于一项或多项勾选，能力上与 Neo Design **Checkbox** 一致，详见 [Checkbox 多选框](https://ui.neocrm.com/web/#/web/common-ui/checkbox)。
-
-**功能特性：**
-
-1. **单框布尔**：单个 Checkbox 表示是否勾选（boolean）  
-2. **组多选**：`Checkbox.Group` 从多个选项中勾选若干项，`value` 为选中值的数组  
-3. **全选/半选**：组场景下可配合 indeterminate 等能力（见文档）  
-4. **数据存储**：布尔或 `value[]` 写入对应字段  
-
-**使用方法：**
-
-```json
-{
-  "type": "neoCheckbox",
-  "name": "features",
-  "label": "展示项",
-  "options": [
-    { "label": "标题", "value": "title" },
-    { "label": "副标题", "value": "subtitle" }
-  ]
-}
-```
-
-**常用属性：**
-
-- `name` / `label`  
-- `value` / `defaultValue`：多选时为数组  
-- `options`：组模式下的选项列表  
-- `disabled`  
-- `visibleOn` / `hiddenOn`、`onChange`  
-
----
-
-### neoDatePicker - 日期选择框
-
-用于选择日期或日期范围，能力上与 Neo Design **DatePicker** 一致，详见 [DatePicker 日期选择框](https://ui.neocrm.com/web/#/web/common-ui/date-picker)。
-
-**功能特性：**
-
-1. **日期 / 周 / 月等**：通过 `picker` 切换选择粒度（以文档为准）  
-2. **范围选择**：可使用 `RangePicker` 选择起止日期（若平台单独暴露类型则按其 `type` 配置）  
-3. **格式化**：`format`、`showTime` 等控制展示与是否含时间  
-4. **数据存储**：一般为日期对象或格式化字符串（与平台绑定约定一致）  
-
-**使用方法：**
-
-```json
-{
-  "type": "neoDatePicker",
-  "name": "startDate",
-  "label": "开始日期",
-  "placeholder": "请选择日期",
-  "format": "YYYY-MM-DD"
-}
-```
-
-**常用属性：**
-
-- `name` / `label`  
-- `value` / `defaultValue`  
-- `format`、`picker`、`showTime`、`allowClear`  
-- `disabled`、`disabledDate`  
-- `visibleOn` / `hiddenOn`、`onChange`  
-
----
-
-### neoTimePicker - 时间选择框
-
-用于选择时刻（不含日历日期或仅时间维度），能力上与 Neo Design **TimePicker** 一致，详见 [TimePicker 时间选择框](https://ui.neocrm.com/web/#/web/common-ui/time-picker)。
-
-**功能特性：**
-
-1. **时间选择**：时、分、秒及步长配置（见文档）  
-2. **格式化**：`format` 控制展示与回填格式  
-3. **数据存储**：时间类值或字符串，依平台约定  
-
-**使用方法：**
-
-```json
-{
-  "type": "neoTimePicker",
-  "name": "remindTime",
-  "label": "提醒时间",
-  "format": "HH:mm",
-  "placeholder": "请选择时间"
-}
-```
-
-**常用属性：**
-
-- `name` / `label`  
-- `value` / `defaultValue`  
-- `format`、`allowClear`、`disabled`  
-- `visibleOn` / `hiddenOn`、`onChange`  
-
----
-
-### neoRate - 评分
-
-用于星级或分值评分，能力上与 Neo Design **Rate** 一致，详见 [Rate 评分](https://ui.neocrm.com/web/#/web/common-ui/rate)。
-
-**功能特性：**
-
-1. **星标展示**：默认星级点击评分  
-2. **半选与总数**：`allowHalf`、`count` 等扩展行为（见文档）  
-3. **数据存储**：数值型评分写入 `value`  
-
-**使用方法：**
-
-```json
-{
-  "type": "neoRate",
-  "name": "satisfaction",
-  "label": "满意度",
-  "count": 5,
-  "allowHalf": true
-}
-```
-
-**常用属性：**
-
-- `name` / `label`  
-- `value` / `defaultValue`  
-- `count`、`allowHalf`、`disabled`  
-- `visibleOn` / `hiddenOn`、`onChange`  
-
----
-
-### neoSlider - 滑动输入条
-
-用于在区间内通过拖动选择数值，能力上与 Neo Design **Slider** 一致，详见 [Slider 滑动输入条](https://ui.neocrm.com/web/#/web/common-ui/slider)。
-
-**功能特性：**
-
-1. **区间与步长**：`min`、`max`、`step`  
-2. **范围滑块**：双滑块选择区间（若文档提供 `range` 等 API）  
-3. **刻度与提示**：`marks`、`tooltip` 相关配置  
-4. **数据存储**：`number` 或 `[number, number]`（范围时）  
-
-**使用方法：**
-
-```json
-{
-  "type": "neoSlider",
-  "name": "opacity",
-  "label": "透明度",
-  "min": 0,
-  "max": 100,
-  "step": 1
-}
-```
-
-**常用属性：**
-
-- `name` / `label`  
-- `value` / `defaultValue`  
-- `min`、`max`、`step`、`marks`、`disabled`  
-- `visibleOn` / `hiddenOn`、`onChange`  
-
----
-
-### neoTransfer - 穿梭框
-
-用于在两栏列表间移动选中项，能力上与 Neo Design **Transfer** 一致，详见 [Transfer 穿梭框](https://ui.neocrm.com/web/#/web/common-ui/transfer)。
-
-**功能特性：**
-
-1. **双栏列表**：左侧源列表、右侧已选列表  
-2. **搜索与禁用**：支持过滤、单项或整侧禁用  
-3. **数据存储**：已选 key 列表 `targetKeys` 与完整 `dataSource` 配合  
-4. **大数据**：可按文档使用懒加载、分页等模式  
-
-**使用方法：**
-
-```json
-{
-  "type": "neoTransfer",
-  "name": "selectedKeys",
-  "label": "字段分配",
-  "dataSource": [
-    { "key": "a", "title": "选项 A" },
-    { "key": "b", "title": "选项 B" }
-  ]
-}
-```
-
-**常用属性：**
-
-- `name` / `label`  
-- `dataSource`：含 `key`、`title`（及 `disabled` 等）  
-- `targetKeys` / `selectedKeys`（命名以文档为准）  
-- `titles`、`showSearch`、`disabled`  
-- `visibleOn` / `hiddenOn`、`onChange`  
-
----
-
-### neoTreeSelect - 树选择
-
-在树形结构中单选或多选节点，能力上与 Neo Design **TreeSelect** 一致，详见 [TreeSelect 树选择](https://ui.neocrm.com/web/#/web/common-ui/tree-select)。
-
-**功能特性：**
-
-1. **树形数据**：`treeData` 描述父子节点  
-2. **单选 / 多选**：`multiple`、`treeCheckable` 等（见文档）  
-3. **搜索与异步**：可搜索节点；支持异步加载子节点时按文档配置  
-4. **数据存储**：选中节点的 `value` 或 `value[]`  
-
-**使用方法：**
-
-```json
-{
-  "type": "neoTreeSelect",
-  "name": "categoryId",
-  "label": "类目",
-  "placeholder": "请选择类目",
-  "treeData": [
-    {
-      "title": "一级",
-      "value": "1",
-      "children": [{ "title": "二级", "value": "1-1" }]
-    }
-  ]
-}
-```
-
-**常用属性：**
-
-- `name` / `label`  
-- `treeData` / `treeDataSimpleMode`（若使用）  
-- `value` / `defaultValue`  
-- `multiple`、`treeCheckable`、`showSearch`、`allowClear`  
-- `visibleOn` / `hiddenOn`、`onChange`  
-
----
-
-### neoUpload - 上传
-
-用于选择并上传文件，能力上与 Neo Design **Upload** 一致，详见 [Upload 上传](https://ui.neocrm.com/web/#/web/common-ui/upload)。
-
-**功能特性：**
-
-1. **点击 / 拖拽**：支持多种触发方式（见文档）  
-2. **列表与预览**：`fileList`、预览、移除  
-3. **限制**：`accept`、`maxCount`、大小校验、`beforeUpload`  
-4. **上传地址与请求**：`action`、`headers`、`data` 等与后端对接  
-5. **数据存储**：文件列表或平台约定的 URL / id 结构写入 `value`  
-
-**使用方法：**
-
-```json
-{
-  "type": "neoUpload",
-  "name": "attachments",
-  "label": "附件",
-  "maxCount": 5,
-  "accept": ".pdf,.png"
-}
-```
-
-**常用属性：**
-
-- `name` / `label`  
-- `action`、`headers`、`data`、`name`（字段名）  
-- `fileList` / `defaultFileList`  
-- `multiple`、`accept`、`maxCount`、`beforeUpload`、`disabled`  
-- `visibleOn` / `hiddenOn`、`onChange`  
-
----
-
-## 二、NeoCRM 平台数据源相关配置项
-
-### xObjectEntityList - 实体列表数据源
-
-这是一个简化的对象实体列表选择配置项，采用直接下拉列表配置方式，专门用于选择对象实体。
-
-**功能特性：**
-
-1. **实体列表展示**：以下拉列表形式展示当前可选择的实体对象  
-2. **搜索功能**：支持实体名称搜索  
-3. **数据存储**：选择的实体 ID 存储到 value 中  
-4. **实体类型控制**：通过 custom 属性控制使用标准实体还是自定义实体  
-
-**使用方法：**
-
-在属性配置面板（propsSchema）中使用：
-
-```json
-{
-  "type": "xObjectEntityList",
-  "name": "xObjectApiKey",
-  "label": "对象实体列表",
-  "custom": false
-}
-```
-
-**组件属性：**
-
-- `name`: 字段名称  
-- `label`: 标签文本  
-- `disabled`: 是否禁用  
-- `custom`: 是否使用自定义实体，设置为 false 则表示展示标准实体列表，不传则展示标准实体和自定义实体  
-- `value`: 当前已选择的实体对象 ID（xObjectApiKey）  
-- `onChange`: 值变化回调  
-
----
-
-### xObjectDataApi - 实体业务数据列表数据源
-
-这是一个用于获取实体业务数据列表的属性配置项。
-
-**功能特性：**
-
-1. **输入框展示**：以输入框形式展示当前配置的实体和选择的字段信息  
-2. **设置按钮**：右侧设置图标，点击打开配置弹窗  
-3. **实体类型选择**：弹窗中支持选择标准实体或自定义实体  
-4. **实体选择**：弹窗中支持下拉选择实体  
-5. **字段选择**：使用 antd Transfer 组件选择字段，默认选中所有实体字段  
-6. **分页配置**：配置页码（默认展示第几页）和每页条数（每页展示多少条数据）  
-7. **数据存储**：选择的实体 ID 存储到 `xObjectApiKey`，选中的字段列表存储到 `fields`，字段信息列表存储到 `fieldDescList`，页码存储到 `page`，每页条数存储到 `pageSize`  
-
-**使用方法：**
-
-在属性配置面板（propsSchema）中使用：
-
-```json
-{
-  "type": "xObjectDataApi",
-  "name": "dataSource",
-  "label": "数据源配置"
-}
-```
-
-**组件属性：**
-
-- `name`: 字段名称  
-- `label`: 标签文本  
-- `disabled`: 是否禁用  
-- `value`: 当前值，格式为 `{ xObjectApiKey: string, fields: string[], fieldDescList: object[], page: number, pageSize: number }`  
-  - `xObjectApiKey`: 选择的实体 API Key  
-  - `fields`: 选中的字段列表  
-  - `fieldDescList`: 字段信息列表  
-  - `page`: 页码，默认为 1（默认展示第几页）  
-  - `pageSize`: 每页条数，默认为 20（每页展示多少条数据）  
-- `onChange`: 值变化回调  
-
----
-
-### xObjectDetailApi - 实体详情数据源
-
-这是一个用于配置获取实体业务详情数据的属性配置项。
-
-**功能特性：**
-
-1. **输入框展示**：以输入框形式展示当前配置的实体、业务数据 ID 和字段信息  
-2. **设置按钮**：右侧设置图标，点击打开配置弹窗  
-3. **实体选择**：弹窗中支持下拉选择实体（标准实体/自定义实体）  
-4. **业务数据 ID 选择**：根据选择的实体，使用 xObject.query 获取业务数据列表，支持选择具体的业务数据 ID  
-5. **字段选择**：使用 antd Transfer 组件选择字段，默认全部选中  
-6. **数据存储**：选择的实体 ID 存储到 `xObjectApiKey`，业务数据 ID 存储到 `objectId`，字段列表存储到 `fieldDescList`  
-
-**使用方法：**
-
-在属性配置面板（propsSchema）中使用：
-
-```json
-{
-  "type": "xObjectDetailApi",
-  "name": "dataSource",
-  "label": "业务详情数据源配置"
-}
-```
-
-**组件属性：**
-
-- `name`: 字段名称  
-- `label`: 标签文本  
-- `disabled`: 是否禁用  
-- `value`: 当前值，格式为 `{ xObjectApiKey: string, objectId: string }`  
-- `onChange`: 值变化回调  
-
-**特性：**
-
-- **实体类型切换**：支持标准实体和自定义实体的切换  
-- **智能联动**：选择实体后自动加载对应的业务数据列表和字段列表  
-- **搜索过滤**：所有选择器都支持搜索过滤功能  
-
----
-
-### selectFieldsApi - 字段 apiKey 多选（穿梭框）
-
-用于在已配置实体数据源的前提下，通过穿梭框多选实体字段的 apiKey 列表。依赖同表单中的实体配置（xObjectApiKey），需先配置实体数据源。
-
-**功能特性：**
-
-1. **输入框展示**：以只读输入框展示「已选择 N 个字段」  
-2. **设置按钮**：右侧设置图标，点击打开「字段选择」弹窗  
-3. **穿梭框选择**：弹窗内使用 Transfer 在「可选字段」与「已选字段」间勾选，支持搜索  
-4. **数据存储**：选中的字段 apiKey 列表存储到 value（`string[]`）  
-5. **联动数据源**：通过 `xObjectApiKey` 指定从 `props.data` 中读取实体 key 的路径，实体变化时会重新拉取字段列表  
-
-**使用方法：**
-
-在属性配置面板（propsSchema）中，需与提供 xObjectApiKey 的配置项（如 xObjectDataApi、xObjectDetailApi）同表单使用：
-
-```json
-{
-  "type": "selectFieldsApi",
-  "name": "fields",
-  "label": "选择字段",
-  "xObjectApiKey": "dataSource.xObjectApiKey"
-}
-```
-
-**组件属性：**
-
-- `name`: 字段名称  
-- `label`: 标签文本  
-- `disabled`: 是否禁用  
-- `xObjectApiKey`: 从 `props.data` 中获取实体 API Key 的 key 名，不传则默认为 `'xObjectApiKey'`。若实体在嵌套对象中可传路径，如 `'dataSource.xObjectApiKey'`  
-- `value`: 当前值，格式为 `string[]`（字段 apiKey 列表）  
-- `onChange`: 值变化回调  
-
----
-
-### selectFieldDescApi - 字段描述选择（下拉单选/多选）
-
-用于在已配置实体数据源的前提下，通过下拉选择实体字段，支持单选或多选。选中的值以「字段描述」对象数组形式存储（含 label、value/apiKey）。依赖同表单中的实体配置（xObjectApiKey）。
-
-**功能特性：**
-
-1. **下拉选择**：以 Select 形式展示，支持搜索、清空  
-2. **单选/多选**：通过 `mode` 控制，可选 `'multiple'` 或 `'tags'`  
-3. **数据存储**：选中的值存储为 `Array<{ label: string; value: string }>`，其中 value 为字段 apiKey  
-4. **联动数据源**：通过 `xObjectApiKey` 指定从 `props.data` 中读取实体 key 的路径，实体变化时会重新加载字段列表  
-
-**使用方法：**
-
-在属性配置面板（propsSchema）中，需与提供 xObjectApiKey 的配置项同表单使用：
-
-```json
-{
-  "type": "selectFieldDescApi",
-  "name": "selectFieldDesc",
-  "label": "绑定字段",
-  "xObjectApiKey": "entityApiKey.xObjectApiKey",
-  "mode": "tags",
-  "placeholder": "请至少选择一个要显示的字段"
-}
-```
-
-**组件属性：**
-
-- `name`: 字段名称  
-- `label`: 标签文本  
-- `disabled`: 是否禁用  
-- `placeholder`: 占位文案  
-- `xObjectApiKey`: 从 `props.data` 中获取实体 API Key 的 key 名或路径，不传则默认为 `'xObjectApiKey'`，如 `'entityApiKey.xObjectApiKey'`  
-- `mode`: 可选 `'multiple'`（多选）或 `'tags'`（多选标签形式），不传为单选  
-- `value`: 当前值，格式为 `Array<{ label: string; value: string }>`  
-- `onChange`: 值变化回调  
-
----
-
-### dataViewIdSelect - 实体视图选择
-
-用于选择指定实体下的列表视图，依赖同表单中的实体 `xObjectApiKey`。详见本文第二节数据源配置。
-
-**功能特性：**
-
-1. **单选视图**：下拉展示当前实体可用视图  
-2. **接口加载**：根据 `xObjectApiKey` 请求视图列表（如 `/rest/data/v2.0/layouts/listLayout`）  
-3. **搜索与清空**：支持搜索视图名、清空选择  
-4. **数据存储**：`value` 为视图 ID 字符串（`viewId`）  
-5. **无实体提示**：未配置实体时禁用并提示先配置数据源  
-
-**使用方法：**
-
-```json
-{
-  "type": "dataViewIdSelect",
-  "name": "defaultViewId",
-  "label": "列表视图",
-  "xObjectApiKey": "objectApiKey",
-  "placeholder": "请选择列表视图"
-}
-```
-
-**组件属性：**
-
-- `name`: 字段名称  
-- `label`: 标签文本  
-- `disabled`: 是否禁用  
-- `placeholder`: 占位文案，默认可为「请选择视图」  
-- `xObjectApiKey`: 从 `props.data` 取实体 API Key 的字段名或路径，默认 `xObjectApiKey`  
-- `value`: 字符串，所选 `viewId`  
-- `onChange`: 值变化回调  
-
----