width

« SVG属性参考主页

该属性在用户坐标系统中标识了一个水平长度。该坐标的确切效果依赖于每个元素。大多数时候,它体现引用元素的矩形区域的宽度(请阅读每个元素的文档以了解例外情况)。

除了<svg>元素之外,别的元素都必须指定该属性,<svg>的宽度默认是100%,而<filter>元素以及<mask>元素的默认宽度是120%

用法

类别
<length>
可变性 Yes
规范文档 SVG 1.1 (2nd Edition): foreignObject element
SVG 1.1 (2nd Edition): image element
SVG 1.1 (2nd Edition): pattern element
SVG 1.1 (2nd Edition): rect element
SVG 1.1 (2nd Edition): svg element
SVG 1.1 (2nd Edition): use element
SVG 1.1 (2nd Edition): Filter primitive
SVG 1.1 (2nd Edition): mask element

<length>

一个长度是一个可度量的距离,给定一个数字以及一个单位。长度可以用两种方法指定。如果在样式表中使用它,可以如下定义<length>:

length ::= number (~"em" | ~"ex" | ~"px" | ~"in" | ~"cm" | ~"mm" | ~"pt" | ~"pc")?

请阅读CSS2规范 以了解单位标识符的意义。

在CSS2中定义的长度属性,必须提供单位标识符。而SVG专用属性的长度值以及它们对应的外观属性,长度单位标识符是可选的。如果没有提供单位标识符,长度值代表当前用户坐标系统中的一段距离。对于外观属性,无论是定义在SVG1.1还是定义在CSS2中,长度单位标识符必须是小写的。

如果是在SVG属性中使用长度,<length>需定义如下:

length ::= number ("em" | "ex" | "px" | "in" | "cm" | "mm" | "pt" | "pc" | "%")?

在这样的<length>值中,单位标识符必须是小写的。

注意,非属性<length>定义同样允许百分比单位标识符。这意味着一个百分比长度值依赖于被指定百分比长度值的属性。分两种情况:

  • 百分比长度值表达了一个视口宽度或高度的百分比;
  • 百分比长度值表达了一个一个给定对象上的边界盒的宽度或高度的百分比。

在SVG DOM中,<length>值可以用{domxref("SVGLength")}}对象或SVGAnimatedLength对象来表达。

元素

下列元素可以使用width属性:

文档标签和贡献者