Package Exports
- @dile/dile-checkbox
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@dile/dile-checkbox) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
@dile/dile-checkbox
Web Component to create a customized checkbox input interface, based on LitElement.
Installation
npm i @dile/dile-checkbox
Usage
<script type="module">
import '@dile/dile-checkbox/dile-checkbox.js';
</script>
<dile-checkbox>Label for the checkbox element</dile-checkbox>
Properties
- checked: Boolean, defines the checkbox state.
- disabled: Boolean, mark checkbox as disabled.
- name: The name of the checkbox, only for identification purposes
Custom events
- dile-checkbox-changed: Every time the checkbox changes emits a dile-checkbox-changed event. The checkbox current state is received in the handler usign the event object "detail" property.
when fired, the custom event sends a detail object, containing the checked state of the element and the value of the name property.
CSS Custom Properties
You can customize it using CSS Custom Properties.
Custom property | Description | Default |
---|---|---|
--dile-checkbox-checked-color | Checked color for check control | #30a030 |
--dile-checkbox-unchecked-color | Unchecked color for check control | #ccc |
--dile-checkbox-fill-color | Fill color for the check control | #fff |
--dile-checkbox-unchecked-fill-color | Checked color for check control when is in unchecked status | #fff |
--dile-checkbox-label-color | label regular color | #303030 |
--dile-checkbox-label-disabled-color | Label color for disabled status | #303030 |
--dile-checkbox-font-weight | Font weight for te label | normal |
--dile-checkbox-size | Checkbox size | 20px |
Customization example
<style>
.customized {
--dile-checkbox-checked-color: #006;
--dile-checkbox-unchecked-color: #f66;
--dile-checkbox-fill-color: #fcc;
--dile-checkbox-unchecked-fill-color: #666;
--dile-checkbox-label-color: #c57;
--dile-checkbox-font-weight: bold;
--dile-checkbox-label-disabled-color: #ddd;
}
</style>
<dile-checkbox checked class="customized">Mark as urgent</dile-checkbox>