mirror of https://github.com/Tencent/tmagic-editor.git synced 2026-07-22 02:03:24 +08:00

roymondchen 1c67b5e77b feat(editor): 注册编辑器字段内置 typeMatch 校验规则并补充文档

- 新增 typeMatchRules.ts，为编辑器自定义字段注册内置 typeMatch 校验规则
- 抽取 event.ts 事件工具函数
- form typeMatch 适配 TDesign 校验器签名，错误消息补充实际值
- rules.md 新增「Editor 字段内置规则」章节，16 个字段文档补充校验说明

2026-07-14 17:15:28 +08:00

3.7 KiB

Raw Blame History

DataSourceSelect 数据源选择器

用于选择数据源的下拉选择器。

::: warning 注意此组件仅在编辑器环境中可用，需要配合 @tmagic/editor 使用。 :::

基础用法

{
  type: 'data-source-select',
  name: 'dataSource',
  text: '数据源'
}

过滤数据源类型

{
  type: 'data-source-select',
  name: 'dataSource',
  text: '数据源',
  dataSourceType: 'http'
}

返回数据源ID

{
  type: 'data-source-select',
  name: 'dataSource',
  text: '数据源',
  value: 'id'
}

值校验

安装 @tmagic/editor 后该字段会自动注册内置 typeMatch 校验规则：value: 'id' 时须为已有 ds id，否则为含 isBindDataSource + dataSourceId 的对象。服务数据未就绪时仅做基础形态校验。详见表单校验 - Editor 字段内置规则。

Attributes

参数	说明	类型	可选值	默认值
name	绑定值	string	—	—
text	表单标签	string	—	—
placeholder	输入框占位文本	string	—	—
disabled	是否禁用	boolean / `FilterFunction`	—	false
dataSourceType	数据源类型过滤	string	base/http等	—
value	返回值类型	string	id/value	—
notEditable	是否不可编辑数据源（disable控制是否可选择）	boolean / `FilterFunction`	—	false
onChange	值变化时触发的函数	`OnChangeHandler`	—	-

::: details 查看 FilterFunction / OnChangeHandler 及关联类型定义 <<< @/../packages/form-schema/src/base.ts#FilterFunction{ts}

<<< @/../packages/form-schema/src/base.ts#OnChangeHandler{ts}

<<< @/../packages/form-schema/src/base.ts#OnChangeHandlerData{ts}

<<< @/../packages/form-schema/src/base.ts#ChangeRecord{ts}

<<< @/../packages/form-schema/src/base.ts#FormValue{ts} :::

配置类型

::: details 查看 DataSourceSelect 配置类型定义 <<< @/../packages/form-schema/src/editor.ts#DataSourceSelect{ts}

<<< @/../packages/form-schema/src/base.ts#FormItem{ts}

<<< @/../packages/form-schema/src/base.ts#Input{ts}

:::

value说明

id: 不编译，返回数据源id
value: 编译后返回数据源data

3.7 KiB Raw Blame History Unescape Escape