Security News
The Unpaid Backbone of Open Source: Solo Maintainers Face Increasing Security Demands
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
@polymer/paper-listbox
Advanced tools
<paper-listbox>
implements an accessible listbox control with Material Design styling. The focused item
is highlighted, and the selected item has bolded text.
<paper-listbox>
<paper-item>Item 1</paper-item>
<paper-item>Item 2</paper-item>
</paper-listbox>
An initial selection can be specified with the selected
attribute.
<paper-listbox selected="0">
<paper-item>Item 1</paper-item>
<paper-item>Item 2</paper-item>
</paper-listbox>
Make a multi-select listbox with the multi
attribute. Items in a multi-select listbox can be deselected,
and multiple item can be selected.
<paper-listbox multi>
<paper-item>Item 1</paper-item>
<paper-item>Item 2</paper-item>
</paper-listbox>
The following custom properties and mixins are available for styling:
Custom property | Description | Default |
---|---|---|
--paper-listbox-background-color | Menu background color | --primary-background-color |
--paper-listbox-color | Menu foreground color | --primary-text-color |
--paper-listbox | Mixin applied to the listbox | {} |
<paper-listbox>
has role="listbox"
by default. A multi-select listbox will also have
aria-multiselectable
set. It implements key bindings to navigate through the listbox with the up and
down arrow keys, esc to exit the listbox, and enter to activate a listbox item. Typing the first letter
of a listbox item will also focus it.
See: Documentation, Demo.
npm install --save @polymer/paper-listbox
<html>
<head>
<script type="module">
import '@polymer/paper-listbox/paper-listbox.js';
</script>
</head>
<body>
<paper-listbox>
<div role="option">item 1</div>
<div role="option">item 2</div>
<div role="option">item 3</div>
</paper-listbox>
</body>
</html>
import {PolymerElement, html} from '@polymer/polymer';
import '@polymer/paper-listbox/paper-listbox.js';
class SampleElement extends PolymerElement {
static get template() {
return html`
<paper-listbox>
<div role="option">item 1</div>
<div role="option">item 2</div>
<div role="option">item 3</div>
</paper-listbox>
`;
}
}
customElements.define('sample-element', SampleElement);
If you want to send a PR to this element, here are the instructions for running the tests and demo locally:
git clone https://github.com/PolymerElements/paper-listbox
cd paper-listbox
npm install
npm install -g polymer-cli
polymer serve --npm
open http://127.0.0.1:<port>/demo/
polymer test --npm
FAQs
Implements an accessible material design listbox
The npm package @polymer/paper-listbox receives a total of 8,711 weekly downloads. As such, @polymer/paper-listbox popularity was classified as popular.
We found that @polymer/paper-listbox demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 11 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
Security News
License exceptions modify the terms of open source licenses, impacting how software can be used, modified, and distributed. Developers should be aware of the legal implications of these exceptions.
Security News
A developer is accusing Tencent of violating the GPL by modifying a Python utility and changing its license to BSD, highlighting the importance of copyleft compliance.