## Installation
```
npm install @material/fab
```
## Basic Usage
### Load Material Icons
We recommend you load [Material Icons](https://material.io/icons/) from Google Fonts
```html
```
### HTML Structure
```html
```
> _NOTE:_ The floating action button icon can be used with a `span`, `i`, `img`, or `svg` element.
### Styles
```scss
@import "../fab/mdc-fab";
```
### JavaScript Instantiation
The FAB will work without JavaScript, but you can enhance it to have a ripple effect by instantiating `MDCRipple` on the root element. See [MDC Ripple](../mdc-ripple) for details.
```js
import {MDCRipple} from '@material/ripple';
const fabRipple = new MDCRipple(document.querySelector('.mdc-fab'));
```
> See [Importing the JS component](../../docs/importing-js.md) for more information on how to import JavaScript.
## Style Customization
### CSS Classes
CSS Class | Description
--- | ---
`mdc-fab` | Mandatory, for the button element
`mdc-fab__icon` | Mandatory, for the icon element
`mdc-fab--mini` | Optional, modifies the FAB to a smaller size
`mdc-fab--exited` | Optional, animates the FAB out of view. When this class is removed, the FAB will return to view.
> **A note about `:disabled`**, No disabled styles are defined for FABs. The FAB promotes action, and should not be displayed in a disabled state. If you want to present a FAB that does *not* perform an action, you should also present an explanation to the user.
### Sass Mixins
#### Basic Sass Mixins
MDC FAB uses [MDC Theme](../mdc-theme)'s `secondary` color by default. Use the following mixins to customize it.
Mixin | Description
--- | ---
`mdc-fab-accessible($container-color)` | Changes the FAB's container color to the given color, and updates the FAB's ink and ripple color to meet accessibility standards.
#### Advanced Sass Mixins
> **A note about advanced mixins**, The following mixins are intended for advanced users. These mixins will override the color of the container, ink, or ripple. You can use all of them if you want to completely customize a FAB. Or you can use only one of them, e.g. if you only need to override the ripple color. **It is up to you to pick container, ink, and ripple colors that work together, and meet accessibility standards.**
Mixin | Description
--- | ---
`mdc-fab-container-color($color)` | Sets the container color to the given color
`mdc-fab-icon-size($width, $height)` | Sets the icon `width`, `height`, and `font-size` properties to the specified `width` and `height`. `$height` is optional and will default to `$width` if omitted. The `font-size` will be set to the provided `$width` value.
`mdc-fab-ink-color($color)` | Sets the ink color to the given color
The ripple effect for the FAB component is styled using [MDC Ripple](../mdc-ripple) mixins.
#### Caveat: Edge and CSS Variables
In browsers that fully support CSS custom properties, the above mixins will work if you pass in a [MDC Theme](../mdc-theme) property (e.g. `primary`) as an argument. However, Edge does not fully support CSS custom properties. If you are using the `mdc-fab-container-color` mixin, you must pass in an actual color value for support in Edge.
### Additional Information
#### Positioning
Developers must position MDC FAB as needed within their application's design.
```html
```