selectmenu-polyfill
v0.1.1
Published
Polyfill for the selectmenu element
Downloads
21
Maintainers
Readme
<selectmenu>
polyfill
Based on the proposal open-ui.org/components/selectmenu by Open UI.
This polyfill depends on the
Popover API
and comes with a light popover polyfill built-in.
So it doesn't require the
Popover polyfill
but aims to be compatible if you wish to use these together.
One of the goals was to research and create it as closely to spec as possible and use the learnings for the implementation in Media Chrome.
Usage Codesandbox
Until the native <selectmenu>
lands in one of the browsers it's recommended
to use the custom elements <x-selectmenu>
and <x-option>
directly and not
use them as a polyfill.
This is to prevent breaking anything in the future
if the native <selectmenu>
API would change and you would be running a native
selectmenu and a polyfilled selectmenu with misaligned API's.
<script type="module" src="https://cdn.jsdelivr.net/npm/selectmenu-polyfill/src/selectmenu.min.js"></script>
<script type="module" src="https://cdn.jsdelivr.net/npm/selectmenu-polyfill/src/option.min.js"></script>
<x-selectmenu>
<x-option>Option 1</x-option>
<x-option>Option 2</x-option>
<x-option>Option 3</x-option>
</x-selectmenu>
Caveats
- Firefox and Safari don't allow creating a shadow DOM
on custom tags like
selectmenu
so the polyfill replacesselectmenu
elements withx-selectmenu
elements via a mutation observer. If you prefer your elements are not replaced usex-selectmenu
directly. - Safari doesn't render
<option>
content not nested in<select>
sooption
elements nested underx-selectmenu
are automatically replaced withx-option
elements. Again if you prefer to keep the element instance intact usex-option
elements directly. - The native
<option>
has a:checked
pseudo selector state. This is not possible to polyfill, so instead<x-option>
adds the.\:checked
CSS class to any selected option.