iulianraduat / ios-switch-material-ui

A material-ui component which implements a iOS like switch

ios-switch-material-ui

A material-ui component which implements a iOS like switch

---

Demo

You can access the storybook for this component here.

Props

The component accepts the props defined bellow in the table.

Props accepted by IosSwitchMaterialUi

Name	Type	Required	Default	Description
aspectRatio	number	no	2	The width/height raport
colorKnobOnLeft	string	no	#eeeeee	The color of the knob when it is on the left
colorKnobOnRight	string	no	#5269d8	The color of the knob when it is on the right
colorSwitch	string	no	#e2e2e2	The color of the switch
defaultKnobOnLeft	boolean	no	false	The initial position of the knob
disabled	boolean	no	false	The component is disabled
knobOnLeft	boolean	no	false	If true, the knob is on the left, othwise on the right
knobSize	number	no	18	The size of the knob
onChange	(knobOnLeft: boolean) => void	no	undefined	The callback function called when the knob changes its position

---

Versions

IosSwitchMaterialUi uses	Material-ui	React
1.0.x	3.6.0	16.6.3
1.1.x	3.9.2	16.8.1
1.2.x	3.9.3	16.8.6
2.0.x	4.0.2	16.8.6
2.1.x	4.2.0	16.8.6
3.0.x	4.2.1	16.8.6
3.1.x	4.3.2	16.9.0
3.2.x	4.9.0	16.9.0
3.3.x	4.9.7	16.9.0
3.4.x	4.10.2	16.9.0
3.5.x	4.11.0	16.9.0
3.6.x	4.11.3	16.9.0 or 17.0.0
3.7.x	4.12.3	16.9.0 or 17.0.0
4.0.x	5.10.17	18.0.0
4.1.x	5.14.20	18.0.0

About versioning schema used for IosSwitchMaterialUi

• Major - it will be increased if the major version of the dependat package changes or there are breaking changes in the code of IosSwitchMaterialUi
• Minor - it will be increased if no major version of the dependat package changes, but there are changes of the minor or patch versions of it
• Patch - it will be increased if there are no changes of the dependat packages, but there are non breaking changes in the code of IosSwitchMaterialUi

---

Example

The base component which allows to create read-only or creatable select components for selecting only one or more values:

import * as React from 'react';
import IosSwitchMaterialUi from 'ios-switch-material-ui';

class App extends React.Component {
  render() {
    return (
      <div className="App">
        <IosSwitchMaterialUi
          colorKnobOnLeft="red"
          colorKnobOnRight="blue"
          colorSwitch="aqua"
          onChange={this.handleChange}
        />
      </div>
    );
  }

  handleChange = (knobOnLeft: boolean) => {
    console.log(knobOnLeft);
  };
}

export default App;

---

Changelog

1.0.0

• ios-switch-material-ui is made publicly available

1.1.0

• Updated packages

1.2.0

• Updated packages

2.0.0

• Updated packages

2.1.0

• Updated packages

3.0.0

• Made the component to be controlled and uncontrolled
• Added a storybook
• Updated packages

3.0.1

• Updated typescript definition of the component

3.0.2

• Removed usage of lodash

3.0.3

• Fixed bug related to not changing the position of the knob in controlled mode

3.1.0

• Updated packages

3.2.0

• Updated packages

3.3.0

• Updated packages
• Moved from npm to yarn

3.4.0

• Updated packages

3.5.0

• Updated packages

3.5.1

• Fixed crash produced by "export * from"

3.6.0

• Accepting React 17 as peerDependencies
• Fixed security warnings

3.7.0

• Updated the packages

4.0.0

• Supports minimum React 18

4.1.0

• Updated the packages

4.1.1

• Fixed bundled lib