roymondchen 873a51fc87 docs: 升级 VitePress 至 v2 alpha,类型引用改为源码片段同步
- 升级 vitepress 到 ^2.0.0-alpha.17
- vite.optimizeDeps.rolldownOptions.transform.define 迁移至 vite.define 以适配 v2 API
- 同步升级 vitest/rolldown/vue/vite 等周边依赖
- 文档中类型链接统一改为 <<< 片段引用源码 region,避免 commit hash 链接失效
- packages/{core,editor,form-schema,schema,stage} 相关类型加 // #region 锚点
- 移除已废弃的 docs/guide/advanced/tmagic-ui.md 及侧栏入口

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-18 11:47:03 +08:00

2.1 KiB

UISelect 组件选择器

用于在画布中选择组件的选择器。

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

基础用法

{
  type: 'ui-select',
  name: 'targetId',
  text: '目标组件'
}

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 查看 UISelectConfig 配置类型定义 <<< @/../packages/form-schema/src/editor.ts#UISelectConfig{ts}

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

:::

使用说明

  1. 点击"点击此处选择"按钮进入选择模式
  2. 在画布中点击目标组件完成选择
  3. 选择后会显示组件名称和ID
  4. 可通过清除按钮清空选择
  5. 点击组件名称可跳转到对应组件