- From: SVG Working Group repository <cam+svgwgrepo@mcc.id.au>
- Date: Wed, 05 Jun 2013 01:14:02 -0700
- To: public-svg-wg@w3.org
details: https://svgwg.org/hg/svg2/rev/3f2cabcb272e branches: changeset: 507:3f2cabcb272e user: Cameron McCormack <cam@mcc.id.au> date: Wed Jun 05 18:11:34 2013 +1000 description: Remove old DOM Level 2 Style related interfaces. diffstat: master/changes.html | 9 + master/definitions.xml | 5 - master/idlindex.html | 3 - master/painting.html | 30 ---- master/svgdom.html | 362 ------------------------------------------------- master/types.html | 349 +----------------------------------------------- 6 files changed, 10 insertions(+), 748 deletions(-) diffs (1073 lines): diff --git a/master/changes.html b/master/changes.html --- a/master/changes.html +++ b/master/changes.html @@ -77,16 +77,19 @@ have been made.</p> <li>Added constructors to <a>SVGNumber</a>, <a>SVGLength</a>, <a>SVGAngle</a> and <a>SVGRect</a>.</li> <li>Added <a href="types.html#__svg__SVGGraphicsElement__getStrokeBBox">getStrokeBBox</a> to get the tight stroke bounding box.</li> <li>Added base value accessors on <a>SVGAnimatedLength</a> and <a>SVGAnimatedLengthList</a> for each of the CSS length units supported.</li> <li>Make viewportElement and ownerSVGElement on <a>SVGElement</a> nullable.</li> + + <li><div class="added-since-last-wd">Removed the getPresentationAttribute + operation on <a>SVGElement</a> and the SVGColor and SVGICCColor interfaces.</div></li> </ul> <h3 id="structure">Document Structure chapter</h3> <ul> <li>Deprecated the <code>suspendRedraw</code>, <code>unsuspendRedraw</code> and <code>unsuspendRedrawAll</code> methods in the SVGSVGElement interface.</li> <li>Removed the <span class="attr-name">'externalResourcesRequired'</span> attribute.</li> @@ -161,16 +164,18 @@ have been made.</p> <li>Added <a>'vector-effect'</a> property to support non-scaling stroke.</li> <li>Add <a><gradient></a> as possible value for <a><paint></a></li> <li>Added arcs value on <a>'stroke-linejoin'</a>.</li> <li><div class="added-since-last-wd">Added the <span class="attr-value">'auto-start-reverse'</span> attribute to the <a>'marker/orient'</a> attribute on <a>'marker element'</a>.</div></li> + + <li><div class="added-since-last-wd">Removed the SVGPaint interface.</div></li> </ul> <h3 id="color">Color chapter</h3> <ul> <li>Added requirements for images to be color managed.</li> <li>Added new color syntaxes from the SVG Color specification: RGBA colors, HSL colors, @@ -258,16 +263,20 @@ have been made.</p> <ul> <li>Added text to require IDL fragments be interpreted as Web IDL.</li> <li>Removed some unnecessary text.</li> <li>Removed mention of read only nodes in the DOM, since that concept no longer exists in DOM4.</li> + + <li><div class="added-since-last-wd">Removed the table defining how properties + are exposed as specific types of CSSValue objects, since CSSValue has been + removed.</div></li> </ul> <h3 id="java">Java Language Binding appendix</h3> <ul> <li>Removed this appendix, as language bindings are now defined by Web IDL.</li> </ul> diff --git a/master/definitions.xml b/master/definitions.xml --- a/master/definitions.xml +++ b/master/definitions.xml @@ -1087,28 +1087,25 @@ <interface name='SVGNumber' href='types.html#InterfaceSVGNumber'/> <interface name='SVGAngle' href='types.html#InterfaceSVGAngle'/> <interface name='SVGMatrix' href='coords.html#InterfaceSVGMatrix'/> <interface name='SVGRect' href='types.html#InterfaceSVGRect'/> <interface name='SVGAnimatedRect' href='types.html#InterfaceSVGAnimatedRect'/> <interface name='SVGLength' href='types.html#InterfaceSVGLength'/> <interface name='SVGTransform' href='coords.html#InterfaceSVGTransform'/> <interface name='SVGStringList' href='types.html#InterfaceSVGStringList'/> - <interface name='SVGPaint' href='painting.html#InterfaceSVGPaint'/> <interface name='SVGTransformList' href='coords.html#InterfaceSVGTransformList'/> <interface name='SVGAnimatedTransformList' href='coords.html#InterfaceSVGAnimatedTransformList'/> <interface name='SVGGradientElement' href='pservers.html#InterfaceSVGGradientElement'/> <interface name='SVGAnimatedLengthList' href='types.html#InterfaceSVGAnimatedLengthList'/> <interface name='SVGAnimatedAngle' href='types.html#InterfaceSVGAnimatedAngle'/> <interface name='SVGAnimatedString' href='types.html#InterfaceSVGAnimatedString'/> <interface name='SVGNumberList' href='types.html#InterfaceSVGNumberList'/> <interface name='SVGAnimatedNumberList' href='types.html#InterfaceSVGAnimatedNumberList'/> <interface name='SVGLengthList' href='types.html#InterfaceSVGLengthList'/> - <interface name='SVGColor' href='types.html#InterfaceSVGColor'/> - <interface name='SVGICCColor' href='types.html#InterfaceSVGICCColor'/> <interface name='SVGGraphicsElement' href='types.html#InterfaceSVGGraphicsElement'/> <interface name='SVGGeometryElement' href='types.html#InterfaceSVGGeometryElement'/> <interface name='SVGTests' href='types.html#InterfaceSVGTests'/> <interface name='SVGURIReference' href='types.html#InterfaceSVGURIReference'/> <interface name='SVGCSSRule' href='types.html#InterfaceSVGCSSRule'/> <interface name='SVGRenderingIntent' href='types.html#InterfaceSVGRenderingIntent'/> <interface name='SVGAnimatedBoolean' href='types.html#InterfaceSVGAnimatedBoolean'/> <interface name='SVGUnitTypes' href='types.html#InterfaceSVGUnitTypes'/> @@ -1382,18 +1379,16 @@ <interface name='Comment' href='http://www.w3.org/TR/2012/WD-dom-20120405/#comment'/> <interface name='Element' href='http://www.w3.org/TR/2012/WD-dom-20120405/#element'/> <interface name='Node' href='http://www.w3.org/TR/2012/WD-dom-20120405/#node'/> <interface name='NodeList' href='http://www.w3.org/TR/2012/WD-dom-20120405/#nodelist'/> <interface name='DOMImplementation' href='http://www.w3.org/TR/2012/WD-dom-20120405/#domimplementation'/> <interface name='DOMException' href='http://www.w3.org/TR/2012/WD-dom-20120405/#exception-domexception'/> <interface name='CSSStyleDeclaration' href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-CSSStyleDeclaration'/> <interface name='CSSPrimitiveValue' href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-CSSPrimitiveValue'/> - <interface name='CSSValueList' href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-CSSValueList'/> - <interface name='CSSValue' href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-CSSValue'/> <interface name='CSSRule' href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-CSSRule'/> <interface name='ViewCSS' href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-ViewCSS'/> <interface name='RGBColor' href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-RGBColor'/> <interface name='AbstractView' href='http://www.w3.org/TR/DOM-Level-2-Views/views.html#Views-AbstractView'/> <interface name='EmbeddingElement' href='http://www.w3.org/TR/Window/#embeddingelt'/> <interface name='Window' href='http://www.w3.org/TR/2012/WD-html5-20120329/browsers.html#the-window-object'/> <!-- ... terms .......................................................... --> diff --git a/master/idlindex.html b/master/idlindex.html --- a/master/idlindex.html +++ b/master/idlindex.html @@ -41,17 +41,16 @@ <li><a>SVGAnimatedPreserveAspectRatio</a></li> <li><a>SVGAnimatedRect</a></li> <li><a>SVGAnimatedString</a></li> <li><a>SVGAnimatedTransformList</a></li> <li><a>SVGAnimationElement</a></li> <li><a>SVGCSSRule</a></li> <li><a>SVGCircleElement</a></li> <li><a>SVGClipPathElement</a></li> - <li><a>SVGColor</a></li> <li><a>SVGColorProfileElement</a></li> <li><a>SVGColorProfileRule</a></li> <li><a>SVGCursorElement</a></li> <li><a>SVGDefsElement</a></li> <li><a>SVGDescElement</a></li> <li><a>SVGDocument</a></li> <li><a>SVGElement</a></li> <li><a>SVGElementInstance</a></li> @@ -67,17 +66,16 @@ <li><a>SVGForeignObjectElement</a></li> <li><a>SVGGElement</a></li> <li><a>SVGGeometryElement</a></li> <li><a>SVGGlyphElement</a></li> <li><a>SVGGlyphRefElement</a></li> <li><a>SVGGradientElement</a></li> <li><a>SVGGraphicsElement</a></li> <li><a>SVGHKernElement</a></li> - <li><a>SVGICCColor</a></li> <li><a>SVGImageElement</a></li> <li><a>SVGLength</a></li> <li><a>SVGLengthList</a></li> <li><a>SVGLineElement</a></li> <li><a>SVGLinearGradientElement</a></li> <li><a>SVGMPathElement</a></li> <li><a>SVGMarkableElement</a></li> <li><a>SVGMarkerElement</a></li> @@ -87,17 +85,16 @@ <li><a>SVGMatrix</a></li> <li><a>SVGMeshGradientElement</a></li> <li><a>SVGMeshPatchElement</a></li> <li><a>SVGMeshRowElement</a></li> <li><a>SVGMetadataElement</a></li> <li><a>SVGMissingGlyphElement</a></li> <li><a>SVGNumber</a></li> <li><a>SVGNumberList</a></li> - <li><a>SVGPaint</a></li> <li><a>SVGPathElement</a></li> <li><a>SVGPathSeg</a></li> <li><a>SVGPathSegArcAbs</a></li> <li><a>SVGPathSegArcRel</a></li> <li><a>SVGPathSegClosePath</a></li> <li><a>SVGPathSegCurvetoCubicAbs</a></li> <li><a>SVGPathSegCurvetoCubicRel</a></li> <li><a>SVGPathSegCurvetoCubicSmoothAbs</a></li> diff --git a/master/painting.html b/master/painting.html --- a/master/painting.html +++ b/master/painting.html @@ -3922,46 +3922,16 @@ bounding box of the entire <a>'text'</a> <p class="caption">Both rectangles are filled with the same orange-to-yellow gradient.</p> </div> </div> </div> <h2 id="DOMInterfaces">DOM interfaces</h2> -<h3 id="InterfaceSVGPaint">Interface SVGPaint</h3> - - -<pre class="idl"> -interface SVGPaint : SVGColor { - - // Paint Types - const unsigned short SVG_PAINTTYPE_UNKNOWN = 0; - const unsigned short SVG_PAINTTYPE_RGBCOLOR = 1; - const unsigned short SVG_PAINTTYPE_RGBCOLOR_ICCCOLOR = 2; - const unsigned short SVG_PAINTTYPE_NONE = 101; - const unsigned short SVG_PAINTTYPE_CURRENTCOLOR = 102; - const unsigned short SVG_PAINTTYPE_URI_NONE = 103; - const unsigned short SVG_PAINTTYPE_URI_CURRENTCOLOR = 104; - const unsigned short SVG_PAINTTYPE_URI_RGBCOLOR = 105; - const unsigned short SVG_PAINTTYPE_URI_RGBCOLOR_ICCCOLOR = 106; - const unsigned short SVG_PAINTTYPE_URI = 107; - - readonly attribute unsigned short paintType; - readonly attribute DOMString uri; - - void setUri(DOMString uri); - void setPaint(unsigned short paintType, DOMString uri, DOMString rgbColor, DOMString iccColor); -}; -</pre> - -<p class="issue">There are some missing definitions of -SVGPaint members here. The interface might be going away, however.</p> - - <div class="ready-for-wider-review"> <h3 id="InterfaceSVGMarkerInstance">Interface SVGMarkerInstance</h3> <p>The <a>SVGMarkerInstance</a> interface is used to represent an instance of a marker that is on a <a>markable element</a>. An <a>SVGMarkerInstance</a> can represent any kind of marker, including <a>positioned markers</a>.</p> <p class="issue">What should we do about liveness? If it is live, we diff --git a/master/svgdom.html b/master/svgdom.html --- a/master/svgdom.html +++ b/master/svgdom.html @@ -383,394 +383,32 @@ function <code>MyActivateHandler</code>. <h2 id="RelationshipWithCSSOM">Relationship with DOM Level 2 CSS</h2> <p>The section describes the facilities from <a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html">DOM Level 2 CSS</a> ([<a href="refs.html#ref-DOM2STYLE">DOM2STYLE</a>], chapter 2) that are part of the SVG DOM.</p> -<h3 id="CSSDOMFeaturesNoCSSSupport">User agents that do not support styling with CSS</h3> - -<p>User agents that do not support <a href="styling.html#StylingWithCSS">styling with CSS</a> -are only required to support the following interfaces from -<a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html">DOM Level 2 CSS</a> -([<a href="refs.html#ref-DOM2STYLE">DOM2STYLE</a>], chapter 2), along with -any interfaces necessary to implement the interfaces, such as -<a>CSSPrimitiveValue</a> and <a>CSSValueList</a>. These interfaces are used in -conjunction with the <a>SVGElement::getPresentationAttribute</a> method call -on interface <a>SVGElement</a>, which must be supported on all implementations -of the SVG DOM.</p> - -<ul> - <li>Interface <a>RGBColor</a></li> - <li>Interface <a>CSSValue</a></li> -</ul> - <h3 id="CSSDOMFeaturesWithCSSSupport">User agents that support styling with CSS</h3> <p>User agents that support <a href="styling.html#StylingWithCSS">Styling with CSS</a>, the SVG DOM, and <a href="http://www.w3.org/TR/2011/REC-CSS2-20110607/aural.html">aural styling</a> ([<a href="refs.html#ref-CSS21">CSS21</a>], appendix A) must support all of the interfaces defined in <a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html">DOM Level 2 CSS</a> ([<a href="refs.html#ref-DOM2STYLE">DOM2STYLE</a>], chapter 2) which apply to aural properties.</p> <p>For <a href="http://www.w3.org/TR/2011/REC-CSS2-20110607/media.html#visual-media-group">visual media</a> ([<a href="refs.html#ref-CSS21">CSS21</a>], section 7.3.1), user agents must support all of the required interfaces defined in DOM Level 2 CSS. All of the interfaces that are optional for DOM Level 2 CSS are also optional for user agents implementing the SVG DOM.</p> -<h3 id="ExtendedInterfaces">Extended interfaces</h3> - -<p>Note: the <a>SVGElement::getPresentationAttribute</a> method and the interfaces that extend <a>CSSValue</a> are deprecated, and may be dropped from future versions of the SVG specification.</p> - -<p>Whether or not a user agent supports <a href="styling.html#StylingWithCSS">styling with CSS</a>, -a user agent still must support interface <a>CSSValue</a>, as this is the type -that is returned from the <a>SVGElement::getPresentationAttribute</a> -method call on interface <a>SVGElement</a>.</p> - -<p>DOM Level 2 CSS defines a set of -<a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-extended">extended interfaces</a> -([<a href="refs.html#ref-DOM2STYLE">DOM2STYLE</a>], section 2.3) for use in -conjunction with interface <a>CSSValue</a>. The table below specifies the type -of <a>CSSValue</a> used to represent each SVG property that applies to -<a href="http://www.w3.org/TR/2011/REC-CSS2-20110607/media.html#visual-media-group">visual media</a> -([<a href="refs.html#ref-CSS21">CSS21</a>], section 7.3.1). -The expectation is that the <a>CSSValue</a> returned from the -<span class="dom-method-name">getPropertyCSSValue</span> method on the -<a>CSSStyleDeclaration</a> interface or the <a>SVGElement::getPresentationAttribute</a> -method on the <a>SVGElement</a> interface can be cast down, using -binding-specific casting methods, to the specific derived interface.</p> - -<p>For properties that are represented by a custom interface -(the <span class='dom-attr-name'>cssValueType</span> of the <a>CSSValue</a> is CSS_CUSTOM), -the name of the derived interface is specified in the table. For these -properties, the table below indicates which extended interfaces -are mandatory and which are not.</p> - -<p>For properties that consist of lists of values (the -<span class='dom-attr-name'>cssValueType</span> of the <a>CSSValue</a> is -CSS_VALUE_LIST), the derived interface is <a>CSSValueList</a>. For all other -properties (the <span class='dom-attr-name'>cssValueType</span> of the <a>CSSValue</a> -is CSS_PRIMITIVE_VALUE), the derived interface is <a>CSSPrimitiveValue</a>.</p> - -<p>For shorthand properties, a <a>CSSValue</a> always will have a value -of null. Shorthand property values can only be accessed and modified as -strings.</p> - -<p>The SVG DOM defines the following SVG-specific custom property -interfaces, all of which are mandatory for SVG user agents:</p> - -<ul> - <li><a>SVGColor</a></li> - <li><a>SVGICCColor</a></li> - <li><a>SVGPaint</a></li> -</ul> - -<table class='vert property-table'> - <tr> - <th>Property Name</th> - <th>Representation</th> - <th>Mandatory?<br/>(Extended interfaces only)</th> - </tr> - <tr> - <td><a>'alignment-baseline'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'baseline-shift'</a></td> - <td>ident, length, percentage</td> - <td> </td> - </tr> - <tr> - <td><a>'clip'</a></td> - <td>rect, ident</td> - <td> </td> - </tr> - <tr> - <td><a>'clip-path'</a></td> - <td>uri, ident</td> - <td> </td> - </tr> - <tr> - <td><a>'clip-rule'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'color'</a></td> - <td>rgbcolor, ident</td> - <td> </td> - </tr> - <tr> - <td><a>'color-interpolation'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'color-rendering'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'cursor property'</a></td> - <td>uri, ident</td> - <td>no</td> - </tr> - <tr> - <td><a>'direction'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'display'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'dominant-baseline'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'enable-background'</a></td> - <td>list of idents and numbers</td> - <td> </td> - </tr> - <tr> - <td><a>'fill'</a></td> - <td><a>SVGPaint</a></td> - <td>yes</td> - </tr> - <tr> - <td><a>'fill-opacity'</a></td> - <td>number</td> - <td> </td> - </tr> - <tr> - <td><a>'fill-rule'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'filter property'</a></td> - <td>uri, ident</td> - <td> </td> - </tr> - <tr> - <td><a>'flood-color'</a></td> - <td><a>SVGColor</a></td> - <td>yes</td> - </tr> - <tr> - <td><a>'flood-opacity'</a></td> - <td>number</td> - <td> </td> - </tr> - <tr> - <td><a>'font property'</a></td> - <td>null</td> - <td> </td> - </tr> - <tr> - <td><a>'font-family'</a></td> - <td>list of strings and idents</td> - <td> </td> - </tr> - <tr> - <td><a>'font-size'</a></td> - <td>ident, length, percentage</td> - <td> </td> - </tr> - <tr> - <td><a>'font-size-adjust'</a></td> - <td>number, ident</td> - <td> </td> - </tr> - <tr> - <td><a>'font-stretch'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'font-style'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'font-variant'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'font-weight'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'glyph-orientation-horizontal'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'glyph-orientation-vertical'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'image-rendering'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'letter-spacing'</a></td> - <td>ident, length</td> - <td> </td> - </tr> - <tr> - <td><a>'lighting-color'</a></td> - <td><a>SVGColor</a></td> - <td>yes</td> - </tr> - <tr> - <td><a>'marker property'</a></td> - <td>null</td> - <td> </td> - </tr> - <tr> - <td><a>'marker-end'</a></td> - <td>uri, ident</td> - <td> </td> - </tr> - <tr> - <td><a>'marker-mid'</a></td> - <td>uri, ident</td> - <td> </td> - </tr> - <tr> - <td><a>'marker-start'</a></td> - <td>uri, ident</td> - <td> </td> - </tr> - <tr> - <td><a>'mask property'</a></td> - <td>uri, ident</td> - <td> </td> - </tr> - <tr> - <td><a>'opacity'</a></td> - <td>number</td> - <td> </td> - </tr> - <tr> - <td><a>'overflow'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'pointer-events'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'shape-rendering'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'stop-color'</a></td> - <td><a>SVGColor</a></td> - <td>yes</td> - </tr> - <tr> - <td><a>'stop-opacity'</a></td> - <td>number</td> - <td> </td> - </tr> - <tr> - <td><a>'stroke'</a></td> - <td><a>SVGPaint</a></td> - <td>yes</td> - </tr> - <tr> - <td><a>'stroke-dasharray'</a></td> - <td>ident or list of lengths</td> - <td> </td> - </tr> - <tr> - <td><a>'stroke-dashoffset'</a></td> - <td>length</td> - <td> </td> - </tr> - <tr> - <td><a>'stroke-linecap'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'stroke-linejoin'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'stroke-miterlimit'</a></td> - <td>length</td> - <td> </td> - </tr> - <tr> - <td><a>'stroke-opacity'</a></td> - <td>number</td> - <td> </td> - </tr> - <tr> - <td><a>'stroke-width'</a></td> - <td>length</td> - <td> </td> - </tr> - <tr> - <td><a>'text-anchor'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'text-decoration'</a></td> - <td>list of ident</td> - <td> </td> - </tr> - <tr> - <td><a>'text-rendering'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'unicode-bidi'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'visibility'</a></td> - <td>ident</td> - <td> </td> - </tr> - <tr> - <td><a>'word-spacing'</a></td> - <td>length, ident</td> - <td> </td> - </tr> - <tr> - <td><a>'writing-mode'</a></td> - <td>ident</td> - <td> </td> - </tr> -</table> - <h2 id="InvalidValues">Invalid values</h2> <p>If a script sets a DOM attribute to an invalid value (e.g., a negative number for an attribute that requires a non-negative number or an out-of-range value for an enumeration), unless this specification indicates otherwise, no exception shall be raised on setting, but the given document fragment shall become technically <em>in error</em> as described in diff --git a/master/types.html b/master/types.html --- a/master/types.html +++ b/master/types.html @@ -296,19 +296,17 @@ attributes, including presentation attri below, or one of the system color keywords listed in <a href='http://www.w3.org/TR/2011/REC-CSS2-20110607/ui.html#system-colors'>System Colors</a> ([<a href='refs.html#ref-CSS21'>CSS21</a>], section 18.2).</p> <p>The corresponding SVG DOM interface definitions for <color> are defined in <a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html">Document Object Model CSS</a>; in particular, see <a>RGBColor</a> - ([<a href='refs.html#ref-DOM2STYLE'>DOM2STYLE</a>], section 2.2). - SVG's extension to color, including the ability to specify ICC-based colors, - are represented using DOM interface <a>SVGColor</a>.</p> + ([<a href='refs.html#ref-DOM2STYLE'>DOM2STYLE</a>], section 2.2).</p> </dd> <dt id="DataTypeFrequency"><frequency></dt> <dd> <p>Frequency values are used with aural properties. As defined in CSS 2.1, a frequency value is a <number> immediately followed by a frequency unit identifier. The frequency unit identifiers are:</p> @@ -342,19 +340,16 @@ attributes, including presentation attri <dt id='DataTypeICCColor'><icccolor></dt> <dd> <p>An <icccolor> is an ICC color specification. In SVG 1.1, an ICC color specification is given by a name, which references a <a>'color-profile element'</a> element, and one or more color component values. The grammar is as follows:</p> <pre class='grammar'><span id='ICCColor'>icccolor</span> ::= "icc-color(" author-ident (<a href='#CommaWSP'>comma-wsp</a> <a href='#Number'>number</a>)+ ")"</pre> - - <p>The corresponding SVG DOM interface for <icccolor> is - <a>SVGICCColor</a>.</p> </dd> <dt id='DataTypeImage'><image></dt> <dd> <p> An image source (including gradients) as defined by CSS Level 4 Image Values ([<a href='refs.html#ref-CSS4IMAGES'>CSS4IMAGES</a>], section 4.3). </p> @@ -552,19 +547,16 @@ number-optional-number ::= <a href='#Dat <dt id="DataTypePaint"><paint></dt> <dd> <p>The values for properties <a>'fill'</a> and <a>'stroke'</a> are specifications of the type of paint to use when filling or stroking a given graphics element. The available options and syntax for <paint> are described in <a href="painting.html#SpecifyingPaint">Specifying paint</a>.</p> - - <p>Within the SVG DOM, <paint> values are represented using - <a>SVGPaint</a> objects.</p> </dd> <dt id="DataTypePercentage"><percentage></dt> <dd> <p>Percentages are specified as a number followed by a "%" character:</p> <pre class='grammar'><span id='Percentage'>percentage</span> ::= <a href='#Number'>number</a> "%"</pre> @@ -1452,18 +1444,16 @@ we can use directly for that.</p> <pre class="idl">interface <b>SVGElement</b> : <a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-745549614">Element</a> { attribute DOMString <a href="types.html#__svg__SVGElement__id">id</a>; attribute DOMString <a href="types.html#__svg__SVGElement__xmlbase">xmlbase</a>; readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedString">SVGAnimatedString</a> <a href="types.html#__svg__SVGElement__className">className</a>; readonly attribute <a class="idlinterface" href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-CSSStyleDeclaration">CSSStyleDeclaration</a> <a href="types.html#__svg__SVGElement__style">style</a>; - <a class="idlinterface" href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-CSSValue">CSSValue</a> <a href="types.html#__svg__SVGElement__getPresentationAttribute">getPresentationAttribute</a>(DOMString name); - attribute DOMString <a href="types.html#__svg__SVGElement__xmllang">xmllang</a>; attribute DOMString <a href="types.html#__svg__SVGElement__xmlspace">xmlspace</a>; readonly attribute <a class="idlinterface" href="struct.html#InterfaceSVGSVGElement">SVGSVGElement</a>? <a href="types.html#__svg__SVGElement__ownerSVGElement">ownerSVGElement</a>; readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>? <a href="types.html#__svg__SVGElement__viewportElement">viewportElement</a>; };</pre> <dl class="interface"> @@ -1528,50 +1518,16 @@ we can use directly for that.</p> <div> The element which established the current viewport. Often, the nearest ancestor <a>'svg'</a> element. Null if the given element is the <a>outermost svg element</a>. </div> </dd> </dl> </dd> - - <dt class="operations-header">Operations:</dt> - <dd> - <dl class="attributes"> - <dt id="__svg__SVGElement__getPresentationAttribute" class="operation first-child"><a class="idlinterface" href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-CSSValue">CSSValue</a> <b>getPresentationAttribute</b>(DOMString <var>name</var>)</dt> - <dd class="operation"> - <p>Returns the base (i.e., static) value of a given <a>presentation - attribute</a> as an object of type <a>CSSValue</a>. The returned object - is live; changes to the objects represent immediate changes to the - objects to which the <a>CSSValue</a> is attached.</p> - - <p>Note: The <code>getPresentationAttribute</code> method is deprecated, - and may be dropped from future versions of the SVG specification.</p> - - <dl class="operation"> - <dt class="parameters-header">Parameters</dt> - <dd> - <ol class="parameters"> - <li class="parameter first-child"> - <div>DOMString <var>name</var></div> - <div>The name of the presentation attribute whose value is to be returned.</div> - </li> - </ol> - </dd> - <dt class="returns-header">Returns</dt> - <dd> - <div>The static/base value of the given <a>presentation attribute</a> - as a <a>CSSValue</a>, or null if the given attribute does not have a - specified value.</div> - </dd> - </dl> - </dd> - </dl> - </dd> </dl> <h3 id="InterfaceSVGAnimatedBoolean">Interface SVGAnimatedBoolean</h3> <p>Used for attributes of type boolean which can be animated.</p> <pre class="idl">interface <b>SVGAnimatedBoolean</b> { @@ -3786,319 +3742,16 @@ the attribute is not animated. </div> </dd> </dl> </dd> </dl> -<h3 id="InterfaceSVGColor">Interface SVGColor</h3> - - - -<p>The <a>SVGColor</a> interface corresponds to color value definition for -properties <a>'stop-color'</a>, <a>'flood-color'</a> and -<a>'lighting-color'</a> and is a base class for interface <a>SVGPaint</a>. -It incorporates SVG's extended notion of color, which incorporates -ICC-based color specifications. -</p> - - -<p>Interface <a>SVGColor</a> does <em>not</em> correspond to the -<a href="types.html#DataTypeColor"><color></a> basic data type. For -the <a href="types.html#DataTypeColor"><color></a> basic data type, -the applicable DOM interfaces are defined in -<a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/">DOM Level 2 Style</a>; -in particular, see the <a>RGBColor</a> interface -([<a href="refs.html#ref-DOM2STYLE">DOM2STYLE</a>], section 2.2). -</p> - - -<p>Note: The <a>SVGColor</a> interface is deprecated, and may be dropped -from future versions of the SVG specification. -</p> -<pre class="idl">interface <b>SVGColor</b> : <a class="idlinterface" - href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-CSSValue">CSSValue</a> { - - // Color Types - const unsigned short <a href="types.html#__svg__SVGColor__SVG_COLORTYPE_UNKNOWN">SVG_COLORTYPE_UNKNOWN</a> = 0; - const unsigned short <a href="types.html#__svg__SVGColor__SVG_COLORTYPE_RGBCOLOR">SVG_COLORTYPE_RGBCOLOR</a> = 1; - const unsigned short <a href="types.html#__svg__SVGColor__SVG_COLORTYPE_RGBCOLOR_ICCCOLOR">SVG_COLORTYPE_RGBCOLOR_ICCCOLOR</a> = 2; - const unsigned short <a href="types.html#__svg__SVGColor__SVG_COLORTYPE_CURRENTCOLOR">SVG_COLORTYPE_CURRENTCOLOR</a> = 3; - - readonly attribute unsigned short <a href="types.html#__svg__SVGColor__colorType">colorType</a>; - readonly attribute <a class="idlinterface" - href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-RGBColor">RGBColor</a> <a href="types.html#__svg__SVGColor__rgbColor">rgbColor</a>; - readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGICCColor">SVGICCColor</a> <a href="types.html#__svg__SVGColor__iccColor">iccColor</a>; - - void <a href="types.html#__svg__SVGColor__setRGBColor">setRGBColor</a>(DOMString rgbColor); - void <a href="types.html#__svg__SVGColor__setRGBColorICCColor">setRGBColorICCColor</a>(DOMString rgbColor, DOMString iccColor); - void <a href="types.html#__svg__SVGColor__setColor">setColor</a>(unsigned short colorType, DOMString rgbColor, DOMString iccColor); -};</pre><dl class="interface"> -<dt class="constants-header">Constants in group “Color Typesâ€:</dt> -<dd> -<dl class="constants"> - -<dt id="__svg__SVGColor__SVG_COLORTYPE_UNKNOWN" class="constant first-child"><b>SVG_COLORTYPE_UNKNOWN</b><span class="idl-type-parenthetical"> (unsigned short)</span></dt> -<dd class="constant"> -<div> -The color type is not one of predefined types. It is invalid to attempt -to define a new value of this type or to attempt to switch an existing -value to this type. - - -</div> -</dd> - -<dt id="__svg__SVGColor__SVG_COLORTYPE_RGBCOLOR" class="constant"><b>SVG_COLORTYPE_RGBCOLOR</b><span class="idl-type-parenthetical"> (unsigned short)</span></dt> -<dd class="constant"> -<div> -An sRGB color has been specified without an alternative ICC color -specification. - - -</div> -</dd> - -<dt id="__svg__SVGColor__SVG_COLORTYPE_RGBCOLOR_ICCCOLOR" class="constant"><b>SVG_COLORTYPE_RGBCOLOR_ICCCOLOR</b><span class="idl-type-parenthetical"> (unsigned short)</span></dt> -<dd class="constant"> -<div> -An sRGB color has been specified along with an alternative ICC color -specification. - - -</div> -</dd> - -<dt id="__svg__SVGColor__SVG_COLORTYPE_CURRENTCOLOR" class="constant"><b>SVG_COLORTYPE_CURRENTCOLOR</b><span class="idl-type-parenthetical"> (unsigned short)</span></dt> -<dd class="constant"> -<div> -Corresponds to when keyword <span class="attr-value">currentColor</span> -has been specified. - - -</div> -</dd> -</dl> -</dd> -<dt class="attributes-header">Attributes:</dt> -<dd> -<dl class="attributes"> - -<dt id="__svg__SVGColor__colorType" class="attribute first-child"><b>colorType</b><span class="idl-type-parenthetical"> (readonly unsigned short)</span></dt> -<dd class="attribute"> -<div> -The type of the value as specified by one of the SVG_COLORTYPE_* -constants defined on this interface. - -</div> -</dd> - -<dt id="__svg__SVGColor__rgbColor" class="attribute"><b>rgbColor</b><span class="idl-type-parenthetical"> (readonly <a class="idlinterface" - href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-RGBColor">RGBColor</a>)</span></dt> -<dd class="attribute"> -<div> -The color specified in the sRGB color space. - -</div> -</dd> - -<dt id="__svg__SVGColor__iccColor" class="attribute"><b>iccColor</b><span class="idl-type-parenthetical"> (readonly <a class="idlinterface" href="types.html#InterfaceSVGICCColor">SVGICCColor</a>)</span></dt> -<dd class="attribute"> -<div> -The alternate ICC color specification. - -</div> -</dd> -</dl> -</dd> -<dt class="operations-header">Operations:</dt> -<dd> -<dl class="attributes"> - -<dt id="__svg__SVGColor__setRGBColor" class="operation first-child">void <b>setRGBColor</b>(DOMString <var>rgbColor</var>) -</dt> -<dd class="operation"> -<div> -Modifies the color value to be the specified sRGB color without an -alternate ICC color specification. - - -</div> -<dl class="operation"> -<dt class="parameters-header">Parameters</dt> -<dd> -<ol class="parameters"> -<li class="parameter first-child"> -<div>DOMString <var>rgbColor</var></div> -<div> A string that matches <a href="types.html#DataTypeColor"><color></a>, -which specifies the new sRGB color value. - -</div> -</li> -</ol> -</dd> -<dt class="exceptions-header">Exceptions</dt> -<dd> -<dl class="exceptions"> -<dt class="exception first-child"><a>SyntaxError</a> -</dt> -<dd class="exception"> Raised if <var>rgbColor</var> -does not match <a href="types.html#DataTypeColor"><color></a>. - -</dd> -</dl> -</dd> -</dl> -</dd> - -<dt id="__svg__SVGColor__setRGBColorICCColor" class="operation">void <b>setRGBColorICCColor</b>(DOMString <var>rgbColor</var>, DOMString <var>iccColor</var>) -</dt> -<dd class="operation"> -<div> -Modifies the color value to be the specified sRGB color with an -alternate ICC color specification. - - -</div> -<dl class="operation"> -<dt class="parameters-header">Parameters</dt> -<dd> -<ol class="parameters"> -<li class="parameter first-child"> -<div>DOMString <var>rgbColor</var></div> -<div> A string that matches <a href="types.html#DataTypeColor"><color></a>, -which specifies the new sRGB color value. - -</div> -</li> -<li class="parameter"> -<div>DOMString <var>iccColor</var></div> -<div> A string that matches <a href="types.html#DataTypeICCColor"><icccolor></a>, -which specifies the alternate ICC color specification. - -</div> -</li> -</ol> -</dd> -<dt class="exceptions-header">Exceptions</dt> -<dd> -<dl class="exceptions"> -<dt class="exception first-child"><a>SyntaxError</a> -</dt> -<dd class="exception"> Raised if <var>rgbColor</var> -does not match <a href="types.html#DataTypeColor"><color></a> -or if <var>iccColor</var> does not match -<a href="types.html#DataTypeICCColor"><icccolor></a>. - -</dd> -</dl> -</dd> -</dl> -</dd> - -<dt id="__svg__SVGColor__setColor" class="operation">void <b>setColor</b>(unsigned short <var>colorType</var>, DOMString <var>rgbColor</var>, DOMString <var>iccColor</var>) -</dt> -<dd class="operation"> -<div> -Sets the color value as specified by the parameters. If -<var>colorType</var> requires an <a>RGBColor</a>, then -<var>rgbColor</var> must be a string that matches -<a href="types.html#DataTypeColor"><color></a>; -otherwise, <var>rgbColor</var>. must be null. If <var>colorType</var> -requires an <a>SVGICCColor</a>, then <var>iccColor</var> must be a string -that matches <a href="types.html#DataTypeICCColor"><icccolor></a>; -otherwise, <var>iccColor</var> must be null. - - -</div> -<dl class="operation"> -<dt class="parameters-header">Parameters</dt> -<dd> -<ol class="parameters"> -<li class="parameter first-child"> -<div>unsigned short <var>colorType</var></div> -<div> One of the defined constants for <a>colorType</a>. - -</div> -</li> -<li class="parameter"> -<div>DOMString <var>rgbColor</var></div> -<div> The specification of an sRGB color, or null. - -</div> -</li> -<li class="parameter"> -<div>DOMString <var>iccColor</var></div> -<div> The specification of an ICC color, or null. - -</div> -</li> -</ol> -</dd> -<dt class="exceptions-header">Exceptions</dt> - <dd> - <dl class="exceptions"> - <dt class="exception first-child"><a>InvalidAccessError</a></dt> - <dd class="exception">Raised if the colorType parameter has an invalid value.</dd> - <dt class="exception"><a>SyntaxError</a></dt> - <dd class="exception">Raised if the rgbColor or iccColor parameter has an invalid value.</dd> - </dl> -</dd> -</dl> -</dd> -</dl> -</dd> -</dl> - - -<h3 id="InterfaceSVGICCColor">Interface SVGICCColor</h3> - - - -<p>The <a>SVGICCColor</a> interface expresses an ICC-based color -specification. -</p> - - -<p>Note: The <a>SVGICCColor</a> interface is deprecated, and may be dropped -from future versions of the SVG specification. -</p> -<pre class="idl">interface <b>SVGICCColor</b> { - attribute DOMString <a href="types.html#__svg__SVGICCColor__colorProfile">colorProfile</a>; - readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGNumberList">SVGNumberList</a> <a href="types.html#__svg__SVGICCColor__colors">colors</a>; -};</pre><dl class="interface"> -<dt class="attributes-header">Attributes:</dt> -<dd> -<dl class="attributes"> - -<dt id="__svg__SVGICCColor__colorProfile" class="attribute first-child"><b>colorProfile</b><span class="idl-type-parenthetical"> (DOMString)</span></dt> -<dd class="attribute"> -<div> -The name of the color profile, which is the first parameter of an ICC -color specification. - - -</div> -</dd> - -<dt id="__svg__SVGICCColor__colors" class="attribute"><b>colors</b><span class="idl-type-parenthetical"> (readonly <a class="idlinterface" href="types.html#InterfaceSVGNumberList">SVGNumberList</a>)</span></dt> -<dd class="attribute"> -<div> -The list of color values that define this ICC color. Each color value -is an arbitrary floating point number. - -</div> -</dd> -</dl> -</dd> -</dl> - - <h3 id="InterfaceSVGRect">Interface SVGRect</h3> <p>Represents rectangular geometry. Rectangles are defined as consisting of a (x,y) coordinate pair identifying a minimum X value, a minimum Y value, and a width and height, which are usually constrained to be non-negative.</p> <p id="ReadOnlyRect">An <a>SVGRect</a> object can be designated as <em>read only</em>,
Received on Wednesday, 5 June 2013 08:14:32 UTC