Skip to content

Latest commit

 

History

History
162 lines (115 loc) · 5.75 KB

README.md

File metadata and controls

162 lines (115 loc) · 5.75 KB
Raw

Buttons

Buttons allow users to take actions, and make choices, with a single tap.

Design & API Documentation

Installation

npm install @material/button

Basic Usage

HTML Structure

<button class="mdc-button">
  Button
</button>

NOTE: Examples here use the generic <button>, but users can also apply the mdc-button class to <a> elements.

Styles

@import "@material/button/mdc-button";

JavaScript Instantiation

The button will work without JavaScript, but you can enhance it to have a ripple effect by instantiating MDCRipple on the root element. See MDC Ripple for details.

import {MDCRipple} from '@material/ripple';

const buttonRipple = new MDCRipple(document.querySelector('.mdc-button'));

See Importing the JS component for more information on how to import JavaScript.

Variants

Contained Button

To style a contained button, add the mdc-button--raised class to the <button> element for a contained button with elevation, or the mdc-button--unelevated class for a contained button flush with the surface.

Outlined Button

To style an outlined button, add the class mdc-button--outlined to the <button> element.

Icons

We recommend using Material Icons from Google Fonts:

<head>
  <link rel="stylesheet" href="https://fonts.googleapis.com/icon?family=Material+Icons">
</head>

However, you can also use SVG, Font Awesome, or any other icon library you wish.

To add an icon, add an element with the mdc-button__icon class inside the button element and set the attribute aria-hidden="true". The icon is set to 18px to meet legibility requirements.

<button class="mdc-button">
  <i class="material-icons mdc-button__icon" aria-hidden="true">favorite</i>
  Button
</button>

It's also possible to use an SVG icon:

<button class="mdc-button">
  <svg class="mdc-button__icon" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" viewBox="...">
  ...
  </svg>
  Button
</button>

Disabled

To disable a button, add the disabled attribute directly to the <button>, or set the disabled attribute on the <fieldset> containing the button. Disabled buttons cannot be interacted with and have no visual interaction effect.

<button class="mdc-button" disabled>
  Button
</button>

Style Customization

CSS Classes

CSS Class Description
mdc-button Mandatory. Defaults to a text button that is flush with the surface.
mdc-button--raised Optional. Styles a contained button that is elevated above the surface.
mdc-button--unelevated Optional. Styles a contained button that is flush with the surface.
mdc-button--outlined Optional. Styles an outlined button that is flush with the surface.
mdc-button--dense Optional. Makes the button text and container slightly smaller.
mdc-button__icon Optional. Indicates an icon element.

Sass Mixins

To customize a button's color and properties, you can use the following mixins.

Basic Sass Mixins

MDC Button uses MDC Theme's primary color by default. Use the following mixins to customize it.

Mixin Description
mdc-button-filled-accessible($container-fill-color) Sets the container fill color for a contained (raised or unelevated) button, and updates the button's ink, icon, and ripple colors to meet accessibility standards

Advanced Sass Mixins

These mixins will override the color of the container, ink, outline or ripple. It is up to you to ensure your button meets accessibility standards.

Mixin Description
mdc-button-container-fill-color($color) Sets the container fill color to the given color.
mdc-button-icon-color($color) Sets the icon color to the given color.
mdc-button-ink-color($color) Sets the ink color to the given color, and sets the icon color to the given color unless mdc-button-icon-color is also used.
mdc-button-shape-radius($radius, $rtl-reflexive) Sets rounded shape to button with given radius size. Set $rtl-reflexive to true to flip radius values in RTL context, defaults to false.
mdc-button-horizontal-padding($padding) Sets horizontal padding to the given number.
mdc-button-outline-color($color) Sets the outline color to the given color.
mdc-button-outline-width($width, $padding) Sets the outline width to the given number (defaults to 2px) and adjusts padding accordingly. $padding is only required in cases where mdc-button-horizontal-padding is also included with a custom value.
Caveat: Edge and CSS Custom Properties

In browsers that fully support CSS custom properties, the above mixins will work if you pass in a MDC Theme property (e.g. primary) as an argument. However, Edge does not fully support CSS custom properties. If you are using the mdc-button-container-fill-color mixin, you must pass in an actual color value for support in Edge.