aurelia-material

Aurelia wrapper for Material Design Lite, forked from the one created by redpelicans. See below for differences.

Material Design Lite has been designed for static html sites. To use it on dynamic ones, we have to register explictly new DOM elements (see MDL)

Aurelia Material will do that for you transparently while keeping MDL flexibility.

See online Demo

Principles

We created the CustomAttribute mdl in charge of the registration of dynamic elements (all elements after index.html will be associated dynamically to the DOM with Aurelia)

So instead of writing:

<button class="mdl-button mdl-js-button mdl-button--fab mdl-button--colored">
  <i class="material-icons">add</i>
</button>

You will write in your views:

<button mdl="button" class="mdl-button--fab mdl-button--colored">
  <i class="material-icons">add</i>
</button>

And that's all...

mdl values are :

[ 'button',
  'textfield',
  'layout',
  'menu',
  'data-table',
  'tabs',
  'slider',
  'tooltip',
  'progress',
  'spinner',
  'badge',
  'switch',
  'radio',
  'icon-toggle',
  'checkbox',
  'snackbar' ]

Some MDL elements are not in the list because we don't have to register them, so we can use them as it.

Install

In your project install the plugin via jspm with following command

  $ jspm install github:BBosman/aurelia-material

Make sure you use manual bootstrapping. In order to do so open your index.html and locate the element with the attribute aurelia-app:

<body aurelia-app="main">
...

Update main.js in your src folder with following content:

export function configure(aurelia) {
  aurelia.use
    .standardConfiguration()
    .developmentLogging()
    // Install the plugin
    .plugin('BBosman/aurelia-material');

  aurelia.start().then(a => a.setRoot());
}

Include material design css in your index.html

    <link rel="stylesheet" href="https://storage.googleapis.com/code.getmdl.io/1.1.3/material.indigo-pink.min.css">

Use wrapped MDL components in your hml views as explained below.

See online Demo

Differences

This fork differs from the redpelicans version in the following ways:

Dropped the jQuery dependency.
Updated the build to use Babel 6.
General cleanup and tweaks.

bbosman / aurelia-material Goto Github PK