Add constructors

RByers · RByers · commit 219546b80cd1 · 2015-07-08T22:03:47.000-04:00
Issue w3c/TouchEvents#10
diff --git a/touchevents.html b/touchevents.html
@@ -266,7 +266,7 @@ <h2><a><code>Touch</code></a> Interface</h2>
         attributes must not change.
       </p>
 
-      <dl title='interface Touch' class='idl'>
+      <dl title='[Constructor(TouchInit touchInitDict)] interface Touch' class='idl' data-merge='TouchInit'>
         <dt>readonly attribute long identifier</dt>
         <dd>
           An identification number for each <a>touch point</a>.
@@ -352,6 +352,29 @@ <h2><a><code>Touch</code></a> Interface</h2>
           the sensitivity in levels of pressure, may vary.
         </dd>
       </dl>
+
+      <dl title='dictionary TouchInit' class='idl'>
+        <dt>required long identifier</dt>
+        <dd>Initializes the <code>identifier</code> property of the <code>Touch</code> object.</dd>
+        <dt>required EventTarget target</dt>
+        <dd>Initializes the <code>identifier</code> property of the <code>Touch</code> object.</dd>
+        <dt>double screenX = 0</dt>
+        <dd>Initializes the <code>screenX</code> property of the <code>Touch</code> object.</dd>
+        <dt>double screenY = 0</dt>
+        <dd>Initializes the <code>screenY</code> property of the <code>Touch</code> object.</dd>
+        <dt>double pageX = 0</dt>
+        <dd>Initializes the <code>pageX</code> and <code>clientX</code> properties of the <code>Touch</code> object.</dd>
+        <dt>double pageY = 0</dt>
+        <dd>Initializes the <code>pageY</code> and <code>clientY</code> properties of the <code>Touch</code> object.</dd>
+        <dt>float radiusX = 0</dt>
+        <dd>Initializes the <code>radiusX</code> property of the <code>Touch</code> object.</dd>
+        <dt>float radiusY = 0</dt>
+        <dd>Initializes the <code>radiusY</code> property of the <code>Touch</code> object.</dd>
+        <dt>float rotationAngle = 0</dt>
+        <dd>Initializes the <code>rotationAngle</code> property of the <code>Touch</code> object.</dd>
+        <dt>float force = 0</dt>
+        <dd>Initializes the <code>force</code> property of the <code>Touch</code> object.</dd>
+      </dl>
     </section>
 
     <section>
@@ -393,7 +416,7 @@ <h2><a><code>TouchEvent</code></a> Interface</h2>
         initialized, its attributes must not change.
       </p>
 
-      <dl title='interface TouchEvent : UIEvent' class='idl'>
+      <dl title='[Constructor(DOMString type, optional TouchEventInit eventInitDict)] interface TouchEvent : UIEvent' class='idl' data-merge='TouchEventInit'>
         <dt>readonly attribute <a><code>TouchList</code></a> touches</dt>
         <dd>
           a list of <a><code>Touch</code></a> objects for every point of contact currently
@@ -445,6 +468,23 @@ <h2><a><code>TouchEvent</code></a> Interface</h2>
         </dd>
       </dl>
 
+      <dl title='dictionary TouchEventInit : UIEventInit' class='idl'>
+        <dt>sequence&lt;Touch&gt; touches = []</dt>
+        <dd>Initializes the <code>touches</code> property of the <code>TouchEvent</code> object with each element from the sequence.</dd>
+        <dt>sequence&lt;Touch&gt; targetTouches = []</dt>
+        <dd>Initializes the <code>touches</code> property of the <code>TouchEvent</code> object with each element from the sequence.</dd>
+        <dt>sequence&lt;Touch&gt; changedTouches = []</dt>
+        <dd>Initializes the <code>touches</code> property of the <code>TouchEvent</code> object with each element from the sequence.</dd>
+        <dt>boolean altKey</dt>
+        <dd>Initializes the <code>altKey</code> property of the <code>TouchEvent</code> object.</dd>
+        <dt>boolean metaKey</dt>
+        <dd>Initializes the <code>metaKey</code> property of the <code>TouchEvent</code> object.</dd>
+        <dt>boolean ctrlKey</dt>
+        <dd>Initializes the <code>ctrlKey</code> property of the <code>TouchEvent</code> object.</dd>
+        <dt>boolean shiftKey</dt>
+        <dd>Initializes the <code>shiftKey</code> property of the <code>TouchEvent</code> object.</dd>
+      </dl>
+
       <section class="informative">
        <h2>TouchEvent Implementer's Note</h2>
        <div class="note">
@@ -781,8 +821,8 @@ <h2>Extensions to the <a><code>Document</code></a> Interface</h2>
         can use it to initialize the properties of a <a><code>TouchEvent</code></a> object,
         including its <a><code>TouchList</code></a> properties (which can be initialized
         with values returned from <a><code>createTouchList</code></a>). The
-        <a><code>initTouchEvent</code></a> method is not yet standardized, but it may appear
-        in some form in a future specification.
+        <a><code>initTouchEvent</code></a> method is not yet standardized and will
+        eventually be superceded by the <code>TouchEvent</code> constructor.
       </p>
     </section>
 
