Define an optional value and use it for setting dialog returnValue

Define a new 'optional value' for buttons and submit inputs,
this is used instead of 'value' when setting a dialog's returnValue.

Author: lukewarlow

source

@@ -51410,6 +51410,10 @@ ldh-str       = &lt; as defined in <a href="https://www.rfc-editor.org/rfc/rfc10
 
   <div w-nodev>
 
+  <p>The element's <span data-x="concept-fe-optional-value">optional value</span> is the value of
+  the element's <code data-x="attr-button-value">value</code> attribute, if there is one, or null
+  otherwise.</p>
+
   <p>The element's <span>input activation behavior</span> given <var>event</var> is as follows:</p>
 
   <ol>
@@ -53865,7 +53869,9 @@ interface <dfn interface>HTMLButtonElement</dfn> : <span>HTMLElement</span> {
   <p>The <dfn element-attr for="button"><code data-x="attr-button-value">value</code></dfn>
   attribute gives the element's value for the purposes of form submission. The element's <span
   data-x="concept-fe-value">value</span> is the value of the element's <code
-  data-x="attr-button-value">value</code> attribute, if there is one, or the empty string
+  data-x="attr-button-value">value</code> attribute, if there is one, or the empty string otherwise.
+  The element's <span data-x="concept-fe-optional-value">optional value</span> is the value of the
+  element's <code data-x="attr-button-value">value</code> attribute, if there is one, or null
   otherwise.</p>
 
   <p class="note">A button (and its value) is only included in the form submission if the button
@@ -56648,6 +56654,11 @@ interface <dfn interface>HTMLLegendElement</dfn> : <span>HTMLElement</span> {
   default value. If it is false, <span data-x="concept-fe-value">value</span> mirrors the default
   value. If it is true, the default value is ignored.</p>
 
+  <p>Some form controls also have an <dfn data-x="concept-fe-optional-value">optional value</dfn>
+  this largely mirrors the <span data-x="concept-fe-value">value</span> but doesn't normalize to an
+  empty string. <span class="note">This <!--non-normative-->should be used sparingly you generally
+  want <span data-x="concept-fe-value">value</span></span>.</p>
+
   <p><code>input</code>, <code>textarea</code>, and <code>select</code> elements have a
   <dfn>user validity</dfn> boolean. It is initially set to false.</p>
 
@@ -60398,8 +60409,9 @@ fur
       </ol>
      </li>
 
-     <li><p>Otherwise, if <var>submitter</var> has a <span data-x="concept-fe-value">value</span>,
-     then set <var>result</var> to that <span data-x="concept-fe-value">value</span>.</p></li>
+     <li><p>Otherwise, if <var>submitter</var> has an <span
+     data-x="concept-fe-optional-value">optional value</span>, then set <var>result</var> to that
+     <span data-x="concept-fe-optional-value">optional value</span>.</p></li>
 
      <li><p><span>Close the dialog</span> <var>subject</var> with <var>result</var>.</p></li>
 
@@ -62609,7 +62621,7 @@ interface <dfn interface>HTMLDialogElement</dfn> : <span>HTMLElement</span> {
 
     <ol>
      <li><p>Let <var>value</var> be <var>invoker</var>'s <span
-     data-x="concept-fe-value">value</span>.</p></li>
+     data-x="concept-fe-optional-value">optional value</span>.</p></li>
 
      <li><p><span>Close the dialog</span> <var>element</var> with <var>value</var>.</p></li>
     </ol>