W3C home > Mailing lists > Public > public-webapi@w3.org > March 2006

ACTION-61: text for embedding part of the Window object

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>
Message-ID: <op.s5xovool64w2qv@id-c0020.oslo.opera.com>

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 &lt;object data="<var>file</var>" id="test"/&gt;  
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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:18:53 GMT