[html5] r6915 - [giow] (2) Define the legacycaller behaviour of <embed> and <object>. Affected t [...]
whatwg at whatwg.org
whatwg at whatwg.org
Wed Jan 25 14:49:05 PST 2012
Author: ianh
Date: 2012-01-25 14:49:03 -0800 (Wed, 25 Jan 2012)
New Revision: 6915
Modified:
complete.html
index
source
Log:
[giow] (2) Define the legacycaller behaviour of <embed> and <object>.
Affected topics: DOM APIs, HTML
Modified: complete.html
===================================================================
--- complete.html 2012-01-24 23:38:02 UTC (rev 6914)
+++ complete.html 2012-01-25 22:49:03 UTC (rev 6915)
@@ -240,7 +240,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 24 January 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 25 January 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -25574,6 +25574,7 @@
attribute DOMString <a href=#dom-embed-type title=dom-embed-type>type</a>;
attribute DOMString <a href=#dom-dim-width title=dom-dim-width>width</a>;
attribute DOMString <a href=#dom-dim-height title=dom-dim-height>height</a>;
+ <a href=#dom-embed-caller title=dom-embed-caller>legacycaller</a> any (any... arguments);
};</pre>
<div class=impl>
<p>Depending on the type of content instantiated by the
@@ -25775,10 +25776,14 @@
attributes of the <code><a href=#the-embed-element>embed</a></code> element that have no namespace
to the <a href=#plugin>plugin</a> used, when it is instantiated.</p>
- <p>If the <a href=#plugin>plugin</a> instantiated for the
- <code><a href=#the-embed-element>embed</a></code> element supports a scriptable interface, the
- <code><a href=#htmlembedelement>HTMLEmbedElement</a></code> object representing the element should
- expose that interface while the element is instantiated.</p>
+ <p>The <code><a href=#htmlembedelement>HTMLEmbedElement</a></code> object representing the element
+ must expose the scriptable interface of the <a href=#plugin>plugin</a>
+ instantiated for the <code><a href=#the-embed-element>embed</a></code> element. At a minimum, this
+ interface must implement the <dfn id=dom-embed-caller title=dom-embed-caller>legacy
+ caller operation</dfn>. (It is suggested that the default behavior
+ of this legacy caller operation, e.g. the behavior of the default
+ plugin's legacy caller operation, be to throw a
+ <code><a href=#notsupportederror>NotSupportedError</a></code> exception.)</p>
</div>
@@ -25863,6 +25868,8 @@
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidatity title=dom-cva-checkValidatity>checkValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
+
+ <a href=#dom-object-caller title=dom-object-caller>legacycaller</a> any (any... arguments);
};</pre>
<div class=impl>
<p>Depending on the type of content instantiated by the
@@ -26556,6 +26563,13 @@
<code title=dom-fae-form><a href=#dom-fae-form>form</a></code> IDL attribute is part of the
element's forms API.</p>
+ <p>All <code><a href=#the-object-element>object</a></code> elements have a <dfn id=dom-object-caller title=dom-object-caller>legacy caller operation</dfn>. If the
+ <code><a href=#the-object-element>object</a></code> element has an instantiated <a href=#plugin>plugin</a>
+ that supports a scriptable interface that defines a legacy caller
+ operation, then that must be the behavior of the object's legacy
+ caller operation. Otherwise, the object's legacy caller operation
+ must be to throw a <code><a href=#notsupportederror>NotSupportedError</a></code> exception.</p>
+
</div>
<div class=example>
Modified: index
===================================================================
--- index 2012-01-24 23:38:02 UTC (rev 6914)
+++ index 2012-01-25 22:49:03 UTC (rev 6915)
@@ -240,7 +240,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 24 January 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 25 January 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -25574,6 +25574,7 @@
attribute DOMString <a href=#dom-embed-type title=dom-embed-type>type</a>;
attribute DOMString <a href=#dom-dim-width title=dom-dim-width>width</a>;
attribute DOMString <a href=#dom-dim-height title=dom-dim-height>height</a>;
+ <a href=#dom-embed-caller title=dom-embed-caller>legacycaller</a> any (any... arguments);
};</pre>
<div class=impl>
<p>Depending on the type of content instantiated by the
@@ -25775,10 +25776,14 @@
attributes of the <code><a href=#the-embed-element>embed</a></code> element that have no namespace
to the <a href=#plugin>plugin</a> used, when it is instantiated.</p>
- <p>If the <a href=#plugin>plugin</a> instantiated for the
- <code><a href=#the-embed-element>embed</a></code> element supports a scriptable interface, the
- <code><a href=#htmlembedelement>HTMLEmbedElement</a></code> object representing the element should
- expose that interface while the element is instantiated.</p>
+ <p>The <code><a href=#htmlembedelement>HTMLEmbedElement</a></code> object representing the element
+ must expose the scriptable interface of the <a href=#plugin>plugin</a>
+ instantiated for the <code><a href=#the-embed-element>embed</a></code> element. At a minimum, this
+ interface must implement the <dfn id=dom-embed-caller title=dom-embed-caller>legacy
+ caller operation</dfn>. (It is suggested that the default behavior
+ of this legacy caller operation, e.g. the behavior of the default
+ plugin's legacy caller operation, be to throw a
+ <code><a href=#notsupportederror>NotSupportedError</a></code> exception.)</p>
</div>
@@ -25863,6 +25868,8 @@
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidatity title=dom-cva-checkValidatity>checkValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
+
+ <a href=#dom-object-caller title=dom-object-caller>legacycaller</a> any (any... arguments);
};</pre>
<div class=impl>
<p>Depending on the type of content instantiated by the
@@ -26556,6 +26563,13 @@
<code title=dom-fae-form><a href=#dom-fae-form>form</a></code> IDL attribute is part of the
element's forms API.</p>
+ <p>All <code><a href=#the-object-element>object</a></code> elements have a <dfn id=dom-object-caller title=dom-object-caller>legacy caller operation</dfn>. If the
+ <code><a href=#the-object-element>object</a></code> element has an instantiated <a href=#plugin>plugin</a>
+ that supports a scriptable interface that defines a legacy caller
+ operation, then that must be the behavior of the object's legacy
+ caller operation. Otherwise, the object's legacy caller operation
+ must be to throw a <code><a href=#notsupportederror>NotSupportedError</a></code> exception.</p>
+
</div>
<div class=example>
Modified: source
===================================================================
--- source 2012-01-24 23:38:02 UTC (rev 6914)
+++ source 2012-01-25 22:49:03 UTC (rev 6915)
@@ -27501,6 +27501,7 @@
attribute DOMString <span title="dom-embed-type">type</span>;
attribute DOMString <span title="dom-dim-width">width</span>;
attribute DOMString <span title="dom-dim-height">height</span>;
+ <span title="dom-embed-caller">legacycaller</span> any (any... arguments);
};</pre>
<div class="impl">
<p>Depending on the type of content instantiated by the
@@ -27741,10 +27742,14 @@
attributes of the <code>embed</code> element that have no namespace
to the <span>plugin</span> used, when it is instantiated.</p>
- <p>If the <span>plugin</span> instantiated for the
- <code>embed</code> element supports a scriptable interface, the
- <code>HTMLEmbedElement</code> object representing the element should
- expose that interface while the element is instantiated.</p>
+ <p>The <code>HTMLEmbedElement</code> object representing the element
+ must expose the scriptable interface of the <span>plugin</span>
+ instantiated for the <code>embed</code> element. At a minimum, this
+ interface must implement the <dfn title="dom-embed-caller">legacy
+ caller operation</dfn>. (It is suggested that the default behavior
+ of this legacy caller operation, e.g. the behavior of the default
+ plugin's legacy caller operation, be to throw a
+ <code>NotSupportedError</code> exception.)</p>
</div>
@@ -27832,6 +27837,8 @@
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidatity">checkValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(DOMString error);
+
+ <span title="dom-object-caller">legacycaller</span> any (any... arguments);
};</pre>
<div class="impl">
<p>Depending on the type of content instantiated by the
@@ -28615,6 +28622,14 @@
<code title="dom-fae-form">form</code> IDL attribute is part of the
element's forms API.</p>
+ <p>All <code>object</code> elements have a <dfn
+ title="dom-object-caller">legacy caller operation</dfn>. If the
+ <code>object</code> element has an instantiated <span>plugin</span>
+ that supports a scriptable interface that defines a legacy caller
+ operation, then that must be the behavior of the object's legacy
+ caller operation. Otherwise, the object's legacy caller operation
+ must be to throw a <code>NotSupportedError</code> exception.</p>
+
</div>
<div class="example">
More information about the Commit-Watchers
mailing list