reagent-material-ui

reagent-material-ui is a Reagent wrapper for Material UI v4.

The purpose of this library is to help ClojureScript/Reagent developers use a modern React UI library without the hassle that Reagent/React interop usually is. It is meant to be comprehensive and up to date.

Usage

If you aren't familiar with Material UI or its documentation yet, that is the best place to start. Their examples are very good. and this library tries to follow the original ideas as well as possible. See the example project for a simple usage example.

To add Material UI to an existing Reagent project, just add this library to your dependencies:

[arttuka/reagent-material-ui "4.8.3-0"]

Most of the library is in the form of regular Reagent components. Each component is contained in a namespace that mirrors Material UI's modules. For example, @material-ui/core/IconButton becomes reagent-material-ui.core.icon-button/icon-button and @material-ui/icons/Menu becomes reagent-material-ui.icons.menu/menu.

Namespace reagent-material-ui.components contains a copy of each component from @material-ui/core for ease of use.

Namespace reagent-material-ui.colors contains all color definitions from @material-ui/core/colors. The colors are organized in a single namespace, so @material-ui/core/colors/red becomes reagent-material-ui.colors/red.

Namespace reagent-material-ui.styles contains helper functions and components from @material-ui/core/styles.

material-ui-pickers

This library also includes date and time picker components from Material-UI Pickers.

Namespace reagent-material-ui.pickers contains all components from @material-ui/pickers.

Namespace reagent-material-ui.cljs-time-utils contains an utility package that lets you use the pickers with cljs-time (goog.date) date objects. The locale prop must be an instance of goog.i18n.DateTimeSymbols. The default locale is used if no locale prop is given. See the example project for a usage example.

Common pitfalls in Reagent/React interop

• Some components want to have a React node as a prop. A Reagent component is not good enough and will just result in errors about invalid React nodes. reagent.core/as-element can turn a Reagent component into a React node.
• React hooks can't be used in most Reagent components. More information.
• Higher order React components can only deal with components that take all their parameters (including children) in a single map.

For more information, check out Reagent's interop guide.

Development

Bug reports, pull requests and ideas for improvement are very welcome. No external services are needed for getting the library up and running.

Tests

There are three ways to run tests:

• Single run from the command line with lein test
• Web test frontend with automatic code reloading with lein figwheel
• The web test frontend and CLJS-REPL is also available via nREPL by running (user/start)

Icon files are excluded from Figwheel dev build, because constantly rebuilding such a large number of files causes Figwheel to break.

The build process also includes lein cljfmt.

Version numbers

The project follows Material UI's version numbering.

• Current @material-ui/core version: 4.8.3
• Current @material-ui/icons version: 4.8.3
• Current @material-ui/pickers version: 3.2.7

License

This project is licensed under the Eclipse Public License 2.0.

Parts of example project are copyright (c) 2013-2017 Dan Holmsand and Reagent contributors, used under the terms of the MIT License. Material UI Icons are copyright (c) Material UI contributors, used under the terms of the MIT License.