on/zodiac

起源:挂载通道


Methods

(static) onColor(reference) → {String}

「标准」Ux.onColor

基本说明

获取主色调专用方法,从 reference 中读取主色调相关信息。主色调的读取方式有两种,说明如下:

  • 从Ant Design 4.0开始,样式和皮肤设置存放在token中。
  1. $settings:从token中获取的样式和皮肤信息,默认没有设置,修改全局的样式和皮肤可进行设置,其中colorPrimary为主色调信息。
  2. Z_CSS_COLOR:关于主色调的环境变量,如果$settings没有设置,则会返回此值。

特殊说明

And Design 5 中的样式定制参考:https://ant.design/docs/react/customize-theme-cn,此处的 token 并非安全相关的 token,而是一种定制主题的方式,它在设置的时候其调用代码如下:

import {ConfigProvider} from 'antd';

return (
    <ConfigProvider locale="cn" theme={
        {
            token: {},
            algorithm: "css-in-js"
        }
    }>
    </ConfigProvider>
)

token 相关的API参考:https://ant.design/docs/react/customize-theme-cn#api,后期关于皮肤的完整设计如:

  1. 所有的皮肤都在 skin 目录中进行管理,而不同的皮肤依靠不同的环境变量来指定:
    • Z_CSS_SKIN_MODULE:指定皮肤的模块
    • Z_CSS_SKIN_NAME:指定皮肤中模块名称
  2. 用户登录系统之后,可以使用皮肤管理工具对当前皮肤进行修改,并且将修改结果存储同步到个人设置中。
  3. 保存之后色彩风格会追加 第三来源:从远程数据库中提取皮肤信息,这种皮肤信息是用户自定义的皮肤信息。
Parameters:
Name Type Description
reference Object | ReactComponent

React对应组件引用。

Returns:

返回主色调信息。

Type
String

(static) onDatum(reference, key) → {Array}

「标准」Ux.onDatum

辅助数据读取专用函数,可根据 key = xxx.yyy 的值处理辅助数据,主要读取:

  1. 读取Tabular专用辅助数据。
  2. 读取Assist专用辅助数据。
  3. 读取Category专用辅助数据。

根据所需信息读取上述三大类的辅助数据,得到最终的 Array 类型的数组结果。

Parameters:
Name Type Description
reference Object | ReactComponent

React对应组件引用。

key String

需要读取的 Tabular/Assist 的键值。

Returns:

返回最终的数组。

Type
Array

(static) onSave(reference, key, data, isDeleted) → {Array}

「标准」Ux.onSave

  1. 数组合并(添加、更新)处理。
  2. 数组删除。
Parameters:
Name Type Default Description
reference Object | ReactComponent

React对应组件引用。

key String

需要读取的 Tabular/Assist 的键值。

data Object

数据处理信息,包含了数据记录集。

isDeleted boolean false

删除还是合并。

Returns:

返回处理完成的数组信息。

Type
Array

(static) onUniform(props, …keys) → {Object}

「引擎」Ux.onUniform

原生 Zero UI中的组件继承属性专用方法,在 Zero Extension 中会调用yoAmbient方法实现属性继承, 继承过程中包含几个核心数据:

  1. $t_$a_ 的辅助数据,Tabular和Assist两种。
  2. app应用程序相关数据。
  3. user, profile用户登录后的数据。
  4. submitting防重复提交状态数据。
  5. router核心路由数据。
  6. 输入的keys对应的键相关数据。
Parameters:
Name Type Attributes Description
props Props

当前React组件的属性信息。

keys Array.<String> <repeatable>

待提取的属性集合。

Returns:

返回最终的数据信息。

Type
Object