A CSS library that implements the Material Design spec
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
demo_fonts
demo_icons
icon
CNAME
LICENSE.txt
README.md
cache.manifest
index.html
material-depth.css
material-elements.css
material-touch.js
material-widgets.css
select_arrow.png

README.md

#MaterialZ

MaterialZ is a CSS library that implements Google's Material Design guidelines in plain CSS.

##Material-ize your site If you want Material-/Paper-themed HTML elements on your page, you just need to include “material-elements.css”, which styles most basic HTML elements.

See examples and code snippets at materialz.zmyaro.com/#elements →

##Add Material widgets You can use widgets such as action bars, lists, and cards by adding “material-widgets.css” and specifying classes:

  • To add a top app bar, add an element with the appBar class (e.g., <header class="appBar">).
  • To add a toolbar, add an element with role="toolbar" class (e.g., <div role="toolbar">). Toolbar buttons are flat and circular by dfault.
    • An Android action bar is frequently just an app bar with toolbar buttons - <header class="appBar" role="toolbar">.
  • To add a list, add a <ul> or <ol> element with the class list (e.g., <ul class="list">).
  • To add a card, add the card class to an element. You may wish to use the depth classes to "raise" the card as well (see below).

Note: adding the widgets stylesheet will automatically add padding to the body for the default app bar size.

See examples and code snippets at materialz.zmyaro.com/#widgets →

##Add depth You can add shadows to elements with classes z1-z5. These are best used with <button>s (e.g., <button class="z1"> for a raised button), .cards (e.g., <div class="card z2">), and .appBars (e.g., <header class="appBar z3">).

See examples and code snippets at materialz.zmyaro.com/#depth →

##Make it work on older mobile browsers One great use of MaterialZ is to make mobile web sites look like native Android L apps. MaterialZ includes a script to make sure all widgets respond to touch properly in mobile WebKit (Mobile Safari, Android Browser, Chrome for Android).

  • Make sure you include the “material-touch.js” file.
  • Add a script tag to your page: <script type="text/javascript" src="material-touch.js"></script>.

##The Roboto Font material-elements.css imports basic Roboto and Roboto Mono by default. If you need more weights or character sets, you can load them through Google Web Fonts.

##Known issues

  • Certain form elements (checkboxes, radio buttons) are only properly themed in WebKit-based browsers (e.g. Safari, Chrome) and partially themed in Presto (older Opera) and the latest version of Trident (IE10+).
  • Certain form elements, such as range sliders, are unsupported in some older browsers.

The above issues are the result of browser limitations or lack of documented solutions.

##Contributing to MaterialZ Contributions to this project are welcome. Please follow standard commit guidelines.