CSS模块的注释——页面重构中的模块化设计(六)
来源:互联网 发布:阿里云学生认证赚钱 编辑:程序博客网 时间:2024/04/28 06:32
从前面的内容我们已经知道,样式是可以分成各个模块去写的,如何表示各个模块的作用及它们之间的关系呢?CSS的注释是不二的选择。
与普通的注释不同,模块的注释需要一些更详细的内容,比如:功能说明、模块版本、关联信息等等。 像 《基类、扩展类──页面重构中的模块化设计(五)》 中例子的注释,显然是比较简单的。为了减少不必要的沟通,我们可以使用较为固定的格式去完成这个注释。
举个例子:
/** * @name:mode_name * @author:ghostzhang * @version:1.0 * @type:基类 * @explain:Demo */.mode_name{...}.mode_name h2{ ...}.mode_name .cont{ ...}/* @end **//** * @name:mode_name_b * @author:ghostzhang * @version:1.0 * @type:扩展类 * @explain:Demo * @dependent:mode_name */.mode_name_b{...}.mode_name_b h2{ ...}.mode_name_b .cont{ ...}/* @end **/
从注释中就可以知道mode_name_b和mode_name_a之间的关系。
主要的关键字有:
- @name
- 标明模块的名称
- @author
- 标明模块的作者
- @version
- 标明该模块的版本
- @explain
- 功能说明
- @relating
- 标明该关联的模块
- @dependent
- 标明该所依赖的模块
- @type
- 标明该模块的类型:公共、基类、扩展类
需要注意的规则:
- 以“/**”标记模块的开始
- 从“/**”到第一个“*/”作为模块相关信息的说明,包含关键字
- 关键字以 @ 开头,“:”后开始到“*”的内容为相关的值,即:
- @关键字:值*
- 以“/* @end **/”标记模块的结束
- 模块注释内不可嵌套
提供了一个小工具( cssModeCode )帮助大家填写样式模块的注释。
文章地址:http://www.cssforest.org/blog/index.php?id=168
- CSS模块的注释——页面重构中的模块化设计(六)
- 模块化的核心思想──页面重构中的模块化设计(四)
- 样式的作用域──页面重构中的模块化设计(一)
- 栏目级作用域──页面重构中的模块化设计(二)
- 继承──页面重构中的模块化设计(三)
- 基类、扩展类──页面重构中的模块化设计(五)
- 页面重构中的模块化思维
- 页面重构中的模块化思维
- js模块化之自定义模块(页面模块化加载)
- 模块化——高效重构
- 前端开发:模块化 — 高效重构
- 前端开发:模块化 — 高效重构
- 《重构:改善既有代码的设计》——关于代码注释的唠叨
- 重构-改善既有的代码设计(六)
- 重构-改善既有代码的设计读书笔记(六)
- CSS模块化设计——从空格谈起
- CSS模块化设计——从空格谈起
- 读ghost的页面模块化设计
- 栏目级作用域──页面重构中的模块化设计(二)
- 继承──页面重构中的模块化设计(三)
- Linux访问Windows远程桌面——rdesktop用法
- 模块化的核心思想──页面重构中的模块化设计(四)
- 基类、扩展类──页面重构中的模块化设计(五)
- CSS模块的注释——页面重构中的模块化设计(六)
- WEB系统架构设计经验分享
- jquery 动态创建元素
- 揭秘:Zoomla逐浪CMS系统使用教程
- QWebView中出现加载网页乱码、图片加载不出来的问题解决以级QMainWindow背景图片设置问题
- Linux Crontab 定时任务 命令详解
- android in practice_Share data by sharing Context
- jquery 获取指定元素
- C#如何定义全局变量