1.[Angular 组件库 NG-ZORRO 基础入门] - 源码初窥: core
2.[译] 关于 Angular 的码解变化检测,你需要知道的码解一切
3.Angular 练级之旅(6)-CDK的使用
4.求angularjs select2写的下拉树形列表源码,类似于附件里的结构
5.什么是 Angular Ahead-of-time (AOT) compilation
6.angular如何集成monaco-editor
[Angular 组件库 NG-ZORRO 基础入门] - 源码初窥: core
在探索和了解了典型组件的源码之后,我们进一步深入 NG-ZORRO 组件库的码解核心结构,发现了一个关键的码解策略来解决组件间共用属性、功能导致的码解重复编写问题。NG-ZORRO 支持近 种组件,码解商品分类下的源码为避免每种组件都需要重复定义相同的码解属性或功能,开发团队采用了将公共方法和定义抽离至 `core` 文件夹的码解策略。
当处理组件的码解通用属性时,我们发现像 `nzSize` 这样的码解属性在多个组件如 `Input` 和 `Button` 中被广泛使用。解决这一问题的码解方法在于引入 `types` 文件夹,这个文件夹记录了哪些组件支持特定属性,码解便于我们查询和重复利用。码解
动画效果是码解 Angular 开发中常见的元素,Angular 官方文档提供了详尽的码解指南。NG-ZORRO 提供了多样化的动画,使页面元素呈现丰富的动态变化。例如在 `Collapse` 折叠面板组件中,通过 `nzActive` 属性操控动画状态,实现元素的展开与收起效果。这一功能在实际开发中非常实用,使用动画使页面交互更加直观。
某些组件,如 `Tag`,在其动态删除操作中应用了淡入淡出动画,该动画机制相较于需要单独配置的状态传递更为简便,直接提升视觉效果和用户体验。NG-ZORRO 内含多种动画类型,如 `moveUpMotion` 和 `slideMotion`,通过探索源码可以轻易找到使用方式。
对于不希望使用动画的场景,NG-ZORRO 提供了 `NzNoAnimationDirective`,允许开发者在模板层面对特定元素禁用动画效果。通过替换 `BrowserAnimationsModule` 为 `NoopAnimationsModule`,可实现全局禁用动画。
总结这一系列核心文件夹——`core` 包含了如 `types` 和 `animations` 等内容,对于项目开发而言,应考虑抽离公共部分,实现跨组件复用,以减少代码冗余和提高开发效率。通过借鉴 NG-ZORRO 的实践,开发者可以优化代码结构,提升组件复用性,同时保持代码的简洁性和易维护性。
[译] 关于 Angular 的变化检测,你需要知道的easyui 源码分析一切
关于 Angular 的变化检测,你需要知道的一切
探究内部实现和具体用例
要全面了解 Angular 的变化检测机制,查看源码是不可或缺的步骤,因为网络上相关文章少之又少。大部分文章只涉及每个组件自身的变化检测器、不可变变量(immutable)和变化检测策略(change detection strategy)的概念,但缺乏深入剖析。本文旨在深入探讨不可变变量如何触发变化检测,以及变化监测策略对检测的影响。同时,你将能将这些知识应用到优化性能的场景中。
本文分为两部分,第一部分侧重于技术细节,包含大量源码链接。我们基于 Angular 4.0.1 版本来解释变化检测机制的工作原理。该版本与 Angular 2.4.1 版本有所差异。若想了解更多,可参考 Stack Overflow 上的相关讨论。
第二部分将展示如何运用变化检测。值得注意的是,尽管两个版本的 API 有所不同,但第二部分的内容对两个版本都适用。
核心概念:视图(view)
Angular 的教程常提到应用是一颗组件树,但在 Angular 内部,视图(view)是一种较低级的抽象概念。视图与组件之间存在直接关联,每个视图都通过 component 属性与对应的组件类关联。所有操作在视图中执行,包括属性检查和 DOM 更新。因此,从技术角度来看,更准确的说法是 Angular 应用是一颗视图树。组件可以视为视图的更高阶概念。源码中对视图有如下描述:
视图是应用 UI 的基本组成元素,由一组在创建和销毁时共同存在的最小集合构成。视图的属性可以改变,但元素结构(数量和顺序)不能改变。想要改变元素结构,只能通过 ViewContainerRef 插入、移动或移除嵌入的视图。每个视图可以包含多个视图容器。
在本文中,我们将交替使用“组件视图”和“组件”概念。
值得注意的是,网络上有关变化检测的文章和 StackOverflow 回答中的“视图”常被称作变化检测器对象(Change Detector Object)或 ChangeDetectorRef。实际上,网厅 源码变化检测并非独立对象,而是在视图上运行的。
每个视图通过 nodes 属性关联子视图,以便对子视图进行操作。
视图的状态
每个视图都有一个 state 属性,这是极其重要的属性,决定了是否对视图及其所有子视图执行变化检测。state 属性有多种可能的值,与本文相关的有:
如果ChecksEnabled 为 false 或视图状态为 Errored 或者 Destroyed,变化检测将跳过此视图及其所有子视图。默认情况下,所有视图均以 ChecksEnabled 作为初始值,除非使用了 ChangeDetectionStrategy.OnPush。
Angular 中有许多高级概念用于操作视图。在文章中已提及部分概念,如 ViewRef。它封装了组件视图并提供了一个名为 detectChanges 的方法,该方法会在异步事件触发时在最顶层的 ViewRef 上执行变化检测。最顶层的 ViewRef 执行变化检测后,会递归地对其子视图执行检测。
通过 ChangeDetectorRef 令牌将 viewRef 注入组件构造函数中,可以实现此操作:
从其定义可知这一点:
变化检测操作
执行变化检测的主要逻辑在 checkAndUpdateView 方法中,该方法主要针对子组件视图执行操作,并递归地调用此方法以遍历从宿主组件到所有组件的所有视图。这意味着,下一次递归中,子组件就成为了新的父组件。
执行变化检测的主要步骤如下:
有几个关键点需要注意:
首先,子组件在子视图被检测之前会触发onChanges 生命周期钩子,即使子视图的变化检测被跳过了。这一点至关重要,后续部分将展示如何利用这一点。
第二,当检测视图时,更新视图的 DOM 是变化检测机制的一部分。因此,如果组件未被检测,DOM 将不会更新,模板中的组件属性发生改变时也是如此。在第一次检测之前,模板已被渲染。这里所说的更新 DOM 指的是更新插值。例如,some { { name}},在第一次检测之前,php 网赚源码已经将 DOM 元素 span 渲染好。检测过程中,只会渲染 { { name}} 部分。
另一个有趣的是,子组件视图的状态可以在变化检测过程中改变。所有组件视图默认初始化为 ChecksEnabled。但是,使用 OnPush 策略的组件在第一次检测后不再执行变化检测(步骤第 9 步)。OnPush 文档说明,只有绑定发生变化时才会执行检测。因此,需要将 ChecksEnabled 位设置为启用检测(步骤第 2 步操作):
只有当父视图绑定发生变化,且子组件视图初始化为 ChangeDetectionStrategy.OnPush 时,才会更新状态。
最后,当前视图的变化检测负责启动子视图的变化检测(步骤第 8 步)。以下是相关的代码:
现在你知道了视图状态控制了是否对此视图及其子视图进行变化检测。那么问题来了——我们能控制这个状态吗?答案是可以,这也是本文第二部分将探讨的内容。
有些生命周期钩子在更新 DOM 前调用(步骤 3、4、5),有些在之后(步骤 9)。例如,组件结构为 A -> B -> C,它们的生命周期钩子调用和更新绑定的顺序是:
总结
假设我们有如图所示的组件树,根据前面所述,每个组件都有一个与之关联的视图。每个视图初始化为 ViewState.ChecksEnabled,这意味着 Angular 进行变化检测时,树中的每个组件都会被检测。
如果我们希望禁用 AComponent 及其子组件的变化检测,只需将 ViewState.ChecksEnabled 设置为 false。由于状态操作是低级操作,Angular 提供了许多视图的公共方法。每个组件都可以通过 ChangeDetectorRef 令牌获取关联的视图。Angular 文档定义了该类的公共接口:
接下来,我们将探讨如何使用这些接口。
detach
detach 允许我们操作状态,它可以对当前视图禁用检查:
在代码中实现如下:
这确保了接下来的变化检测中,从 AComponent 开始,左子树的所有组件都会被跳过(橙色的组件不会被检测):
需要注意的是,改变的是 AComponent 的状态,其所有子组件都不会被检测。第二点是网赚网 源码,由于整个左子树的组件都不执行变化检测,它们模板中的 DOM 也不会更新。以下例子简要描述了这种情况:
当组件首次被检测时,span 将被渲染为“See if I change: false”。两秒后,changed 属性变为 true,但 span 中的文字不会更新。然而,如果去掉了 this.cd.detach(),就会按照预期更新。
reattach
如第一部分所述,如果 AComponent 的输入绑定 aProp 发生变化,AComponent 的 Onchanges 生命周期钩子就会被触发。这意味着一旦得知输入属性发生变化,即可启动当前组件的变化检测器来检测变化,然后在下一个周期将其分离。以下是实现此功能的代码片段:
由于reattach 只是简单地设置 ViewState.ChecksEnabled 位:
这与将 ChangeDetectionStrategy 设置为 OnPush 的效果相似:在第一次变化检测后禁用检测,当父组件绑定的属性发生变化时启用,检测完之后再次禁用。
需要注意的是,OnChanges 钩子仅在禁用检查的子树的最顶端组件触发,子树中的其他组件不会触发。然而,我们可以通过这个钩子执行自定义逻辑,然后将组件标记为可以执行一次变化检测。由于 Angular 只检测对象引用,我们在此可以检查对象的属性:
markForCheck
reattach 方法仅对当前组件启用检测,如果父组件未启用变化检测,效果有限。我们需要一个能够检测所有父组件直到根组件的方法,这个方法就是 markForCheck:
从代码中可以看出,它仅向上迭代直至根节点,使所有父组件都启用检查。
何时使用这个方法?与 ngOnChanges 一样,在使用 OnPush 策略时也会触发 ngDoCheck 生命周期钩子。再次强调,只有禁用检查的子树的最顶端组件会触发,子树中的其他组件都不会触发。但是,我们可以通过这个钩子执行一些自定义逻辑,然后将组件标记为可以执行一次变化检测。由于 Angular 只检测对象引用,我们在此可以检查对象的属性:
detectChanges
有一种方法可以对当前组件和所有子组件执行一次变化检测,这就是 detectChanges 方法。此方法会对当前组件视图执行变化检测,不管组件的状态如何。也就是说,视图仍会禁用检测,并且在接下来常规的变化检测中,不会检测此组件。例如:
尽管变化检测器引用仍保持分离,但 DOM 元素仍会随着输入绑定的变化而变化。
checkNoChanges
这是变化检测器的最后一个方法,主要作用是确保当前执行的变化检测中,没有变化发生。简单来说,它执行本文第一部分提到的列表中的第 1、7、8 步。如果发现绑定发生变化或 DOM 需要更新,会抛出异常。
还有疑问?
若对本文有任何疑问,欢迎在 Stack Overflow 上提问,并在本文评论区贴上链接。这样整个社区都能受益。感谢。
关注我以获取更多资讯
若发现译文存在错误或其他需要改进的地方,欢迎到 掘金翻译计划 对译文进行修改并 PR,也可获得相应奖励积分。本文永久链接即为本文在 GitHub 上的 MarkDown 链接。
掘金翻译计划 是一个翻译优质互联网技术文章的社区,文章来源为 掘金 上的英文分享文章。内容覆盖 Android、 iOS、 前端、 后端、 区块链、 产品、 设计、 人工智能等领域,想要查看更多优质译文请持续关注 掘金翻译计划、 官方微博、 知乎专栏。
Angular 练级之旅(6)-CDK的使用
探讨Angular CDK的使用与价值,尤其是Overlay模块的实践。CDK,即Component Dev Kit,是Angular官方提供的一系列组件、指令和辅助方法,旨在简化和提升组件开发的效率。
CDK组件广泛应用于构建交互复杂、功能丰富的应用。本文重点介绍Overlay模块,它为组件如select、dropdown、modal等提供统一的实现方式,通过触发器展现额外的HTML内容。
OverlayModule是创建浮层的关键模块,它负责管理浮层的呈现、位置和尺寸。实际应用中,我们经常使用它实现下拉菜单、模态框等功能。在官方示例中,将UserProfile集成到overlay中,但其文档阅读体验不佳。直接查看API文档会更清晰。
API文档中,Overlay服务用于动态附加overlay,而指令则负责设定overlay的附加部分。在使用中,服务的场景和需求并不常见,而指令成为了我更常用的工具。
以at-ui源码为例,展示了如何创建Overlay内容,并通过_atOrigin作为触发点。在实际项目中,通常需要注入elementRef来监听hover、click和contextmenu事件,以实现多种触发方式。这些事件对应不同的操作模式,通过Demo可以直观体验。
关于为何不直接在按钮DOM上创建dropdown内容,讨论了几个不理想之处。代码解释比文字说明更直观,特地提供了一篇更深入的教程链接。文章内容虽相对简略,但希望读者能从中有所启发和收获。
求angularjs select2写的下拉树形列表源码,类似于附件里的结构
使用group by 去进行分组。这个像sql语句一样的
<select ng-model="selected" ng-options="(m.productColor + ' - ' + m.productName) group by m.mainCategory for m in model">
<option value="">-- 请选择 --</option>
</select>
什么是 Angular Ahead-of-time (AOT) compilation
Ahead-of-time (AOT) 编译是 Angular 框架的关键特性,它在构建阶段将 TypeScript 和模板转换为高效的 JavaScript 和 HTML,显著提升性能。AOT 编译在构建过程中的完成避免了运行时模板解析,从而加速启动和提高性能。
AOT 编译通过在构建阶段解析、类型检查和优化源代码实现。此过程在应用程序部署前进行,确保在浏览器加载时无需进行模板解析和编译,带来更快的启动速度和更好的性能。
AOT 编译的核心步骤包括模板解析、类型检查和代码优化。它通过静态编译模板,加快了启动时间,减小了应用程序体积,提供了更早的错误检测和更高安全性,以及更好的性能。
与 Just-in-time (JIT) 编译相比,AOT 编译优势明显。JIT 编译在运行时动态编译模板,导致启动延迟,增加应用程序体积,易受潜在模板注入攻击,并影响性能,因为它需要在运行时执行模板编译和解析。
在 Angular 项目中采用 AOT 编译相对简单。基本步骤包括配置构建过程以触发 AOT 编译,并在 dist 目录生成编译后的文件。
使用 AOT 编译时需注意几点,包括避免模板注入、确保组件与服务正确连接、注意错误处理和优化代码。示例中,一个简单的 Angular 组件在 AOT 编译中被转换为静态可执行的 JavaScript 代码,显示用户名字和电子邮件地址,这表明模板解析和编译已提前完成。
总结而言,AOT 编译是优化 Angular 项目的关键工具,通过提高性能、减小体积、增强安全性和提供更早错误检测,特别适用于大型和移动应用程序。理解和实施 AOT 编译,能够显著提升用户体验,无论开发的企业级应用还是轻量级移动应用。
angular如何集成monaco-editor
在进行前端开发时,如果需要集成高级代码编辑器,monaco-editor是一个理想的选择。本文将分享如何在Angular环境中成功集成monaco-editor,并解释其背后的原理和不同集成方式。基础配置
通常,第三方库通过npm安装并导入即可使用。然而,monaco-editor因其动态加载模块支持多种语言的特性,需要特殊处理。monaco-editor提供AMD和ESM两种包格式,它们的区别如下:AMD:异步加载模块标准,适合浏览器和异步加载场景,用define和require实现,可能需要额外的RequireJS库支持。
ESM:ECMAScript模块标准,静态加载,import和export操作,现代浏览器和Node.js原生支持,无需额外库。
Angular集成
根据monaco-editor的包类型,Angular的集成方式分为两种:AMD方式:在angular.json中配置资源路径,通过service管理模块加载。可以使用@monaco-editor/loader简化这一过程,它能从CDN获取或配置为本地资源。
ESM方式:使用webpack进行配置,推荐使用@angular-builders/custom-webpack或ngx-build-plus,官方提供了monaco-editor-webpack-plugin,但个人建议避免直接操作webpack配置。
另一种选择是使用封装好的组件库,如nz-zorro-antd的实验性code editor组件,它内含monaco-editor的实现,无需自己编写代码,可以直接查看其源码。总结
本文分享了将monaco-editor融入Angular项目的详细步骤,无论是AMD还是ESM方式,都涉及了必要的配置和最佳实践。希望这些信息对您的项目集成有所帮助。Angular 组件库 NG-NEST 源码解析:Button 组件
NG-NEST 介绍
讲解项目源码结构时,我们提过单个组件的文件架构,现在深入解析下 Button 组件内部实现。
功能分析
先看 Button 组件能提供的核心功能。
主题颜色
设置主题颜色时,我们仅需定义 type 参数。
参数定义
type 参数设在 button.property.ts 文件内,用于定义输入参数并指定为 XButtonType 的联合类型,初始值为 "initial"。
具体定义与使用情况
在 button.component.ts 文件中,setClassMap() 函数中指定了根据 type 生成的样式属性,并通过 ngClass 映射样式。
SCSS 样式定义
参数与样式的关联在 button.component.scss 文件中实现,通过 @include 输出 @mixin 的混入样式。
@mixin 定义在 style/mixin.scss 内,如 button-type 定义了基于不同参数的不同按钮样式。
样式复用
利用 @mixin 实现不同主题颜色样式的便捷复用,提高代码的可维护性和一致性。
总结
Button 组件主题颜色功能实现清晰明了:利用 type 参数定义样式名,SCSS 文件中具体定义样式。通过 button.property.ts 和 button.component.ts 文件的协同工作,组件属性清晰明了,便于后续的维护与优化。
组件属性分离策略提升代码可维护性,且能够自动生成官方 API 文档中的属性说明文档。组件主要围绕样式设计,对主题样式有深入了解的开发者应进一步探索其余功能的详细实现。
Angular router.resetConfig() 对路由复用策略的影响
在公司内部组件库中遇到一个在切换导航时,滚动条总是重置到顶部的问题。经过初步排查,发现组件重新渲染导致了滚动条重置现象。通过研究Angular的Router组件,了解到默认情况下,重复导航到同一路由通常不会重新渲染。问题的关键在于路由复用策略RouteReuseStrategy的实现中,特别是其中的shouldReuseRoute()函数。默认策略中,判断要切换的路由与当前路由的routeConfig对象是否相同,从而决定是否重用组件。在我们的案例中,推测是因为future.routeConfig对象引用发生变化,导致组件重新渲染。进一步排查发现,一个模块的构造函数中调用了Router.resetConfig()函数,导致了routeConfig引用的改变。查看resetConfig源码得知,该函数会递归重新赋值所有路由的routeConfig。问题的根本在于Module构造函数中频繁调用resetConfig,引发生产环境项目未出现该问题的原因在于使用了路由懒加载。为解决此问题,提出两个解决方案:避免在Module构造函数中调用router.resetConfig,或实现自定义路由复用策略。总结整个问题流程,关键在于路由懒加载与resetConfig的不当使用导致组件不必要的重新渲染。为了避免此类问题,应当谨慎控制模块的引入时机,以及路由配置的重新生成次数,确保组件渲染效率与用户体验。