Display
Quickly and responsively toggle the display value of components and more with the display utilities. Includes support for some of the more common values, as well as some extras for controlling display when printing.
Examples
Inline
inline
inline
<Box component="div" sx={{ display: 'inline' }}>inline</Box>
<Box component="div" sx={{ display: 'inline' }}>inline</Box>
Block
blockblock
<Box component="span" sx={{ display: 'block' }}>block</Box>
<Box component="span" sx={{ display: 'block' }}>block</Box>
Hiding elements
For faster mobile-friendly development, use responsive display classes for showing and hiding elements by device. Avoid creating entirely different versions of the same site, instead hide element responsively for each screen size.
Screen Size | Class |
---|---|
Hidden on all | sx={{ display: 'none' }} |
Hidden only on xs | sx={{ display: { xs: 'none', sm: 'block' } }} |
Hidden only on sm | sx={{ display: { xs: 'block', sm: 'none', md: 'block' } }} |
Hidden only on md | sx={{ display: { xs: 'block', md: 'none', lg: 'block' } }} |
Hidden only on lg | sx={{ display: { xs: 'block', lg: 'none', xl: 'block' } }} |
Hidden only on xl | sx={{ display: { xs: 'block', xl: 'none' } }} |
Visible only on xs | sx={{ display: { xs: 'block', sm: 'none' } }} |
Visible only on sm | sx={{ display: { xs: 'none', sm: 'block', md: 'none' } }} |
Visible only on md | sx={{ display: { xs: 'none', md: 'block', lg: 'none' } }} |
Visible only on lg | sx={{ display: { xs: 'none', lg: 'block', xl: 'none' } }} |
Visible only on xl | sx={{ display: { xs: 'none', xl: 'block' } }} |
hide on screens wider than md
hide on screens smaller than md
<Box sx={{ display: { xs: 'block', md: 'none' }}}>
hide on screens wider than md
</Box>
<Box sx={{ display: { xs: 'none', md: 'block' }}}>
hide on screens smaller than md
</Box>
Display in print
Screen Only (Hide on print only)
Print Only (Hide on screen only)
<Box sx={{ display: 'block', displayPrint: 'none' }}>
Screen Only (Hide on print only)
</Box>
<Box sx={{ display: 'none', displayPrint: 'block' }}>
Print Only (Hide on screen only)
</Box>
Overflow
Not scrollable, overflow is hidden
Try scrolling this overflow auto box
<Box component="div" sx={{ overflow: 'hidden' }}>
Not scrollable, overflow is hidden
</Box>
<Box component="div" sx={{ overflow: 'auto' }}>
Try scrolling this overflow auto box
</Box>
Text overflow
Lorem Ipsum is simply dummy text
Lorem Ipsum is simply dummy text
<Box component="div" sx={{ textOverflow: 'clip' }}>
Lorem Ipsum is simply dummy text
</Box>
<Box component="div" sx={{ textOverflow: 'ellipsis' }}>
Lorem Ipsum is simply dummy text
</Box>
Visibility
Visible containerInvisible container
<Box component="div" sx={{ visibility: 'visible' }}>
Visible container
</Box>
<Box component="div" sx={{ visibility: 'hidden' }}>
Invisible container
</Box>
White space
Lorem Ipsum has been the industry's standard dummy text ever since the 1500s.
Lorem Ipsum has been the industry's standard dummy text ever since the 1500s.
<Box component="div" sx={{ whiteSpace: 'nowrap' }}>
Lorem Ipsum has been the industry's standard dummy text ever since the 1500s.
</Box>
<Box component="div" sx={{ whiteSpace: 'normal' }}>
Lorem Ipsum has been the industry's standard dummy text ever since the 1500s.
</Box>
API
import { display } from '@mui/system';
Import name | Prop | CSS property | Theme key |
---|---|---|---|
displayPrint |
displayPrint |
display |
none |
displayRaw |
display |
display |
none |
overflow |
overflow |
overflow |
none |
textOverflow |
textOverflow |
text-overflow |
none |
visibility |
visibility |
visibility |
none |
whiteSpace |
whiteSpace |
white-space |
none |