Intact v2.2.0 发布

距离Intact上个版本过去了大半年,这半年里,一直致力于基于Intact的组件库Kpc的开发工作。而在这次开发过程中,一点一点地将Intact打磨成了一个比较理想的版本。同时也接受了大型组件库,以及金山云线上项目的洗礼,相信稳定性和便利性都有了质的飞跃。这一版本修复了多处bug的同时,也加入了一些新特性。而且实现了Intact在Vue中运行的兼容层intact-vue,进一步拓展了Intact以及Kpc组件库的适用范围。

下面将介绍以下本次发布的几个重要更新,其它更新,请见更新日志:

$receive事件

$receive事件会在组件 更新 的时候,如果检测到传入变更的新属性值,就会触发。

在组件的设计过程中,通常会遇到这样的需求:验证传入组件的属性值是否合法,甚至在不合法的情况下纠正它,或者传入的某个值并不会在组件中直接使用,而是映射成组件内部维护的另一个状态值。

虽然在Intact中,只要通过set方法设置数据触发了变更,就会抛出$change事件。但通过该事件解决上述问题,存在以下问题:

触发太频繁,因为该事件不管数据来源是外部属性传递,还是内部自己改变都会触发,在事件回调函数中,我们无法得知该事件的来源,而大多数情况下,内部触发的变更我们是无需去验证和修正该值的合法性的,同时我们也可能需要根据不同来源处理不同逻辑。

例如,当我们需要对用户传入的String类型的数字转换为Number类型时,可以如下这么做:

  1. class Component extends Intact {
  2. defaults() {
  3. return {
  4. value: 0
  5. };
  6. }
  7. _init() {
  8. // 初始化时修正
  9. this._fixValue();
  10. // 接收到属性变更时修正
  11. this.on('$receive:value', this._fixValue);
  12. }
  13. _fixValue() {
  14. this.set('value', Number(this.get('value')) || 0);
  15. }
  16. _add() {
  17. // 内部触发的变更不会触发$receive事件
  18. this.set('value', this.get('value') + 1);
  19. }
  20. }

由于该事件只在更新组件时触发,对于初始化我们需要在_init周期函数中手动调用

又例如,对于日期范围选择组件,我们会依次选择开始时间和结束时间,对于v-model双向绑定的选择结果值,我们希望在选择的过程中,将结果置位空,而选择完成后才去设为最终值。此时我们可以将v-model的绑定的属性值value映射成内部维护的_value来达到目的,但是在外部传入的value的确发生变化时,也要同步更新_value

  1. class Component extends Intact {
  2. defaults() {
  3. return {
  4. value: [],
  5. _value: [],
  6. };
  7. }
  8. _init() {
  9. // 初始化时,将value赋给_value
  10. this.set('_value', this.get('value'));
  11. this.on('$receive:value', (c, v) => {
  12. // 接收到外部传入的新值时,同步更新_value
  13. this.set('_value', v);
  14. });
  15. this.on('$change:_value', (c, v) => {
  16. // 内部_value变化时,去判断是否选择完成,如果没有,则置为空数组
  17. if (v && v.length === 1) {
  18. v = [];
  19. }
  20. this.set('value', v);
  21. });
  22. }
  23. ...
  24. }

如果我们将上面中的$receive替换成$change会发生什么?

  1. this.on('$receive:value', (c, v) => {
  2. // 接收到外部传入的新值时,同步更新_value
  3. this.set('_value', v);
  4. });
  5. =>
  6. this.on('$change:value', (c, v) => {
  7. // 只要value变更就会同步更新_value
  8. this.set('_value', v);
  9. });

当内部只选择了开始时间时,_value取值类似于['2018-05-01'],此时触发的$change:_value事件会将value置为[],而这又会触发$change:value事件,又将_value设为空了[],用户将永远选择空数组[]。而$receive:value则会很好地解决这一问题,因为它只在外部传递的属性值变更时触发。

<b:block>语法在组件中的应用

在之前的版本中,<b:block>只能配合模板继承<t:template>使用,如果你需要往组件中传入子模板,需要通过属性值来传递,这会给复杂模板的传递带来麻烦。现在<b:block>也可以用于在组件中传递子模板,类似于Vue中的slot,不同的是它依然支持parent()调用组件中的默认模板内容。

例如,定义一个简化的Dialog组件如下

  1. // @file dialog.vdt
  2. <div class="dialog">
  3. <b:header>
  4. <div class="header">{this.get('title')}</div>
  5. </b:header>
  6. <b:body />
  7. </div>
  1. // @file dialog.js
  2. import template from './dialog.vdt';
  3. import Intact from 'intact';
  4. export default class Dialog extends Intact {
  5. @Intact.template()
  6. static template = template;
  7. defaults() {
  8. return {title: 'Title'};
  9. }
  10. }

上述Dialog组件中,我们在模板中定义了headerbody两个block块,其中header定义了默认模板内容<div class="header">{this.get('title')}</div>,而body为空block。下面我们使用该组件,并往特定区域填充内容

  1. import Dialog from './dialog';
  2. <Dialog>
  3. <b:header>
  4. {parent()}
  5. <button class="close">X</button>
  6. </b:header>
  7. <b:body>
  8. Hello Intact!
  9. </b:body>
  10. </Dialog>

在往header这个block中填充内容时,我们可以通过parent()方法引用该block在组件模板中的默认内容。所以它的渲染结果为:

  1. <div class="dialog">
  2. <div class="header">Title</div>
  3. <button class="close">X</button>
  4. Hello Intact!
  5. </div>