Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/luqin/react-icheck
:radio_button: iCheck components built with React. Highly customizable checkbox, radio buttons and radio group.
https://github.com/luqin/react-icheck
checkbox icheck radio react switch
Last synced: 20 days ago
JSON representation
:radio_button: iCheck components built with React. Highly customizable checkbox, radio buttons and radio group.
- Host: GitHub
- URL: https://github.com/luqin/react-icheck
- Owner: luqin
- Created: 2015-10-21T03:28:03.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-05-30T07:33:37.000Z (over 6 years ago)
- Last Synced: 2024-11-16T23:03:35.542Z (27 days ago)
- Topics: checkbox, icheck, radio, react, switch
- Language: JavaScript
- Homepage: https://luqin.github.io/react-icheck
- Size: 1.87 MB
- Stars: 177
- Watchers: 6
- Forks: 40
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# React-iCheck
[![NPM version][npm-badge]][npm] [![Build Status][travis-ci-image]][travis-ci-url]
[![Dependency Status][deps-badge]][deps]
[![devDependency Status][dev-deps-badge]][dev-deps]
[![peerDependency Status][peer-deps-badge]][peer-deps]
[iCheck](https://github.com/fronteed/icheck) components built with [React](http://facebook.github.io/react/). **No jQuery and Zepto**
Online demo: http://luqin.github.io/react-icheck
**Note: React-iCheck still in development**
## Features
* **Identical inputs across different browsers and devices** — both [desktop and mobile](#browser-support)
* **Touch devices support** — iOS, Android, BlackBerry, Windows Phone, Amazon Kindle
* **Keyboard accessible inputs** — `Tab`, `Spacebar`, `Arrow up/down` and other shortcuts
* **Customization freedom** — use any HTML and CSS to style inputs (try [6 Retina-ready skins](http://fronteed.com/iCheck/))
* **No jQuery and Zepto**
* **Screenreader accessible inputs** — [ARIA](https://developer.mozilla.org/en-US/docs/Accessibility/ARIA) attributes for VoiceOver and others
* **Lightweight size**
**By default, iCheck doesn't provide any CSS styles for wrapper divs** (if you don't use [skins](http://fronteed.com/iCheck/)).
## Usage
```sh
npm install react-icheck icheck --save
```
```js
import 'icheck/skins/all.css'; // or single skin css
import {Checkbox, Radio} from 'react-icheck';
// Checkbox with label
// without label
First name
// Radio
```
```js
import {Radio, RadioGroup} from 'react-icheck';
```
More examples: [Online demo](http://luqin.github.io/react-icheck), [Source](https://github.com/luqin/react-icheck/tree/master/examples)
## Browser support
iCheck is verified to work in Internet Explorer 6+, Firefox 2+, Opera 9+, Google Chrome and Safari browsers. Should also work in many others.
Mobile browsers (like Opera mini, Chrome mobile, Safari mobile, Android browser, Silk and others) are also supported. Tested on iOS (iPad, iPhone, iPod), Android, BlackBerry and Windows Phone devices.
## Contribute
Dev base on [react-component-tools](https://github.com/luqin/react-component-tools)
```sh
$ git clone https://github.com/luqin/react-icheck.git
$ cd react-icheck
$ npm install
$ npm start # Run the docs site in development mode. This will watch for file changes as you work. And auto refresh the page to see the updates.
```
[npm-badge]: http://badge.fury.io/js/react-icheck.svg
[npm]: https://www.npmjs.com/package/react-icheck
[deps-badge]: https://david-dm.org/luqin/react-icheck.svg
[deps]: https://david-dm.org/luqin/react-icheck
[dev-deps-badge]: https://david-dm.org/luqin/react-icheck/dev-status.svg
[dev-deps]: https://david-dm.org/luqin/react-icheck#info=devDependencies
[peer-deps-badge]: https://david-dm.org/luqin/react-icheck/peer-status.svg
[peer-deps]: https://david-dm.org/luqin/react-icheck#info=peerDependencies
[travis-ci-image]: https://travis-ci.org/luqin/react-icheck.svg
[travis-ci-url]: https://travis-ci.org/luqin/react-icheck