0.3.0 • Published 1 year ago

@justeat/f-toggle-switch v0.3.0

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
1 year ago

f-toggle-switch

A component to switch a single setting on/off.


npm version Coverage Status Known Vulnerabilities


Usage

Installation

Install the module using npm or Yarn:

yarn add @justeat/f-toggle-switch
npm install @justeat/f-toggle-switch

Vue Applications

You can import it in your Vue SFC like this (please note that styles have to be imported separately):

import ToggleSwitch from '@justeat/f-toggle-switch';
import '@justeat/f-toggle-switch/dist/f-toggle-switch.css';

export default {
    components: {
        ToggleSwitch
    }
}

If you are using Webpack, you can import the component dynamically to separate the toggle-switch bundle from the main bundle.client.js:

import '@justeat/f-toggle-switch/dist/f-toggle-switch.css';

export default {
    components: {
        // …
        ToggleSwitch: () => import(/* webpackChunkName: "toggle-switch" */ '@justeat/f-toggle-switch')
    }
}

Configuration

Props

There may be props that allow you to customise its functionality.

The props that can be defined are as follows (if any):

PropTypeDefaultDescription
checkedBooleanfalseToggles the toggle-switch on and off
disabledBooleanfalseSets the toggle-switch to disabled
aria-labelledbyString''The id for an element that will 'label' the toggle-switch
aria-describedbyString''The id for an element describing what the toggle-switch will control
dirString'ltr'The reading/writing direction

Events

The events that can be subscribed to are as follows (if any):

EventDescription
updateFired when a user changes the state of the toggle-switch. Payload contains the updated value of the toggle-switch.

Development

Start by cloning the repository and installing the required dependencies:

$ git clone git@github.com:justeat/fozzie-components.git
$ cd fozzie-components
$ yarn

Change directory to the f-toggle-switch package:

$ cd packages/components/atoms/f-toggle-switch

Testing

To test all components, run from root directory. To test only f-toggle-switch, run from the ./fozzie-components/packages/components/atoms/f-toggle-switch directory.

Unit and Integration tests

yarn test

Component and Accessibility Tests

# Note: Ensure Storybook is running when running the following commands
cd ./fozzie-components

yarn storybook:build
yarn storybook:serve-static

yarn test-component:chrome

### Accessibility tests
```bash
yarn test-a11y:chrome

Documentation to be completed once module is in stable state.

0.3.0

1 year ago

0.2.0

2 years ago

0.1.0

2 years ago