Flex最佳做法[二]

原文地址：http://www.adobe.com/cn/devnet/flex/articles/best_practices_pt2_02.html

MXML 编码标准

1. 组织元素属性
2. 将 ID 属性放在第一个属性位置
3. 将相关属性归入同一行
4. 将相关属性分组
5. 使用空行组织 MXML
6. 组织 MXML 文档

Flex 的 CSS 编码标准

1. 避免内联 CSS
2. 最小化和清理 CSS
3. 将类似的样式定义分组
4. 注释样式
5. 将 CSS 声明限制为每行一个
6. 尽可能使用类选择器而不是类型选择器
7. 为类选择器名称使用 lowerCamelCase (第一个词的首字母小写, 后面每个词的首字母大写)
8. 避免在类选择器名称中使用下划线
9. 避免根据外观命名类选择器
10. 使用一致的命名系统

为 ASDoc 注释 ActionScript 源代码

1. 遵循使用的标准 ASDoc 注释格式
2. 使用空格和前导星号提高注释的可读性
3. 使用受支持的 HTML 对 ASDoc 输出进行格式化
4. 为主要描述编写完整而简洁的第一句
5. 为每个类创建实用的注释
6. 使用 @private 对 ASDoc 隐藏类
7. 如果方法包含返回类型, 则使用 @return
8. 将 @see 用于存在关系的项目
9. 不要在 ASDoc 注释中使用特殊字符
10. 注释文本应当始终在任何 @ 标记之前
11. 描述变量的使用方式
12. 为所有方法和接口创建实用注释
13. 为事件类型使用标准类路径