[csswg-drafts] [resize-observer] the example "ResizeObservation" (#3839)

dholbert has just created a new issue for https://github.com/w3c/csswg-drafts:

== [resize-observer] the example "ResizeObservation" ==
* please tag the issue title with the spec's shortname, like `[css-foo]`
* please link to the spec section you're talking about, or at least the spec

https://wpt.fyi/results/resize-observer/idlharness.window.html shows a bunch of cross-browser test failures for the `ResizeObservation interface`, which come from chunk of IDL:

https://github.com/web-platform-tests/wpt/blob/a8d97c0c7c58cdc2def51573e30c2cad92923d75/interfaces/resize-observer.idl#L39-L43

```
interface ResizeObservation {
    readonly attribute Element target;
    readonly attribute ResizeObserverBoxOptions observedBox;
    readonly attribute ResizeObserverSize lastReportedSize;
};
```

This interface is mentioned in the spec, but it's clearly labeled as an "example" which is *not* supposed to be exposed to JS:
> **ยง 3.1. ResizeObservation example struct**
> This section is not normative. ResizeObservation is an example struct that can be used in implementation of Resize Observer. It is being included here in order to help provide clarity during the processing model. It effectively holds observation information for a single Element. This interface is not visible to Javascript.
> [...]
> interface ResizeObservation {

https://drafts.csswg.org/resize-observer/#resize-observation-interface


Unfortunately, the WPT `interfaces/resize-observer.idl` file is autogenerated, so we can't just edit it to remove this example interface. It'll just come back whenever the file gets regenerated, presumably.  So I think we need to edit the spec to make it clearer (to the Reffy tool) that the 

Please view or discuss this issue at https://github.com/w3c/csswg-drafts/issues/3839 using your GitHub account

Received on Wednesday, 17 April 2019 22:41:43 UTC