@material/react-fab

React Floating Action Button

A React version of an MDC Floating Action Button.

Installation

npm install @material/react-fab

Usage

Styles

with Sass:

import '@material/react-fab/index.scss';

with CSS:

import '@material/react-fab/dist/fab.css';

JSX Structure

The Fab can be used with the span, i, img or svg elements. It can also be used with the Material Icon react component.

<Fab icon={<span className="material-icons">favorite</span>}/>

<Fab icon={<i className="material-icons">favorite</i>}/>

<Fab icon={
  <svg xmlns="http://www.w3.org/2000/svg" className="material-icons" viewBox="0 0 24 24">
  ...
  </svg>
  }/>

<Fab icon={<img className="material-icons" src="/images/ic_button_24px.svg"/>}/>

<Fab icon={<MaterialIcon icon="favorite"/>}/>

Props

Prop Name	Type	Description
className	String	Classes to be applied to the root element.
mini	n/a	Enables the mini variant.
icon	Element	The icon.
textLabel	String	The label, which makes the FAB extended.

Sass Mixins

Sass mixins may be available to customize various aspects of the components. Please refer to the MDC Web repository for more information on what mixins are available, and how to use them.

Advanced Sass Mixins

Usage with Icons

Please see our Best Practices doc when importing or using icon fonts.

Changelog

0.8.0 (2018-12-28)

Bug Fixes

• infrastructure: add declaration package.json (#572) (8cb4b1b)
• infrastructure: condense webpack configuration build step into one json file (#571) (512f3aa)
• infrastructure: unit test code coverage for typescript (#487) (1170a1f)
• list: minification-safe element type comparison (#509) (89f5fd2)
• select: defensive foundation check before unmounting - also includes radio, checkbox, text-field (#512) (2ee4c80)
• top-app-bar: foundation should be destroyed and reinitialized on variant change (#519) (58cfc6f)
• lint for typings files (#577) (8f971a8)
• remove prop-types from package.json (#576) (7f38952)

Features

• button: typescript (#508) (fee5968)
• card: typescript (#497) (c9665bc)
• checkbox: typescript support (#490) (02775ac)
• chips: typescript support (#493) (764ed40)
• drawer: typescript support (#494) (2a91edd)
• fab: typescript support (#495) (b62c36f)
• icon-button: typescript support (#496) (e9e29a3)
• infrastructure: add typescript eslint (#549) (abee1a8)
• infrastructure: build JS from TS (#547) (862c110)
• layout-grid: typescript (#498) (a25039e)
• linear-progress: typescript (#526) (cffefa0)
• list: typescript (#501) (3b6c501)
• material-icon: typescript (#525) (e3373bb)
• menu-surface: typescript (#502) (94d006d)
• radio: typescript (#506) (af94a3a)
• ripple: typescript (#527) (4dcf389)
• select: typescript (#540) (a3d014a)
• switch: typescript (#530) (ba058d4)
• tab: typescript (#532) (206540f)
• tab-bar: typescript (#535) (a0709d7)
• tab-indicator: typescript (#545) (056adb5)
• tab-scroller: typescript (#536) (4582a7d)
• text-field: add typescript support (#550) (e003fea)
• top app bar: dense variant (#520) (461cce9)
• top-app-bar: TopAppBarFixedAdjust variants added (#524) (e3bb701)
• top-app-bar: typescript (#548) (8680796)
• typography: typescript (#521) (090aa7e)

BREAKING CHANGES

• infrastructure: Remove <package-name>.es.js files. The alternate is now to use the index.tsx files.
• ripple: withRipple is no longer the default export.

<a name="0.7.1"></a>