Angular - 风格指南

风格指南

如果你正在寻找关于 Angular 语法、约定和应用组织结构的官方指南,那你就来对了。 本风格指南介绍了提倡的约定,更重要的是,解释了为什么。

风格指南的用词

每个指导原则都会描述好的或者坏的做法,所有指导原则都用同样的风格描述。

指导原则中使用的词汇用来表明推荐的程度。

坚持意味着总是应该遵循的约定。 说"总是"可能显得有点绝对,应该"总是"遵循的指导原则非常少,不过,只有遇到极不寻常的情况才能打破坚持的原则。

考虑表示通常应该遵循的指导原则。 如果你能完全理解指导原则背后的含义,并且有很好的理由违反它,那就改吧。但是请保持一致。

避免表示你绝对不应该做的事。需要避免的代码范例会有明显的红色标题。

为何?会给出随后的建议的理由。

文件结构约定

在一些代码例子中,有的文件有一个或多个相似名字的配套文件。(例如 hero.component.tshero.component.html)。

本指南将会使用像 hero.component.ts|html|css|spec 的简写来表示上面描述的多个文件,目的是保持本指南的简洁性,增加描述文件结构时的可读性。

上次更新: : 9/26/2019, 4:20:09 PM