@material/react-checkbox

React Checkbox

A React version of an MDC Checkbox.

Installation

npm install @material/react-checkbox

Usage

Styles

with Sass:

import '@material/react-checkbox/index.scss';

with CSS:

import "@material/react-checkbox/dist/checkbox.css";

Javascript Instantiation

import React from 'react';
import Checkbox from '@material/react-checkbox';

class MyApp extends React.Component {
  state = {checked: false, indeterminate: false};

  render() {
    return (
      <React.Fragment>
        <Checkbox
          nativeControlId='my-checkbox'
          checked={this.state.checked}
          indeterminate={this.state.indeterminate}
          onChange={(e) => this.setState({
            checked: e.target.checked,
            indeterminate: e.target.indeterminate})
          }
        />
        <label htmlFor='my-checkbox'>My Checkbox</label>
      </React.Fragment>
    );
  }
}

NOTE: In order to get access to the checked or indeterminate value, you must add an onChange handler that accepts an Event and updates state as shown above.

Props

Prop Name	Type	Description
className	String	Classes to be applied to the checkbox element
checked	Boolean	Indicates whether the checkbox is checked ("on")
indeterminate	Boolean	Indicates whether the checkbox is indeterminate
disabled	Boolean	Indicates whether the checkbox is disabled
nativeControlId	String	Id attached to the native control for relationship with the label

Sass Mixins

Sass mixins may be available to customize various aspects of the Components. Please refer to the MDC Web repository for more information on what mixins are available, and how to use them.

Advanced Sass Mixins

Changelog

0.9.0 (2019-01-23)

Bug Fixes

• list: Support null as a child element for ListItem (#584) (bf487d7)
• ripple: add missing dependency to package.json (#612) (f6e4725)
• ripple: Adds HTMLElement shim to fix regression for SSR projects (#592) (3aaf871)
• text field: adds missing adapter method notifyIconAction on Icon (#600) (632896a)
• top-app-bar: make top app bar props optional (#587) (1585c95)

Features

• button: trailing icon support (#622) (796850b)
• dialog: new component (#611) (555e61f)

<a name="0.8.0"></a>