46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
|
---
|
||
|
|
productId: material-ui
|
||
|
|
title: React Floating Action Button (FAB) component
|
||
|
|
components: Fab
|
||
|
|
githubLabel: 'component: Fab'
|
||
|
|
materialDesign: https://m2.material.io/components/buttons-floating-action-button
|
||
|
|
githubSource: packages/mui-material/src/Fab
|
||
|
|
---
|
||
|
|
|
||
|
|
# Floating Action Button
|
||
|
|
|
||
|
|
<p class="description">A Floating Action Button (FAB) performs the primary, or most common, action on a screen.</p>
|
||
|
|
|
||
|
|
A floating action button appears in front of all screen content, typically as a circular shape with an icon in its center.
|
||
|
|
FABs come in two types: regular, and extended.
|
||
|
|
|
||
|
|
Only use a FAB if it is the most suitable way to present a screen's primary action.
|
||
|
|
Only one component is recommended per screen to represent the most common action.
|
||
|
|
|
||
|
|
{{"component": "@mui/docs/ComponentLinkHeader"}}
|
||
|
|
|
||
|
|
## Basic FAB
|
||
|
|
|
||
|
|
{{"demo": "FloatingActionButtons.js"}}
|
||
|
|
|
||
|
|
## Size
|
||
|
|
|
||
|
|
By default, the size is `large`. Use the `size` prop for smaller floating action buttons.
|
||
|
|
|
||
|
|
{{"demo": "FloatingActionButtonSize.js"}}
|
||
|
|
|
||
|
|
{{"demo": "FloatingActionButtonExtendedSize.js"}}
|
||
|
|
|
||
|
|
## Animation
|
||
|
|
|
||
|
|
The floating action button animates onto the screen as an expanding piece of material, by default.
|
||
|
|
|
||
|
|
A floating action button that spans multiple lateral screens (such as tabbed screens) should briefly disappear,
|
||
|
|
then reappear if its action changes.
|
||
|
|
|
||
|
|
The Zoom transition can be used to achieve this. Note that since both the exiting and entering
|
||
|
|
animations are triggered at the same time, we use `enterDelay` to allow the outgoing Floating Action Button's
|
||
|
|
animation to finish before the new one enters.
|
||
|
|
|
||
|
|
{{"demo": "FloatingActionButtonZoom.js", "bg": true}}
|