CSS验证器的用户手册
目录
如何使用CSS验证器
使用验证器来验证一个CSS文档最简单的方法就是用基本界面。这里你会发现3种不同的页面,对应有3种不同的界面:
通过URL的Response来验证
只需要指定一个你需要验证的文档的URL就可以验证该文档这个文档可以是HTML或者CSS文件
通过上传文件来验证
这个方法允许你上传然后验证你上传的文件。点击“浏览...”按钮,然后选择一个你的机器上的要进行验证的文件就可以进行验证
这种情况下,只允许使用CSS文档,也就是说,你不能上传HTML格式的文件。你还需要注意的一点是@import属性。只有当他们是一个明确的公开的URL的时候才会被验证(也就是说,不要使用相对路径)。
通过直接输入的内容来验证
这个方法目的是为了测试一段CSS的代码。你只需要在文本输入框中输入你的CSS代码就可以了。
和上一种方法一样需要注意只能使用CSS的代码并且只能使用绝对的URL路径。这种方法在你的某一段CSS代码有问题希望得到解决的时候非常有用,也非常方便。在报告某个bug的时候也很简单,因为你可以将验证结果的URL给我们。
基本验证都作了什么工作?
当使用基本界面的时候,验证器会和CSS2的标准(目前最新的标准)进行比较,
你会看到一个XHTML格式的Error输出(不会包括警告)。
媒介会设定到使用所有的设备媒介(对于媒介的描述请参考
http://www.w3.org/TR/CSS2/media.html)。
高级验证
如果你需要一个更精确的验证,你可以使用高级验证界面,在高级验证界面中你可以设定三个参数,下面是对每个参数的简单说明。
Warnings
这个参数对控制CSS验证器的输出很有用。事实上,验证器能给出两种消息:错误和警告。错误是当被检查的CSS不符合CSS标准的要求的时候产生的,警告和错误不同,它不是说和标准不符合的问题,它们只是用来警告CSS的开发人员,某些CSS代码在不同的客户端上可能会有导致奇怪动作的危险。
一个典型的警告就是使用了font-family的时候:如果你不是提供一个通用字体,你将会得到一个警告,告诉你应该在最后添加一个通用字体,否则某个客户端上可能不能识别你所设定的字体,从而转为该客户端的默认字体。而这样可能会导致一个很奇怪的显示内容。
配置
CSS验证器可以检查不同的CSS配置。所谓的配置列出了一系列某一个特定平台上的的特性。配置本身的定义可以参考 CSS站点 。默认的选择就是当前最常用的 CSS 2.1标准.
媒介
这个参数就等同于@media规则,适用于所有的文档。你可以在 http://www.w3.org/TR/CSS2/media.html 找到更多的关于媒介的资料。
写给专家的话
验证请求的URL格式
下面是某个发送给W3C的CSS验证服务器的URL请求中的参数列表
如果你想使用W3C的公开验证服务器,使用下面的参数,连接在下面基本URI之后来组织一个URL:
http://jigsaw.w3.org/css-validator/validator
(将地址替换成你自己的服务器地址也可以)。
注意: 如果你想这样在程序中调用验证器来验证一批文档,那么请一定在你的程序中设定每两次验证之间间隔 至少1秒。CSS验证服务是给所有人免费的服务,大家会感谢你对公共资源的尊重。
参数 | 说明 | 默认值 |
---|---|---|
uri | 等待被验证的文档的URL 。CSS或者HTML都可以 | 没有。但是这个参数和下面的text 参数,至少有一个不为空。 |
text | 被验证的CSS代码片断,只允许CSS代码 | 没有。但是这个参数和上面的uri 参数,至少有一个不为空。 |
usermedium | 指定用于被验证的媒介(medium),例如screen ,
print , braille ... |
all |
output | 设定验证器输出结果的格式。可能的格式有:
text/html and html (XHTML document,
Content-Type: text/html),
application/xhtml+xml and xhtml (XHTML
document, Content-Type: application/xhtml+xml),
application/soap+xml and soap12 (SOAP 1.2
document, Content-Type: application/soap+xml),
text/plain and text (text document,
Content-Type: text/plain),
everything else (XHTML document, Content-Type: text/plain)
|
html |
profile | 设定用于验证比较的标准CSS配置文件。可以是
css1 , css2 , css21 ,
css3 , svg , svgbasic ,
svgtiny , mobile , atsc-tv ,
tv or none |
最新的W3C标准: CSS 2 |
lang | 输出结果的语言,目前支持en ,
fr , it , ko , ja , es ,
zh-cn , nl , de . |
English (en ). |
warning | 警告的级别:no 表示没有警告, 0
精简的警告信息, 1 或者 2 详细警告信息
|
2 |
CSS验证器的Web Service API: SOAP 1.2 验证接口文档
更多的技术帮助,特别是SOAP1.2的输出,以及所有可能调用验证的方法,请参考 CSS 验证器 Web Service API.