@astrouxds/rux-toggle v5.0.0
Toggle
A Toggle describes a state or value. Similar to a checkbox, a toggle allow users to change a setting between two states such as “On" or "Off.” Unlike a checkbox, a toggle button initiates an action with immediate effect.
Guidelines
Web Components Usage
1. Installation
Install the Astro UXDS Toggle package via Command Line (Preferred Method)
npm i --save @astrouxds/rux-toggle
You may use Yarn, NPM, or your Node package manager of choice. The --save
flag adds this component as a dependency in your package.json
file.
Alternatively, download the Astro UXDS Component Library source to your project.
Via CLI:
git clone https://bitbucket.org/rocketcom/astro-components.git
Or, download the Astro UXDS Components as a .zip
2. Import the Astro Toggle Web Component
This example assumes you're using the NPM package in node_modules
. Otherwise, import the component using the path to the Astro Components directory in your project.
import { RuxToggle } from "@astro-components/rux-toggle/rux-toggle.js";
3. Render the Astro Toggle Web Component
Pass properties as attributes of the Astro Toggle custom element:
<rux-toggle disabled="false" checked="false"></rux-toggle>
Properties
Property | Type | Default | Required | Description |
---|---|---|---|---|
disabled | Boolean | false | No | Disables the button via HTML disabled attribute. Button takes on a distinct visual state. Cursor uses the not-allowed system replacement and all keyboard and mouse events are ignored. |
checked | Boolean | false | No | Checks the button via HTML checked attribute. Button takes on a distinct "enabled" or "selected" visual state. |
Basic HTML Usage
1. Include the Astro UXDS CSS file
Latest release is available in Astro UXDS Styles repo.
<link rel="stylesheet" href="/your-project/path/astro.css" />
2. Markup the component using HTML and the Astro CSS classes
Astro CSS classes follow the BEM-style naming convention.
Configure the component using native HTML attributes.
<div class="rux-toggle">
<input class="rux-toggle__input" disabled id="toggle1" type="checkbox">
<label class="rux-toggle__button" for="toggle1"></label>
</div>
Attributes
Attribute | Type | Default | Required | Description |
---|---|---|---|---|
disabled | Boolean | false | No | Disables the button via HTML disabled attribute. Button takes on a distinct visual state. Cursor uses the not-allowed system replacement and all keyboard and mouse events are ignored. |
checked | Boolean | false | No | Checks the button via HTML checked attribute. Button takes on a distinct "enabled" or "selected" visual state. |
For more information about AstroUXDS usage outside of a Web Component environment, please see Astro UXDS Stylesheets
Revision History
4.1
- Replaced Polymer 3 implementation with LitElement for improved speed and interoperability with JS Frameworks as well as simpler template declaration now available in vanilla JavaScript.
3.0
- Breaking change to markup of toggle button
2.1
- Moved Pushbuttons to its own style sheet
1.4
- Added
rux_
prefixes and BEM-compatible classes to allsatcom_
-prefixed elements. NOTE:satcom_
will be removed in a future version - Removed prefixed linear gradients
- Removed prefixed transition
- Fixed added colon to checked pseudo class (e.g., checked became :checked)
- Alignment issue fixed on toggle button label
- Updated to WCAG colors
- Updated transition speed