Skip to content

Commit be54da6

Browse files
Sean Wilsonadrianefong
andauthored
Update space token names design foundations (#6945)
* Updating space token names design foundations Updates the Foundations-Design-Space page to use up-to-date `space` token names and range. * Correcting a missing size-space switch * update polaris space unit image Co-authored-by: adrianefong <[email protected]>
1 parent 7b17b1d commit be54da6

File tree

3 files changed

+25
-121
lines changed

3 files changed

+25
-121
lines changed

polaris.shopify.com/content/foundations/design/space/index.md

Lines changed: 25 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -55,36 +55,38 @@ Merchants experience pages, space should feel like a small part of a bigger syst
5555

5656
## Spacing tools
5757

58-
### Polaris size units
58+
### Polaris space units
5959

60-
All measurements used across the experience (space, width, height, etc) must reference Polaris size units to guarantee visual consistency and balance.
60+
All measurements used across the experience (space, width, height, etc) must reference Polaris space units to guarantee visual consistency and balance.
6161

6262
<div class="punit-img">
63-
<img src="/images/foundations/design/space/spacing-polaris-units.svg" alt="A visual example of a polaris unit">
63+
<img src="/images/foundations/design/space/spacing-polaris-units@2x.png" alt="A visual example of a polaris unit">
6464
</div>
6565

66-
### Size scale
67-
68-
| Value | Size | px value | rem value |
69-
| ------------ | ------------ | -------- | --------- |
70-
| 0 | --p-size-0 | 0 | 0 |
71-
| 0.25 | --p-size-025 | 1 | 0.0625 |
72-
| 0.5 | --p-size-05 | 2 | 0.03125 |
73-
| **1 (base)** | --p-size-1 | 4 | 0.25 |
74-
| 2 | --p-size-2 | 8 | 0.5 |
75-
| 3 | --p-size-3 | 12 | 0.75 |
76-
| 4 | --p-size-4 | 16 | 1 |
77-
| 5 | --p-size-5 | 20 | 1.25 |
78-
| 6 | --p-size-6 | 24 | 1.5 |
79-
| 8 | --p-size-8 | 32 | 2 |
80-
| 10 | --p-size-10 | 40 | 2.5 |
81-
| 12 | --p-size-12 | 48 | 3 |
82-
| 16 | --p-size-16 | 64 | 4 |
83-
| 24 | --p-size-24 | 96 | 6 |
84-
| 32 | --p-size-32 | 128 | 8 |
66+
### Space scale
67+
68+
| Value | Space | px value | rem value |
69+
| ------------ | ------------- | -------- | --------- |
70+
| 0 | --p-space-0 | 0 | 0 |
71+
| 0.25 | --p-space-025 | 1 | 0.0625 |
72+
| 0.5 | --p-space-05 | 2 | 0.125 |
73+
| **1 (base)** | --p-space-1 | 4 | 0.25 |
74+
| 2 | --p-space-2 | 8 | 0.5 |
75+
| 3 | --p-space-3 | 12 | 0.75 |
76+
| 4 | --p-space-4 | 16 | 1 |
77+
| 5 | --p-space-5 | 20 | 1.25 |
78+
| 6 | --p-space-6 | 24 | 1.5 |
79+
| 8 | --p-space-8 | 32 | 2 |
80+
| 10 | --p-space-10 | 40 | 2.5 |
81+
| 12 | --p-space-12 | 48 | 3 |
82+
| 16 | --p-space-16 | 64 | 4 |
83+
| 20 | --p-space-20 | 80 | 5 |
84+
| 24 | --p-space-24 | 96 | 6 |
85+
| 28 | --p-space-28 | 112 | 7 |
86+
| 32 | --p-space-32 | 128 | 8 |
8587

8688
Polaris units are more dense at a small scale, and less so as dimensions increase.
87-
This is intentional to provide a good range to work with, but you must be deliberate in the units you decide to pair. We encourage designing with rhythm and contrast to achieve clear visual hierarchy. This often means skipping at least one unit in the scale when you’re pairing different sizes.
89+
This is intentional to provide a good range to work with, but you must be deliberate in the units you decide to pair. We encourage designing with rhythm and contrast to achieve clear visual hierarchy. This often means skipping at least one unit in the scale when you’re pairing different spaces.
8890

8991
![Examples of different variations of spacing](/images/foundations/design/space/[email protected])
9092

0 commit comments

Comments
 (0)