Form Elements
Text fields allow user input. The border should light up simply and clearly indicating which field
the user is currently editing. You must have a .input-field
div
wrapping your input and label. This helps our jQuery animate the label. This is only used in our
Input and Textarea form elements.
The validate class leverages HTML5 validation and will add a valid
and invalid
class accordingly. If you don't want the Green and
Red validation states, just remove the validate
class from your
inputs.
<div class="row">
<form class="col s12">
<div class="row">
<div class="input-field col s6">
<input placeholder="Placeholder" id="first_name" type="text" class="validate">
<label for="first_name">First Name</label>
</div>
<div class="input-field col s6">
<input id="last_name" type="text" class="validate">
<label for="last_name">Last Name</label>
</div>
</div>
<div class="row">
<div class="input-field col s12">
<input disabled value="I am not editable" id="disabled" type="text" class="validate">
<label for="disabled">Disabled</label>
</div>
</div>
<div class="row">
<div class="input-field col s12">
<input id="password" type="password" class="validate">
<label for="password">Password</label>
</div>
</div>
<div class="row">
<div class="input-field col s12">
<input id="email" type="email" class="validate">
<label for="email">Email</label>
</div>
</div>
<div class="row">
<div class="col s12">
This is an inline input field:
<div class="input-field inline">
<input id="email" type="email" class="validate">
<label for="email" data-error="wrong" data-success="right">Email</label>
</div>
</div>
</div>
</form>
</div>
If you are having trouble with the labels overlapping prefilled content, Try adding class="active"
to the label.
You can also call the function M.updateTextFields();
to reinitialize all the Materialize labels on the page if you are dynamically adding inputs.
<div class="row">
<div class="input-field col s6">
<input value="Alvin" id="first_name2" type="text" class="validate">
<label class="active" for="first_name2">First Name</label>
</div>
</div>
$(document).ready(function() {
M.updateTextFields();
});
You can add an icon prefix to make the form input label even more clear. Just add an icon with the class
prefix
before the input and label.
<div class="row">
<form class="col s12">
<div class="row">
<div class="input-field col s6">
<i class="material-icons prefix">account_circle</i>
<input id="icon_prefix" type="text" class="validate">
<label for="icon_prefix">First Name</label>
</div>
<div class="input-field col s6">
<i class="material-icons prefix">phone</i>
<input id="icon_telephone" type="tel" class="validate">
<label for="icon_telephone">Telephone</label>
</div>
</div>
</form>
</div>
You can add custom validation messages by adding either data-error
or data-success
attributes to your input field labels.
<div class="row">
<form class="col s12">
<div class="row">
<div class="input-field col s12">
<input id="email" type="email" class="validate">
<label for="email" data-error="wrong" data-success="right">Email</label>
<span class="helper-text" data-error="wrong" data-success="right">Helper Text</span>
</div>
</div>
</form>
</div>
Textareas allow larger expandable user input. The border should light up simply and clearly indicating
which field the user is currently editing. You must have a .input-field
div wrapping your input and label. This helps our jQuery animate the label. This is only used in our
Input and Textarea form elements.
Textareas will auto resize to the text inside.
<div class="row">
<form class="col s12">
<div class="row">
<div class="input-field col s12">
<textarea id="textarea2" class="materialize-textarea"></textarea>
<label for="textarea2">Textarea</label>
</div>
</div>
</form>
</div>
advanced note: When dynamically changing the value of a textarea with methods like jQuery's .val()
,
you must trigger an autoresize on it afterwords because .val() does not automatically trigger the events
we've binded to the textarea.
$('#textarea2').val('New Text');
M.textareaAutoResize($('#textarea2'));
You can add an icon prefix to make the form input label even more clear. Just add an icon with the class
prefix
before the input and label.
<div class="row">
<form class="col s12">
<div class="row">
<div class="input-field col s6">
<i class="material-icons prefix">mode_edit</i>
<textarea id="icon_prefix2" class="materialize-textarea"></textarea>
<label for="icon_prefix2">First Name</label>
</div>
</div>
</form>
</div>
Select allows user input through specified options. Make sure you wrap it in a .input-field
for proper alignment with other text fields. Remember that this is a jQuery plugin so make sure you
initialize this in your document ready.
<div class="input-field col s12">
<select>
<option value="" disabled selected>Choose your option</option>
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</select>
<label>Materialize Select</label>
</div>
<div class="input-field col s12">
<select multiple>
<option value="" disabled selected>Choose your option</option>
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</select>
<label>Materialize Multiple Select</label>
</div>
<div class="input-field col s12">
<select>
<optgroup label="team 1">
<option value="1">Option 1</option>
<option value="2">Option 2</option>
</optgroup>
<optgroup label="team 2">
<option value="3">Option 3</option>
<option value="4">Option 4</option>
</optgroup>
</select>
<label>Optgroups</label>
</div>
<div class="input-field col s12 m6">
<select class="icons">
<option value="" disabled selected>Choose your option</option>
<option value="" data-icon="../../app-assets/images/avatar/avatar-7.png" class="circle">example 1</option>
<option value="" data-icon="../../app-assets/images/avatar/avatar-5.png" class="circle">example 2</option>
<option value="" data-icon="../../app-assets/images/avatar/avatar-3.png" class="circle">example 3</option>
</select>
<label>Images in select</label>
</div>
<div class="input-field col s12 m6">
<select class="icons">
<option value="" disabled selected>Choose your option</option>
<option value="" data-icon="../../app-assets/images/avatar/avatar-7.png" class="left circle">example 1</option>
<option value="" data-icon="../../app-assets/images/avatar/avatar-5.png" class="left circle">example 2</option>
<option value="" data-icon="../../app-assets/images/avatar/avatar-3.png" class="left circle">example 3</option>
</select>
<label>Images in select</label>
</div>
<label>Browser Select</label>
<select class="browser-default">
<option value="" disabled selected>Choose your option</option>
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</select>
You can also add disabled
to the select element to make the whole
thing disabled. Or if you add disabled
to the options, the
individual options will be unselectable.
<div class="input-field">
<select disabled>
<option value="" disabled selected>Choose your option</option>
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</select>
<label>Materialize Disabled</label>
</div>
<label>Browser Disabled</label>
<select class="browser-default" disabled>
<option value="" disabled selected>Choose your option</option>
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</select>
Use checkboxes when looking for yes or no answers. The for
attribute is necessary to bind our custom checkbox with the input. Add the input's id
as the value of the for
attribute of the label.
<form action="#">
<p>
<label>
<input type="checkbox" />
<span>Checkbox-1</span>
</label>
</p>
<p>
<label>
<input type="checkbox" checked="checked" />
<span>Checkbox-2</span>
</label>
</p>
<p>
<label>
<input type="checkbox" class="filled-in" checked="checked" />
<span>Filled in</span>
</label>
</p>
<p>
<label>
<input id="indeterminate-checkbox" type="checkbox" />
<span>Indeterminate Style</span>
</label>
</p>
<p>
<label>
<input type="checkbox" checked="checked" disabled="disabled" />
<span>Checkbox-3</span>
</label>
</p>
<p>
<label>
<input type="checkbox" disabled="disabled" />
<span>Checkbox-4</span>
</label>
</p>
</form>
Use checkboxes when looking for yes or no answers. The for
attribute is necessary to bind our custom checkbox with the input. Add the input's id
as the value of the for
attribute of the label.
<!-- Switch -->
<div class="switch">
<label>
Off
<input type="checkbox">
<span class="lever"></span>
On
</label>
</div>
<!-- Disabled Switch -->
<div class="switch">
<label>
Off
<input disabled type="checkbox">
<span class="lever"></span>
On
</label>
</div>
If you want to style an input button with a path input we provide this structure.
<form action="#">
<div class="file-field input-field">
<div class="btn">
<span>File</span>
<input type="file">
</div>
<div class="file-path-wrapper">
<input class="file-path validate" type="text">
</div>
</div>
</form>
You can also use the multiple
attribute to allow multiple file
uploads.
<form action="#">
<div class="file-field input-field">
<div class="btn">
<span>File</span>
<input type="file" multiple>
</div>
<div class="file-path-wrapper">
<input class="file-path validate" type="text" placeholder="Upload one or more files">
</div>
</div>
</form>
Add a range slider for values with a wide range. This one is set to be a number between 0 and 100. We
have two different types of sliders. nouiSlider is a 3rd party plugin which we've modified. To use the
noUiSlider, you will have to manually link the nouislider.css
and
nouislider.js
files located in the extras folder.
noUiSlider
See noUiSlider's official documentation here to see a variety of slider options
<div id="test-slider"></div>
var slider = document.getElementById('test-slider');
noUiSlider.create(slider, {
start: [20, 80],
connect: true,
step: 1,
orientation: 'horizontal', // 'horizontal' or 'vertical'
range: {
'min': 0,
'max': 100
},
format: wNumb({
decimals: 0
})
});
We use a modified version of pickadate.js to create a materialized date picker. Test it out below!
<input type="text" class="datepicker">
document.addEventListener('DOMContentLoaded', function() {
var elems = document.querySelectorAll('.datepicker');
var instances = M.Datepicker.init(elems, options);
});
// Or with jQuery
$(document).ready(function(){
$('.datepicker').datepicker();
});
We use a modified version of pickatime.js to create a materialized time picker. Test it out below!
<input type="text" class="timepicker">
document.addEventListener('DOMContentLoaded', function() {
var elems = document.querySelectorAll('.timepicker');
var instances = M.timepicker.init(elems, options);
});
// Or with jQuery
$(document).ready(function(){
$('.timepicker').timepicker();
});
<div class="row">
<div class="col s12">
<div class="row">
<div class="input-field col s12">
<i class="material-icons prefix">textsms</i>
<input type="text" id="autocomplete-input" class="autocomplete">
<label for="autocomplete-input">Autocomplete</label>
</div>
</div>
</div>
</div>
$(document).ready(function(){
$('input.autocomplete').autocomplete({
data: {
"Apple": null,
"Microsoft": null,
"Google": 'https://placehold.it/250x250'
},
});
});
<div class="row">
<form class="col s12">
<div class="row">
<div class="input-field col s6">
<input id="input_text" type="text" data-length="10">
<label for="input_text">Input text</label>
</div>
</div>
<div class="row">
<div class="input-field col s12">
<textarea id="textarea1" class="materialize-textarea" data-length="120"></textarea>
<label for="textarea1">Textarea</label>
</div>
</div>
</form>
</div>
$(document).ready(function() {
$('input#input_text, textarea#textarea1').characterCounter();
});