mdl-selectfield

mdl-selectfield for material-design-lite

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
mdl-selectfield
11041.0.46 years ago7 years agoMinified + gzip package size for mdl-selectfield in KB

Readme

mdl-selectfield
Material Design Lite selectfield component (https://github.com/google/material-design-lite)
Bower Version NPM Version license
bitHound Overall Score bitHound Dependencies bitHound Dev Dependencies bitHound Code
A custom implementation of a selectfield component for Material Design Lite

Live Example

Check out the CodePen

Install

Via bower:
```` bower install mdl-selectfield ````
Or via npm:
```` npm install mdl-selectfield ````
Then include in your html:
```` ... ````

Basic use

To use any MDL component, you must include the minified CSS and JavaScript files using standard relative-path references in the <head> section of the page, as described in the MDL Introduction.

To include a MDL select field component:

 1. Code a <div> element to hold the text field.
<div>
...
</div>
 2. Inside the div, code an <select> element, add the options and add an id attribute of your choice.
<div>
  <select id="gender">
    <option value=""></option>
    <option value="male">Male</option>
    <option value="female">Female</option>
  </select>
</div>
 3. Also inside the div, after the select field, code a <label> element with a for attribute whose value matches the select element's id value, and a short string to be used as the field's placeholder text.
<div>
  <select id="gender">
    <option value=""></option>
    <option value="option1">option 1</option>
    <option value="option2">option 2</option>
  </select>
  <label for="gender">User gender</label>
</div>
 4. Add one or more MDL classes, separated by spaces, to the div container, select field, select label, and error message using the class attribute.
<div class="mdl-selectfield mdl-js-selectfield">
  <select id="gender" class="mdl-selectfield__select">
    <option value=""></option>
    <option value="option1">option 1</option>
    <option value="option2">option 2</option>
  </select>
  <label class="mdl-selectfield__label" for="gender">User gender</label>
  <span class="mdl-selectfield__error">Select a value</span>
</div>
The select field component is ready for use.

Examples

Select field with a standard label.
<div class="mdl-selectfield mdl-js-selectfield">
  <select id="gender" class="mdl-selectfield__select">
    <option value=""></option>
    <option value="option1">option 1</option>
    <option value="option2">option 2</option>
  </select>
  <label class="mdl-selectfield__label" for="gender">User gender</label>
  <span class="mdl-selectfield__error">Select a value</span>
</div>

Select field with a floating label.
<div class="mdl-selectfield mdl-js-selectfield mdl-selectfield--floating-label">
  <select id="gender" class="mdl-selectfield__select">
    <option value=""></option>
    <option value="option1">option 1</option>
    <option value="option2">option 2</option>
  </select>
  <label class="mdl-selectfield__label" for="gender">User gender</label>
  <span class="mdl-selectfield__error">Select a value</span>
</div>

Select field with a standard label, and error message.
<div class="mdl-selectfield mdl-js-selectfield mdl-selectfield--floating-label">
  <select id="gender" class="mdl-selectfield__select">
    <option value=""></option>
    <option value="option1">option 1</option>
    <option value="option2">option 2</option>
  </select>
  <label class="mdl-selectfield__label" for="gender">User gender</label>
  <span class="mdl-textfield__error">Select a value</span>
</div>

Select field with a floating label and icon.
<div class="mdl-selectfield mdl-js-selectfield mdl-selectfield--floating-label">
  <select id="gender" class="mdl-selectfield__select">
    <option value=""></option>
    <option value="option1">option 1</option>
    <option value="option2">option 2</option>
  </select>
  <div class="mdl-selectfield__icon"><i class="material-icons">arrow_drop_down</i></div>
  <label class="mdl-selectfield__label" for="gender">User gender</label>
</div>