Editorial: refactor designMode

Author: annevk

source

@@ -73576,21 +73576,11 @@ body { display:none }
 
 
 
-  <h4>Making entire documents editable: the <code data-x="dom-document-designMode">designMode</code>
-  IDL attribute</h4>
-
-  <div w-nodev>
-
-  <p>Documents have a <dfn id="designMode"
-  data-x="dom-document-designMode"><code>designMode</code></dfn>, which can be either enabled or
-  disabled.</p>
-
-  </div>
+  <h4 id="making-entire-documents-editable:-the-designmode-idl-attribute">Making entire documents
+  editable: the <code data-x="dom-document-designMode">designMode</code> getter and setter</h4>
 
   <dl class="domintro">
-
    <dt><var>document</var> . <code subdfn data-x="dom-document-designMode">designMode</code> [ = <var>value</var> ]</dt>
-
    <dd>
     <p>Returns "<code data-x="">on</code>" if the document is editable, and "<code
     data-x="">off</code>" if it isn't.</p>
@@ -73602,28 +73592,37 @@ body { display:none }
 
   <div w-nodev>
 
-  <p>The <code data-x="dom-document-designMode">designMode</code> IDL attribute on the
-  <code>Document</code> object takes two values, "<code data-x="">on</code>" and "<code
-  data-x="">off</code>". On setting, the new value must be compared in an <span>ASCII
-  case-insensitive</span> manner to these two values; if it matches the "<code data-x="">on</code>"
-  value, then <code data-x="dom-document-designMode">designMode</code> must be enabled, and if it
-  matches the "<code data-x="">off</code>" value, then <code
-  data-x="dom-document-designMode">designMode</code> must be disabled. Other values must be
-  ignored.</p>
+  <p><code>Document</code> objects have an associated <dfn>design mode enabled</dfn>, which is a
+  boolean. It is initially false.</p>
 
-  <p>On getting, if <code data-x="dom-document-designMode">designMode</code> is enabled, the IDL
-  attribute must return the value "<code data-x="">on</code>"; otherwise it is disabled, and the
-  attribute must return the value "<code data-x="">off</code>".</p>
+  <p>The <dfn id="designMode"><code data-x="dom-document-designMode">designMode</code></dfn> getter
+  steps are to return "<code data-x="">on</code>" if <span>this</span>'s <span>design mode
+  enabled</span> is true; otherwise "<code data-x="">off</code>".</p>
 
-  <p>The last state set must persist until the document is destroyed or the state is changed.
-  Initially, documents must have their <code data-x="dom-document-designMode">designMode</code>
-  disabled.</p>
+  <p>The <code data-x="dom-document-designMode">designMode</code> setter steps are:</p>
 
-  <p>When the <code data-x="dom-document-designMode">designMode</code> changes from being disabled to
-  being enabled, the user agent must <span>immediately</span> reset the document's <span>active range</span>'s
-  start and end boundary points to be at the start of the <code>Document</code> and then run the
-  <span>focusing steps</span> for the <span>document element</span> of the <code>Document</code>, if
-  non-null.</p>
+  <ol>
+   <li><p>Let <var>value</var> be the given value, converted to <span>ASCII
+   lowercase</span>.</p></li>
+
+   <li>
+    <p>If <var>value</var> is "<code data-x="">on</code>" and <span>this</span>'s <span>design mode
+    enabled</span> is false, then:</p>
+
+    <ol>
+     <li><p>Set <span>this</span>'s <span>design mode enabled</span> to true.</p></li>
+
+     <li><p>Reset <span>this</span>'s <span>active range</span>'s start and end boundary points to
+     be at the start of <span>this</span>.</p></li>
+
+     <li><p>Run the <span>focusing steps</span> for <span>this</span>'s <span>document
+     element</span>, if non-null.</p></li>
+    </ol>
+   </li>
+
+   <li><p>If <var>value</var> is "<code data-x="">off</code>", then set <span>this</span>'s
+   <span>design mode enabled</span> to false.</p></li>
+  </ol>
 
   </div>
 
@@ -73665,8 +73664,8 @@ body { display:none }
   <p>An <dfn data-export="">editing host</dfn> is either an <span data-x="HTML elements">HTML
   element</span> with its <code data-x="attr-contenteditable">contenteditable</code> attribute in
   the <i>true</i> state, or a <span data-x="concept-tree-child">child</span> <span data-x="HTML
-  elements">HTML element</span> of a <code>Document</code> with <code
-  data-x="dom-document-designMode">designMode</code> enabled.</p>
+  elements">HTML element</span> of a <code>Document</code> whose <span>design mode enabled</span> is
+  true.</p>
 
   <p>The definition of the terms <dfn
   data-x-href="https://w3c.github.io/editing/execCommand.html#active-range">active range</dfn>, <dfn