W3C home > Mailing lists > Public > public-svg-wg@w3.org > October to December 2012

svg2: ACTION-3377: Make SVGDocument into an alias for document

From: SVG Working Group repository <cam@mcc.id.au>
Date: Thu, 11 Oct 2012 13:44:24 -0700
Message-Id: <hg.14feb8d4af67.1349988264.3034738116371802840@ps58493.dreamhostps.com>
To: public-svg-wg@w3.org
details:   https://svgwg.org/hg/svg2/rev/14feb8d4af67
changeset: 392:14feb8d4af67
user:      Erik Dahlstr?m <ed@opera.com>
date:      Thu Oct 11 22:43:09 2012 +0200
ACTION-3377: Make SVGDocument into an alias for document

Also removed the URL property since it's already defined in
Document, http://www.w3.org/TR/2012/WD-dom-20120405/#interface-document.


 master/definitions.xml |   1 +
 master/struct.html     |  62 ++++++++++---------------------------------------
 2 files changed, 14 insertions(+), 49 deletions(-)

diffs (141 lines):

diff --git a/master/definitions.xml b/master/definitions.xml
--- a/master/definitions.xml
+++ b/master/definitions.xml
@@ -1334,16 +1334,17 @@
   <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 .......................................................... -->
   <term name='compound selector' href='http://dev.w3.org/csswg/selectors4/#compound'/>
   <term name='compound selectors' href='http://dev.w3.org/csswg/selectors4/#compound'/>
   <term name='filter primitive element' href='https://dvcs.w3.org/hg/FXTF/raw-file/tip/filters/index.html#TermFilterPrimitiveElement'/>
   <term name='filter primitive elements' href='https://dvcs.w3.org/hg/FXTF/raw-file/tip/filters/index.html#TermFilterPrimitiveElement'/>
   <term name='tree order' href='http://www.w3.org/TR/2012/WD-dom-20120405/#concept-tree-order'/>
   <term name='InvalidAccessError' href='http://www.w3.org/TR/2012/WD-dom-20120405/#invalidaccesserror'/>
diff --git a/master/struct.html b/master/struct.html
--- a/master/struct.html
+++ b/master/struct.html
@@ -2056,66 +2056,39 @@ of <span class="attr-name">'xlink:lang'<
     discussion <a href="text.html#WhiteSpace">white space
     handling</a> in SVG.</p>
     <p>New content should use the <a>'white-space'</a> property instead.</p>
 <h2 id="DOMInterfaces">DOM interfaces</h2>
-<h3 id="InterfaceSVGDocument">Interface SVGDocument</h3>
-<p>When an <a>'svg'</a> element is embedded inline as
-a component of a document from another namespace, such as when an
-<a>'svg'</a> element is embedded inline within an
-XHTML document [<a href="refs.html#ref-XHTML">XHTML</a>], then an
-<a>SVGDocument</a> object will not exist; instead, the root object in
-the document object hierarchy will be a Document object of a different
-type, such as an HTMLDocument object.
-<p>However, an <a>SVGDocument</a> object will indeed exist when the
-root element of the XML document hierarchy is an
-<a>'svg'</a> element, such as when viewing a stand-alone SVG file (i.e., a
-file with MIME type "image/svg+xml"). In this case, the <a>SVGDocument</a>
-object will be the root object of the document object model hierarchy.
-<p>In the case where an SVG document is embedded by reference,
-such as when an XHTML document has an <span class="element-name">'object'</span>
+<h3 id="InterfaceSVGDocument">Interface Document</h3>
+<p>The DOM Core specification defines a <a>Document</a> interface, which this specification extends.</p>
+<p class="note">In the case where an SVG document is embedded by reference,
+such as when an HTML document has an <span class="element-name">'object'</span>
 element whose <span class="attr-name">'href'</span> attribute references an SVG
 document (i.e., a document whose MIME type is "image/svg+xml"
 and whose root element is thus an <a>'svg'</a> element), there will exist
 two distinct DOM hierarchies. The first DOM hierarchy will be for the
 referencing document (e.g., an XHTML document). The second DOM hierarchy
-will be for the referenced SVG document.  In this second DOM hierarchy, the
-root object of the document object model hierarchy is an
-<a>SVGDocument</a> object.
+will be for the referenced SVG document.
-<p>The <a>SVGDocument</a> interface contains a similar list of attributes
-and methods to the HTMLDocument interface described in the
-<a href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-html.html">Document
-Object Model (HTML) Level 1</a> chapter of the
-[<a href="refs.html#ref-DOM1">DOM1</a>] specification.
-<p class="issue">We shouldn't be shadowing URL from Document, we should just inherit it.
-HTML defines title, referrer and domain.</p>
-<pre class="idl">interface <b>SVGDocument</b> : <a>Document</a> {
+<p class="issue">HTML defines title, referrer and domain.</p>
+<p>For historical reasons, <a>Window</a> objects must also have a writable, configurable,
+non-enumerable property named SVGDocument whose value is the <a>Document</a> interface object.</p>
+<pre class="idl">partial interface <a>Document</a> {
   readonly attribute DOMString <a href="struct.html#__svg__SVGDocument__title">title</a>;
   readonly attribute DOMString <a href="struct.html#__svg__SVGDocument__referrer">referrer</a>;
   readonly attribute DOMString <a href="struct.html#__svg__SVGDocument__domain">domain</a>;
-  readonly attribute DOMString <a href="struct.html#__svg__SVGDocument__URL">URL</a>;
   readonly attribute <a class="idlinterface" href="struct.html#InterfaceSVGSVGElement">SVGSVGElement</a> <a href="struct.html#__svg__SVGDocument__rootElement">rootElement</a>;
 };</pre><dl class="interface">
 <dt class="attributes-header">Attributes:</dt>
 <dl class="attributes">
 <dt id="__svg__SVGDocument__title" class="attribute first-child"><b>title</b><span class="idl-type-parenthetical"> (readonly DOMString)</span></dt>
 <dd class="attribute">
@@ -2141,36 +2114,27 @@ link, but, for example, via a bookmark).
 <dd class="attribute">
 The domain name of the server that served the document, or a null string
 if the server cannot be identified by a domain name.
-<dt id="__svg__SVGDocument__URL" class="attribute"><b>URL</b><span class="idl-type-parenthetical"> (readonly DOMString)</span></dt>
-<dd class="attribute">
-The complete URI of the document.
 <dt id="__svg__SVGDocument__rootElement" class="attribute"><b>rootElement</b><span class="idl-type-parenthetical"> (readonly <a class="idlinterface" href="struct.html#InterfaceSVGSVGElement">SVGSVGElement</a>)</span></dt>
 <dd class="attribute">
 The root <a>'svg'</a> in the document hierarchy.
 <h3 id="InterfaceSVGSVGElement">Interface SVGSVGElement</h3>
 <edit:with element='svg'>
 <p>A key interface definition is the <a>SVGSVGElement</a> interface,
 which is the interface that corresponds to the <a>'svg'</a> element. This
Received on Thursday, 11 October 2012 20:45:37 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:20:16 UTC