[html5] r6310 - [e] (0) Add a placeholder for window.find(), pending a decision from the UAs tha [...]

whatwg at whatwg.org whatwg at whatwg.org
Tue Jul 19 12:33:23 PDT 2011


Author: ianh
Date: 2011-07-19 12:33:21 -0700 (Tue, 19 Jul 2011)
New Revision: 6310

Modified:
   complete.html
   index
   source
Log:
[e] (0) Add a placeholder for window.find(), pending a decision from the UAs that implement it.

Modified: complete.html
===================================================================
--- complete.html	2011-07-15 22:11:14 UTC (rev 6309)
+++ complete.html	2011-07-19 19:33:21 UTC (rev 6310)
@@ -239,7 +239,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>Web Applications 1.0</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 15 July 2011</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 19 July 2011</h2>
    </hgroup><dl><dt>Multiple-page version:</dt>
     <dd><a href=http://www.whatwg.org/specs/web-apps/current-work/complete/>http://www.whatwg.org/specs/web-apps/current-work/complete/</a></dd>
     <dt>One-page version:</dt>
@@ -1004,7 +1004,8 @@
      <li><a href=#redo:-moving-forward-in-the-undo-transaction-history><span class=secno>8.8.4 </span>Redo: moving forward in the undo transaction history</a></li>
      <li><a href=#the-undomanagerevent-interface-and-the-undo-and-redo-events><span class=secno>8.8.5 </span>The <code>UndoManagerEvent</code> interface and the <code title=event-undo>undo</code> and <code title=event-redo>redo</code> events</a></li>
      <li><a href=#implementation-notes><span class=secno>8.8.6 </span>Implementation notes</a></ol></li>
-   <li><a href=#editing-apis><span class=secno>8.9 </span>Editing APIs</a></ol></li>
+   <li><a href=#text-search-apis><span class=secno>8.9 </span>Text search APIs</a></li>
+   <li><a href=#editing-apis><span class=secno>8.10 </span>Editing APIs</a></ol></li>
  <li><a href=#video-conferencing-and-peer-to-peer-communication><span class=secno>9 </span>Video conferencing and peer-to-peer communication</a>
   <ol>
    <li><a href=#introduction-10><span class=secno>9.1 </span>Introduction</a></li>
@@ -1526,6 +1527,7 @@
    <li>Rules for <a href=#atom>converting HTML to Atom</a>.</li> <!--MD-->
    <li>The <code title=dom-document-cssElementMap><a href=#dom-document-csselementmap>cssElementMap</a></code> feature for defining <span title="CSS element reference identifier">CSS element reference identifiers</span>.</li> <!--CSSREF-->
    <li>An experimental <code><a href=#undomanager>UndoManager</a></code> interface.</li><!--UNDO-->
+   <li>An experimental specification of the legacy <code title=dom-find><a href=#dom-find>window.find()</a></code> API.</li><!--FIND-->
    <li>Some predefined <a href=#mdvocabs>Microdata vocabularies</a>.</li>
   </ul><!--
   <p>Features that are part of the WHATWG HTML Living Standard
@@ -61780,9 +61782,10 @@
            attribute DOMString <a href=#dom-name title=dom-name>name</a>; <!-- not [Replaceable] per WebKit and IE8 -->
   [PutForwards=<a href=#dom-location-href title=dom-location-href>href</a>] readonly attribute <a href=#location>Location</a> <a href=#dom-location title=dom-location>location</a>;
   readonly attribute <a href=#history-0>History</a> <a href=#dom-history title=dom-history>history</a>;
-<!--UNDO-->
+<!--UNDO--><!--FIND-->
   readonly attribute <a href=#undomanager>UndoManager</a> <a href=#dom-undomanager title=dom-undoManager>undoManager</a>;
-<!--UNDO-->
+  boolean <a href=#dom-find title=dom-find>find</a>(in optional DOMString aString, in optional boolean aCaseSensitive, in optional boolean aBackwards, in optional boolean aWrapAround, in optional boolean aWholeWord, in optional boolean aSearchInFrames, in optional boolean aShowDialog);
+<!--UNDO--><!--FIND-->
   [Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-locationbar title=dom-window-locationbar>locationbar</a>;
   [Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-menubar title=dom-window-menubar>menubar</a>;
   [Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-personalbar title=dom-window-personalbar>personalbar</a>;
@@ -74399,13 +74402,71 @@
   no detectable difference.</p>
 
   </div>
+
 <!--UNDO-->
 
 
+<!--FIND-->
 
+  <h3 id=text-search-apis><span class=secno>8.9 </span>Text search APIs</h3>
 
-  <h3 id=editing-apis><span class=secno>8.9 </span>Editing APIs</h3>
+  <p class=critical>This legacy API is not very interoperably
+  implemented, and has a number of design problems (such as having six
+  boolean arguments in a row, giving the ability to expose a UA
+  dialog, affecting the selection when successful, etc). We may just
+  drop it instead. <a href=http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-May/thread.html#31457>Read
+  more...</a></p>
 
+  <!-- demo: http://software.hixie.ch/utilities/js/live-dom-viewer/saved/1076 -->
+
+  <!-- bugs:
+
+     https://bugzilla.mozilla.org/show_bug.cgi?id=672395
+     https://bugs.webkit.org/show_bug.cgi?id=64761
+
+  -->
+
+  <!-- notes:
+
+   if first argument is '', gecko throws a dialog. webkit does not.
+
+   aCaseSensitive, if true, matches case.
+   Webkit: If false, even if the search string is the equivalent of cåt, it'll still match "cat".
+   Gecko: some sort of unicode case-insensitive (aring matches Aring)
+
+   search starts from the last place the user placed the invisible cursor
+
+   once find() has selected text in a text field, it acts as if the cursor jumps back to the top of the page
+
+   aWholeWord has no effect.
+
+   Gecko: aWrapAround has no effect.
+   WebKit: aWrapAround works by wrapping around at the bottom of the page (top if going backwards).
+
+   Gecko: searches iframes if aSearchInFrames is set
+   WebKit: doesn't search iframes; aSearchInFrames has no effect.
+
+   Gecko: aShowDialog works
+   Webkit: does not
+
+   Gecko: doesn't work on display:none iframes. (works fine in webkit)
+   WebKit: doesn't work before body.onload has fired or some such (works fine in gecko)
+
+  -->
+
+  <!--
+  boolean <span title="dom-find">find</span>(in optional DOMString aString, in optional boolean aCaseSensitive, in optional boolean aBackwards, in optional boolean aWrapAround, in optional aWholeWord, in optional aSearchInFrames, in optional aShowDialog);
+  -->
+
+  <p class=XXX><dfn id=dom-find title=dom-find>window.find()</dfn> goes here</p>
+
+<!--FIND-->
+
+
+
+
+  <h3 id=editing-apis><span class=secno>8.10 </span>Editing APIs</h3>
+
   <dl class=domintro><dt><var title="">document</var> . <code title=dom-document-execCommand><a href=#execCommand>execCommand</a></code>(<var title="">commandId</var> [, <var title="">showUI</var> [, <var title="">value</var> ] ] )</dt>
 
    <dd>

Modified: index
===================================================================
--- index	2011-07-15 22:11:14 UTC (rev 6309)
+++ index	2011-07-19 19:33:21 UTC (rev 6310)
@@ -243,7 +243,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 15 July 2011</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 19 July 2011</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>
@@ -1004,7 +1004,8 @@
      <li><a href=#redo:-moving-forward-in-the-undo-transaction-history><span class=secno>8.8.4 </span>Redo: moving forward in the undo transaction history</a></li>
      <li><a href=#the-undomanagerevent-interface-and-the-undo-and-redo-events><span class=secno>8.8.5 </span>The <code>UndoManagerEvent</code> interface and the <code title=event-undo>undo</code> and <code title=event-redo>redo</code> events</a></li>
      <li><a href=#implementation-notes><span class=secno>8.8.6 </span>Implementation notes</a></ol></li>
-   <li><a href=#editing-apis><span class=secno>8.9 </span>Editing APIs</a></ol></li>
+   <li><a href=#text-search-apis><span class=secno>8.9 </span>Text search APIs</a></li>
+   <li><a href=#editing-apis><span class=secno>8.10 </span>Editing APIs</a></ol></li>
  <li><a href=#video-conferencing-and-peer-to-peer-communication><span class=secno>9 </span>Video conferencing and peer-to-peer communication</a>
   <ol>
    <li><a href=#introduction-10><span class=secno>9.1 </span>Introduction</a></li>
@@ -1444,6 +1445,7 @@
    <li>Rules for <a href=#atom>converting HTML to Atom</a>.</li> <!--MD-->
    <li>The <code title=dom-document-cssElementMap><a href=#dom-document-csselementmap>cssElementMap</a></code> feature for defining <span title="CSS element reference identifier">CSS element reference identifiers</span>.</li> <!--CSSREF-->
    <li>An experimental <code><a href=#undomanager>UndoManager</a></code> interface.</li><!--UNDO-->
+   <li>An experimental specification of the legacy <code title=dom-find><a href=#dom-find>window.find()</a></code> API.</li><!--FIND-->
    <li>Some predefined <a href=#mdvocabs>Microdata vocabularies</a>.</li>
   </ul><!--
   <p>Features that are part of the WHATWG HTML Living Standard
@@ -61652,9 +61654,10 @@
            attribute DOMString <a href=#dom-name title=dom-name>name</a>; <!-- not [Replaceable] per WebKit and IE8 -->
   [PutForwards=<a href=#dom-location-href title=dom-location-href>href</a>] readonly attribute <a href=#location>Location</a> <a href=#dom-location title=dom-location>location</a>;
   readonly attribute <a href=#history-0>History</a> <a href=#dom-history title=dom-history>history</a>;
-<!--UNDO-->
+<!--UNDO--><!--FIND-->
   readonly attribute <a href=#undomanager>UndoManager</a> <a href=#dom-undomanager title=dom-undoManager>undoManager</a>;
-<!--UNDO-->
+  boolean <a href=#dom-find title=dom-find>find</a>(in optional DOMString aString, in optional boolean aCaseSensitive, in optional boolean aBackwards, in optional boolean aWrapAround, in optional boolean aWholeWord, in optional boolean aSearchInFrames, in optional boolean aShowDialog);
+<!--UNDO--><!--FIND-->
   [Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-locationbar title=dom-window-locationbar>locationbar</a>;
   [Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-menubar title=dom-window-menubar>menubar</a>;
   [Replaceable] readonly attribute <a href=#barprop>BarProp</a> <a href=#dom-window-personalbar title=dom-window-personalbar>personalbar</a>;
@@ -74297,13 +74300,71 @@
   no detectable difference.</p>
 
   </div>
+
 <!--UNDO-->
 
 
+<!--FIND-->
 
+  <h3 id=text-search-apis><span class=secno>8.9 </span>Text search APIs</h3>
 
-  <h3 id=editing-apis><span class=secno>8.9 </span>Editing APIs</h3>
+  <p class=critical>This legacy API is not very interoperably
+  implemented, and has a number of design problems (such as having six
+  boolean arguments in a row, giving the ability to expose a UA
+  dialog, affecting the selection when successful, etc). We may just
+  drop it instead. <a href=http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-May/thread.html#31457>Read
+  more...</a></p>
 
+  <!-- demo: http://software.hixie.ch/utilities/js/live-dom-viewer/saved/1076 -->
+
+  <!-- bugs:
+
+     https://bugzilla.mozilla.org/show_bug.cgi?id=672395
+     https://bugs.webkit.org/show_bug.cgi?id=64761
+
+  -->
+
+  <!-- notes:
+
+   if first argument is '', gecko throws a dialog. webkit does not.
+
+   aCaseSensitive, if true, matches case.
+   Webkit: If false, even if the search string is the equivalent of cåt, it'll still match "cat".
+   Gecko: some sort of unicode case-insensitive (aring matches Aring)
+
+   search starts from the last place the user placed the invisible cursor
+
+   once find() has selected text in a text field, it acts as if the cursor jumps back to the top of the page
+
+   aWholeWord has no effect.
+
+   Gecko: aWrapAround has no effect.
+   WebKit: aWrapAround works by wrapping around at the bottom of the page (top if going backwards).
+
+   Gecko: searches iframes if aSearchInFrames is set
+   WebKit: doesn't search iframes; aSearchInFrames has no effect.
+
+   Gecko: aShowDialog works
+   Webkit: does not
+
+   Gecko: doesn't work on display:none iframes. (works fine in webkit)
+   WebKit: doesn't work before body.onload has fired or some such (works fine in gecko)
+
+  -->
+
+  <!--
+  boolean <span title="dom-find">find</span>(in optional DOMString aString, in optional boolean aCaseSensitive, in optional boolean aBackwards, in optional boolean aWrapAround, in optional aWholeWord, in optional aSearchInFrames, in optional aShowDialog);
+  -->
+
+  <p class=XXX><dfn id=dom-find title=dom-find>window.find()</dfn> goes here</p>
+
+<!--FIND-->
+
+
+
+
+  <h3 id=editing-apis><span class=secno>8.10 </span>Editing APIs</h3>
+
   <dl class=domintro><dt><var title="">document</var> . <code title=dom-document-execCommand><a href=#execCommand>execCommand</a></code>(<var title="">commandId</var> [, <var title="">showUI</var> [, <var title="">value</var> ] ] )</dt>
 
    <dd>

Modified: source
===================================================================
--- source	2011-07-15 22:11:14 UTC (rev 6309)
+++ source	2011-07-19 19:33:21 UTC (rev 6310)
@@ -232,6 +232,7 @@
    <li>Rules for <a href="#atom">converting HTML to Atom</a>.</li> <!--MD-->
    <li>The <code title="dom-document-cssElementMap">cssElementMap</code> feature for defining <span title="CSS element reference identifier">CSS element reference identifiers</span>.</li> <!--CSSREF-->
    <li>An experimental <code>UndoManager</code> interface.</li><!--UNDO-->
+   <li>An experimental specification of the legacy <code title="dom-find">window.find()</code> API.</li><!--FIND-->
    <li>Some predefined <a href="#mdvocabs">Microdata vocabularies</a>.</li>
   </ul>
 
@@ -70226,9 +70227,10 @@
            attribute DOMString <span title="dom-name">name</span>; <!-- not [Replaceable] per WebKit and IE8 -->
   [PutForwards=<span title="dom-location-href">href</span>] readonly attribute <span>Location</span> <span title="dom-location">location</span>;
   readonly attribute <span>History</span> <span title="dom-history">history</span>;
-<!--END w3c-html--><!--UNDO-->
+<!--END w3c-html--><!--UNDO--><!--FIND-->
   readonly attribute <span>UndoManager</span> <span title="dom-undoManager">undoManager</span>;
-<!--START w3c-html--><!--UNDO-->
+  boolean <span title="dom-find">find</span>(in optional DOMString aString, in optional boolean aCaseSensitive, in optional boolean aBackwards, in optional boolean aWrapAround, in optional boolean aWholeWord, in optional boolean aSearchInFrames, in optional boolean aShowDialog);
+<!--START w3c-html--><!--UNDO--><!--FIND-->
   [Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-locationbar">locationbar</span>;
   [Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-menubar">menubar</span>;
   [Replaceable] readonly attribute <span>BarProp</span> <span title="dom-window-personalbar">personalbar</span>;
@@ -84903,11 +84905,70 @@
   no detectable difference.</p>
 
   </div>
-<!--START w3c-html--><!--UNDO-->
 
+<!--UNDO-->
 
 
+<!--FIND-->
 
+  <h3>Text search APIs</h3>
+
+  <p class="critical">This legacy API is not very interoperably
+  implemented, and has a number of design problems (such as having six
+  boolean arguments in a row, giving the ability to expose a UA
+  dialog, affecting the selection when successful, etc). We may just
+  drop it instead. <a
+  href="http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-May/thread.html#31457">Read
+  more...</a></p>
+
+  <!-- demo: http://software.hixie.ch/utilities/js/live-dom-viewer/saved/1076 -->
+
+  <!-- bugs:
+
+     https://bugzilla.mozilla.org/show_bug.cgi?id=672395
+     https://bugs.webkit.org/show_bug.cgi?id=64761
+
+  -->
+
+  <!-- notes:
+
+   if first argument is '', gecko throws a dialog. webkit does not.
+
+   aCaseSensitive, if true, matches case.
+   Webkit: If false, even if the search string is the equivalent of cåt, it'll still match "cat".
+   Gecko: some sort of unicode case-insensitive (aring matches Aring)
+
+   search starts from the last place the user placed the invisible cursor
+
+   once find() has selected text in a text field, it acts as if the cursor jumps back to the top of the page
+
+   aWholeWord has no effect.
+
+   Gecko: aWrapAround has no effect.
+   WebKit: aWrapAround works by wrapping around at the bottom of the page (top if going backwards).
+
+   Gecko: searches iframes if aSearchInFrames is set
+   WebKit: doesn't search iframes; aSearchInFrames has no effect.
+
+   Gecko: aShowDialog works
+   Webkit: does not
+
+   Gecko: doesn't work on display:none iframes. (works fine in webkit)
+   WebKit: doesn't work before body.onload has fired or some such (works fine in gecko)
+
+  -->
+
+  <!--
+  boolean <span title="dom-find">find</span>(in optional DOMString aString, in optional boolean aCaseSensitive, in optional boolean aBackwards, in optional boolean aWrapAround, in optional aWholeWord, in optional aSearchInFrames, in optional aShowDialog);
+  -->
+
+  <p class="XXX"><dfn title="dom-find">window.find()</dfn> goes here</p>
+
+<!--START w3c-html--><!--FIND-->
+
+
+
+
   <h3>Editing APIs</h3>
 
   <dl class="domintro">




More information about the Commit-Watchers mailing list