open-consul/ui/packages/consul-ui/app/components/toggle-button
John Cowen 2200cde988
ui: Replaces almost all remaining instances of SASS variables with CSS (#11200)
From an engineers perspective, whenever specifying colors from now on we should use the form:

```
color: rgb(var(--tone-red-500));
```

Please note:

- Use rgb. This lets us do this like rgb(var(--tone-red-500) / 10%) so we can use a 10% opacity red-500 if we ever need to whilst still making use of our color tokens.
- Use --tone-colorName-000 (so the prefix tone). Previously we could use a mix of --gray-500: $gray-500 (note the left hand CSS prop and right hand SASS var) for the things we need to theme currently. As we no longer use SASS we can't do --gray-500: --gray-500, so we now do --tone-gray-500: --gray-500.

Just for clarity after that, whenever specifying a color anywhere, use rgb and --tone. There is only one reason where you might not use tone, and that is if you never want a color to be affected by a theme (for example a background shadow probably always should use --black)

There are a 2 or 3 left for the code editor, plus our custom-query values
2021-10-07 19:21:11 +01:00
..
README.mdx ui: Improves UI engineering docs (#9875) 2021-03-17 15:58:17 +00:00
index.hbs ui: Add 'Search Across' for finer grained searching (#9282) 2020-12-01 15:45:09 +00:00
index.js ui: Move to Workspaced Structure (#8994) 2020-10-21 15:23:16 +01:00
index.scss ui: Colocate old base components into our app/component folder (#10275) 2021-05-26 15:08:57 +01:00
layout.scss ui: Colocate old base components into our app/component folder (#10275) 2021-05-26 15:08:57 +01:00
skin.scss ui: Replaces almost all remaining instances of SASS variables with CSS (#11200) 2021-10-07 19:21:11 +01:00

README.mdx

---
class: ember
---
## ToggleButton

`<ToggleButton checked="checked" @onchange={{action 'change'}} as |api|>Toggle</ToggleButton>`

`<ToggleButton />` is a straightforward combination of a `<label>` and `<input type="checkbox" />` to allow you to easily setup CSS based (`input:checked ~ *`) visual toggling. The body of the component ends up inside the `<label>`.

Additionally, a `clickoutside` is currently included, so if the toggle is in an 'on' state, clicking outside the `<ToggleButton>` itself will un-toggle the component. This could be changed in a future version for this to be configurable/preventable and/or use/rely on a modifer instead.

### Arguments

| Argument/Attribute | Type | Default | Description |
| --- | --- | --- | --- |
| `checked` | `Boolean` | false | The default value of the toggle on/off (true/false) |
| `onchange` | `Function` |  | The action to fire when the data changes. Emits an Event-like object with a `target` that is a reference to the underlying standard DOM input element. |

### Methods/Actions/api

| Method/Action |  Description |
| --- | --- |
| `click` | Fire a click event on the ToggleButton/input which reverse the state of the toggle. |

### Example

Here is an example of a simple CSS based dropdown menu. Note: The general sibling selector (`~`) should be used as the label/button itself is the adjacent sibling (`+`).

```handlebars
<div class="menu">
  <ToggleButton>
	  Open Menu
  </ToggleButton>
  <ul>
    <li><a href="">Link 1</a></li>
    <li><a href="">Link 2</a></li>
  </ul>
</div>
```

```css
.menu input ~ ul {
  display: none;
}
.menu input:checked ~ ul {
  display: block;
}
```



### See

- [Component Source Code](./index.js)
- [TemplateSource Code](./index.hbs)

---