[mediacapture-surface-control] Clarify "fire a blank event" for "capturedzoomlevelchange" (#50)

tidoust has just created a new issue for https://github.com/w3c/mediacapture-surface-control:

== Clarify "fire a blank event" for "capturedzoomlevelchange" ==
The spec current defines the [`oncapturedzoomlevelchange`](https://w3c.github.io/mediacapture-surface-control/#dom-capturecontroller-oncapturedzoomlevelchange) event handler as: "The user agent MUST fire a blank event on this `EventHandler` ...", but:

- What is a "blank event"? In particular, what interface does the event use? `Event`? That should be specified, at least implicitly by linking back to "[fire an event](https://dom.spec.whatwg.org/#concept-event-fire)".
- An event does not fire on an event handler. It fires at a target (an instance of some interface). Here, that would be the underlying `CaptureController` instance.

Ideally, the spec would rather say something like:

```
Given a {{CaptureController}} |controller|, the user agent MUST [=fire an event=]
named `capturedzoomlevelchange` at |controller| whenever the
|controller|.<a data-cite="!screen-capture/#dfn-source">[[\Source]]</a>'s
[=zoom level=] changes.
```

... and the event handler would rather be defined as:

```
An [=event handler IDL attribute=] whose [=event handler event type=] is
`capturedzoomlevelchange`.
```



Please view or discuss this issue at https://github.com/w3c/mediacapture-surface-control/issues/50 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Wednesday, 4 December 2024 09:06:52 UTC