@qin-ui/antdv-next-pro 1.1.15 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (128) hide show
  1. package/AI-CONTEXT.md +35 -24
  2. package/LICENSE +9 -0
  3. package/README.md +61 -61
  4. package/api.json +42 -28
  5. package/es/antdv-next-pro.css +9 -9
  6. package/es/component-provider/{index-Daiw7IxY.js → index-Tesc9NuK.js} +2 -1
  7. package/es/component-provider/index-Tesc9NuK.js.map +1 -0
  8. package/es/component-provider/index.js +2 -1
  9. package/es/component-provider/index.js.map +1 -0
  10. package/es/components/component-provider/components/index.vue.d.ts +27 -0
  11. package/es/components/component-provider/components/index.vue.d.ts.map +1 -0
  12. package/es/components/component-provider/constants/index.d.ts +16 -0
  13. package/es/components/component-provider/constants/index.d.ts.map +1 -0
  14. package/es/components/component-provider/index.d.ts +4 -0
  15. package/es/components/component-provider/index.d.ts.map +1 -0
  16. package/es/components/component-provider/types/index.d.ts +26 -0
  17. package/es/components/component-provider/types/index.d.ts.map +1 -0
  18. package/es/components/form/components/BaseField/index.vue.d.ts +13 -0
  19. package/es/components/form/components/BaseField/index.vue.d.ts.map +1 -0
  20. package/es/components/form/components/BaseField/utils/index.d.ts +3 -0
  21. package/es/components/form/components/BaseField/utils/index.d.ts.map +1 -0
  22. package/es/components/form/components/BaseFormItem/index.vue.d.ts +9 -0
  23. package/es/components/form/components/BaseFormItem/index.vue.d.ts.map +1 -0
  24. package/es/components/form/components/ContainerFragment/index.vue.d.ts +23 -0
  25. package/es/components/form/components/ContainerFragment/index.vue.d.ts.map +1 -0
  26. package/es/components/form/components/GroupedFieldAttrs/index.vue.d.ts +31 -0
  27. package/es/components/form/components/GroupedFieldAttrs/index.vue.d.ts.map +1 -0
  28. package/es/components/form/components/PathProvider/index.vue.d.ts +24 -0
  29. package/es/components/form/components/PathProvider/index.vue.d.ts.map +1 -0
  30. package/es/components/form/components/ProForm/index.vue.d.ts +36 -0
  31. package/es/components/form/components/ProForm/index.vue.d.ts.map +1 -0
  32. package/es/components/form/components/SlotComponent/index.vue.d.ts +7 -0
  33. package/es/components/form/components/SlotComponent/index.vue.d.ts.map +1 -0
  34. package/es/components/form/components/index.d.ts +12 -0
  35. package/es/components/form/components/index.d.ts.map +1 -0
  36. package/es/components/form/constants/index.d.ts +81 -0
  37. package/es/components/form/constants/index.d.ts.map +1 -0
  38. package/es/components/form/hooks/index.d.ts +5 -0
  39. package/es/components/form/hooks/index.d.ts.map +1 -0
  40. package/es/components/form/hooks/useFields.d.ts +57 -0
  41. package/es/components/form/hooks/useFields.d.ts.map +1 -0
  42. package/es/components/form/hooks/useForm.d.ts +93 -0
  43. package/es/components/form/hooks/useForm.d.ts.map +1 -0
  44. package/es/components/form/hooks/useFormRef.d.ts +30 -0
  45. package/es/components/form/hooks/useFormRef.d.ts.map +1 -0
  46. package/es/components/form/index.d.ts +7 -0
  47. package/es/components/form/index.d.ts.map +1 -0
  48. package/es/components/form/types/index.d.ts +251 -0
  49. package/es/components/form/types/index.d.ts.map +1 -0
  50. package/es/components/table/components/ColumnControl.vue.d.ts +9 -0
  51. package/es/components/table/components/ColumnControl.vue.d.ts.map +1 -0
  52. package/es/components/table/components/DefaultSearchFormContainer.vue.d.ts +18 -0
  53. package/es/components/table/components/DefaultSearchFormContainer.vue.d.ts.map +1 -0
  54. package/es/components/table/components/DefaultTableContainer.vue.d.ts +18 -0
  55. package/es/components/table/components/DefaultTableContainer.vue.d.ts.map +1 -0
  56. package/es/components/table/components/ProTable.vue.d.ts +118 -0
  57. package/es/components/table/components/ProTable.vue.d.ts.map +1 -0
  58. package/es/components/table/components/SearchForm.vue.d.ts +48 -0
  59. package/es/components/table/components/SearchForm.vue.d.ts.map +1 -0
  60. package/es/components/table/components/SizeControl.vue.d.ts +12 -0
  61. package/es/components/table/components/SizeControl.vue.d.ts.map +1 -0
  62. package/es/components/table/components/icons/ColumnHeightOutlined.vue.d.ts +3 -0
  63. package/es/components/table/components/icons/ColumnHeightOutlined.vue.d.ts.map +1 -0
  64. package/es/components/table/components/icons/DownOutlined.vue.d.ts +3 -0
  65. package/es/components/table/components/icons/DownOutlined.vue.d.ts.map +1 -0
  66. package/es/components/table/components/icons/FilterOutlined.vue.d.ts +3 -0
  67. package/es/components/table/components/icons/FilterOutlined.vue.d.ts.map +1 -0
  68. package/es/components/table/components/index.d.ts +5 -0
  69. package/es/components/table/components/index.d.ts.map +1 -0
  70. package/es/components/table/index.d.ts +8 -0
  71. package/es/components/table/index.d.ts.map +1 -0
  72. package/es/components/table/types/index.d.ts +48 -0
  73. package/es/components/table/types/index.d.ts.map +1 -0
  74. package/es/components/table/useTable.d.ts +111 -0
  75. package/es/components/table/useTable.d.ts.map +1 -0
  76. package/es/form/{index-7clzY8ZD.js → index-CcP5OaUd.js} +12 -6
  77. package/es/form/index-CcP5OaUd.js.map +1 -0
  78. package/es/form/index.js +4 -3
  79. package/es/form/index.js.map +1 -0
  80. package/es/index.d.ts +76 -1543
  81. package/es/index.d.ts.map +1 -0
  82. package/es/index.js +14 -23
  83. package/es/index.js.map +1 -0
  84. package/es/shared/core/index.d.ts +6 -0
  85. package/es/shared/core/index.d.ts.map +1 -0
  86. package/es/shared/ui/index.d.ts +9 -0
  87. package/es/shared/ui/index.d.ts.map +1 -0
  88. package/es/table/index.js +11 -9
  89. package/es/table/index.js.map +1 -0
  90. package/package.json +10 -11
  91. package/src/components/component-provider/components/index.vue +67 -0
  92. package/src/components/component-provider/constants/index.ts +177 -0
  93. package/src/components/component-provider/index.ts +6 -0
  94. package/src/components/component-provider/types/index.ts +59 -0
  95. package/src/components/form/components/BaseField/index.vue +181 -0
  96. package/src/components/form/components/BaseField/utils/index.ts +16 -0
  97. package/src/components/form/components/BaseFormItem/index.vue +158 -0
  98. package/src/components/form/components/ContainerFragment/index.vue +24 -0
  99. package/src/components/form/components/GroupedFieldAttrs/index.vue +119 -0
  100. package/src/components/form/components/PathProvider/index.vue +19 -0
  101. package/src/components/form/components/ProForm/index.vue +104 -0
  102. package/src/components/form/components/SlotComponent/index.vue +26 -0
  103. package/src/components/form/components/index.ts +15 -0
  104. package/src/components/form/constants/index.ts +140 -0
  105. package/src/components/form/hooks/index.ts +5 -0
  106. package/src/components/form/hooks/useFields.ts +67 -0
  107. package/src/components/form/hooks/useForm.ts +110 -0
  108. package/src/components/form/hooks/useFormRef.ts +35 -0
  109. package/src/components/form/index.ts +29 -0
  110. package/src/components/form/types/index.ts +317 -0
  111. package/src/components/table/components/ColumnControl.vue +142 -0
  112. package/src/components/table/components/DefaultSearchFormContainer.vue +22 -0
  113. package/src/components/table/components/DefaultTableContainer.vue +19 -0
  114. package/src/components/table/components/ProTable.vue +372 -0
  115. package/src/components/table/components/SearchForm.vue +296 -0
  116. package/src/components/table/components/SizeControl.vue +54 -0
  117. package/src/components/table/components/icons/ColumnHeightOutlined.vue +4 -0
  118. package/src/components/table/components/icons/DownOutlined.vue +4 -0
  119. package/src/components/table/components/icons/FilterOutlined.vue +4 -0
  120. package/src/components/table/components/index.ts +4 -0
  121. package/src/components/table/index.ts +14 -0
  122. package/src/components/table/types/index.ts +52 -0
  123. package/src/components/table/useTable.ts +129 -0
  124. package/src/index.ts +81 -0
  125. package/src/shared/core/index.ts +37 -0
  126. package/src/shared/ui/index.ts +55 -0
  127. package/es/core/index-ghYuQ3Sy.js +0 -360
  128. package/es/vendor/utils/lodash-es-p6jau26B.js +0 -1120
@@ -0,0 +1,181 @@
1
+ <script lang="ts" setup>
2
+ /**
3
+ * @component BaseField
4
+ * @description 字段级渲染组件,负责将 field 配置渲染为实际的输入组件
5
+ *
6
+ * ## 核心职责
7
+ *
8
+ * 1. **组件解析**:按优先级解析要渲染的组件(teleport 插槽 > 自定义组件 > 内置组件映射 > 原始值)
9
+ * 2. **v-model 双向绑定**:通过 computed getter/setter 将组件值与 formData 的深层路径绑定
10
+ * 3. **valueFormatter 处理**:支持 get/set 格式化函数,用于数据转换(如日期格式化)
11
+ * 4. **属性合并**:将注入的默认 props、组件传入的 attrs 合并为最终属性
12
+ *
13
+ * ## 组件解析优先级
14
+ *
15
+ * ```
16
+ * teleport 组件(ProForm 插槽注入)
17
+ * ↓ 未匹配
18
+ * 自定义组件(ProComponentProvider 的 componentMap)
19
+ * ↓ 未匹配
20
+ * 内置组件映射(componentMap: input → Input, select → Select ...)
21
+ * ↓ 未匹配
22
+ * 原始 component 值(可能是字符串或 Vue 组件对象)
23
+ * ```
24
+ */
25
+
26
+ import {
27
+ type Component,
28
+ computed,
29
+ inject,
30
+ mergeProps,
31
+ ref,
32
+ useAttrs,
33
+ } from 'vue';
34
+ import { cloneDeep, omit } from '../../../../shared/core';
35
+ import { useDisabledContext } from '../../../../shared/ui';
36
+ import type { Field } from '../../types';
37
+ import { ContainerFragment, SlotComponent } from '..';
38
+ import { componentMap, TeleportComponentNamePrefix } from '../../constants';
39
+ import { INJECT_COMPONENTS } from '../../../component-provider/constants';
40
+ import { useForm } from '../../hooks/useForm';
41
+ import { getInitProps } from './utils';
42
+
43
+ defineOptions({ name: 'BaseField', inheritAttrs: false });
44
+
45
+ type Props = {
46
+ component?: string | Component;
47
+ path?: string;
48
+ };
49
+ const { component = undefined, path = '' } = defineProps<Props>();
50
+
51
+ // 通过 inject 获取父表单实例(非根模式)
52
+ const form = useForm(false);
53
+ const { getFormData, setFormData } = form;
54
+
55
+ const componentRef = ref<any>();
56
+
57
+ const attrs: any = useAttrs();
58
+
59
+ /** 深拷贝当前值,用于 valueFormatter 的 set 回调中获取旧值 */
60
+ function getOldValue() {
61
+ return cloneDeep(getFormData?.(path));
62
+ }
63
+
64
+ // computed getter/setter 实现 v-model 双向绑定到 formData 的深层路径
65
+ // getter: 从 formData 读取值,支持 valueFormatter.get 格式化
66
+ // setter: 向 formData 写入值,支持 valueFormatter / valueFormatter.set 转换
67
+ const value = computed({
68
+ get() {
69
+ let val = getFormData?.(path);
70
+ const { valueFormatter } = groupedAttrs.value;
71
+ if (
72
+ typeof valueFormatter === 'object' &&
73
+ typeof valueFormatter.get === 'function'
74
+ ) {
75
+ val = valueFormatter.get(val);
76
+ }
77
+ return val;
78
+ },
79
+ set(val) {
80
+ let newVal = val;
81
+ const { valueFormatter } = groupedAttrs.value;
82
+ if (valueFormatter) {
83
+ if (typeof valueFormatter === 'function') {
84
+ newVal = valueFormatter(val, getOldValue());
85
+ } else if (typeof valueFormatter.set === 'function') {
86
+ newVal = valueFormatter.set(val, getOldValue());
87
+ }
88
+ }
89
+ setFormData?.(path, newVal);
90
+ },
91
+ });
92
+
93
+ const parentDisabled = useDisabledContext();
94
+
95
+ /*
96
+ * 将注入的默认 props、外部传入的 attrs、field 配置合并为最终属性
97
+ * 属性分为三类:绑定属性(v-model)、组件属性(传递给组件)、插槽(动态渲染)
98
+ */
99
+ const groupedAttrs = computed(() => {
100
+ const initProps = getInitProps({
101
+ component: component,
102
+ picker: attrs.picker,
103
+ } as Field);
104
+ const modelPropName = attrs.modelProp ?? initProps.modelProp ?? 'value';
105
+ const mergedProps = mergeProps(
106
+ initProps,
107
+ attrs,
108
+ { class: attrs.componentClass, style: attrs.componentStyle },
109
+ { class: initProps.componentClass, style: initProps.componentStyle },
110
+ { disabled: attrs.disabled ?? parentDisabled.value ?? initProps.disabled },
111
+ { modelProp: modelPropName }
112
+ ) as Required<Field>;
113
+ // prettier-ignore
114
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
115
+ const { valueFormatter, modelProp, slots, componentClass, componentStyle, componentContainer, ...rest } = mergedProps
116
+ const modelBindingProp = modelProp ?? 'value';
117
+ // 从剩余属性中移除 v-model 绑定属性,避免重复绑定
118
+ const bindAttrs = omit(rest as Record<string, any>, [
119
+ modelBindingProp,
120
+ `onUpdate:${modelBindingProp}`,
121
+ ]);
122
+ return {
123
+ attrs: bindAttrs,
124
+ slots,
125
+ componentContainer,
126
+ modelProp: modelBindingProp,
127
+ valueFormatter,
128
+ };
129
+ });
130
+
131
+ // 从 ProForm 插槽注入的 teleport 组件(优先级最高)
132
+ const teleportComponent = inject(
133
+ `${TeleportComponentNamePrefix}${path}`,
134
+ undefined
135
+ );
136
+
137
+ // 从 ProComponentProvider 注入的自定义组件映射
138
+ const customComponents = inject(INJECT_COMPONENTS, {});
139
+
140
+ /*
141
+ * 按优先级解析最终要渲染的组件:
142
+ * teleport 插槽 → 自定义组件映射 → 内置组件映射 → 原始 component 值
143
+ */
144
+ const is = computed(() => {
145
+ if (teleportComponent) return teleportComponent;
146
+ if (typeof component === 'string') {
147
+ return (
148
+ (customComponents as any)[component] ||
149
+ (componentMap as any)[component] ||
150
+ component
151
+ );
152
+ }
153
+ return component;
154
+ });
155
+
156
+ defineExpose({
157
+ getComponentRef: () => componentRef.value,
158
+ getComponentComputedProps: () => groupedAttrs.value.attrs as any,
159
+ });
160
+ </script>
161
+
162
+ <template>
163
+ <ContainerFragment :component="groupedAttrs.componentContainer" :path="path">
164
+ <component
165
+ :is="is"
166
+ v-if="is"
167
+ v-bind="groupedAttrs.attrs"
168
+ ref="componentRef"
169
+ v-model:[`${groupedAttrs.modelProp}`]="value"
170
+ :path="path"
171
+ >
172
+ <template
173
+ v-for="(slot, name) in groupedAttrs.slots"
174
+ :key="name"
175
+ #[name]="scoped"
176
+ >
177
+ <SlotComponent :path="path" v-bind="scoped" :component="slot" />
178
+ </template>
179
+ </component>
180
+ </ContainerFragment>
181
+ </template>
@@ -0,0 +1,16 @@
1
+ import { Field } from '../../../types';
2
+ import { getInjectConfig } from '../../../../component-provider/constants';
3
+ import { inject } from 'vue';
4
+
5
+ export const getInitProps = (field: Field): Record<string, any> => {
6
+ const { component } = field as any;
7
+ const picker = component === 'date-picker' ? '' : (field as any).picker;
8
+ if (typeof component === 'string') {
9
+ const k = [component, picker].filter(Boolean).join('.');
10
+ const config = getInjectConfig(k);
11
+ if (!config) return {};
12
+ const injectProps = inject(config.injectionKey, config.default);
13
+ return injectProps;
14
+ }
15
+ return {};
16
+ };
@@ -0,0 +1,158 @@
1
+ <script lang="ts" setup>
2
+ /**
3
+ * @component BaseFormItem
4
+ * @description 表单字段渲染引擎
5
+ *
6
+ * ## 渲染流程
7
+ *
8
+ * 1. 遍历 fields 数组,过滤 hidden 字段
9
+ * 2. 对每个字段:
10
+ * a. 通过 PathProvider 提供当前字段路径
11
+ * b. 通过 GroupedFieldAttrs 将 field 配置拆分为 gridItemProps / formItemProps / componentProps
12
+ * c. 如果字段有 `fields` 子字段 → 递归渲染 BaseFormItem(嵌套表单)
13
+ * d. 否则 → 渲染 BaseField(输入组件)
14
+ * 3. 通过 ref 回调收集 FormItem 和 Component 实例,注入到 field 对象上
15
+ */
16
+
17
+ import { getObject, toPath } from '../../../../shared/core';
18
+ import {
19
+ FormItem,
20
+ Grid as AGrid,
21
+ GridItem as AGridItem,
22
+ GridProps,
23
+ useDisabledContextProvider,
24
+ } from '../../../../shared/ui';
25
+ import { computed, inject, toValue } from 'vue';
26
+ import type { Fields, Grid } from '../../types';
27
+ import { BaseField, SlotComponent, ContainerFragment } from '..';
28
+ import PathProvider from '../PathProvider/index.vue';
29
+ import GroupedFieldAttrs from '../GroupedFieldAttrs/index.vue';
30
+ import { INJECT_CONFIG } from '../../../component-provider/constants';
31
+
32
+ defineOptions({ name: 'BaseFormItem', inheritAttrs: false });
33
+
34
+ type Props = {
35
+ grid?: Grid;
36
+ fields?: Fields;
37
+ disabled?: boolean;
38
+ };
39
+ const {
40
+ grid = undefined,
41
+ fields = [],
42
+ disabled = undefined,
43
+ } = defineProps<Props>();
44
+
45
+ // 过滤掉 hidden 字段,隐藏字段不渲染
46
+ const validFields = computed(() => fields.filter?.(field => !field.hidden));
47
+
48
+ // 向子组件提供 disabled 上下文
49
+ useDisabledContextProvider(computed(() => disabled) as any);
50
+
51
+ const config = INJECT_CONFIG['pro-form'];
52
+
53
+ const { grid: injectGrid } = inject(config.injectionKey, config.default);
54
+
55
+ // 网格布局:优先使用当前层级的 grid 配置,否则使用注入的全局配置
56
+ const enableGrid = computed(() => {
57
+ if (grid !== undefined) return !!grid;
58
+ return !!injectGrid;
59
+ });
60
+
61
+ const computedGridProps = computed<GridProps>(() => {
62
+ return enableGrid.value
63
+ ? { ...getObject(injectGrid), ...getObject(grid) }
64
+ : {};
65
+ });
66
+
67
+ const formItemRefs: any[] = [];
68
+ const componentRefs: any[] = [];
69
+
70
+ // FormItem 挂载回调:将 FormItem 实例和计算属性注入到 field 对象上
71
+ // 外部可通过 field.getFormItemRef() 获取 FormItem 实例
72
+ const onFormItemMounted = (index: number, formItemProps?: any) => {
73
+ const field = validFields.value[index];
74
+ Object.assign(field, {
75
+ getFormItemRef: () => formItemRefs[index],
76
+ getFormItemComputedProps: () => formItemProps,
77
+ });
78
+ };
79
+
80
+ // 组件挂载回调:将输入组件实例注入到 field 对象上
81
+ // 外部可通过 field.getComponentRef() 获取底层输入组件实例
82
+ const onComponentMounted = (index: number) => {
83
+ const field = validFields.value[index];
84
+ Object.assign(field, {
85
+ getComponentRef: () => componentRefs[index]?.getComponentRef(),
86
+ getComponentComputedProps: () =>
87
+ componentRefs[index]?.getComponentComputedProps(),
88
+ });
89
+ };
90
+ </script>
91
+
92
+ <template>
93
+ <ContainerFragment
94
+ :component="enableGrid ? AGrid : undefined"
95
+ v-bind="computedGridProps"
96
+ >
97
+ <PathProvider
98
+ v-for="({ path: _path, name: _name, ...field }, index) of validFields"
99
+ :key="toPath(toValue((_name ?? _path) as any)).join('.') || index"
100
+ v-bind="{ path: (_name ?? _path) as any }"
101
+ >
102
+ <template #default="{ path }">
103
+ <GroupedFieldAttrs :field="field">
104
+ <template
105
+ #default="{
106
+ gridItemProps,
107
+ formItemProps: { container, ...formItemProps },
108
+ componentProps,
109
+ formItemSlots,
110
+ }"
111
+ >
112
+ <ContainerFragment
113
+ :component="enableGrid ? AGridItem : undefined"
114
+ v-bind="gridItemProps"
115
+ >
116
+ <ContainerFragment :component="container" :path="path">
117
+ <FormItem
118
+ v-bind="formItemProps"
119
+ :ref="el => (formItemRefs[index] = el)"
120
+ :name="toPath(path)"
121
+ :path="path"
122
+ @vue:mounted="onFormItemMounted(index, formItemProps)"
123
+ >
124
+ <template
125
+ v-for="(slot, name) in formItemSlots"
126
+ :key="name"
127
+ #[name]="scoped"
128
+ >
129
+ <SlotComponent
130
+ :path="path"
131
+ :component="slot"
132
+ v-bind="scoped"
133
+ />
134
+ </template>
135
+ <template v-if="field.fields">
136
+ <BaseFormItem
137
+ :grid="(field as any).grid ?? grid"
138
+ :fields="field.fields"
139
+ :disabled="toValue(field.disabled)"
140
+ />
141
+ </template>
142
+ <template v-else>
143
+ <BaseField
144
+ :ref="el => (componentRefs[index] = el)"
145
+ v-bind="componentProps"
146
+ :path="path"
147
+ @vue:mounted="onComponentMounted(index)"
148
+ />
149
+ </template>
150
+ </FormItem>
151
+ </ContainerFragment>
152
+ </ContainerFragment>
153
+ </template>
154
+ </GroupedFieldAttrs>
155
+ </template>
156
+ </PathProvider>
157
+ </ContainerFragment>
158
+ </template>
@@ -0,0 +1,24 @@
1
+ <script lang="ts" setup>
2
+ /**
3
+ * @component ContainerFragment
4
+ * @description 容器分片渲染组件。用于动态渲染表单行或表单项的外部包裹容器(例如 Grid 行、Col 列等布局容器)。
5
+ *
6
+ * @public
7
+ */
8
+ import type { ContainerComponent } from '../../types';
9
+
10
+ type Props = {
11
+ component?: ContainerComponent;
12
+ };
13
+
14
+ defineProps<Props>();
15
+
16
+ defineOptions({ name: 'ContainerFragment', inheritAttrs: false });
17
+ </script>
18
+
19
+ <template>
20
+ <component :is="component" v-if="component" v-bind="$attrs">
21
+ <slot />
22
+ </component>
23
+ <slot v-else />
24
+ </template>
@@ -0,0 +1,119 @@
1
+ <script lang="ts" setup>
2
+ /**
3
+ * @component GroupedFieldAttrs
4
+ * @description 字段属性分组器,将 field 配置对象拆分为三类属性
5
+ *
6
+ * ## 属性分发逻辑
7
+ *
8
+ * 单个 field 对象包含多种属性,需要分发到不同的渲染目标:
9
+ *
10
+ * 1. **gridItemProps** — 网格布局属性(span、xs、sm、md、lg、xl、xxl 等),传递给 GridItem
11
+ * 2. **formItemProps** — 表单项属性(label、rules、required 等),传递给 FormItem
12
+ * 3. **componentProps** — 组件属性(placeholder、allowClear 等),传递给输入组件
13
+ * 4. **formItemSlots** — FormItem 的具名插槽(label、help、extra 等)
14
+ *
15
+ * 分组依据:
16
+ * - 匹配 antdv-next GridItem 的 props key → gridItemProps
17
+ * - 匹配 antdv-next FormItem 的 props key → formItemProps
18
+ * - 其余所有属性 → componentProps
19
+ * - 属于 FORM_ITEM_SLOT_KEYS 的插槽 → formItemSlots
20
+ * - 其余插槽 → componentProps.slots
21
+ */
22
+
23
+ import { computed, inject, mergeProps, toValue } from 'vue';
24
+ import {
25
+ GridItemProps,
26
+ FormItemProps,
27
+ gridItemProps,
28
+ formItemProps,
29
+ } from '../../../../shared/ui';
30
+ import { INJECT_CONFIG } from '../../../component-provider/constants';
31
+ import type { Base, Field } from '../../types';
32
+ import { FORM_ITEM_SLOT_KEYS } from '../../constants';
33
+ import { isPlainObject } from '../../../../shared/core';
34
+
35
+ const formItemPropKeys = Object.keys(formItemProps());
36
+ const gridItemPropKeys = Object.keys(gridItemProps());
37
+
38
+ type Props = {
39
+ field: Field;
40
+ };
41
+ const props = defineProps<Props>();
42
+
43
+ const config = INJECT_CONFIG['pro-form-item'];
44
+ const injectFormItemProps = inject(config.injectionKey, config.default);
45
+
46
+ type GroupedFieldAttrs = {
47
+ gridItemProps: GridItemProps;
48
+ formItemProps: FormItemProps & { container?: Base['formItemContainer'] };
49
+ formItemSlots: Record<(typeof FORM_ITEM_SLOT_KEYS)[number], any>;
50
+ componentProps: Record<string, any>;
51
+ };
52
+
53
+ // 将 field 配置按 key 分发到三类属性分组中
54
+ const groupedAttributes = computed<GroupedFieldAttrs>(() => {
55
+ let gridItemProps: Record<string, any> = {};
56
+ let formItemProps: Record<string, any> = {};
57
+ const componentProps: Record<string, any> = { slots: {} };
58
+ const formItemSlots: Record<string, any> = {};
59
+
60
+ if (isPlainObject(props.field)) {
61
+ // prettier-ignore
62
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
63
+ const { path, name, fields, formItemClass, formItemStyle, formItemContainer, hidden, span, getFormItemRef, getComponentRef, getFormItemComputedProps, getComponentComputedProps, slots = {}, formItemDataAttrs = {}, componentDataAttrs = {}, extraProps, ...rest } =
64
+ props.field as any;
65
+ const {
66
+ class: injectClassName,
67
+ style: injectStyle,
68
+ span: injectSpan,
69
+ formItemContainer: injectFormItemContainer,
70
+ xs,
71
+ sm,
72
+ md,
73
+ lg,
74
+ xl,
75
+ xxl,
76
+ ...injectRest
77
+ } = injectFormItemProps;
78
+
79
+ const initGridItemProps =
80
+ span || span === 0
81
+ ? { span }
82
+ : { xs, sm, md, lg, xl, xxl, span: injectSpan };
83
+
84
+ gridItemProps = fields ? { span: span ?? 24 } : initGridItemProps;
85
+ formItemProps = mergeProps(
86
+ injectRest as any,
87
+ { class: injectClassName, style: injectStyle },
88
+ { class: toValue(formItemClass), style: toValue(formItemStyle) },
89
+ formItemDataAttrs
90
+ );
91
+ formItemProps.container = formItemContainer ?? injectFormItemContainer;
92
+
93
+ Object.keys(rest).forEach(k => {
94
+ if (gridItemPropKeys.includes(k)) {
95
+ gridItemProps[k] = rest[k];
96
+ } else if (formItemPropKeys.includes(k)) {
97
+ (formItemProps as any)[k] = rest[k];
98
+ } else {
99
+ componentProps[k] = rest[k];
100
+ }
101
+ });
102
+ // 将 componentDataAttrs 展开到组件 props 中
103
+ Object.assign(componentProps, componentDataAttrs);
104
+ Object.keys(slots).forEach(k => {
105
+ if (FORM_ITEM_SLOT_KEYS.includes(k as any)) {
106
+ formItemSlots[k] = slots[k];
107
+ } else {
108
+ componentProps['slots'][k] = slots[k];
109
+ }
110
+ });
111
+ }
112
+
113
+ return { gridItemProps, formItemProps, componentProps, formItemSlots };
114
+ });
115
+ </script>
116
+
117
+ <template>
118
+ <slot v-bind="groupedAttributes"></slot>
119
+ </template>
@@ -0,0 +1,19 @@
1
+ <script lang="ts" setup>
2
+ import { computed, provide } from 'vue';
3
+ import { InjectionPathKey } from '../../constants';
4
+ import { NamePath } from '../../../../shared/ui';
5
+
6
+ const props = defineProps<{ path?: NamePath }>();
7
+
8
+ const namePath = computed(() => {
9
+ return Array.isArray(props.path)
10
+ ? props.path.join('.')
11
+ : (props.path as string | undefined);
12
+ });
13
+
14
+ provide(InjectionPathKey, namePath);
15
+ </script>
16
+
17
+ <template>
18
+ <slot :path="namePath" />
19
+ </template>
@@ -0,0 +1,104 @@
1
+ <script lang="ts" setup generic="F extends Form<any> = Form">
2
+ /**
3
+ * @component ProForm
4
+ * @description @qin-ui/antdv-next-pro 配置驱动表单组件
5
+ *
6
+ * 架构设计说明 (Architecture Overview)
7
+ *
8
+ * [ 数据层 (Core) ] => [ 绑定层 (ProForm) ] => [ 渲染层 (BaseFormItem / BaseField) ]
9
+ *
10
+ * 1. 数据隔离:ProForm 本身不负责存储和管理表单状态,所有核心状态(formData, fields, 校验规则)
11
+ * 均交由底层的 `useForm`(@qin-ui/pro-components-core)驱动。
12
+ * 2. 上下文透传:通过 `provide` 将核心状态下发给子组件,避免了深层嵌套的 Props 传递。
13
+ * 3. 递归渲染:网格布局和具体字段的解析交由 `<BaseFormItem>` 递归完成,实现了 UI 布局与表单逻辑的解耦。
14
+ *
15
+ * 通过配置驱动的方式快速构建表单,支持:
16
+ * - 字段联动(通过 setField、watch 等实现)
17
+ * - 嵌套字段(通过 fields 递归配置)
18
+ * - 自定义组件(通过 component 属性和 custom 类型)
19
+ * - 网格布局(通过 grid 属性)
20
+ * - 动态插槽(以字段 path 命名的插槽)
21
+ *
22
+ * @template F - 表单实例类型
23
+ * @param {Form<D>} [form] - useForm 返回的表单实例
24
+ * @param {boolean | GridProps} [grid=false] - 是否启用网格布局
25
+ *
26
+ * @slot default - 默认插槽
27
+ * @slot [path] - 以字段 path 命名的动态插槽,用于自定义字段渲染组件
28
+ *
29
+ * @public
30
+ */
31
+ import { Form as AForm, FormProps as AFormProps } from '../../../../shared/ui';
32
+ import {
33
+ inject,
34
+ mergeProps,
35
+ provide,
36
+ type Slot,
37
+ watchEffect,
38
+ computed,
39
+ } from 'vue';
40
+ import { INJECT_CONFIG } from '../../../component-provider/constants';
41
+ import { BaseFormItem } from '..';
42
+ import { InjectionFormKey, TeleportComponentNamePrefix } from '../../constants';
43
+ import type { Grid, VModelProps, PathProps } from '../../types';
44
+ import { Path, camelizeProperties } from '../../../../shared/core';
45
+ import type { Form } from '../../hooks/useForm';
46
+
47
+ defineOptions({ name: 'ProForm', inheritAttrs: false });
48
+
49
+ type FormProps = Partial<Omit<AFormProps, 'model'>>;
50
+
51
+ type Props = { grid?: Grid; form?: F } & /* @vue-ignore */ FormProps;
52
+ const { grid = false, form = {} as F } = defineProps<Props>();
53
+
54
+ /**
55
+ * 依赖注入中心:
56
+ * 将 Core 包生成的 Form 实例注入到 Vue 的 Context 中。
57
+ * 供深层子组件(如 BaseFormItem, BaseField, 自定义插槽)跨层级直接访问数据和方法。
58
+ */
59
+ provide(InjectionFormKey, form as F);
60
+
61
+ const { formData, fields, setFormRef } = form as F;
62
+ const _fields = computed(() => fields.value);
63
+
64
+ const config = INJECT_CONFIG['pro-form'];
65
+
66
+ // 从 ProComponentProvider 获取全局配置,与传入的 props 合并
67
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
68
+ const { grid: _injectGrid, ...injectAttrs } = inject(
69
+ config.injectionKey,
70
+ config.default
71
+ );
72
+
73
+ type ExtractPath<T> = T extends Form<infer D> ? Path<D> : string;
74
+ type FieldSlotProps = VModelProps &
75
+ PathProps & { disabled?: boolean; [x: string]: any };
76
+ type FieldSlots = Record<ExtractPath<F>, Slot<FieldSlotProps>>;
77
+
78
+ const slots = defineSlots<Partial<FieldSlots & { default: Slot }>>();
79
+
80
+ /**
81
+ * 动态插槽映射中心 (Slot Teleporting):
82
+ * 目的:将 ProForm 上以 Field Path 命名的插槽,动态注册为全局可访问的 Context。
83
+ * 实现:BaseField 组件在渲染对应字段时,会通过 inject 尝试获取对应的 Prefix+Path,
84
+ * 如果存在,则将插槽内容渲染到深层的具体位置,从而突破了组件嵌套层级的限制。
85
+ */
86
+ watchEffect(() => {
87
+ Object.keys(slots).forEach(name => {
88
+ if (name === 'default') return;
89
+ provide(`${TeleportComponentNamePrefix}${name}`, (slots as any)[name]);
90
+ });
91
+ });
92
+ </script>
93
+
94
+ <template>
95
+ <AForm
96
+ :ref="(el: any) => setFormRef?.(el)"
97
+ :model="formData"
98
+ v-bind="mergeProps(injectAttrs, camelizeProperties($attrs))"
99
+ class="pro-form"
100
+ >
101
+ <BaseFormItem :fields="_fields" :grid="grid" />
102
+ <slot />
103
+ </AForm>
104
+ </template>
@@ -0,0 +1,26 @@
1
+ <script lang="ts" setup>
2
+ /**
3
+ * @component SlotComponent
4
+ * @description 插槽渲染辅助组件。用于在表单或表格的自定义插槽中动态渲染外部传入的 VNode、渲染函数或静态字符串。
5
+ *
6
+ * @public
7
+ */
8
+ import { isVNode } from 'vue';
9
+ import { SlotComponentType } from '../../types';
10
+
11
+ defineOptions({ name: 'SlotComponent', inheritAttrs: false });
12
+
13
+ type Props = {
14
+ component?: SlotComponentType;
15
+ };
16
+ defineProps<Props>();
17
+ </script>
18
+
19
+ <template>
20
+ <component
21
+ :is="component"
22
+ v-if="isVNode(component) || typeof component === 'function'"
23
+ v-bind="$attrs"
24
+ />
25
+ <template v-else>{{ component }}</template>
26
+ </template>
@@ -0,0 +1,15 @@
1
+ import { ComponentProps, ComponentExposed } from 'vue-component-type-helpers';
2
+ import ProForm from './ProForm/index.vue';
3
+ import BaseFormItem from './BaseFormItem/index.vue';
4
+
5
+ export { default as BaseField } from './BaseField/index.vue';
6
+ export { default as ContainerFragment } from './ContainerFragment/index.vue';
7
+ export { default as SlotComponent } from './SlotComponent/index.vue';
8
+ export { ProForm, BaseFormItem };
9
+
10
+ // instance
11
+ export type ProFormInstance = ComponentExposed<typeof ProForm>;
12
+ export type ProFormProps = ComponentProps<typeof ProForm>;
13
+
14
+ export type ProFormItemInstance = ComponentExposed<typeof BaseFormItem>;
15
+ export type ProFormItemProps = ComponentProps<typeof BaseFormItem>;