/react-materialize

Material design for react, powered by materializecss

Primary LanguageJavaScriptMIT LicenseMIT

React Materialize

Join the chat at https://gitter.im/react-materialize/react-materialize Build Status npm version code style: prettier

Material design components for react, powered by materializecss.

New materialize-css version and removal of jquery is being developed under the branch 3.0.0-beta.0, please try it out and file any issue under the 3.0.0 label. Thanks!

Join us on discord

Install

npm install react-materialize

Use

HTML Setup (from materializecss)

<!DOCTYPE html>
<html>
  <head>
    <link rel="stylesheet" href="https://fonts.googleapis.com/icon?family=Material+Icons">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/materialize/0.100.2/css/materialize.min.css">
  </head>
  <body>
    <script src="https://code.jquery.com/jquery-2.1.1.min.js"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/materialize/0.100.2/js/materialize.min.js"></script>
    <script src="path/to/your/bundle.js"></script>
  </body>
</html>

JS (ES6)

import { Button, Card, Row, Col } from 'react-materialize';

Docs && Examples

See documentation for live examples. Try out the boilerplate.

How does it compare to X.Y.Z?

The main goal of this project is to provide react component for materializecss, at the current stage, I am trying to implement all possible widgets that are supported by materializecss. Please create an issue on github if you find you desired component is not available.

There are other material design components for react.js, e.g. material-ui, which is more mature and popular than this one. The main advantage of this project over e.g. material-ui is that it provides a grid system similar to react-bootstrap. Another advantage over material-ui is that react-materialize does not include css in the js - which can be cumbersome to some project's architecture.

Contributions

Yes, please!

We have a help-wanted label in the issues page for convenience