informed源码解析

informed的源码有三个重点: FormController和FieldController以及withFieldStuff函数。他们的关系如下所示:


image.png

FormController

FormController是核心。它有三个属性: valuesfield,以及errorsvalueserrors的数据类型ObjectMap(为什么要用这个数据格式我没有搞懂),fieldmap类型,一个fieldName绑定一个对应的fieldController。FormController 继承EventEmitter,继承这个库在以下功能中都有用到。这里主要介绍setValue/getValue/register方法

ObjectMap

ObjectMap的数据类型有三个属性:objects, map,pathpath的格式是这样的

{
      'a.b.c':[a,b,c],
      'a.b[1]':[a, b, 1]
}

objects就是fieldNamevalue的一一对应,比如:

{
       a:{
            b:{
                c: 'hello'
            }
      }
}

map的数据格式如下所示

image.png

这个class有还有getset方法。基本上就是遍历设置和获取对应field的值。
这里我有一个疑问了,我刷了整个informed的方法,用到map的寥寥无几,这个属性有存在的必要吗?

values

values中存储的是每一个包含在form表单中组件的值。它是一个特殊的数据格式(ObjectMap)
和这个属性相关的有两个函数: setValuegetValue,顾名思义。

  • setValue
    setValue的代码如下:
this.values.set(
      field,
      fieldController.config.mask ? fieldController.config.mask(value) : value
    ); 
...
this.emit('change', this.state);
this.emit('values', this.state.values);
this.emit('field', field);

重点是这三个事件changevaluesfield。那么接收change事件调用的函数在Form组件中的constructor

 this.controller.on('change', () => this.forceUpdate());

调用的是react的forceUpdate方法。会让form下的所有子组件重新渲染。
接收field事件的函数,是在withFieldStuff函数中。

const buildFieldState = (formApi, field) => {
  return {
    value: formApi.getValue(field),
    touched: formApi.getTouched(field), //touch并不知道干嘛用的
    error: formApi.getError(field),
    asyncError: formApi.getAsyncError(field)
  };
};
....
const updateMe = name => {
     if (name === formApi.getFullField(field)) {
              //重新获取field对应新的value的值
              this.setState(buildFieldState(formApi, field));
    }
 };

controller.on('field', updateMe);

以上代码,当接收到field事件时,每一个包裹Field的input,都会从FormController中重新获取当前field的最新的值。

FieldController

FieldController的代码如下所示:


class FieldController {
  constructor(field, api, config) {
    this.field = field;
    this.config = config;
    this.api = api;
  }
  validate(values) {
    if (this.config.validate) {
      return this.config.validate(this.api.getValue(), values);
    }
  }
  asyncValidate(values) {
    if (this.config.asyncValidate) {
      return this.config.asyncValidate(this.api.getValue(), values);
    }
  }
  updateConfig(config) {
    this.config = config;
  }
}

FieldController主要对传入的this.config.validate函数进行一层封装。创建FieldController函数的代码如下所示:

this.fieldController = new FieldController(
              formApi.getFullField(field),
              this.fieldApi,
              {
                validateOnBlur,
                validateOnChange,
                validate,
                onValueChange,
                asyncValidate,
                asyncValidateOnBlur,
                initialValue,
                validateOnMount,
                notify,
                mask
              }
            );

Field初始化时(constructor ),会为每一个field创建一个controller。
那什么时候使用这个constroller的valiate函数呢?在formControllersetValuesetTouched函数都有,前提要配置一些参数

setValue函数中的,如果配置了validateOnChange

...
 if (fieldController.config.validateOnChange) {
      this.errors.set(field, fieldController.validate(this.state.values));
      // We changed so notify all other fields
      this.notify(fieldController.config.notify);
    }
...

setTouched函数,如果配置了validateOnBlur

if (fieldController.config.validateOnBlur) {
      this.errors.set(field, fieldController.validate(this.state.values));
      // We changed so notify all other fields
      this.notify(fieldController.config.notify);
    }

withFieldStuff函数

withFieldStuff函数是连接FieldControllerFormController之间的桥梁。同时也从formApi中获取本field相关的函数和值。主要的函数是register函数。该函数会在Field组件componentDidMount中调用

class Field extends PureComponent  {
 constructor(props) {
    super(props);
    this.me = React.createRef();
  }

 componentDidMount() {
  
    this.props.register();
  }

}

接下来看register函数的流程。

image.png

整个informed源码的重点部分就说完了

问题:
1.如果我在组件A中需要用到组件B的值?(这个在表单中非常常见)
2.作者创建一个objectMap数据类型意义何在?

以后的话:
我看的这个版本的informed源码是比较老。新的版本又出了,使用了hook的技术。所以这个系列未完待续。

`

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,123评论 6 490
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,031评论 2 384
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 156,723评论 0 345
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,357评论 1 283
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,412评论 5 384
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,760评论 1 289
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,904评论 3 405
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,672评论 0 266
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,118评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,456评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,599评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,264评论 4 328
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,857评论 3 312
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,731评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,956评论 1 264
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,286评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,465评论 2 348

推荐阅读更多精彩内容

  • mean to add the formatted="false" attribute?.[ 46% 47325/...
    ProZoom阅读 2,694评论 0 3
  • Lua 5.1 参考手册 by Roberto Ierusalimschy, Luiz Henrique de F...
    苏黎九歌阅读 13,763评论 0 38
  • 你说,十六岁才刚开始 遇见我,是第一块石头 我说,不管不顾,只走到最后,再看结果怎么样 想你啊!想你…… 只要你不...
    齐家能阅读 215评论 0 2
  • 今日体验:今天不是很忙 做好本职工作 快过年了 保证好安全以及自身安全!
    酷酷的峰666阅读 71评论 0 0
  • 有这样一个男孩,他乐观但却会在深夜忧伤,他热情却又似乎什么都不在乎,他很简单但却遇见了他喜欢的她。 他喜欢她在雨里...
    寂迹阅读 166评论 0 1