起源:表单行为
Methods
(static) formClear(reference, data) → {Object}
「标准」Ux.formClear
Ant Design中的表单清空专用方法,用于清空当前 Ant Design表单。
Parameters:
Name | Type | Description |
---|---|---|
reference |
Object | ReactComponent | React组件引用,必须绑定过 Ant 中的 Form。 |
data |
Object | 需要清空的对象值。 |
Returns:
处理被清空的所有方法。
- Type
- Object
(static) formGet(reference, key) → {Object|any}
「标准」Ux.formGet
直接从 form 中按 key
读取表单数据值。
- 如果传入了 Array 类型的 key,则读取包含了 key 中所有元素的表单对象值。
- 如果传入了 String 类型的 key,则直接读取表单字段为
key
的字段值。 - 如果什么都没传入,则直接返回所有表单值。
Parameters:
Name | Type | Description |
---|---|---|
reference |
Object | ReactComponent | React组件引用,必须绑定过 Ant 中的 Form。 |
key |
String | Array | 字段名称,有可能是字段集合。 |
Returns:
返回读取的字段值。
- Type
- Object | any
(static) formHit(reference, key, value) → {any}
「标准」Ux.formHit
「Ambiguity」Ant Design中的Form操作的二义性函数
value
有值时直接设置key
的表单值;value
为undefined时则直接读取Form中的key
对应的值
这个方法是一个典型的二义性方法,如果有 value 则设置字段key
的值,如果没有value则读取value
的值,但是它的读取不如 formGet
,
formGet
是增强版的表单读取方法,不仅仅可以读单字段的值,还可以读一个子对象(Object)。
Parameters:
Name | Type | Description |
---|---|---|
reference |
Object | ReactComponent | React组件引用,必须绑定过 Ant 中的 Form。 |
key |
String | 字段名称。 |
value |
any | 字段值 |
Returns:
只有在 value 不传入时使用该值。
- Type
- any
(static) formHits(reference, values)
「标准」Ux.formHits
Ant Design中的Form表单执行值设置,直接使用values执行设置,values中如果有undefined则清空该字段。
Parameters:
Name | Type | Description |
---|---|---|
reference |
Object | ReactComponent | React组件引用,必须绑定过 Ant 中的 Form。 |
values |
Object | 设置Form表单中的字段值 |
(static) formReset(reference, keys, response)
「标准」Ux.formReset
重设表单值专用方法。
Parameters:
Name | Type | Description |
---|---|---|
reference |
Object | ReactComponent | React组件引用,必须绑定过 Ant 中的 Form。 |
keys |
String | Array | 字段名称,有可能是字段集合。 |
response |
Object | 响应最终信息数据。 |
(static) formRow(reference, request, config) → {Promise.<Object>}
「标准」 Ux.formRow
针对窗口类型组件 Dialog 执行的行添加专用提交方法,通常是窗口内包含了表单内数据,其核心如数如下:
- reference 中的 $mode 用于表示当前表单所做的操作类型,包括
ADD / EDIT
两种。 - reference 中的 $inited 用于表示当前表单的初始化基本数据。
- reference 中的 rxRow 为调用此API的核心函数,此函数必须存在,若不存在则直接抛出异常:throw new Error("rxRow")
- config 中目前使用的操作是做表单部分重置,config 中的 reset = [] 属性
对应数据格式如:
{
"$mode": "ADD | EDIT",
"$inited": {
"field1": "value1",
"field2": "value2",
"...": "..."
},
"rxRow": () => ....
}
此API还会有一个特性,即在添加行数据时,若出现了持续添加,则
key
会被重制 UUID。
Parameters:
Name | Type | Description |
---|---|---|
reference |
Object | ReactComponent | React组件引用,必须绑定过 Ant 中的 Form。 |
request |
Object | 表单请求通过标准化处理后的数据 |
config |
Object | 传入的属性配置 |
Returns:
异步返回Promise封装request 数据的 monad
- Type
- Promise.<Object>