HTML5 Tracker

Diff (omit for latest revision)
Filter

Short URL: http://html5.org/r/7161

SVNBugCommentTime (UTC)
7161Drop the attempt at speccing the legacy window.find() API.2012-06-29 20:46
Index: source
===================================================================
--- source	(revision 7160)
+++ source	(revision 7161)
@@ -268,7 +268,6 @@
    <li>The <code title="attr-inert">inert</code> global attribute to disable subtrees.</li><!--INERT-->
    <li>The <code title="attr-fs-method-dialog-keyword">dialog</code> keyword on the <code>form</code> element's <code title="attr-fs-method">method</code> attribute, for a simpler way to close dialogs.</li><!--FORM-DIALOG-->
    <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 specification of the legacy <code title="dom-find">window.find()</code> API.</li><!--FIND-->
    <li>Some predefined <a href="#mdvocabs">Microdata vocabularies</a>.</li>
    <li>The <code>data</code> element for marking up machine-readable data.</li><!--DATA--><!--FORK-->
    <li>The <code title="scheme-http+aes">http+aes:</code> and <code title="scheme-http+aes">https+aes:</code> schemes.</li><!--FORK-->
@@ -76870,9 +76869,6 @@
            attribute DOMString <span title="dom-name">name</span>; <!-- not [Replaceable] per WebKit and IE8 -->
   [PutForwards=<span title="dom-location-href">href</span>, Unforgeable] 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--><!--FIND-->
-  boolean <span title="dom-find">find</span>(optional DOMString aString, optional boolean aCaseSensitive, optional boolean aBackwards, optional boolean aWrapAround, optional boolean aWholeWord, optional boolean aSearchInFrames, optional boolean aShowDialog);
-<!--START w3c-html--><!--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>;
@@ -92660,73 +92656,9 @@
 <!--REMOVE-TOPIC:Security-->
 
 
-<!--END w3c-html--><!--FIND-->
-<!--TOPIC:DOM APIs-->
-  <h3>Text search APIs</h3> <!-- window.find() -->
 
-  <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.</p>
-
-  <!-- use case seems to be to just have an API that allows scripts to
-  search for text, then manipulate it (e.g. execCommand).
-  Unfortunately it currently destroys the selection to do so (though I
-  guess you can save it and restore it). We could provide an API for
-  this instead, but it would require changes to execCommand() to work
-  on ranges rather than the selection (probably needed anyway, but not
-  being worked on as of now) -->
-
-  <!-- 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&aring;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-->
-
 <!--END dev-html--><!--END w3c-html-->
 
-
-
   <div data-component="Web Workers (editor: Ian Hickson)"><!--TOPIC:Web Workers-->
 
   <h2 id="workers">Web workers</h2>

|