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

@mbrodesser commented on this pull request.



>    };
   </pre>
 
-  <div id="clipboard-idl" dfn-for="Clipboard">
+  A <dfn>Clipboard</dfn> may contain <dfn>Clipboard Items</dfn> which has one or more [=clipboard item=]s. Multiple [=clipboard item=]s are only supported on platforms such as iOS/iPadOS.

As mentioned in [this comment](https://github.com/w3c/clipboard-apis/pull/158/#discussion_r766517505), it seems the term "Clipboard Items" shouldn't be defined. The marked line contains a `<dfn>Clipboard Items<dfn>` which defines the term "Clipboard Items" without precisely defining it.

The `<dfn>Clipboard<dfn>` in the same line redefines the Clipboard defined via IDL; it should be a reference instead, i.e. `<code><a ...>Clipboard</a></code>`. Moreover, the `Clipboard` interface doesn't "have" clipboard items. It operates with them.
So something like

`A <code><a ...>Clipboard</a></code>'s <code><a ...>read()</a></code> and <code><a ...>write()</a></code> method must support multiple <code><a ...>ClipboardItem</a></code>s, when the operating systems supports them. <p class="note" ...>Currently, only operating systems from Apple (e.g. iOS) support multiple <code><a ...>ClipboardItem</a></code>s` seems more correct. WDYT?

-- 
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#pullrequestreview-828741196