@fishbelly/form-morph-arco 0.1.0 → 0.1.2
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.
- package/README.md +224 -211
- package/dist/__tests__/formRendererValidation.test.d.ts +1 -0
- package/dist/__tests__/labelWidth.test.d.ts +1 -0
- package/dist/__tests__/optionDisabled.test.d.ts +1 -0
- package/dist/__tests__/treeValue.test.d.ts +1 -0
- package/dist/fields/treeValue.d.ts +8 -0
- package/dist/index.js +580 -524
- package/dist/index.js.map +1 -1
- package/dist/style.css +1 -1
- package/package.json +53 -53
package/README.md
CHANGED
|
@@ -1,212 +1,225 @@
|
|
|
1
|
-
# @fishbelly/form-morph-arco
|
|
2
|
-
|
|
3
|
-
[form-morph](https://www.npmjs.com/package/@fishbelly/form-morph) 的官方 Arco Design 字段包,提供 22 种字段、展示组件与布局容器,并实现 Arco 风格的表单外壳与字段校验视觉。
|
|
4
|
-
|
|
5
|
-
引擎本身不依赖 UI 组件库;安装本包即可获得开箱可用的 Arco Design 表单组件。
|
|
6
|
-
|
|
7
|
-
- 完整 API 文档:[docs/API.md](https://gitee.com/fishbelly/form-morph/blob/master/docs/API.md)
|
|
8
|
-
- 主包:[@fishbelly/form-morph](https://www.npmjs.com/package/@fishbelly/form-morph)
|
|
9
|
-
|
|
10
|
-
## 安装
|
|
11
|
-
|
|
12
|
-
```bash
|
|
13
|
-
# npm
|
|
14
|
-
npm install @fishbelly/form-morph @fishbelly/form-morph-arco @arco-design/web-vue
|
|
15
|
-
|
|
16
|
-
# yarn
|
|
17
|
-
yarn add @fishbelly/form-morph @fishbelly/form-morph-arco @arco-design/web-vue
|
|
18
|
-
|
|
19
|
-
# pnpm
|
|
20
|
-
pnpm add @fishbelly/form-morph @fishbelly/form-morph-arco @arco-design/web-vue
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
## 快速开始
|
|
24
|
-
|
|
25
|
-
```ts
|
|
26
|
-
// main.ts
|
|
27
|
-
import { createApp } from 'vue';
|
|
28
|
-
import ArcoVue from '@arco-design/web-vue';
|
|
29
|
-
import { createFormMorph } from '@fishbelly/form-morph';
|
|
30
|
-
import { createArcoPack } from '@fishbelly/form-morph-arco';
|
|
31
|
-
import '@arco-design/web-vue/dist/arco.css';
|
|
32
|
-
import '@fishbelly/form-morph/style.css';
|
|
33
|
-
import '@fishbelly/form-morph-arco/style.css';
|
|
34
|
-
import App from './App.vue';
|
|
35
|
-
|
|
36
|
-
const morph = createFormMorph({
|
|
37
|
-
plugins: [createArcoPack()]
|
|
38
|
-
});
|
|
39
|
-
|
|
40
|
-
createApp(App).use(ArcoVue).use(morph).mount('#app');
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
```vue
|
|
44
|
-
<script setup lang="ts">
|
|
45
|
-
import { ref } from 'vue';
|
|
46
|
-
import { FormRenderer, type FormSchema } from '@fishbelly/form-morph';
|
|
47
|
-
|
|
48
|
-
const schema: FormSchema = {
|
|
49
|
-
id: 'arco-demo',
|
|
50
|
-
layout: { mode: 'horizontal', labelWidth: 96, gutter: 16 },
|
|
51
|
-
nodes: [
|
|
52
|
-
{ id: 'n1', type: 'input', name: 'name', label: '姓名', validate: { required: true } },
|
|
53
|
-
{
|
|
54
|
-
id: 'n2',
|
|
55
|
-
type: 'select',
|
|
56
|
-
name: 'level',
|
|
57
|
-
label: '等级',
|
|
58
|
-
data: {
|
|
59
|
-
source: {
|
|
60
|
-
kind: 'static',
|
|
61
|
-
options: [
|
|
62
|
-
{ label: '高', value: 'high' },
|
|
63
|
-
{ label: '中', value: 'medium' },
|
|
64
|
-
{ label: '低', value: 'low' }
|
|
65
|
-
]
|
|
66
|
-
}
|
|
67
|
-
}
|
|
68
|
-
},
|
|
69
|
-
{ id: 'n3', type: 'switch', name: 'enabled', label: '启用' }
|
|
70
|
-
]
|
|
71
|
-
};
|
|
72
|
-
|
|
73
|
-
const values = ref<Record<string, unknown>>({});
|
|
74
|
-
</script>
|
|
75
|
-
|
|
76
|
-
<template>
|
|
77
|
-
<FormRenderer :schema="schema" v-model="values" show-actions />
|
|
78
|
-
</template>
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
也可以直接使用全局默认实例:
|
|
82
|
-
|
|
83
|
-
```ts
|
|
84
|
-
import { arcoPack } from '@fishbelly/form-morph-arco';
|
|
85
|
-
|
|
86
|
-
const morph = createFormMorph({ plugins: [arcoPack] });
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
## 字段清单
|
|
90
|
-
|
|
91
|
-
### 基础字段
|
|
92
|
-
|
|
93
|
-
| type | 名称 | valueType | 别名 | 常用属性 |
|
|
94
|
-
| --- | --- | --- | --- | --- |
|
|
95
|
-
| `input` | 单行文本 | `string` | `text`、`text-input`、`string` | `placeholder`、`allowClear`、`maxLength` |
|
|
96
|
-
| `textarea` | 多行文本 | `string` | `text-area` | `rows`、`autoSize`、`showWordLimit`、`maxLength` |
|
|
97
|
-
| `password` | 密码输入 | `string` | — | `placeholder`、`allowClear` |
|
|
98
|
-
| `number` | 数字输入 | `number` | `input-number`、`inputnumber` | `min`、`max`、`step`、`precision` |
|
|
99
|
-
|
|
100
|
-
### 选择字段
|
|
101
|
-
|
|
102
|
-
| type | 名称 | valueType | 别名 | 常用属性 |
|
|
103
|
-
| --- | --- | --- | --- | --- |
|
|
104
|
-
| `select` | 下拉选择 | `string` | `dropdown` | `placeholder`、`allowSearch`、`allowClear` |
|
|
105
|
-
| `multi-select` | 多选下拉 | `string[]` | `multiselect`、`multiple-select`、`multi` | 同上、`maxTagCount` |
|
|
106
|
-
| `radio` | 单选框 | `string` | — | `direction`(`horizontal` / `vertical`) |
|
|
107
|
-
| `checkbox` | 复选框 | `string[]` | — | `direction` |
|
|
108
|
-
| `switch` | 开关 | `boolean` | — | `checkedText`、`uncheckedText` |
|
|
109
|
-
| `slider` | 滑动条 | `number` | — | `min`、`max`、`step`、`showInput` |
|
|
110
|
-
| `rate` | 评分 | `number` | — | `count`、`allowHalf` |
|
|
111
|
-
|
|
112
|
-
### 日期时间
|
|
113
|
-
|
|
114
|
-
| type | 名称 | valueType | 别名 | 常用属性 |
|
|
115
|
-
| --- | --- | --- | --- | --- |
|
|
116
|
-
| `date` | 日期 | `timestamp` | `datepicker`、`date-picker` | `showTime`、`format`、`allowClear` |
|
|
117
|
-
| `date-range` | 日期范围 | `timestamp[]` | `daterange`、`date-picker-range`、`rangepicker` | `showTime`、`format`、`allowClear` |
|
|
118
|
-
| `time` | 时间 | `string` | `timepicker`、`time-picker` | `format`、`allowClear` |
|
|
119
|
-
|
|
120
|
-
> `date` / `date-range` 的值类型为时间戳(number),绑定到业务字段时如需字符串请在提交前通过值适配器转换。
|
|
121
|
-
|
|
122
|
-
### 高级字段
|
|
123
|
-
|
|
124
|
-
| type | 名称 | valueType | 别名 | 常用属性 |
|
|
125
|
-
| --- | --- | --- | --- | --- |
|
|
126
|
-
| `upload` | 文件上传 | `file[]` | `file`、`file-upload` | `accept`、`action`、`autoUpload`、`limit`、`multiple`、`showFileList` |
|
|
127
|
-
| `cascader` | 级联选择 | `string[]` | — | `placeholder`、`allowSearch`、`changeOnSelect` |
|
|
128
|
-
| `tree-select` | 树选择 | `string` | `treeselect` | `placeholder`、`allowSearch`、`allowClear` |
|
|
129
|
-
| `color` | 颜色选择 | `string` | — | `disabledAlpha` |
|
|
130
|
-
|
|
131
|
-
### 展示与容器
|
|
132
|
-
|
|
133
|
-
| type | 名称 | kind | 别名 | 常用属性 |
|
|
134
|
-
| --- | --- | --- | --- | --- |
|
|
135
|
-
| `static-text` | 静态文本 | display | `static`、`statictext` | `content`、`type` |
|
|
136
|
-
| `card` | 卡片容器 | container | — | `bordered` |
|
|
137
|
-
| `section` | 分组区块 | container | — | `icon`、`plain` |
|
|
138
|
-
| `divider` | 分割线 | display | `line` | `orientation`、`dividerType` |
|
|
139
|
-
|
|
140
|
-
容器节点通过 `children` 嵌套子节点,渲染时使用默认插槽承载子网格。
|
|
141
|
-
|
|
142
|
-
## 上传字段
|
|
143
|
-
|
|
144
|
-
- 使用 Arco 默认上传按钮,同时支持将文件拖拽到整个字段区域;拖拽与点击共享 `accept`、`multiple`、`limit`
|
|
145
|
-
-
|
|
146
|
-
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
}
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
-
|
|
182
|
-
-
|
|
183
|
-
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
##
|
|
211
|
-
|
|
1
|
+
# @fishbelly/form-morph-arco
|
|
2
|
+
|
|
3
|
+
[form-morph](https://www.npmjs.com/package/@fishbelly/form-morph) 的官方 Arco Design 字段包,提供 22 种字段、展示组件与布局容器,并实现 Arco 风格的表单外壳与字段校验视觉。
|
|
4
|
+
|
|
5
|
+
引擎本身不依赖 UI 组件库;安装本包即可获得开箱可用的 Arco Design 表单组件。
|
|
6
|
+
|
|
7
|
+
- 完整 API 文档:[docs/API.md](https://gitee.com/fishbelly/form-morph/blob/master/docs/API.md)
|
|
8
|
+
- 主包:[@fishbelly/form-morph](https://www.npmjs.com/package/@fishbelly/form-morph)
|
|
9
|
+
|
|
10
|
+
## 安装
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
# npm
|
|
14
|
+
npm install @fishbelly/form-morph @fishbelly/form-morph-arco @arco-design/web-vue
|
|
15
|
+
|
|
16
|
+
# yarn
|
|
17
|
+
yarn add @fishbelly/form-morph @fishbelly/form-morph-arco @arco-design/web-vue
|
|
18
|
+
|
|
19
|
+
# pnpm
|
|
20
|
+
pnpm add @fishbelly/form-morph @fishbelly/form-morph-arco @arco-design/web-vue
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## 快速开始
|
|
24
|
+
|
|
25
|
+
```ts
|
|
26
|
+
// main.ts
|
|
27
|
+
import { createApp } from 'vue';
|
|
28
|
+
import ArcoVue from '@arco-design/web-vue';
|
|
29
|
+
import { createFormMorph } from '@fishbelly/form-morph';
|
|
30
|
+
import { createArcoPack } from '@fishbelly/form-morph-arco';
|
|
31
|
+
import '@arco-design/web-vue/dist/arco.css';
|
|
32
|
+
import '@fishbelly/form-morph/style.css';
|
|
33
|
+
import '@fishbelly/form-morph-arco/style.css';
|
|
34
|
+
import App from './App.vue';
|
|
35
|
+
|
|
36
|
+
const morph = createFormMorph({
|
|
37
|
+
plugins: [createArcoPack()]
|
|
38
|
+
});
|
|
39
|
+
|
|
40
|
+
createApp(App).use(ArcoVue).use(morph).mount('#app');
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
```vue
|
|
44
|
+
<script setup lang="ts">
|
|
45
|
+
import { ref } from 'vue';
|
|
46
|
+
import { FormRenderer, type FormSchema } from '@fishbelly/form-morph';
|
|
47
|
+
|
|
48
|
+
const schema: FormSchema = {
|
|
49
|
+
id: 'arco-demo',
|
|
50
|
+
layout: { mode: 'horizontal', labelWidth: 96, gutter: 16 },
|
|
51
|
+
nodes: [
|
|
52
|
+
{ id: 'n1', type: 'input', name: 'name', label: '姓名', validate: { required: true } },
|
|
53
|
+
{
|
|
54
|
+
id: 'n2',
|
|
55
|
+
type: 'select',
|
|
56
|
+
name: 'level',
|
|
57
|
+
label: '等级',
|
|
58
|
+
data: {
|
|
59
|
+
source: {
|
|
60
|
+
kind: 'static',
|
|
61
|
+
options: [
|
|
62
|
+
{ label: '高', value: 'high' },
|
|
63
|
+
{ label: '中', value: 'medium' },
|
|
64
|
+
{ label: '低', value: 'low' }
|
|
65
|
+
]
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
},
|
|
69
|
+
{ id: 'n3', type: 'switch', name: 'enabled', label: '启用' }
|
|
70
|
+
]
|
|
71
|
+
};
|
|
72
|
+
|
|
73
|
+
const values = ref<Record<string, unknown>>({});
|
|
74
|
+
</script>
|
|
75
|
+
|
|
76
|
+
<template>
|
|
77
|
+
<FormRenderer :schema="schema" v-model="values" show-actions />
|
|
78
|
+
</template>
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
也可以直接使用全局默认实例:
|
|
82
|
+
|
|
83
|
+
```ts
|
|
84
|
+
import { arcoPack } from '@fishbelly/form-morph-arco';
|
|
85
|
+
|
|
86
|
+
const morph = createFormMorph({ plugins: [arcoPack] });
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## 字段清单
|
|
90
|
+
|
|
91
|
+
### 基础字段
|
|
92
|
+
|
|
93
|
+
| type | 名称 | valueType | 别名 | 常用属性 |
|
|
94
|
+
| --- | --- | --- | --- | --- |
|
|
95
|
+
| `input` | 单行文本 | `string` | `text`、`text-input`、`string` | `placeholder`、`allowClear`、`maxLength` |
|
|
96
|
+
| `textarea` | 多行文本 | `string` | `text-area` | `rows`、`autoSize`、`showWordLimit`、`maxLength` |
|
|
97
|
+
| `password` | 密码输入 | `string` | — | `placeholder`、`allowClear` |
|
|
98
|
+
| `number` | 数字输入 | `number` | `input-number`、`inputnumber` | `min`、`max`、`step`、`precision` |
|
|
99
|
+
|
|
100
|
+
### 选择字段
|
|
101
|
+
|
|
102
|
+
| type | 名称 | valueType | 别名 | 常用属性 |
|
|
103
|
+
| --- | --- | --- | --- | --- |
|
|
104
|
+
| `select` | 下拉选择 | `string` | `dropdown` | `placeholder`、`allowSearch`、`allowClear` |
|
|
105
|
+
| `multi-select` | 多选下拉 | `string[]` | `multiselect`、`multiple-select`、`multi` | 同上、`maxTagCount` |
|
|
106
|
+
| `radio` | 单选框 | `string` | — | `direction`(`horizontal` / `vertical`) |
|
|
107
|
+
| `checkbox` | 复选框 | `string[]` | — | `direction` |
|
|
108
|
+
| `switch` | 开关 | `boolean` | — | `checkedText`、`uncheckedText` |
|
|
109
|
+
| `slider` | 滑动条 | `number` | — | `min`、`max`、`step`、`showInput` |
|
|
110
|
+
| `rate` | 评分 | `number` | — | `count`、`allowHalf` |
|
|
111
|
+
|
|
112
|
+
### 日期时间
|
|
113
|
+
|
|
114
|
+
| type | 名称 | valueType | 别名 | 常用属性 |
|
|
115
|
+
| --- | --- | --- | --- | --- |
|
|
116
|
+
| `date` | 日期 | `timestamp` | `datepicker`、`date-picker` | `showTime`、`format`、`allowClear` |
|
|
117
|
+
| `date-range` | 日期范围 | `timestamp[]` | `daterange`、`date-picker-range`、`rangepicker` | `showTime`、`format`、`allowClear` |
|
|
118
|
+
| `time` | 时间 | `string` | `timepicker`、`time-picker` | `format`、`allowClear` |
|
|
119
|
+
|
|
120
|
+
> `date` / `date-range` 的值类型为时间戳(number),绑定到业务字段时如需字符串请在提交前通过值适配器转换。
|
|
121
|
+
|
|
122
|
+
### 高级字段
|
|
123
|
+
|
|
124
|
+
| type | 名称 | valueType | 别名 | 常用属性 |
|
|
125
|
+
| --- | --- | --- | --- | --- |
|
|
126
|
+
| `upload` | 文件上传 | `file[]` | `file`、`file-upload` | `accept`、`maxSize`、`action`、`autoUpload`、`limit`、`multiple`、`showFileList` |
|
|
127
|
+
| `cascader` | 级联选择 | `string[]` | — | `placeholder`、`allowSearch`、`changeOnSelect` |
|
|
128
|
+
| `tree-select` | 树选择 | `string` | `treeselect` | `placeholder`、`allowSearch`、`allowClear` |
|
|
129
|
+
| `color` | 颜色选择 | `string` | — | `disabledAlpha` |
|
|
130
|
+
|
|
131
|
+
### 展示与容器
|
|
132
|
+
|
|
133
|
+
| type | 名称 | kind | 别名 | 常用属性 |
|
|
134
|
+
| --- | --- | --- | --- | --- |
|
|
135
|
+
| `static-text` | 静态文本 | display | `static`、`statictext` | `content`、`type` |
|
|
136
|
+
| `card` | 卡片容器 | container | — | `bordered` |
|
|
137
|
+
| `section` | 分组区块 | container | — | `icon`、`plain` |
|
|
138
|
+
| `divider` | 分割线 | display | `line` | `orientation`、`dividerType` |
|
|
139
|
+
|
|
140
|
+
容器节点通过 `children` 嵌套子节点,渲染时使用默认插槽承载子网格。
|
|
141
|
+
|
|
142
|
+
## 上传字段
|
|
143
|
+
|
|
144
|
+
- 使用 Arco 默认上传按钮,同时支持将文件拖拽到整个字段区域;拖拽与点击共享 `accept`、`multiple`、`limit` 规则;超限/不支持的类型会在按钮下方提示。
|
|
145
|
+
- 提交时引擎按 `accept` 与 `maxSize`(MB)做 Schema 级校验;远程文件缺少本地元信息时跳过。`disabled` / `readonly` 渲染为静态链接或数量摘要。
|
|
146
|
+
- 默认 `autoUpload: false`,文件对象暂存在表单值中,由宿主在提交时统一上传(推荐)。
|
|
147
|
+
- 需要自定义上传链路时,注册值适配器在 `serialize` 阶段上传并返回业务所需的值(如文件 ID 数组):
|
|
148
|
+
|
|
149
|
+
```ts
|
|
150
|
+
import { defineValueAdapter, definePlugin } from '@fishbelly/form-morph';
|
|
151
|
+
|
|
152
|
+
export const uploadAdapterPlugin = definePlugin({
|
|
153
|
+
name: 'my-upload-adapter',
|
|
154
|
+
version: '1.0.0',
|
|
155
|
+
contributes: {
|
|
156
|
+
valueAdapters: [
|
|
157
|
+
defineValueAdapter({
|
|
158
|
+
name: 'upload-codec',
|
|
159
|
+
appliesTo: ['upload'],
|
|
160
|
+
serialize: async (value) => {
|
|
161
|
+
if (!Array.isArray(value)) return value;
|
|
162
|
+
const uploaded = await Promise.all(
|
|
163
|
+
value.map((item) => (item instanceof File ? myUpload(item) : item))
|
|
164
|
+
);
|
|
165
|
+
return uploaded.map((item) => item.id);
|
|
166
|
+
},
|
|
167
|
+
deserialize: async (value) => (Array.isArray(value) ? value : [])
|
|
168
|
+
})
|
|
169
|
+
]
|
|
170
|
+
}
|
|
171
|
+
});
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
宿主如需资源地址前缀,可通过 `createFormMorph({ resolveAssetUrl })` 统一解析回显链接。
|
|
175
|
+
|
|
176
|
+
## 选项过滤与禁用
|
|
177
|
+
|
|
178
|
+
`select`、`multi-select`、`radio`、`checkbox`、`cascader`、`tree-select` 支持 Schema v3 的选项效果(`kind: 'options'`):
|
|
179
|
+
|
|
180
|
+
- `mode: 'filter'`:按关联值过滤选项;来源字段为空时结果为空列表;默认 `clear: true` 会清空失效值。
|
|
181
|
+
- `mode: 'disable'`:选项仍展示但不可选,只把匹配项的 `disabled` 置为 `true`,不会恢复静态已禁用项;`scope: 'unmatching'` 可改为禁用不匹配项。
|
|
182
|
+
- 静态选项在设计器「数据」页「关联值」列维护 `parent`;过滤/禁用效果默认按 `parent` 匹配,动态数据源也支持 `parentId`、`code`、`group` 或自定义键。
|
|
183
|
+
- 控件直接消费运行时选项的 `disabled` 字段:Select 下拉、Cascader 级联、Radio/Checkbox 标签均按 Arco 原生禁用样式渲染;TreeSelect 通过 `buildTreeData` 保留 `disabled`。
|
|
184
|
+
- `legacy-*` 宿主字段由内部控件解析数据源并忽略运行时选项,因此不使用选项效果;状态、赋值、属性与清空校验效果不受影响。
|
|
185
|
+
|
|
186
|
+
> 0.1.2 起行为联动为 Schema v3,不兼容 v2:旧 `actions` / `elseActions` 规则不会执行,需重新配置。
|
|
187
|
+
|
|
188
|
+
## 设计器属性面板
|
|
189
|
+
|
|
190
|
+
每个字段定义内置 `inspector` 配置,设计器会自动渲染对应属性控件(文本、数字、开关、下拉、文本域)。字段 API(别名、默认布局、默认属性、可配置项)可在设计器「API 文档 → 组件 API」中直接查看。
|
|
191
|
+
|
|
192
|
+
## 扩展与覆写
|
|
193
|
+
|
|
194
|
+
- 通过 `createArcoPack({ name })` 可自定义插件名,用于多实例或按名传配置。
|
|
195
|
+
- 需要覆写已有字段时,在 `createFormMorph({ allowOverrideTypes: ['input'] })` 中显式声明允许覆盖的类型,再通过 `morph.registry.resolveField('input')` 等 API 处理。
|
|
196
|
+
- 自定义字段仍使用 `defineFieldType` 注册,可参考本包源码中的字段实现。
|
|
197
|
+
|
|
198
|
+
```ts
|
|
199
|
+
import { createFormMorph } from '@fishbelly/form-morph';
|
|
200
|
+
import { createArcoPack, arcoFieldTypes } from '@fishbelly/form-morph-arco';
|
|
201
|
+
|
|
202
|
+
const morph = createFormMorph({
|
|
203
|
+
plugins: [createArcoPack()],
|
|
204
|
+
allowOverrideTypes: ['input']
|
|
205
|
+
});
|
|
206
|
+
|
|
207
|
+
console.log(morph.registry.listFields());
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
## 兼容性
|
|
211
|
+
|
|
212
|
+
- Vue `^3.4.0`
|
|
213
|
+
- `@arco-design/web-vue` `^2.50.0`
|
|
214
|
+
- `@fishbelly/form-morph` `^0.1.2`
|
|
215
|
+
- 需同时引入 Arco 样式、`@fishbelly/form-morph/style.css` 与本包 `style.css`
|
|
216
|
+
|
|
217
|
+
## 文档
|
|
218
|
+
|
|
219
|
+
- [完整 API 文档](https://gitee.com/fishbelly/form-morph/blob/master/docs/API.md)
|
|
220
|
+
- [主包 @fishbelly/form-morph](https://www.npmjs.com/package/@fishbelly/form-morph)
|
|
221
|
+
- [示例与演示](https://gitee.com/fishbelly/form-morph/tree/master/examples/playground)
|
|
222
|
+
|
|
223
|
+
## License
|
|
224
|
+
|
|
212
225
|
[MIT](https://gitee.com/fishbelly/form-morph/blob/master/LICENSE)
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { DataSourceOption } from '../../../form-morph/src/index.ts';
|
|
2
|
+
export interface ArcoTreeNode {
|
|
3
|
+
key: string | number;
|
|
4
|
+
title: string;
|
|
5
|
+
disabled?: boolean;
|
|
6
|
+
children?: ArcoTreeNode[];
|
|
7
|
+
}
|
|
8
|
+
export declare function buildTreeData(options?: DataSourceOption[]): ArcoTreeNode[];
|