form/zodiac

起源:表单行为


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 读取表单数据值。

  1. 如果传入了 Array 类型的 key,则读取包含了 key 中所有元素的表单对象值。
  2. 如果传入了 String 类型的 key,则直接读取表单字段为 key 的字段值。
  3. 如果什么都没传入,则直接返回所有表单值。
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的值,但是它的读取不如 formGetformGet是增强版的表单读取方法,不仅仅可以读单字段的值,还可以读一个子对象(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 执行的行添加专用提交方法,通常是窗口内包含了表单内数据,其核心如数如下:

  1. reference 中的 $mode 用于表示当前表单所做的操作类型,包括 ADD / EDIT 两种。
  2. reference 中的 $inited 用于表示当前表单的初始化基本数据。
  3. reference 中的 rxRow 为调用此API的核心函数,此函数必须存在,若不存在则直接抛出异常:throw new Error("rxRow")
  4. 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>