Sizing

Our sizing class names are set up in a human-readable format, e.g. .slds-size_1-of-2. This equates to a width of 50%.

By default, a group of sizing helpers are created based on standard grid column spans of – 2, 3, 4, 5, 6, 7, 8 and 12. For example, if you need 3 cards to horizontally align along the same x-axis, you would use the class .slds-size_1-of-3 on each element. This will make each card take up 33.333% of containing section.

Our sizing helpers have the option to be responsive. By pre-pending a breakpoint name to a sizing helper, e.g. .slds-medium-size_1-of-3 you will output a width at the specified breakpoint name.

Absolute sizing helpers are also available (where widths are declared in rem units): xx-small, x-small, medium, large, x-large and xx-large as defined in the <a href="/design-tokens/#category-sizing">sizing category of the Design Tokens</a>. e.g. .slds-size_large.

In some uncommon cases, you may need a sizing helper that is up to a certain breakpoint. For these, use the classes prefixed with max- to achieve this result.

Here is an overview of our available breakpoint names:

Our responsive sizing helpers are built upon a mobile first approach. To achieve the desired outcome of this approach, you will need to append responsive sizing helpers to an element that overrides the previous breakpoint. A default sizing helper is required and responsive sizing helpers are additive. The following example demonstrates the class name position for each breakpoint:

<div class="[default] [small size override] [medium size override] [large size override]">

A real world example would look like this:

<div class="slds-size_1-of-2 slds-small-size_1-of-3 slds-medium-size_1-of-4 slds-large-size_1-of-3">

This will equate to the following width output for your element:

.foo {
width: 50%;
@media only screen and (min-width: 30em) {
  width: 33.3333%;
}
@media only screen and (min-width: 48em) {
  width: 25%;
}
@media only screen and (min-width: 64em) {
  width: 33.3333%;
}
}