FLEX(UI)开发规范.docx

FLEX(UI)开发规范1.1 整体框架规范1.1.1 目录规范每一个目录对应一个大的功能模块，此目录下的子包应该对应每一个功能，如果有更细小的功能分支则继续放置旗下以封装好的子包形式出现，以此类推。其规则就是要有集成和封装的性质，这样，代码的编写以及维护等阶段都会显得很有条理。1.1.2 布局样式规范经过反复尝试和经验的积累，我们得到了很多准确和成熟的比例以及精准的长宽数值，这些数值使得我们的页面满足在任何大于1024*768 分辨率的情形下，都可以正常展现预想的效果。1.2 文件命名规范1.2.1 文件扩展名Mxml ： .mxmlActionScript: .asCss: .css1.2.2 文件名首先不能包含空格、标点和特殊符号1.2.2.1 ActionScript类和接口使用开头字母大写的驼峰式命名，例：ExampleClassName接口总是以一个大写字母I开头，例：IExampleInterface报名(includes)使用开头字母小写的驼峰式命名命名空间使用开头字母小写的驼峰式命名，例：myNameSpace1.2.2.2 MXML总是使用开头字母大写的驼峰式命名 1.2.3 编码所有文件都必须使用UTF-8编码1.3 ActionScript文件1.3.1 import(引用)使用完整的引用名，不要使用星号（*），除非使用了包的绝大部分推荐使用：import mx.core.Application 避免使用 import mx.core.*1.3.2 变量声明每行只有一个声明。正确的：var a:int = 10 ;var b:int = 10 ;错误的：var a:int = 10 ;var b:int = 10 ;尽量对变量进行初始化，如果一些变量的初始值在方法调用中付给则不需要初始化。即使是默认值也要初始化。正确的：public var isAdmin:Boolean = false;错误的:public var isAdmin:Boolean; /Boolean型变量的默认值是false变量的声明放在代码块开始的位置，除非是在循环中。1.3.3 注释1.3.3.1 文档注释文档注释是指在每个类、接口、变量、方法以及元标签等定义前面放置的一段注释，文档注释的作用是，让那些将要使用这些定义的人能更好的了解定义的作用，而无需去研究代码。例：/*LinkButton 仿IE超链接 样式： color:字体颜色 textDecoration:下线划（无：normal,有:underline） textRollOverColor:鼠标滑过时字的颜色 textSelectedColor:鼠标按下时字的颜色，即被选中时的颜色 */1.3.3.2 执行注释/鼠标悬浮在字上override protected function rollOverHandler(event:MouseEvent):voidsuper.rollOverHandler(event);if (_linkable)super.setStyle(textDecoration, underline);/显示下划线super.setStyle(textRollOverColor, #FF0000);/设置鼠标滑过时的字体颜色1.4 MXML文件以XML文件头开头1.4.1 命名一般规则 缩写：应尽量避免使用缩写，除非是那些缩写形式更常用于它的全称的缩写（例如URL, HTML等）。工程名可以是用缩写，如果他就是叫那个名字。只使用AscII字符，不包括重音符号（）、空格、标点和特殊字符；不要使用FlexSDK中预留的关键字命名（像mx包中的Application、DataGrid等），也不要使用FlashPlayer中预留的关键字（像Flash包中的IOError、 Bitmap等）既然在MXML中编写代码与在ActionScript中一样容易，在MXML中的命名规则也和ActionScript中是一样的（举例来说，一个MXML就像一个ActionScript类，其内部的组件和变量等同于属性）1.4.2 注释1.4.2.1 文档