Hidden
Quickly and responsively toggle the visibility value of components and more with the hidden utilities.
All elements are visible unless they are explicitly hidden.
To ease integration with Material-UI's responsive breakpoints,
this component can be used to hide any content,
or you can use it in conjunction with the Grid
component.
How it works
Hidden works with a range of breakpoints e.g. xsUp
or mdDown
, or one or more breakpoints e.g. only='sm'
or only={['md', 'xl']}
.
Ranges and individual breakpoints can be used simultaneously to achieve very customized behavior.
The ranges are inclusive of the specified breakpoints.
innerWidth |xs sm md lg xl
|--------|--------|--------|--------|-------->
width | xs | sm | md | lg | xl
smUp | show | hide
mdDown | hide | show
Implementations
js
By default, the js
implementation is used, responsively hiding content based on using the withWidth()
higher-order component that watches screen size.
This has the benefit of not rendering any content at all unless the breakpoint is met.
css
If you are using server-side rendering, you can set implementation="css"
if you don't want the browser to re-flow your content on the screen.
Breakpoint up
Using any breakpoint up
property, the given children will be hidden at or above the breakpoint.
Breakpoint down
Using any breakpoint down
property, the given children will be hidden at or below the breakpoint.
Breakpoint only
Using the breakpoint only
property, the given children will be hidden at the specified breakpoint(s).
The only
property can be used in two ways:
- list a single breakpoint
- list an array of breakpoints
Integration with Grid
It is quite common to alter Grid
at different responsive breakpoints, and in many cases, you want to hide some of those elements.