# UI 自动化规范
# 概述
此规范只用于平台的 UI 自动化测试所用,且与平台整合性较强,整个元素定位以id属性做为定位点。
# 全名规范
# 基本要求
- 文件编码统一使用 UTF-8 编码;
- 命名时以符合语义为主要参考指标,CSS 属性书写规范,采用统一风格及命名方法;
- 结构清晰,层级关系明朗,以不超过三级为标准;
- 同一表现形式的样式要求可重复利用,模块组件类的样式要求可整体外部移植;
- 编写 CSS 的时候,应当避免使用 CSS Hack,能不用则不用。
- 所有页面默认都针对 Firefox 等最接近标准的浏览器进行设计,然后使用 IE 特有条件注释功能进行针对性修正。
- 请使用英文进行命名,尽量避免使用拼音。命名要求具有可读性,尽量避免使用缩写。命名虽然允许数字,但应尽量避免使用数字命名。
# 元素全名
命名规则:
a_主语_含义_动作
如表单:
表单:a-form
用户表单:a-form-user
用户更新表单:a-form-user-update
如字段:
用户姓名字段:a-input-username
用户密码字段:a-input-password
# 元素主语
| 元素 | 标识 | 备注 |
|---|---|---|
| 头 | header | |
| 内容 | content/container | |
| 尾 | footer | |
| 导航 | nav | |
| 侧栏 | sidebar | |
| 栏目 | column | |
| 页面外围控制整体布局宽度 | wrapper | |
| 左右中 | left right center | |
| 登录条 | loginbar | |
| 标志 | logo | |
| 广告 | banner | |
| 页面主体 | main | |
| 热点 | hot | |
| 新闻 | news | |
| 下载 | download | |
| 子导航 | subnav | |
| 菜单 | menu | |
| 子菜单 | submenu | |
| 搜索 | search | |
| 友情链接 | friendlink | |
| 页脚 | footer | |
| 版权 | copyright | |
| 滚动 | scroll | |
| 内容 | content | |
| 标签页 | tab | |
| 文章列表 | list | |
| 提示信息 | msg | |
| 小技巧 | tips | |
| 栏目标题 | title | |
| 加入 | joinus | |
| 指南 | guild | |
| 服务 | service | |
| 注册 | regsiter | |
| 状态 | status | |
| 投票 | vote | |
| 合作伙伴 | partner |
# 元素主语
| 元素 | 名称 | 备注 |
|---|---|---|
| a | 定义锚 | |
| abbr | 定义缩写 | |
| acronym | 定义只取首字母的缩写 | |
| address | 定义文档作者或拥有者的联系信息 | |
| applet | 不赞成使用定义嵌入的 applet | |
| area | 定义图像映射内部的区域 | |
| article | 定义文章 | |
| aside | 定义页面内容之外的内容 | |
| audio | 定义声音内容 | |
| b | 定义粗体字 | |
| base | 定义页面中所有链接的默认地址或默认目标 | |
| basefont | 不赞成使用定义页面中文本的默认字体、颜色或尺寸 | |
| bdi | 定义文本的文本方向,使其脱离其周围文本的方向设置 | |
| bdo | 定义文字方向 | |
| big | 定义大号文本 | |
| blockquote | 定义长的引用 | |
| body | 定义文档的主体 | |
| br | 定义简单的折行 | |
| button | 定义按钮 (push button) | |
| canvas | 定义图形 | |
| caption | 定义表格标题 | |
| center | 不赞成使用定义居中文本 | |
| cite | 定义引用(citation) | |
| code | 定义计算机代码文本 | |
| col | 定义表格中一个或多个列的属性值 | |
| colgroup | 定义表格中供格式化的列组 | |
| command | 定义命令按钮 | |
| datalist | 定义下拉列表 | |
| dd | 定义定义列表中项目的描述 | |
| del | 定义被删除文本 | |
| details | 定义元素的细节 | |
| dir | 不赞成使用定义目录列表 | |
| div | 定义文档中的节 | |
| dfn | 定义定义项目 | |
| dialog | 定义对话框或窗口 | |
| dl | 定义定义列表 | |
| dt | 定义定义列表中的项目 | |
| em | 定义强调文本 | |
| embed | 定义外部交互内容或插件 | |
| fieldset | 定义围绕表单中元素的边框 | |
| figcaption | 定义 figure 元素的标题 | |
| figure | 定义媒介内容的分组,以及它们的标题 | |
| font | 不赞成使用定义文字的字体、尺寸和颜色 | |
| footer | 定义 section 或 page 的页脚 | |
| form | 定义供用户输入的 HTML 表单 | |
| frame | 定义框架集的窗口或框架 | |
| frameset | 定义框架集 | |
| h1 to h6 | 定义 HTML 标题,可以改变标题的大小 | |
| head | 定义关于文档的信息 | |
| header | 定义 section 或 page 的页眉 | |
| hr | 定义水平线 | |
| html | 定义 HTML 文档 | |
| i | 定义斜体字 | |
| iframe | 定义内联框架 | |
| img | 定义图像 | |
| input | 定义输入控件 | |
| ins | 定义被插入文本 | |
| isindex | 不赞成使用定义与文档相关的可搜索索引 | |
| kbd | 定义键盘文本 | |
| keygen | 定义生成密钥 | |
| label | 定义 input 元素的标注 | |
| legend | 定义 fieldset 元素的标题 | |
| li | 定义列表的项目 | |
| link | 定义文档与外部资源的关系 | |
| map | 定义图像映射 | |
| mark | 定义有记号的文本 | |
| menu | 定义菜单列表 | |
| meta | 定义关于 HTML 文档的元信息 | |
| meter | 定义预定义范围内的度量 | |
| nav | 定义导航链接 | |
| noframes | 定义针对不支持框架的用户的替代内容 | |
| noscript | 定义针对不支持客户端脚本的用户的替代内容 | |
| object | 定义内嵌对象 | |
| ol | 定义有序列表 | |
| optgroup | 定义选择列表中相关选项的组合 | |
| option | 定义选择列表中的选项 | |
| output | 定义输出的一些类型 | |
| p | 定义段落 | |
| param | 定义对象的参数 | |
| pre | 定义预格式文本 | |
| progress | 定义任何类型的任务的进度 | |
| q | 定义短的引用 | |
| rp | 定义若浏览器不支持 ruby 元素显示的内容 | |
| rt | 定义 ruby 注释的解释 | |
| ruby | 定义 ruby 注释 | |
| s | 定义加删除线的文本 | |
| samp | 定义计算机代码样本 | |
| script | 定义客户端脚本 | |
| section | 定义 section | |
| select | 定义选择列表(下拉列表) | |
| small | 定义小号文本 | |
| source | 定义媒介源 | |
| span | 定义文档中的节 | |
| strike | 不赞成使用定义加删除线文本 | |
| strong | 定义强调文本 | |
| style | 定义文档的样式信息 | |
| sub | 定义下标文本 | |
| summary | 为 <details> 元素定义可见的标题 | |
| sup | 定义上标文本 | |
| table | 定义表格 | |
| tbody | 定义表格中的主体内容 | |
| td | 定义表格中的单元 | |
| textarea | 定义多行的文本输入控件 | |
| tfoot | 定义表格中的表注内容(脚注) | |
| th | 定义表格中的表头单元格 | |
| thead | 定义表格中的表头内容 | |
| time | 定义日期/时间 | |
| title | 定义文档的标题 | |
| tr | 定义表格中的行 | |
| track | 定义用在媒体播放器中的文本轨道 | |
| tt | 定义打字机文本 | |
| u | 定义下划线文本 | |
| ul | 定义无序列表 | |
| var | 定义文本的变量部分 | |
| video | 定义视频 | |
| wbr | 定义视频 | |
| xmp | 定义预格式文本 |
# 动作
| 动作 | 标识 | 备注 |
|---|---|---|
| 添加 | add | |
| 保存 | save | |
| 移除 | remove | |
| 删除 | delete | |
| 修改 | modify | |
| 更新 | update | |
| 查询 | find |
# 工具
<a href="#" >元素命名规范</a>
← 编码的基本规范 MySQL运维及开发规范 →