lun3322 / bootstrap-material-design

0 Watch 1 Star 0 Fork 0
加入码云
与超过 300 万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
暂无描述 展开 收起

Kevin Ross 最后提交于 .
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README.md 12.76 KB

bootstrap-material-design

WARNING: THESE DOCS RELATE TO 0.5.0, WHICH IS A SIGNIFICANT CHANGE FROM PREVIOUS VERSIONS.

build status gratipay Bower version

banner

This Bootstrap theme is an easy way to use the new Material Design guidelines by Google in your Bootstrap 3 based application. Just include the theme, after the Bootstrap CSS and include the JavaScript at the end of your document (just before the </body> tag), and everything will be converted to Material Design (Paper) style.

NOTE: This theme is still in development, it could be used on production websites but I can't guarantee compatibility with previous versions.

Check out the demo at this link.

How to install

You may install this theme using Bower or Meteor:

  • Bower : bower install bootstrap-material-design
  • Meteor: meteor add fezvrasta:bootstrap-material-design

If you prefer, you can include this framework in your project using our official CDN:

Getting started

Add the necessary links to your <head element for fonts To embed Roboto into your web page, copy the code as the first element in the

of your HTML document.
  <!-- Material Design fonts -->
  <link rel="stylesheet" href="http://fonts.googleapis.com/css?family=Roboto:300,400,500,700" type="text/css">
  <link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">

  <!-- Bootstrap -->
  <link href="//maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css" rel="stylesheet">

  <!-- Bootstrap Material Design -->
  <link href="dist/css/bootstrap-material-design.css" rel="stylesheet">
  <link href="dist/css/ripples.min.css" rel="stylesheet">

Support

If you like this project you may support it by donating via Gittip, starring this repository or reporting issues. All issues filed should be reduced to a CodePen test case where possible.

gittip issues

Contribute

Please see the CONTRIBUTING.md file.

Development

We are using Grunt to automate the workflow and build process. Ensure you have nodejs installed and grunt-cli installed globally. After cloning the repo, run npm install to ensure you have all dev dependencies.

Grunt

  • grunt build - run the tests and compile the less/sass. See Gruntfile.js for details on targets.
  • grunt test - browser-based Jasmine unit tests.
  • grunt serve - build and fire up an http server with live-reload and a watch for development purposes.

LESS & SASS

The bootstrap 3.x compatible version (master) is developed using LESS, with an automated conversion to SASS.

The upcoming 4.x version (no branch yet) will be developed using SASS.

Documentation

Material Design (spec) for Bootstrap provides styles for bootstrap based markup to comply with Material Design concepts.

Customization

Themes

NOTE: (In active) development First, this is probably not what you think when a 'theme' is mentioned.

The material design specification mentions light vs. dark themes throughout. By default, the source is written assuming a light theme is being used, but as reviews/refactorings occur, the .theme-dark marker class is being used to denote differences.
This could be used on the top level elements such as body or .container. Effort on this is just beginning, but search the codebase for .theme-dark to see variations. Help/PR's welcome.

Colors

There are 17 color variations (in addition to the classic 4 variations) described by the Material Design color palette:

palette

TODO: Describe variable override via less/sass
  • describe variables, and the well defined material design colors in _colors.less
TODO: Describe customization/compilation of static css

Forms

All inputs should be surrounded by a standard .form-group, and as such material.js will enforce this. The .form-group is used to signal different input styles and variations. See the examples for variations.

Sizing

In general, it is preferred that sizing be altered with either .form-group-sm or .form-group-lg. Due to the interconnected nature of inputs, labels, margins and padding, material.js will convert any use of .input-sm or .input-lg to .form-group-sm or .form-group-lg in order to reduce the necessary markup/variations and get a standard sizing with fewer side effects.

Buttons

Add .btn-flat to a button to make it flat, without shadows. Add .btn-raised to a button to add a permanent shadow to it.

Inputs

Labels

The following classes should be placed on the .form-group to indicate the label style:

  • .label-floating - renders label as a placeholder, that animates above the field upon focus
  • .label-static - renders label above the field. input placeholder attribute can also be used in conjunction
  • .label-placeholder - renders a label as a placeholder only
  • no label, but use of input placeholder attribute - same rendering as .label-placeholder
Hints

Upon focus, a hint can be displayed. Use any p | span with .help-block.

Examples
  <div class="form-group label-static">
    <label for="i2" class="control-label">label-static</label>
    <input type="email" class="form-control" id="i2" placeholder="placeholder attribute">
    <p class="help-block">This is a hint as a <code>p.help-block.hint</code></p>
  </div>

  <div class="form-group label-floating">
    <label for="i5" class="control-label">label-floating</label>
    <input type="email" class="form-control" id="i5">
    <span class="help-block">This is a hint as a <code>span.help-block.hint</code></span>
  </div>

  <div class="form-group label-placeholder">
    <label for="i5p" class="control-label">label-placeholder</label>
    <input type="email" class="form-control" id="i5p">
    <span class="help-block">This is a hint as a <code>span.help-block.hint</code></span>
  </div>

Radio, Checkbox, Toggle

Be sure to inspect the source of the demos to find proper markup examples. Remember to use the proper HTML markup.

Radio example:

<div class="form-group">
  <label class="col-lg-2 control-label">Radios</label>

  <div class="col-lg-10">
    <div class="radio radio-primary">
      <label>
        <input type="radio" name="optionsRadios" checked="">
        Option one
      </label>
    </div>
    <div class="radio radio-primary">
      <label>
        <input type="radio" name="optionsRadios">
        Option two
      </label>
    </div>
  </div>
</div>

Icons

Material Design for Bootstrap includes 490 original Material Design icons! These icons are extracted from the original Google sources and are licensed under the BSD license. They are provided as an iconic and easy to use font.

Variations are available for every icon, including the original Bootstrap icons.

The syntax to add a Material icon is:

<i class="icon icon-material-favorite"></i>

Cards

A card will expand to fill all of the available width (e.g. column's width). Card's height will be automatically resized to match width.

Here is an example on how to use it:

<div class="card">

    <div class="card-height-indicator"></div>

    <div class="card-content">

        <div class="card-image">
            <img src="./image.jpg" alt="Loading image...">
            <h3 class="card-image-headline">Lorem Ipsum Dolor</h3>
        </div>

        <div class="card-body">
            <p>Lorem Ipsum is simply dummy text of the printing and typesetting industry.</p>
        </div>

        <footer class="card-footer">
            <button class="btn btn-flat">Share</button>
            <button class="btn btn-flat btn-warning">Learn More</button>
        </footer>

    </div>

</div>

Cards will adapt to column's width. The card below will have width equal to col-lg-6:

<div class="row">
    <div class="col-lg-3"></div>

    <div class="col-lg-6">
        <div class="card">
            ...
        </div>
    </div>

    <div class="col-lg-3"></div>
</div>

material.js

material.js is a jQuery plugin that adds some magic to your markup and allows Material Design for Bootstrap to style some elements like inputs, checkboxes, radios etc.

Functions

  • $.material.init() - shortcut to run all the following commands:
  • $.material.ripples() will apply ripples.js to the default elements.
  • $.material.input() will enable the MD style to the text inputs, and other kind of inputs (number, email, file etc).
  • $.material.checkbox(): will enable the MD style to the checkboxes (remember to follow the markup guidelines explained in the Inputs section.
  • $.material.radio(): will enable the MD style to the checkboxes (remember to follow the markup guidelines explained in the Inputs section.

Apply only to specific elements

Every function expects an optional value that will be used as a selector for the function; for example, $.material.ripples("#selector, #foobar") will apply Ripples.js only to #selector and #foobar. The functions that allows an optional selector are $.material.ripples, $.material.input, $.material.checkbox and $.material.radio.

You can even override the default values using the $.material.options function. The default values are:

$.material.options = {
    "withRipples": ".btn:not(.btn-link), .card-image, .navbar a:not(.withoutripple), .nav-tabs a:not(.withoutripple), .withripple",
    "inputElements": "input.form-control, textarea.form-control, select.form-control",
    "checkboxElements": ".checkbox > label > input[type=checkbox]",
    "radioElements": ".radio > label > input[type=radio]"
}

Arrive.js support

If you need to dynamically add elements to your DOM then you may need to include Arrive.js before Material.js. This will automatically apply material.js to every new element added via JavaScript.

Plugins

Material Design for Bootstrap comes with styling support for various external scripts:

SnackbarJS

Create snackbars and toasts with the SnackbarJS plugin. The default toast style is the squared one (snackbar style). If you like to use the rounded style (toast style), please add the toast class to the style option of SnackbarJS.

RipplesJS

This is part of the Material Design for Bootstrap project and is a plain JavaScript script which creates the ripple effect when clicking on the specified elements. At the moment RipplesJS does not have its own repository but it will probably have one in the future.

You may want to set a custom color to the ripples of a specific element, to do so write:

<button class="btn btn-default" data-ripple-color="#F0F0F0">Custom ripple</button>

noUiSlider

Make cross-browser sliders and get them styled with Material Design thanks to the support provided by this theme. Read more about noUiSlider here.

Dropdown.js

Finally a dropdown plugin that transforms select inputs in nice dropdowns and does not drive you crazy. Read more about Dropdown.js here.

Selectize.js

Transform select and multi-select inputs into advanced text inputs. Material Design for BS provides a full replacement of the plugin's CSS, so don't include it. Read more about selectize.js.

Bootstrap Material Datepicker

A Material Design datepicker created to be used with Material Design for Bootstrap.
Read more about Bootstrap Material Datepicker

Compatibility

Currently, Material Design for Bootstrap supports Google Chrome (tested v37+), Mozilla Firefox (tested 30+), and Internet Explorer (tested 11+). Mobile browsers are not currently tested but they may work.

License

MIT License

项目点评 ( 0 )

你可以在登录后,发表评论

搜索帮助

12_float_left_people 12_float_left_close