Skip to content

Spacing

Use the theme.spacing() helper to create consistent spacing between the elements of your UI.

Material-UI uses a recommended 8px scaling factor by default.

const theme = createTheme();

theme.spacing(2); // `${8 * 2}px` = '16px'

Custom spacing

You can change the spacing transformation by providing:

  • a number
const theme = createTheme({
  spacing: 4,
});

theme.spacing(2); // `${4 * 2}px` = '8px'
  • a function
const theme = createTheme({
  spacing: (factor) => `${0.25 * factor}rem`, // (Bootstrap strategy)
});

theme.spacing(2); // = 0.25 * 2rem = 0.5rem = 8px
  • an array
const theme = createTheme({
  spacing: [0, 4, 8, 16, 32, 64],
});

theme.spacing(2); // = '8px'

Multiple arity

The theme.spacing() helper accepts up to 4 arguments. You can use the arguments to reduce the boilerplate.

-padding: `${theme.spacing(1)} ${theme.spacing(2)}`, // '8px 16px'
+padding: theme.spacing(1, 2), // '8px 16px'

Mixing string values is also supported:

margin: theme.spacing(1, 'auto'), // '8px auto'