1.Angular 组件库 NG-NEST 源码解析:Button 组件
2.[译] 关于 Angular 的城源变化检测,你需要知道的源码一切
3.浅谈 Angular 和 UI5 这两种前端框架里控件 ID 的设计思路差异
4.求angularjs select2写的下拉树形列表源码,类似于附件里的结构
5.angular如何集成monaco-editor
6.[Angular 组件库 NG-ZORRO 基础入门] - 源码初窥: core
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 的变化检测,你需要知道的一切
关于 Angular 的变化检测,你需要知道的一切
探究内部实现和具体用例
要全面了解 Angular 的变化检测机制,查看源码是不可或缺的步骤,因为网络上相关文章少之又少。大部分文章只涉及每个组件自身的变化检测器、不可变变量(immutable)和变化检测策略(change detection strategy)的概念,但缺乏深入剖析。本文旨在深入探讨不可变变量如何触发变化检测,以及变化监测策略对检测的影响。同时,你将能将这些知识应用到优化性能的场景中。
本文分为两部分,第一部分侧重于技术细节,包含大量源码链接。unbound源码下载我们基于 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 属性有多种可能的java 常用源码值,与本文相关的有:
如果ChecksEnabled 为 false 或视图状态为 Errored 或者 Destroyed,变化检测将跳过此视图及其所有子视图。默认情况下,所有视图均以 ChecksEnabled 作为初始值,除非使用了 ChangeDetectionStrategy.OnPush。
Angular 中有许多高级概念用于操作视图。在文章中已提及部分概念,如 ViewRef。它封装了组件视图并提供了一个名为 detectChanges 的方法,该方法会在异步事件触发时在最顶层的 ViewRef 上执行变化检测。最顶层的 ViewRef 执行变化检测后,会递归地对其子视图执行检测。
通过 ChangeDetectorRef 令牌将 viewRef 注入组件构造函数中,可以实现此操作:
从其定义可知这一点:
变化检测操作
执行变化检测的主要逻辑在 checkAndUpdateView 方法中,该方法主要针对子组件视图执行操作,并递归地调用此方法以遍历从宿主组件到所有组件的所有视图。这意味着,下一次递归中,子组件就成为了新的父组件。
执行变化检测的主要步骤如下:
有几个关键点需要注意:
首先,子组件在子视图被检测之前会触发onChanges 生命周期钩子,即使子视图的变化检测被跳过了。这一点至关重要,后续部分将展示如何利用这一点。
第二,当检测视图时,更新视图的 DOM 是变化检测机制的一部分。因此,如果组件未被检测,DOM 将不会更新,模板中的组件属性发生改变时也是如此。在第一次检测之前,模板已被渲染。这里所说的更新 DOM 指的是更新插值。例如,some { { name}},在第一次检测之前,已经将 DOM 元素 span 渲染好。检测过程中,只会渲染 { { name}} 部分。ruby 源码加密
另一个有趣的是,子组件视图的状态可以在变化检测过程中改变。所有组件视图默认初始化为 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 开始,左子树的所有组件都会被跳过(橙色的组件不会被检测):
需要注意的是,改变的viewpage源码解析是 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 和 UI5 这两种前端框架里控件 ID 的设计思路差异
在深入探讨Angular与UI5这两种前端框架时,我们关注的焦点在于控件ID的设计思路差异。尽管它们都是企业级前端应用开发的杰出框架,但Angular和UI5在设计理念与开发思路上存在显著差异,这在控件ID生成逻辑上尤为明显。
让我们以UI5为例,创建一个简单的Button控件。UI5的渲染器会生成HTML代码,其中控件ID遵循特定格式:控件名称前缀加上一个计数器。例如,Button控件ID前缀为"button",且ID生成时会考虑全局计数器,确保ID的独特性。
在UI5开发场景中,如何通过原生JavaScript触发UI5按钮控件的点击事件处理函数,是一个常见需求。对于这个问题,UI5会生成如下的HTML代码,其中三个Button控件ID分别为button0、button1和button2。UI5控件ID的格式清晰地体现了其前缀命名规则与计数机制。
UI5中,控件ID的前缀存储在元数据中,而全局计数器维护在字典数据结构中。创建UI5控件实例时,如未显式指定ID,则ID遵循上述规则生成。显式通过构造函数参数传入ID时,生成的HTML代码中的ID值不再包含前缀。
为了获取控件实例,UI5提供工具方法byId,它直接从全局注册表mElements中查询并返回对应实例,无需调用原生DOM APIdocument.getElementById。每个UI5控件实例在创建后都会被添加到此注册表中,从而提高了获取控件实例的效率。
在处理控件ID冲突时,UI5通过方法.ui.getCore().byId检测重复ID,如果发现重复则执行相应的处理逻辑。这是确保UI5控件ID唯一性的重要机制。
与UI5相比,Angular在视图设计上存在一个显著差异:Angular组件的视图实现于原生HTML文件中,而UI5则使用XML或JavaScript视图实现页面布局。这导致Angular组件HTML视图源代码与最终渲染的HTML源代码差异不大,没有UI5渲染器的概念。
例如,Commerce Cloud组织架构明细页面的HTML视图源代码与最终渲染的HTML源代码差异较小。而UI5的XML视图与最终渲染的HTML源代码差异巨大,因为渲染过程涉及复杂处理,包括根据OData注解进行的许多操作。这些差异反映了两种框架在视图设计与渲染逻辑上的不同。
在分配控件ID方面,Angular与UI5展现出不同策略。UI5倾向于为每个HTML元素分配一个不重复的ID,而Angular则通过结构化指令ng-template配合NgIf指令实现页面布局的条件渲染,ID标注通常更为灵活。
UI5的ViewFragment类似Angular的模板设计,可以作为容器包裹UI5控件,支持多个XML视图重用,进一步展示了两者在控件ID与视图设计上的差异。
综上所述,通过对比Angular与UI5在控件ID设计思路上的差异,我们能更深入理解这两种框架的独特之处。希望这些建议能为使用这两个前端框架的开发者提供有价值的观点。
求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如何集成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-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 的实践,开发者可以优化代码结构,提升组件复用性,同时保持代码的简洁性和易维护性。
2024-11-26 23:13
2024-11-26 22:45
2024-11-26 22:27
2024-11-26 22:04
2024-11-26 21:40
2024-11-26 21:29