vue-toggle-component makes an ease to use, lightweight and highly customizable toggle component for Vue.js. This component is available in both light and dark mode and it supports Vue 3.
- 🍞 Easy: Easy use with minimal required properties.
- 🍤 Tiny: Small footprint < 4kb which makes your apps faster to load.
- ✅ Accessible: ARIA attributes in the component which makes it very accessible.
# install with yarn
yarn add vue-toggle-component
# install with npm
npm install vue-toggle-component --save<template>
<vue-toggle title="Toggle me" name="vue-toggle"/>
</template>
<script>
import VueToggle from 'vue-toggle-component';
export default {
name: 'App',
components: { VueToggle },
}
</script>| Property name | Type | Default | Required | Description |
|---|---|---|---|---|
| name | String |
❌ | ✅️ | Set's the name value of the input (checkbox). Useful for persisting data. |
| title | String |
❌ | ✅ | The title that is displayed next to the toggle. |
| activeColor | String |
#9FD6AE |
❌ | The color that is displayed when the toggler is active. |
| darkTheme | Boolean |
false |
❌ | Set's dark mode to active. (note that this will not change the background like in the preview GIF) |
| disabled | Number |
false |
❌ | Disables the toggler. |
| fontSize | String |
16px |
❌ | Sets the font size of the text next to the toggle |
| fontWeight | Boolean |
normal |
❌ | Sets the font weight of the text next to the toggle. |
| toggled | Boolean |
true |
❌ | Sets the default value for the toggler. |
When you toggle the component the component emits the toggle event. You can use the event using the example below. The value in the event is the whether the toggler is toggled or not.
<template>
<VueToggle title="Toggle me" name="VueToggle" @toggle="doSomething"/>
</template>
<script>
import VueToggle from "vue-toggle-component";
export default {
name: 'App',
components: {
VueToggle
},
methods: {
doSomething(value) {
// value = true || false.
}
},
}
</script>The main v1 version supports Vue 3.x only, for previous versions of Vue, check the following the table.
| Vue version | vue-toggle-component version |
|---|---|
2.x |
0.1.x |
3.x |
1.x |
MIT