Capability: Toggle whether default controls are displayed

[prushforth]

This issue is for discussion of the map viewer capability "Toggle whether default controls are displayed".

---

Using the <video> element as an example, the browser renderer is capable of rendering video content on demand of the author using something as simple as

<video controls width="250">

    <source src="/media/examples/flower.webm"
            type="video/webm">

    <source src="/media/examples/flower.mp4"
            type="video/mp4">

    Sorry, your browser doesn't support embedded videos.
</video>

The video player rendered by that has default controls, styled according to the particular browser implementation. Yet, and I am not an expert, but I believe you can shut the controls off (by omitting the controls attribute) and provide your own controls (if you wish) which respond to events (handled by script).

Maps should follow a similar approach: if you don't want default controls, don't ask for them. Then, use events emitted by the map 'player' to bind your own self-created controls to the map, with script.

[Malvoz]

I believe you can shut the controls off (by omitting the controls attribute) and provide your own controls (if you wish)

Correct, https://html.spec.whatwg.org/multipage/media.html#attr-media-controls

In addition to controls, consider controlslist aswell.

[prushforth]

In addition to controls, consider controlslist aswell.

Thanks I was not aware of that attribute. There will be a map-specific list of controls that we will need to define and specify.

[AmeliaBR]

The controlslist proposal is also new to me, but definitely relevant to the discussion (& should be mentioned in the related web standards subsection). There's a PR under discussion for WHATWG HTML, and a matching issue, in addition to the WICG repository.

That said, the way it is currently defined (as a block list of noXXX keywords) is probably more narrow than what we want here.

[Malvoz]

@AmeliaBR

the way it is currently defined (as a block list of noXXX keywords) is probably more narrow than what we want here.

Help me understand why that is too narrow. controls enables default controls, controlslist="noXXX" then disables specific controls that aren't desired.

[AmeliaBR]

Help me understand why that is too narrow.

The problem comes when you want to have both default and custom controls as part of the map widget layout (as discussed in #79 ). HTML video doesn't currently have this option: you can create buttons on your web page that affect the video, but you can't add buttons to the video control panel itself.

To match how the libraries currently do it, you'd need to be able to specify which default controls get shown in which corners of the map.