Re: [w3c/clipboard-apis] Add clipboard IDL description. (#158)

@snianu commented on this pull request.



> @@ -621,8 +622,84 @@ urlPrefix: https://w3c.github.io/FileAPI/#dfn-; type: dfn;
   };
   </pre>
 
-  <div id="clipboard-idl" dfn-for="Clipboard">
+  <div class="algorithm" data-algorithm="clipboard-item">
+  <h4 id="h-clipboard-item"><dfn>ClipboardItem</dfn></h4>
+  The [=ClipboardItem=] object represents the content of the MIME types that are in the [=mandatory data types=] list, and are currently on the [=system clipboard=].
+  It has a mapping of the MIME types in {{DOMString}} format and a [=Blob=] corresponding to the MIME types that contains the actual payload. A web author needs to
+  create a [=ClipboardItem=] object in order to write content to the clipboard using the {{Clipboard/write()}} method. {{Clipboard/read()}} returns a [=ClipboardItem=] object
+  that can be used to read a specific |type| using {{ClipboardItem/getType()}}.
+  </div>
+  <dl class=note>
+   <dt><code><var>clipboardItem</var> = new <a constructor lt="ClipboardItem()">ClipboardItem</a>([<var>items</var>, <var>options</var>])</code>

hm Chrome and Safari implementations are currently matching the spec and they have already shipped, so renaming these types now would be confusing. I can certainly make these changes if everyone agrees to it. Please let me know what you think.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/w3c/clipboard-apis/pull/158#discussion_r727604287