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

@mbrodesser commented on this pull request.



> -    Promise<Blob> getType(DOMString type);
-  };
+   <dt><code><var>clipboardItem</var>.<var>types</var></code>
+   <dd><p>Returns the list of <var>types</var> contained in the <var>clipboardItem</var> object.
+
+  </dl>
+
+  <h4 id="clipboard-item">Clipboard Item</h4>
+
+  A [=clipboard item=] is conceptually data that the user has expressed a desire to make shareable by invoking a "cut" or "copy" command.
+
+  <p class=note>
+   For example, if a user copies a range of cells from a spreadsheet of a native application, it will result in one [=clipboard item=]. If a user copies a set of files from their desktop, that list of files will be represented by multiple [=clipboard item=]s.
+  </p>
+
+  Some platforms may support having more than one [=clipboard item=] at a time on the [=Clipboard=], while other platforms replace the previous [=clipboard item=] with the new one. 

Thanks for the response.

> It also talks about the platforms that don't support multiple Clipboard Items like Windows. 

That information is beyond the scope of _a_ Clipboard Item.

> I think the model should describe both single and multiple Clipboard Item/s.

Which model?

> That way it is clear how implementers would implement the conceptual Clipboard Item object.

That information is unnecessary for implementing the conceptual clipboard item.

> Section 7.3 just describes the conceptual Clipboard object and the methods associated with it, not the Clipboard Item(single or multiple).

No. That section defines `ClipboardItems` in IDL: `typedef sequence<ClipboardItem> ClipboardItems;`.

> The methods in Clipboard object use Clipboard Items, but Clipboard Items isn't part of Clipboard object.

The `typedef` isn't part of the interface defined in IDL (I wonder if it could be).

> I did define the conceptual Clipboard Items there as that is used by the conceptual Clipboard object

The definition is in IDL, https://webidl.spec.whatwg.org/#idl-typedefs. The definition isn't conceptual, IIUC. `Clipboard` is defined in IDL, it's not conceptual. @snianu, @domenic, please correct me if I'm wrong. 



-- 
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_r764725047