[giow] (2) Define the legacycaller behaviour of <embed> and <object>.

Affected topics: DOM APIs, HTML git-svn-id: http://svn.whatwg.org/webapps@6915 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Jan 25, 2012 · 2e03ad0 · 2e03ad0
1 parent f46cfd7
commit 2e03ad0
Show file tree

Hide file tree

Showing 3 changed files with 57 additions and 14 deletions.
diff --git a/complete.html b/complete.html
@@ -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 &mdash; Last Updated 24 January 2012</h2>
+    <h2 class="no-num no-toc">Living Standard &mdash; 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 @@ <h4 id=the-embed-element><span class=secno>4.8.3 </span>The <dfn><code>embed</co
            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 @@ <h4 id=the-embed-element><span class=secno>4.8.3 </span>The <dfn><code>embed</co
   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 @@ <h4 id=the-object-element><span class=secno>4.8.4 </span>The <dfn><code>object</
   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 @@ <h4 id=the-object-element><span class=secno>4.8.4 </span>The <dfn><code>object</
   <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>

diff --git a/index b/index
@@ -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 &mdash; Last Updated 24 January 2012</h2>
+    <h2 class="no-num no-toc">Living Standard &mdash; 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 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
            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 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
   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 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
   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 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
   <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>

diff --git a/source b/source
@@ -27501,6 +27501,7 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
            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 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
   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 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
   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 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
   <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">