tmagic-editor/docs/form-config/editor-fields/page-fragment-select.md
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

2.4 KiB

PageFragmentSelect 页面片选择器

用于选择页面片的下拉选择器。

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

基础用法

{
  type: 'page-fragment-select',
  name: 'pageFragment',
  text: '页面片'
}

值校验

安装 @tmagic/editor 后该字段会自动注册内置 typeMatch 校验规则:须为 stringnumber,有节点树时须为已有页面片 id。服务数据未就绪时仅做基础形态校验。详见表单校验 - Editor 字段内置规则

Attributes

参数 说明 类型 可选值 默认值
name 绑定值 string
text 表单标签 string
disabled 是否禁用 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 查看 PageFragmentSelectConfig 配置类型定义 <<< @/../packages/form-schema/src/editor.ts#PageFragmentSelectConfig{ts}

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

:::

使用说明

  1. 下拉框会自动列出当前项目中所有的页面片
  2. 选中页面片后,点击编辑图标可跳转到对应页面片进行编辑