Angular - 风格指南
风格指南
如果你正在寻找关于 Angular 语法、约定和应用组织结构的官方指南,那你就来对了。 本风格指南介绍了提倡的约定,更重要的是,解释了为什么。
风格指南的用词
每个指导原则都会描述好的或者坏的做法,所有指导原则都用同样的风格描述。
指导原则中使用的词汇用来表明推荐的程度。
坚持意味着总是应该遵循的约定。 说"总是"可能显得有点绝对,应该"总是"遵循的指导原则非常少,不过,只有遇到极不寻常的情况才能打破坚持的原则。
考虑表示通常应该遵循的指导原则。 如果你能完全理解指导原则背后的含义,并且有很好的理由违反它,那就改吧。但是请保持一致。
避免表示你绝对不应该做的事。需要避免的代码范例会有明显的红色标题。
为何?会给出随后的建议的理由。
文件结构约定
在一些代码例子中,有的文件有一个或多个相似名字的配套文件。(例如 hero.component.ts
和 hero.component.html
)。
本指南将会使用像 hero.component.ts|html|css|spec
的简写来表示上面描述的多个文件,目的是保持本指南的简洁性,增加描述文件结构时的可读性。