Openbiz Web开发标准规范

### Openbiz Web开发标准规范详解 #### 规范概述 - **目标**：该文档旨在通过规范化的开发标准，确保Web项目的高效性、可维护性和扩展性。具体目标包括实现前端代码的高度重用，减少输出至客户端的CSS文件数量；后台文件组织遵循“高内聚低耦合”的原则，确保业务逻辑分离，便于后期维护和扩展。 #### CSS编码规范 - **代码排版约束**： - 每个样式名称单独占一行，以逗号结尾。 - 每行只包含一个CSS属性，并使用TAB进行缩进。 - 括号的开始和结束分别占据一行。 - 示例： ```css .content-blk, .content-block { color: #666666; font-size: 12px; font-weight: normal; border: 1px solid #efefef; } ``` - **代码属性使用规范**： - **尺寸单位使用规范**：统一使用绝对单位（像素px），避免使用相对单位（如pt、em）。 - **排版占位方式规范**：使用外层div的`padding`属性控制边距，避免使用`margin`属性。 - **文件路径引用规范**：使用相对路径引用站内图片资源。 - **颜色代码编写规范**：统一使用6位大写的十六进制色号。 - **排版边距预留规范**：遵循特定的比例和规则，确保与设计稿一致。 - **注释编写规范**： - 对于描述同一部件的一组CSS定义，需添加群组样式定义注释，以便于理解和维护。 #### XHTML编码规范 - **排版约束**：规定了XHTML文档的结构和元素使用规则，确保文档的语义化和易读性。 - **注释编写规范**：类似于CSS中的注释规范，用于增加XHTML文档的可读性和维护性。 - **TITLE标签使用规范**：确保每个页面都有一个描述性的`<title>`标签。 - **网页META编写规范**：定义了元信息标签的标准，包括关键词、描述等。 - **H1-H7标题标签规范**：规范了标题标签的使用，确保层次分明。 - **表格使用规范**：限制了表格的使用场景，鼓励使用更语义化的布局技术。 #### 文件结构命名规范 - **文件夹命名规范**：规定了文件夹的命名规则，便于管理和查找。 - **网页文件名命名规范**：明确了网页文件的命名标准，提高识别度。 - **图片文件名命名规范**：规定了图片文件的命名规则，便于管理和自动化处理。 #### 网站文件结构 - 描述了网站的整体文件结构，包括静态资源、动态脚本和配置文件等的组织方式。 #### 文件默认编码规范 - 规定了所有文件的默认字符编码，通常为UTF-8。 #### URL组织规范 - **多语言组织**：定义了多语言站点的URL结构，支持国际化。 - **内容栏目组织**：规范了内容栏目的URL结构，提高用户友好性和SEO优化。 #### 总结 通过这一系列详细的规范，Openbiz Web开发标准确保了项目的高质量输出。这些规范不仅覆盖了CSS和XHTML编码的具体细节，还涉及到了文件结构、URL组织等多个方面，为开发者提供了全面的指导。遵循这些规范，可以显著提升Web项目的质量、可维护性和扩展性，同时也有助于提高团队协作效率，降低沟通成本。