top
关闭

开发者登录

空间动态模板技术规范

第三方自定义开发文档

为方便第三方的开发,保证开发过程中页面的完整、美化、及合理性,防止页面中CSS,JS文件和原有的文件发生冲突,特列出以下说明:

 

一、防止发生冲突注意事项

1. 对于自定义模块开发,在最外层必须带上一个有class名的div盒子,这样是为了在对子元素进行自定义的样式时,可以有一个父级倚靠,防止给子元素直接加样式引起和别的页面的样式冲突(如图示中<style>部分)。

2. 图示中的标签及样式的写法仅仅只是参考用,和页面实际表现无关。开发者可以根据自己的需求进行适当的修改和添加。但是弹出播放视频事件和预览相册事件是已固定了的。

3. 对于自定义的模块的样式书写,可以在行间直接写,也可以在用<style>写内嵌,只是在写内嵌时需注意把父级class命带上,但是禁止引及外联CSS文件和JS文件。

开发文档14692.png 

 

二、开发文件管理规范

1. 文夹命名规则:用简短有意义的英文或者拼音(不能出现中文)来命名,并需要全部小写。例如(emotions,mail);

2. 图片命名规则:第一个单词首写字母小写,之后每个单词首写字母大写,或者全部小写,单词间用下划线接连。例如(btn_sign.gif , bgTipBox.png);

3. JS和CSS的使用:由于开发项目的特殊性,原则上不能使用外联JS和CSS文件(在开发调试时,可以引用“<link href="http://css.huijiaoyun.cn/tianyu_edu_dev/common/css/public.css" rel="stylesheet" type="text/css" />”),在开发过程中,如需要新增CSS样式,可写行间样式或是根据提供的dome标准添加有限的class名。

 

三、开发者XHTML书写规范

1. 禁止要额外引用JS和CSS文件,如确实需要,可以写在行间和内嵌。(在开发调试时,可以引用“<link href="http://css.huijiaoyun.cn/tianyu_edu_dev/common/css/public.css" rel="stylesheet" type="text/css" />”);

2. 编码必须遵循w3c标准,标签、属性及属性命名必须由小写字母及下划线数字组成,且所有标签必须闭合;属性值必须用双引号包括;

3. 充分利用无兼容性问题的html自身标签,比如span,em,strong,label,等等;需要为html元素添加自定义属性的时候,首先要考虑下有没有默认的已有的合适标签去设置,如果没有,可以使用须以”data-”为前缀来添加自定义属性,避免使用”data:”等其他命名方式;

4. 语义化html,如标题根据重要性用h1~h6(同一页面只能有一个h1),段落标记用p,列表用ul,内联元素中不可嵌套块级元素;

5. 尽可能减少div嵌套;

6. 必须为含有描述性表单元素(input,textarea)添加label;

7. 能以背景形式呈现的图片,尽量写入CSS样式中;

8. 图片必须加上alt属性,并且需要使用绝对路径;给重要的元素和截断的元素加上title;

9. 不是标签一部分的特殊符号都用编码表示:比如<(<)&>(>)&空格()&?(?)等等;

10. 给区块代码及重要功能(比如循环)加上合理的注释,方便后台添加功能:注释格式,‘–-’只能在注释的始末位置,不能出现2个或2个以上的"--"。

 

四、Demo文档使用方法

文字大小

字号引用class名示例
12Class:f1212
14Class:1414
16Class:1616
18Class:1818



文字颜色
 

使用范围引用class名示例
超链接普通文字颜色Class:blue示例
网页,简介,说明等普通文字颜色Class:c555示例
网页标题,正文,重要提示等文字颜色Class:c222示例
特别提示,重要数据,价格等文字颜色Class:red示例




                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             

关闭

扫码登录更安全

手机扫码,安全登录

二维码已失效 请点击刷新
请打开家校帮扫一扫登录

手机扫码,安全登录

扫描成功!

请在手机上确认登录

取消二维码登录