CSS验证器的用户手册

目录

如何使用CSS验证器

使用验证器来验证一个CSS文档最简单的方法就是用基本界面。这里你会发现3种不同的页面,对应有3种不同的界面:

通过URL的Response来验证

只需要指定一个你需要验证的文档的URL就可以验证该文档这个文档可以是HTML或者CSS文件

Validation by URI form

通过上传文件来验证

这个方法允许你上传然后验证你上传的文件。点击“浏览...”按钮,然后选择一个你的机器上的要进行验证的文件就可以进行验证

Validation by File Upload

这种情况下,只允许使用CSS文档,也就是说,你不能上传HTML格式的文件。你还需要注意的一点是@import属性。只有当他们是一个明确的公开的URL的时候才会被验证(也就是说,不要使用相对路径)。

通过直接输入的内容来验证

这个方法目的是为了测试一段CSS的代码。你只需要在文本输入框中输入你的CSS代码就可以了。

Validation by direct input

和上一种方法一样需要注意只能使用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.