Skip to content

🎉 v5 release candidate is out! Head to the v5 documentation to get started.

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.