- From: Anne van Kesteren <annevk@opera.com>
- Date: Sun, 05 Mar 2006 10:34:26 +0100
- To: "Web APIs WG (public)" <public-webapi@w3.org>
Here is some proposed text for section 4 on embedding, basically about window.name, window.parent, window.top and window.frameElement, to complete my action item: === The element that refers to another document that is then embedded is called the <dfn>referencing element</dfn>. The document the element points to is called the <dfn>child document</dfn>. Seen from the child document, the referencing element is part of the <dfn>parent document</dfn>. When a document has no referencing element that points to it the document is the <dfn>root element</dfn>. A document can be both a parent document and child document at the same time. <code>window.frameElement</code> from a child document MUST reflect the referencing element. <code>window.parent</code> MUST reflect the parent document Window object. <code>window.top</code> MUST reflect the root document Window object. If there is no referencing element, parent document or root document the attributes MUST be <code>null</code> respectively. <code>window.name</code> from a child document MUST initially reflect the name assigned by the referencing element. How this name is assigned is language specific. If there is no referencing element this attribute MUST be the empty string. The document itself can change its name by changing <code>window.name</code> to any arbitrary string. For example, if you have <object data="<var>file</var>" id="test"/> in an XHTML document the <code>window.name</code> DOM attribute within <var>file</var> will be "test" initially. === -- Anne van Kesteren <http://annevankesteren.nl/> <http://www.opera.com/>
Received on Sunday, 5 March 2006 09:34:42 UTC