1 | ---
|
2 | name: 使用说明
|
3 | route: /
|
4 | ---
|
5 |
|
6 | ## 通用组件库
|
7 | > 项目中使用的通用组件
|
8 | 基于 antd ,进行再次封装的数据绑定通用组件
|
9 |
|
10 | ### 安装
|
11 | ```
|
12 | $ npm install fan-standard-comp --save
|
13 | ```
|
14 | 或
|
15 | ```
|
16 | $ yarn add fan-standard-comp
|
17 | ```
|
18 |
|
19 |
|
20 | ### 更新日志
|
21 |
|
22 | 🔥组件 🆕新增 🐞修复 🔔删除 💄优化 📝 🛠 🗑
|
23 | ## 2.0.x
|
24 | `2020-04-16`
|
25 | - 🔥 StandardFilter
|
26 | - 🌟 新增 `initialValues` 设置表单控件组初始值,只有初始化以及重置时生效
|
27 | - 🌟 新增 `getFormFields` 获取表单字段值及表单实例
|
28 | - 🛠 formItemGroup API
|
29 | - 🔔 弃用 `filedOptions`
|
30 | - 🌟 新增 `rules` 校验规则,设置字段的校验逻辑 (由原来的filedOptions.rules转到此处)
|
31 | - 💄 优化 `icon` 支持传 String 或 ReactNode (String显示图标功能待优化,未引入图标库)
|
32 | - 🔥 RenderItemGroup
|
33 | - 🔔 弃用 `disabledAll` 改正使用 `fieldStatus='disabled'`
|
34 | - 🌟 新增 `fieldStatus` 表示当前控件正常操作、禁用、或仅显示文本
|
35 | - 🛠 ItemGroup API
|
36 | - 💄 优化 `display` 可支持传对象,即当前标签与输入控件间的布局,如{labelCol:{span: 3}, wrapperCol: {span: 8}}
|
37 | - 🔥 FieldComponent
|
38 | - 🔔 调整 `type` 表单控件类型接收值 🔔 弃用 `monthPicker`,` weekPicker`, `yearPicker`
|
39 | - 🔔 弃用 `disabledAll` 改正使用 `fieldStatus='disabled'`
|
40 | - 🌟 新增 `fieldStatus` 表示当前控件正常操作、禁用、或仅显示文本
|
41 | - 🔥 RefactorTree
|
42 | - 🔔 调整 `onSelect` 参数字段:`onSelect(keys, selectData(如:{ currentData, multiData: multiCheckedData }), e)`
|
43 | - 🌟 新增 `onCheck` 参数字段:`onSelect(keys,selectData(如:{ currentData, multiData: multiCheckedData }), e)`
|
44 | - StandardTable
|
45 | - 💄 优化 `columns 操作列`配置 `buttonGroup` 支持方法格式,返回数组进行渲染
|
46 | - SpecIcon
|
47 | - 🔔 调整 `type`默认设置值为`colour`,使用svg格式,若使用字形图标则需配置 `type="font"`
|
48 | - 🔔 调整 `prefix`默认设置为`speci`,适用为基础图标使用,若是项目内,则会使用额外定义的prefix值
|
49 | - StandardModal
|
50 | - 💄 优化 `getFormFields` 弹窗类型`type='form'` 时获取弹窗内表单字段值及表单实例
|
51 | - 🌟 新增 `initialValues` 设置弹窗内表单控件组初始值
|
52 | - 🛠 formItemGroup API
|
53 | - 🔔 弃用 `filedOptions`
|
54 | - 🌟 新增 `rules` 校验规则,设置字段的校验逻辑 (由原来的filedOptions.rules转到此处)
|
55 | - 💄 优化 `icon` 支持传 String 或 ReactNode (String显示图标功能待优化,未引入图标库)
|
56 | - formItemGroup (涉及:StandardModal、StandardFilter)表单渲染配置项更新
|
57 | - 💄 优化 `isHide`,支持使用方法返回,`isHide(fieldValues,form)`, fieldValues参数可获取当前表单内所有表单项的值
|
58 | - 🌟 新增 `type='tree-select`,下拉树选择添加表单处可显示完整层级名称字段 `showFullLevel`,并添加`separator` 配置其层级分割符,默认是`/`
|
59 |
|
60 | ## 2.0.4,2.0.5
|
61 | `2020-04-28`
|
62 | - FieldComponent
|
63 | - 修复 控件类型为`type=select`配置`labelInValue`下只读无法显示值
|
64 | - 修复 控件类型为`type=tree-select`,渲染数据异步请求时,值显示为空白
|
65 | - 新增 控件类型为`type=select`,新增配置项`selectOptionRender`,可自定义下拉选项展示内容
|
66 |
|
67 | `2020-04-29`
|
68 | - RefactorTree
|
69 | - 💄 修改 `optionName` 替换成原来字段名指定的 ` key 替换成 value` `{ value: 'id', title: 'title', children: 'children' }`
|
70 | - StandardTable
|
71 | - 💄 优化 `data.pagination=false`时,隐藏页码栏
|
72 |
|
73 | ## 2.0.6
|
74 | - StandardModal
|
75 | - 🐞 修复 `fieldStatus`为'viewOnly'或'disabled'时,隐藏底部按钮
|
76 | - FieldComponent
|
77 | - 🐞 修复 表单控件“select"显示筛选条件配置filterOption返回值警告
|
78 | - 🐞 修复 “只读”状态,如果值为 0 时,显示异常
|
79 | - StandardTable
|
80 | - 🐞 修复 表格列配置`columns`默认render返回为0时,显示成 ‘-’
|
81 |
|
82 |
|
83 | ## 2.0.7
|
84 | - 🌟 新增 WrapperContent,SubfieldContent 通用页面结构组件
|
85 | - FieldComponent
|
86 | - 🌟 新增 控件类型`cascader, switch, slider`用法
|
87 |
|
88 | ## 2.0.8
|
89 | - StandardModal
|
90 | - 🐞 修复 `type=form`表单实例往父组件无法派发
|
91 | - FieldComponent
|
92 | - 🌟 新增 控件类型 `timePicker,timePickerRange`用法
|
93 | - FormItemGroup
|
94 | - 💄 修改 `getFormFields(fields, form)` `form`实例参数返回值为对象,无需要添加.current
|
95 | - StandardFilter
|
96 | - 🔔 修改 `isHIde` 返回参数
|
97 |
|
98 |
|
99 | ## 2.1.0
|
100 | - StandardModal
|
101 | - 🔔 修改 类组件替换成函数组件应用
|
102 | - 💄 优化 `formPrefix`和`formPostfix`方法参数,` Function(modalForm, modalProps, forceUpdateForm)`,添加第三个参数`forceUpdateForm()`用于自定义表单值更新时,强制触发表单实例更新
|
103 | - 💄 优化 `custormRender`方法参数,` Function(form,item,fieldStatus, forceUpdateForm) `,添加第四个参数`forceUpdateForm()`用于自定义表单值更新时,强制触发表单实例更新
|
104 | - 💄 优化 `isHide`使用时,需要同` ProtoFormItem.shouldUpdate `一并使用
|
105 |
|
106 | - FormItemGroup
|
107 | - 💄 优化 `isHide`使用时,需要同` ProtoFormItem.shouldUpdate `一并使用
|
108 |
|
109 | ## 2.1.1
|
110 | - FieldComponent
|
111 | - 💄 优化 控件类型 `tree-select`的选择 `onSelect`参数优化,第二个node参数返回加上当前节点的原始数据,及添加第四个参数`nodeParent`返回当前节点上级父节点集合
|
112 | - 💄 优化 控件类型 `password`只读时,只显示 ●●●●●●
|
113 | - 💄 优化 所有控件设置禁用时,`disabled=true或fieldsStatus='disabled'`时,控件值为空时不显示`placeholder`
|
114 | - 🐞 修复 `type="select"`控件配置 `labelInValue`时,只读状态显示值异常
|
115 | - 💄 优化 `tree-select`配置`disabled`字段值
|
116 | - RenderItemGroup
|
117 | - 💄 优化 内部表单控件`onChange`配置参数还原成原始官方API参数
|
118 | - Uploader
|
119 | - 💄 修复 在弹窗关闭后无法重新渲染图片
|
120 |
|
121 | ## 2.1.2
|
122 | - StandardTable
|
123 | - 💄 优化 操作列 权限配置返回按钮数量
|
124 | - 🌟 新增 配置参数 `codes`,`permissionCodes`,用于配置按钮组权限
|
125 | - StandardFilter
|
126 | - 💄 优化 筛选条件 重置及赋值数据未清空
|
127 | - 💄 优化 操作列 权限配置返回按钮数量
|
128 | - 🌟 新增 配置参数 `codes`,`permissionCodes`,用于配置按钮组权限
|
129 | - ButtonGroup
|
130 | - 🌟 新增 按钮组配置,主要用于表格与筛选按钮组合数据过滤
|
131 | - FieldComponent
|
132 | - 💄 优化 控件类型 `switch`只读状态不显示文本,显示控件并对其禁用
|
133 |
|
134 | ## 2.1.3
|
135 | - FieldFilter
|
136 | - 🐞 修复 筛选 buttonGroup 未配置参数时异常值判断
|
137 | - StandardModal
|
138 | - 🐞 修复 弹窗未配置renderButtonGroup 时hideFooter未生效
|
139 | - StandardTable
|
140 | - 🐞 修复 操作列isHide配置返回异常,及对应参数异常
|
141 | - 🐞 优化 操作列放开`confirmText`配置限制(原来只针对 codeBtnDelete)
|
142 |
|
143 | ## 2.1.4
|
144 | - FieldComponent
|
145 | - 🐞 修复 `tree-select` 详情只读模式未显示当前名称
|
146 | - 🐞 修复 `tree-select` 只读模式可显示多选择时的当前数据
|
147 | - 💄 优化 `select` 设置 `option`的 `title`配置,用于鼠标经过点击完整名称
|
148 | - 💄 优化 `select、input、textarea、tree-select` 禁用模式下鼠标经过显示完整值
|
149 | - 🐞 修复 `tree-select` 返回值为[],禁用状态显示异常警告
|
150 |
|
151 | - StandardTable
|
152 | - 🌟 表格操作列 `type:action` 新增配置 `min` 的 用于最小展示按钮数,其余超出将被折叠显示
|
153 | - StandardFilter
|
154 | - 🌟 筛选按钮组 新增配置 `min` 的 用于最小展示按钮数,其余超出将被折叠显示
|
155 | - 🔔 修复 筛选组件重置未清空表单
|
156 | - RenderItemGroup
|
157 | - 💄 优化 表单组 `itemGroup` 单个控件可配置 fieldStatus
|
158 |
|
159 | ## 2.1.5
|
160 | - StandardForm
|
161 | - 🆕 添加 表单控件
|
162 | - fieldComponent
|
163 | - 💄 优化 password 无值时不显示文本,tree-select 旧文件显示样式调整
|
164 | - RenderItemGroup
|
165 | - 🆕 新增 `layout` 表单控件布局模式(继承表单配置)
|
166 | - StandardModal
|
167 | - 🆕 新增 `layout`参数,展示表单布局
|
168 |
|
169 | ## 2.1.6
|
170 | - fieldComponent
|
171 | - 💄 tree-select配置disabled时且多选择下(treeCheckable=true),不显示 title
|
172 | - RenderItemGroup
|
173 | - 🐞 修复 表单组控件必填标识显示判断
|
174 | - StandardFilter,StandardTable
|
175 | - 💄 优化 按钮组元素带子集合时,由于权限判断结果为[],不显示其父节点
|
176 | - RenderItemGroup
|
177 | - 🐞 修复 表单组 type='custom'配置隐藏无效
|
178 | - fieldComponent
|
179 | - 🐞 修复 表单控件radio,tree-select提示“ref"异常
|
180 | - 💄 优化 `tree-select` 详情只读模式配置`showFullLevel`和`showCheckedStrategy`显示完整路径
|
181 | - 💄 优化 `radio`和`checkbox` 新增配置`selectOptionRender`,可自定义选项展示内容
|
182 | - 💄 优化 `checkbox` 配置`separator`,可自定义分隔符
|
183 |
|
184 | ## 2.1.7
|
185 | - RefactorTree
|
186 | - 🐞 修复 配置根节点情况下,数据list为空时不隐藏节点
|
187 | - SpecIcon
|
188 | - 🐞 修复 图标组件应用时样式引用字段库无法识别
|
189 |
|
190 | ## 2.1.8
|
191 | - SpecIcon
|
192 | - 🐞 修复 “字体”图标伪类样式异常
|
193 |
|
194 | ## 2.1.9
|
195 | ` 2020-08-05`
|
196 | - FieldComponent
|
197 | - 💄 优化 控件`select`相关的更改事件`onChange(value, Option)`参数返回值 `Option`累加当前选中数据的完整字段
|
198 |
|
199 | ## 2.1.10
|
200 | ` 2020-09-27`
|
201 | - DragBar
|
202 | - 🆕 添加 上下左右拉动条
|
203 | - DragContent
|
204 | - 🆕 添加 可拉伸的容器
|
205 | - SubfieldContent
|
206 | - 💄 优化 左侧内容配置`leftSiderDragDirection`设置左侧容器可拉伸
|
207 |
|
208 | ## 2.1.11
|
209 | ` 2020-10-13`
|
210 | - Uploader
|
211 | - 🐞 修复 预览弹窗隐藏按钮组
|
212 |
|
213 | ` 2020-10-14`
|
214 | - StepForm
|
215 | - 💄 优化 调整步骤表单内展示结构,交对其步骤按钮组的切换添加校验规则,具体查看DEMO,涉及 `stepClick\actions`等相关配置调整
|
216 | - 💄 优化 步骤切换可配置内部校验或自定义校验
|
217 | - StandardModal
|
218 | - 💄 优化 `tyep=stepForm`按钮组配置事件处理(配置校验处理)
|
219 |
|
220 | ## 2.1.12
|
221 | ` 2020-10-20`
|
222 | - FieldComponent
|
223 | - 💄 优化 `type=inputNumber`控件增加最大输入长度限制
|
224 | ` 2020-10-23`
|
225 | - Uploader
|
226 | - 💄 优化 新增支持svg格式上传预览
|
227 | - 💄 修复 控件台报ref不存在警告
|
228 |
|
229 | ## 2.1.13
|
230 | ` 2020-11-06`
|
231 | - FieldComponent
|
232 | - 💄 优化 `type=uploader` 只读情况下,value值不为数组情况下判断
|
233 | - 💄 优化 `type` 不赋值情况下,显示文本值
|
234 |
|
235 | ` 2020-11-06`
|
236 | - SpecIcon
|
237 | - 🆕 添加 `noPrefix`属性,用于配置图标没有 分割符'-' name渲染
|
238 |
|
239 | ` 2020-11-17`
|
240 | - StandardModal
|
241 | - 💄 优化 调整小号弹窗表单栅格
|
242 | - Uploader
|
243 | - 💄 优化 调整 校验异常时,边框样式
|
244 | - 💄 优化 当有配置扩展值`extraExt`时,svg文件限制提示将去掉
|
245 | - FieldComponent
|
246 | - 💄 优化 `tree-select`下拉树控件`showFullLevel`状态下提示文本
|
247 |
|
248 | ` 2020-11-24`
|
249 | - ButtonGroup
|
250 | - 💄 优化 图标`icon`无prefix时配置方式
|
251 | - StandardModal
|
252 | - 💄 优化 弹窗底部按钮渲染 `footerButtonGroup` 数组内数据支持返回DOM
|
253 |
|
254 | ` 2020-11-27`
|
255 | - uploader
|
256 | - 🆕 添加 `className`配置
|
257 | - SubfieldContent
|
258 | - 💄 优化 左侧栏超出滚动条显示调整
|
259 | - FieldComponent
|
260 | - 💄 优化 `select`重置返回完整字段值
|
261 |
|
262 | ## 2.1.14
|
263 | ` 2020-12-2`
|
264 | - FieldComponent
|
265 | - 💄 优化 `tree-select`配置`labelInValue`时,显示完整名称
|
266 |
|
267 | ` 2020-12-3`
|
268 | - StandardModal
|
269 | - 💄 添加 弹窗底部按钮参数配置 `cancelButtonProps,okButtonProps`
|
270 |
|
271 | ` 2020-12-4`
|
272 | - RenderItemGroup
|
273 | - 💄 优化 `displayLayout`配置优先级低于单个控件配置`display`的值
|
274 |
|
275 | ## 2.1.15
|
276 | ` 2020-12-3`
|
277 | - FieldComponent
|
278 | - 💄 还原 `select` 重置返回完整字段值
|
279 |
|
280 | ` 2020-12-16`
|
281 | - uploader
|
282 | - 💄 优化 去除文件类型校验判断
|
283 |
|
284 |
|
285 | ` 2020-12-17`
|
286 | - RefactorTree
|
287 | - 💄 修复 旧Icon图标应用
|
288 |
|
289 | ` 2020-12-18`
|
290 | - RefactorTree
|
291 | - 💄 优化 树数据渲染模式,移除TreeNode渲染
|
292 |
|
293 | ## 2.1.16
|
294 | ` 2020-12-18`
|
295 | - RenderItemGroup
|
296 | - 💄 优化 `type=title`或`type='html'`可配置隐藏`isHide`,用法同其他类型控件
|
297 |
|
298 | - ButtonGroup
|
299 | - 💄 新增 `confirmConfig` 用于气泡确认框扩展配置
|
300 |
|
301 | ## 2.1.17
|
302 | ` 2021-01-18`
|
303 | - StandardFilter
|
304 | - 修复 @height-base在antd3.0中无对应变量
|
305 |
|
306 |
|
307 | ## 2.1.18
|
308 | ` 2021-02-02`
|
309 | - SpliterLayout
|
310 | - 添加 分割布局组件
|
311 |
|
\ | No newline at end of file |