Inset β
Utilities for controlling inset positioning using custom spacing variables.
π‘ Tip
The inset utilities allow you to control the distance between an element and its containing block, providing flexibility for layout adjustments. This shorthand method ensures the element is positioned relative to its parent container on the top, right, bottom, and left sides.
| Class Name | CSS Equivalent |
|---|---|
| .inset-none | inset: var(--cds-sys-spacing-none); /* β0px*/ |
| .inset-b-none | inset-block: var(--cds-sys-spacing-none); /* β0px*/ |
| .inset-i-none | inset-inline: var(--cds-sys-spacing-none); /* β0px*/ |
| .inset-bs-none | inset-block-start: var(--cds-sys-spacing-none); /* β0px*/ |
| .inset-be-none | inset-block-end: var(--cds-sys-spacing-none); /* β0px*/ |
| .inset-is-none | inset-inline-start: var(--cds-sys-spacing-none); /* β0px*/ |
| .inset-ie-none | inset-inline-end: var(--cds-sys-spacing-none); /* β0px*/ |
| .inset-3xs | inset: var(--cds-sys-spacing-3xs); /* β4px*/ |
| .inset-b-3xs | inset-block: var(--cds-sys-spacing-3xs); /* β4px*/ |
| .inset-i-3xs | inset-inline: var(--cds-sys-spacing-3xs); /* β4px*/ |
| .inset-bs-3xs | inset-block-start: var(--cds-sys-spacing-3xs); /* β4px*/ |
| .inset-be-3xs | inset-block-end: var(--cds-sys-spacing-3xs); /* β4px*/ |
| .inset-is-3xs | inset-inline-start: var(--cds-sys-spacing-3xs); /* β4px*/ |
| .inset-ie-3xs | inset-inline-end: var(--cds-sys-spacing-3xs); /* β4px*/ |
| .inset-2xs | inset: var(--cds-sys-spacing-2xs); /* β8px*/ |
| .inset-b-2xs | inset-block: var(--cds-sys-spacing-2xs); /* β8px*/ |
| .inset-i-2xs | inset-inline: var(--cds-sys-spacing-2xs); /* β8px*/ |
| .inset-bs-2xs | inset-block-start: var(--cds-sys-spacing-2xs); /* β8px*/ |
| .inset-be-2xs | inset-block-end: var(--cds-sys-spacing-2xs); /* β8px*/ |
| .inset-is-2xs | inset-inline-start: var(--cds-sys-spacing-2xs); /* β8px*/ |
| .inset-ie-2xs | inset-inline-end: var(--cds-sys-spacing-2xs); /* β8px*/ |
| .inset-xs | inset: var(--cds-sys-spacing-xs); /* β12px*/ |
| .inset-b-xs | inset-block: var(--cds-sys-spacing-xs); /* β12px*/ |
| .inset-i-xs | inset-inline: var(--cds-sys-spacing-xs); /* β12px*/ |
| .inset-bs-xs | inset-block-start: var(--cds-sys-spacing-xs); /* β12px*/ |
| .inset-be-xs | inset-block-end: var(--cds-sys-spacing-xs); /* β12px*/ |
| .inset-is-xs | inset-inline-start: var(--cds-sys-spacing-xs); /* β12px*/ |
| .inset-ie-xs | inset-inline-end: var(--cds-sys-spacing-xs); /* β12px*/ |
| .inset-s | inset: var(--cds-sys-spacing-s); /* β16px*/ |
| .inset-b-s | inset-block: var(--cds-sys-spacing-s); /* β16px*/ |
| .inset-i-s | inset-inline: var(--cds-sys-spacing-s); /* β16px*/ |
| .inset-bs-s | inset-block-start: var(--cds-sys-spacing-s); /* β16px*/ |
| .inset-be-s | inset-block-end: var(--cds-sys-spacing-s); /* β16px*/ |
| .inset-is-s | inset-inline-start: var(--cds-sys-spacing-s); /* β16px*/ |
| .inset-ie-s | inset-inline-end: var(--cds-sys-spacing-s); /* β16px*/ |
| .inset-m | inset: var(--cds-sys-spacing-m); /* β24px*/ |
| .inset-b-m | inset-block: var(--cds-sys-spacing-m); /* β24px*/ |
| .inset-i-m | inset-inline: var(--cds-sys-spacing-m); /* β24px*/ |
| .inset-bs-m | inset-block-start: var(--cds-sys-spacing-m); /* β24px*/ |
| .inset-be-m | inset-block-end: var(--cds-sys-spacing-m); /* β24px*/ |
| .inset-is-m | inset-inline-start: var(--cds-sys-spacing-m); /* β24px*/ |
| .inset-ie-m | inset-inline-end: var(--cds-sys-spacing-m); /* β24px*/ |
| .inset-l | inset: var(--cds-sys-spacing-l); /* β32px*/ |
| .inset-b-l | inset-block: var(--cds-sys-spacing-l); /* β32px*/ |
| .inset-i-l | inset-inline: var(--cds-sys-spacing-l); /* β32px*/ |
| .inset-bs-l | inset-block-start: var(--cds-sys-spacing-l); /* β32px*/ |
| .inset-be-l | inset-block-end: var(--cds-sys-spacing-l); /* β32px*/ |
| .inset-is-l | inset-inline-start: var(--cds-sys-spacing-l); /* β32px*/ |
| .inset-ie-l | inset-inline-end: var(--cds-sys-spacing-l); /* β32px*/ |
| .inset-xl | inset: var(--cds-sys-spacing-xl); /* β48px*/ |
| .inset-b-xl | inset-block: var(--cds-sys-spacing-xl); /* β48px*/ |
| .inset-i-xl | inset-inline: var(--cds-sys-spacing-xl); /* β48px*/ |
| .inset-bs-xl | inset-block-start: var(--cds-sys-spacing-xl); /* β48px*/ |
| .inset-be-xl | inset-block-end: var(--cds-sys-spacing-xl); /* β48px*/ |
| .inset-is-xl | inset-inline-start: var(--cds-sys-spacing-xl); /* β48px*/ |
| .inset-ie-xl | inset-inline-end: var(--cds-sys-spacing-xl); /* β48px*/ |
| .inset-2xl | inset: var(--cds-sys-spacing-2xl); /* β64px*/ |
| .inset-b-2xl | inset-block: var(--cds-sys-spacing-2xl); /* β64px*/ |
| .inset-i-2xl | inset-inline: var(--cds-sys-spacing-2xl); /* β64px*/ |
| .inset-bs-2xl | inset-block-start: var(--cds-sys-spacing-2xl); /* β64px*/ |
| .inset-be-2xl | inset-block-end: var(--cds-sys-spacing-2xl); /* β64px*/ |
| .inset-is-2xl | inset-inline-start: var(--cds-sys-spacing-2xl); /* β64px*/ |
| .inset-ie-2xl | inset-inline-end: var(--cds-sys-spacing-2xl); /* β64px*/ |
| .inset-3xl | inset: var(--cds-sys-spacing-3xl); /* β96px*/ |
| .inset-b-3xl | inset-block: var(--cds-sys-spacing-3xl); /* β96px*/ |
| .inset-i-3xl | inset-inline: var(--cds-sys-spacing-3xl); /* β96px*/ |
| .inset-bs-3xl | inset-block-start: var(--cds-sys-spacing-3xl); /* β96px*/ |
| .inset-be-3xl | inset-block-end: var(--cds-sys-spacing-3xl); /* β96px*/ |
| .inset-is-3xl | inset-inline-start: var(--cds-sys-spacing-3xl); /* β96px*/ |
| .inset-ie-3xl | inset-inline-end: var(--cds-sys-spacing-3xl); /* β96px*/ |
Add inset to all sides β
Control the inset of an element on all four sides using the inset-{size} utilities.
<div class="[...] inset-l">inset-l</div>Add horizontal inset β
Control the horizontal inset of an element using the inset-i-{size} utilities. This will affect both the left and right sides.
<div class="[...] inset-i-m">inset-i-m</div>Add vertical inset β
Control the vertical inset of an element using the inset-b-{size} utilities. This will affect both the top and bottom sides.
<div class="[...] inset-b-xl">inset-b-xl</div>Add inset to specific sides β
Control the inset of an element on a specific side using the inset-{b|s}{s|e}-{size} utilities, similar to the padding and margin utilities.
| Abbreviation | |
|---|---|
| b | top (block axis) |
| i | left (inline axis) |
| s | top or left depending on axis |
| e | bottom or right depending on axis |
As an illustration, consider using the class "inset-bs-m" to apply 1.5rem distance to the top (block-start) at desktop size.
π‘ Tip
We recommend using logical properties like {block|inline}-{end|start} to handle different writing directions. This approach makes your layouts more flexible and adaptable for various languages and screen sizes.
<div class="[...] inset-bs-m">inset-bs-m</div>
<div class="[...] inset-ie-s">inset-ie-s</div>
<div class="[...] inset-be-l">inset-be-l</div>
<div class="[...] inset-is-2xl">inset-is-2xl</div>