873a51fc87
- 升级 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>
3.1 KiB
Form组件属性 props
config
-
详情： 表单配置
-
默认值：
[] -
类型：
FormConfig::: details 查看 FormConfig 及关联类型定义 <<< @/../packages/form-schema/src/base.ts#FormConfig{ts}
<<< @/../packages/form-schema/src/base.ts#FormItemConfig{ts}
<<< @/../packages/form-schema/src/base.ts#ChildConfig{ts}
<<< @/../packages/form-schema/src/base.ts#DynamicTypeConfig{ts}
<<< @/../packages/form-schema/src/base.ts#FormItem{ts} :::
-
示例：
<template>
<m-form-dialog :config="config"></m-form-dialog>
</template>
<script setup>
import { ref } from "Vue";
const config = ref([
{
name: "text",
text: "文本",
},
{
name: "multiple",
text: "多行文本",
type: "switch",
},
]);
</script>
initValues
-
详情： 表单初始化值
-
默认值：
{} -
类型：
Object -
示例：
<template>
<m-form-dialog :init-values="initValues"></m-form-dialog>
</template>
<script setup>
import { ref } from 'Vue';
const initValues = ref([
text: 'text',
multiply: true,
]);
</script>
lastValues
-
详情： 需对比的值（开启对比模式时传入）
-
默认值：
{} -
类型：
Object
isCompare
-
详情： 是否开启对比模式
-
默认值：
false -
类型：
boolean
parentValues
-
详情： 父级表单值
-
默认值：
{} -
类型：
Object
labelWidth
- 详情：
表单域标签的宽度，例如 '50px'。 作为 Form 直接子元素的 form-item 会继承该值。 支持 auto
-
默认值：
'200px' -
类型：
string
disabled
-
详情： 是否禁用该表单内的所有组件。 若设置为 true，则表单内组件上的 disabled 属性不再生效
-
默认值： false
-
类型：
boolean
height
-
详情： 表单容器的高度，会作为内联样式
height应用到表单根元素上 -
默认值：
'auto' -
类型：
string
stepActive
-
详情： 当表单包含 step 容器时，控制当前激活的步骤
-
默认值：
1 -
类型：
string | number
size
-
详情： 用于控制该表单内组件的尺寸
-
类型：
'small' | 'default' | 'large'
inline
-
详情： 行内表单模式
-
默认值： false
-
类型：
boolean
labelPosition
-
详情： 表单域标签的位置， 当设置为 left 或 right 时，则也需要设置 label-width 属性
-
默认值：
'right' -
类型：
string
keyProp
-
详情： 作为表单项的组件实例的key
-
默认值：
'__key' -
类型：
string
popperClass
-
详情： tooltip弹出层的class
-
类型：
string
preventSubmitDefault
-
详情： 是否阻止表单原生 submit 事件的默认行为
-
类型：
boolean
extendState
-
详情： 扩展 formState 的钩子函数，返回的对象会被合并到 formState 上
-
类型：
(state: FormState) => Record<string, any> | Promise<Record<string, any>>