Build status

Demo and API docs

##<paper-checkbox>

Material design: Checkbox

paper-checkbox is a button that can be either checked or unchecked. User can tap the checkbox to check or uncheck it. Usually you use checkboxes to allow user to select multiple options from a set. If you have a single ON/OFF option, avoid using a single checkbox and use paper-toggle-button instead.

Example:

<paper-checkbox>label</paper-checkbox>

<paper-checkbox checked> label</paper-checkbox>

Styling

The following custom properties and mixins are available for styling:

Custom propertyDescriptionDefault
--paper-checkbox-unchecked-background-colorCheckbox background color when the input is not checkedtransparent
--paper-checkbox-unchecked-colorCheckbox border color when the input is not checked--primary-text-color
--paper-checkbox-unchecked-ink-colorSelected/focus ripple color when the input is not checked--primary-text-color
--paper-checkbox-checked-colorCheckbox color when the input is checked--primary-color
--paper-checkbox-checked-ink-colorSelected/focus ripple color when the input is checked--primary-color
--paper-checkbox-checkmark-colorCheckmark colorwhite
--paper-checkbox-label-colorLabel color--primary-text-color
--paper-checkbox-label-spacingSpacing between the label and the checkbox8px
--paper-checkbox-error-colorCheckbox color when invalid--error-color
--paper-checkbox-sizeSize of the checkbox18px

This element applies the mixin --paper-font-common-base but does not import paper-styles/typography.html. In order to apply the Roboto font to this element, make sure you've imported paper-styles/typography.html.