资讯专栏INFORMATION COLUMN

高级 Angular 组件模式 (3b)

wums / 2681人阅读

摘要:原文的第四篇文章中的一个重要元素在上一篇文章中没有涉及,使用高阶组件中的常用模式可以将组件中的公用逻辑分离出来。同时,因为组件的模板并不存在任何的变动,我们可以将它转化为一个指令,这样我们可以以更加灵活的方式来使用它。

03-b Enhance Components with Directives
原文: Enhance Components with Directives

Kent C. Dodds的第四篇文章中的一个重要元素在上一篇文章中没有涉及,使用withToggle高阶组件(HoC, react中的常用模式)可以将组件中的公用逻辑分离出来。

虽然上一篇文章中上面提及的三个组件并没有太多的公用逻辑,可以万一它们有公用逻辑呢?如果我们想要提供更加声明式的功能,比如能够显式的声明它们使用的组件实例而非最邻近的父实例。

同时,因为组件的模板并不存在任何的变动,我们可以将它转化为一个指令,这样我们可以以更加灵活的方式来使用它。

目标

允许我们的组件能够以tag的形式或者attribute的形式使用,如或者

允许通过withToggle`指令显式地设置```组件

实现 1)将作为一个指令

组件改变为指令十分简单,因为它本身的模板仅仅是,在组件渲染时,会被替换为我们当前组件标签内包含的内容,所以我们可以直接移除它,并使用@Directive装饰器来描述组件,如下:

@Directive({
  exportAs: "toggle",
  selector: "toggle, [toggle]",
})
export class ToggleDirective {}

你可能注意到了,指令的选择器允许toggle指令可以以标签名属性名的形式来使用。对于exportAs关键字是必须要提供的,因为这是当我们需要在别的指令或者组件能够获取toggle指令引用的名字,会在这个系列文章的第5章详细删除exportAs(Handle Template Reference Variables with Directives)。

2)withToggle指令

在这个新的指令中,我们将会封装关于如何选取需要绑定某个toggle指令实例的逻辑。

首先,我们的设想是这样的,每一个组件注入withToggle指令,而不是直接注入最邻近的父toggle指令。同时每个使用withToggle指令的组件通过使用withToggle.toggle来访问它所绑定的toggle指令的实例,如下:

@Component({
  selector: "toggle-off",
  template: ``,
})
export class ToggleOffComponent {
  constructor(public withToggle: WithToggleDirective) {}
}

其次,withToggle指令将它自身与toggle指令的选择器绑定(就是两个指令的选择器是相同的),同时增加一个额外的选择器[withToggle],如下:

@Directive({
  exportAs: "withToggle",
  selector: "toggle, [toggle], [withToggle]",
})
export class WithToggleDirective //...

现在withToggle指令为它的子组件们提供所绑定的toggle指令实例,无论这个实例是显示绑定的,还是默认的父toggle指令。关于其中实现的具体细节,可以参考文章最后的附录部分。

成果

我们的app.component.html现在可以通过三种不同的使用方式来展现内容。

1)基本
... ...

注意#firstToggle#secondToggle视图变量是如何使用toggle组件的,前者使用属性声明的方式,后者使用标签名声明方式,无论怎样,它们都按理想中那样运行。

而且,#secondToggle是嵌套在#firstToggle中的,所以它的子组件使用的是它本身的开关状态,而非#firstToggle中的,这符合我们的预期。

2)显式引用

First: On Off

这里没有任何toggle指令是当前p标签的子组件的祖先,但是通过withToggle指令,我们可以让所有的子组件使用#firstToggletoggle指令实例。

3)自定义组件

withToggle指令甚至可以通过DI机制注入到内部的任何自定义组件中,如组件和都没有任何关于withToggle或者toggle的引用声明。它们无需关心这个开关状态的来源,它们仅仅需要知道的是,根据这个开关状态,如何与它们的子组件进行交互。

附录

withToggle的实现,是一个标准的指令声明方式,除了它的构造方法,如下:

constructor(
  @Host() @Optional() private toggleDirective: ToggleDirective,
) {}

值得注意的有两点:

@Host():这个装饰器的作用是,可以限制从属于当前指令的DI注入器,仅注入绑定到某个满足特定条件指定或者组件上的toggle指令实例,而不是从它的祖先组件们中注入。(这里选择器为空,则为宿主对象)

@Optional():这个装饰器会告诉编译器,当注入器没有找到任何可注入的toggle指令时,不要抛出错误(如果我们手动的指定某个引用),这样在它无法被注入时,使它保持undefined即可。

现在我们可以很容易的理解在ngOnChanges生命周期钩子函数中的代码的作用,

this.toggle = this.withToggle || this.toggleDirective;

如果我们的@Input()被指定,那么使用它的值

如果没有,则尝试去使用在当前宿主对象上注入的toggle指令实例

如果没有,则使用undefined

当前的this指定withToggle本身,所以拥有它引用的子组件都可以访问它。

在线代码演示(自备梯子): https://stackblitz.com/edit/a...

译者注

在这一节中,主要进行了以下几方面的改进:

简化toggle本身,因为它一直是作为一个容器组件使用的,所以完全可以以指令(可以理解为没有模板的组件)的形式存在

依赖注入(DI)的机制虽然很强大,但是受限于它的运作原理(关于具体的运作原理可以参考官方文档)。这里原作者使用一个额外的withToggle指令作为中间件,来作为toggle指令的托管容器。这部分理解起来可能需要先了解一下视图变量和exportAs的相关的知识

对于toggle指令实例的获取逻辑,采用平稳退化的策略,就好比人在实际生活中思考问题的方式一样。

这种开发模式,在实际工作中,我有一次在重构公司项目中一个关于表单组件的过程中曾使用过,之所以使用这种方式,是因为在表单组件中,会存在一些关于联动校验或者分组的需求,如果将这部门逻辑封装为service或者直接写在controller内部,越到后面会发现逻辑复杂度越高,从而越来越难维护。

使用这种模式,将复杂的逻辑划分成小的颗粒,再封装为独立的指令,在需要用到这些逻辑的组件中注入这些指令即可,指令的特点就是一般都会比较简洁,只会做一些简单的事情,相比之下,维护一个十分复杂的service和维护若干简单的指令,我更倾向于后者。

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/90803.html

相关文章

  • 高级 Angular 组件模式 (6)

    摘要:为了适应表单校验的灵活性,我们使用这种模式会事半功倍,提供校验信息的组件仅仅声明渲染表单错误提示信息需要设计的状态变量即可,比如等等,对于错误信息的文案及样式,统统交由错误提示组件的使用者完成。 06 Use Render Props最近在React社区中引起了轰动,但是与之类似的模式在Angular中似乎并没有得到太多关注。我在之前写的文章提及过,TemplateRefs就是Ang...

    caohaoyu 评论0 收藏0
  • 高级 Angular 组件模式 (1)

    摘要:原文如那样,我们将使用一个相对简单的组件来说明这些模式。组件的职责是仅仅是管理一个简单的布尔值状态属性。文件夹并且特别是,将针对库在不同的情形下的使用做出相应的改变。 写在前头 Angular到现在已经到5.x的版本了,对于MVVM框架我首先接触的是angularjs后来又转为react,之后换了工作因项目技术栈的原因又转换到之前的angularjs,在实际工作中实施了公司几个比较重要...

    Corwien 评论0 收藏0
  • 高级 Angular 组件模式 (7)

    摘要:目标提供一些方法或指令给组件使用者,使其可以与所提供的元素交互并修改它们。这个指令拥有一个属性并与组件共享,该属性将决定属性的值是还是。 07 使用 Content Directives 原文: Use Content Directives 因为父组件会提供所有相关的 UI 元素(比如这里的 button),所以 toggle 组件的开发者可能无法满足组件使用者的一些附加需求,比如,...

    chadLi 评论0 收藏0
  • 高级 Angular 组件模式 (3a)

    摘要:同时,依赖注入机制是依附于组件本身存在的,并不依附于模板的层级关系,因此不会面临问题二的困扰。对于木偶组件本身,往往作为消费者存在,这种情况下使用机制可能会达到更好的效果。 03-a Communicate Between Components Using Dependency Injection 原文: Communicate Between Components Using Dep...

    Chiclaim 评论0 收藏0
  • 高级 Angular 组件模式 (2)

    摘要:相关话题装饰器将会返回在组件标签包含的内容中,第一个符合选择器的子组件或者子指令的引用,比如。或者装饰器是用来获取在组件内部模板中使用的单个或者多个组件的。 02 Write Compound Components 原文: Write Compound Components 目标 我们需要实现的需求是能够使使用者通过组件动态的改变包含在它内部的内容。 实现 我们可以把toggle抽象...

    Taste 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<