@solid-design-system/mcp 6.30.0 → 7.0.0-next.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +33 -0
- package/metadata/packages/components/docs/installation.md +9 -117
- package/metadata/packages/components/docs/usage.md +4 -4
- package/metadata/packages/components/sd-dialog/stories/headline.md +3 -1
- package/metadata/packages/components/sd-dialog/stories/no-close-button.md +3 -1
- package/metadata/packages/components/sd-dialog/stories/open.md +12 -8
- package/metadata/packages/components/sd-drawer/info.md +1 -2
- package/metadata/packages/components/sd-header/info.md +4 -2
- package/metadata/packages/components/sd-header/stories/shadow.md +9 -0
- package/metadata/packages/components/sd-icon/stories/custom-libraries.md +1 -1
- package/metadata/packages/components/sd-input/info.md +1 -0
- package/metadata/packages/components/sd-notification/stories/duration.md +5 -0
- package/metadata/packages/components/sd-tag/info.md +1 -1
- package/metadata/packages/components/sd-textarea/info.md +1 -1
- package/metadata/packages/icons/default/system.json +23 -23
- package/metadata/packages/quickstart/docs/quickstart.md +9 -27
- package/metadata/packages/styles/docs/installation.md +8 -56
- package/metadata/packages/styles/sd-chip/info.md +12 -8
- package/metadata/packages/styles/sd-chip/stories/{variants.md → color.md} +8 -10
- package/metadata/packages/styles/sd-chip/stories/outlined.md +8 -0
- package/metadata/packages/styles/sd-chip/stories/shade.md +17 -0
- package/metadata/packages/styles/sd-chip/stories/sharp.md +8 -0
- package/metadata/packages/styles/sd-chip/stories/size.md +8 -0
- package/metadata/packages/styles/sd-hidden-links/stories/surrounding-content.md +1 -1
- package/metadata/packages/templates/badge.md +1 -1
- package/metadata/packages/templates/bottom-navigation.md +2 -4
- package/metadata/packages/templates/breadcrumb.md +1 -1
- package/metadata/packages/templates/dialog.md +0 -10
- package/metadata/packages/templates/header-navigation.md +6 -6
- package/metadata/packages/templates/status-badge.md +3 -3
- package/metadata/packages/templates/teaser.md +20 -14
- package/metadata/packages/tokens/docs/installation.md +2 -23
- package/metadata/packages/tokens/docs/usage.md +3 -27
- package/metadata/packages/tokens/tokens.json +4 -0
- package/package.json +4 -4
- package/metadata/packages/components/sd-spinner/info.md +0 -53
- package/metadata/packages/components/sd-spinner/stories/size.md +0 -15
- package/metadata/packages/components/sd-spinner/stories/variants.md +0 -43
- package/metadata/packages/styles/sd-flag/info.md +0 -45
- package/metadata/packages/styles/sd-flag/stories/variants.md +0 -40
- package/metadata/packages/templates/flag.md +0 -38
|
@@ -8,13 +8,17 @@
|
|
|
8
8
|
|
|
9
9
|
Use the styles tool (with `style` + `example` args) to retrieve the HTML for any of these examples:
|
|
10
10
|
|
|
11
|
-
- sd-chip/
|
|
11
|
+
- sd-chip/color
|
|
12
|
+
- sd-chip/shade
|
|
13
|
+
- sd-chip/size
|
|
14
|
+
- sd-chip/outlined
|
|
15
|
+
- sd-chip/sharp
|
|
12
16
|
|
|
13
17
|
## Guidelines
|
|
14
18
|
|
|
15
19
|
### Use Cases
|
|
16
20
|
|
|
17
|
-
- Display selected items or categories within sd-teaser, such as chosen filters, tags, or interests.
|
|
21
|
+
- Display selected items or categories within [sd-teaser](./?path=/docs/components-sd-teaser--docs), such as chosen filters, tags, or interests.
|
|
18
22
|
- Indicate attributes of items, such as “New,” “Featured,” or “Verified”.
|
|
19
23
|
- Communicate user roles, like “Moderator” or “Admin”.
|
|
20
24
|
|
|
@@ -24,15 +28,15 @@ Use the styles tool (with `style` + `example` args) to retrieve the HTML for any
|
|
|
24
28
|
|
|
25
29
|
- Keep chip text short and easily scannable. Long text disrupts layouts and diminishes the chip’s visual impact.
|
|
26
30
|
- Avoid overuse. Too many chips in one area can create visual clutter.
|
|
27
|
-
- Use the “&--
|
|
31
|
+
- Use the “&--color” and “&--shade” properties to apply the color that best works on the background, and “&--outlined” for a border-only style, keeping it consistent throughout the product.
|
|
28
32
|
|
|
29
|
-
### Chips and
|
|
33
|
+
### Chips and Tags
|
|
30
34
|
|
|
31
|
-
-
|
|
35
|
+
- Use only as a non-interactive element; for interactive elements (e.g., a dynamic filter), use [sd-tag](./?path=/docs/components-sd-tag--docs) instead.
|
|
32
36
|
|
|
33
|
-
###
|
|
37
|
+
### Corner Style
|
|
34
38
|
|
|
35
|
-
- Use
|
|
39
|
+
- Use sharp="true" when sd-chip sits directly on top of an image or a container with no padding, so the rounded corners aren’t cut off at the edge. For all other placements, use sharp="true".
|
|
36
40
|
|
|
37
41
|
### Accessibility
|
|
38
42
|
|
|
@@ -43,7 +47,7 @@ Use the styles tool (with `style` + `example` args) to retrieve the HTML for any
|
|
|
43
47
|
### Related Templates
|
|
44
48
|
|
|
45
49
|
- chip--docs
|
|
46
|
-
-
|
|
50
|
+
- tab-group--docs
|
|
47
51
|
- status-badge--docs
|
|
48
52
|
|
|
49
53
|
Use the templates tool (with `template` arg) to retrieve the full code for any of these templates.
|
|
@@ -23,18 +23,16 @@ args
|
|
|
23
23
|
}
|
|
24
24
|
};
|
|
25
25
|
/**
|
|
26
|
-
Use the
|
|
26
|
+
Use the `&--color-*` classes to switch between color families:
|
|
27
27
|
|
|
28
|
-
- primary
|
|
29
|
-
- `sd-chip--
|
|
30
|
-
- `sd-chip--
|
|
31
|
-
- `sd-chip--white`
|
|
28
|
+
- sd-chip--color-primary is the default appearance
|
|
29
|
+
- `sd-chip--color-neutral`
|
|
30
|
+
- `sd-chip--color-white`
|
|
32
31
|
|
|
33
32
|
```html
|
|
34
|
-
<div class="flex gap-12">
|
|
35
|
-
<div class="sd-chip">primary
|
|
36
|
-
<div class="sd-chip sd-chip--
|
|
37
|
-
<div class="sd-chip sd-chip--
|
|
38
|
-
<div class="sd-chip sd-chip--white">white</div>
|
|
33
|
+
<div class="flex gap-12 items-center">
|
|
34
|
+
<div class="sd-chip sd-chip--color-primary">primary</div>
|
|
35
|
+
<div class="sd-chip sd-chip--color-neutral">neutral</div>
|
|
36
|
+
<div class="sd-chip sd-chip--color-white">white</div>
|
|
39
37
|
</div>
|
|
40
38
|
```
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
Use the `&--shade-*` classes to select an emphasis level within the chosen color:
|
|
2
|
+
|
|
3
|
+
- sd-chip--shade-subtle is the default appearance
|
|
4
|
+
- `sd-chip--shade-low`
|
|
5
|
+
- `sd-chip--shade-medium`
|
|
6
|
+
- `sd-chip--shade-high`
|
|
7
|
+
- `sd-chip--shade-none` (white only)
|
|
8
|
+
|
|
9
|
+
```html
|
|
10
|
+
<div class="flex gap-12 items-center">
|
|
11
|
+
<div class="sd-chip sd-chip--shade-subtle">subtle</div>
|
|
12
|
+
<div class="sd-chip sd-chip--shade-low">low</div>
|
|
13
|
+
<div class="sd-chip sd-chip--shade-medium">medium</div>
|
|
14
|
+
<div class="sd-chip sd-chip--shade-high">high</div>
|
|
15
|
+
<div class="sd-chip sd-chip--shade-none">none</div>
|
|
16
|
+
</div>
|
|
17
|
+
```
|
|
@@ -42,7 +42,7 @@ The style appends its position relative to the position of the parent container
|
|
|
42
42
|
<div class="z-20 sd-hidden-links">
|
|
43
43
|
<sd-button href="#">Skip to content</sd-button>
|
|
44
44
|
</div>
|
|
45
|
-
<sd-header class="z-10" fixed>
|
|
45
|
+
<sd-header class="z-10" fixed shadow>
|
|
46
46
|
<div class="flex justify-between items-center">
|
|
47
47
|
<!-- top-left-area start !-->
|
|
48
48
|
<a class="flex flex-shrink" href="#">
|
|
@@ -86,7 +86,7 @@ version: 1.0.0
|
|
|
86
86
|
}
|
|
87
87
|
</style>
|
|
88
88
|
|
|
89
|
-
<sd-header class="max-w-[650px]" fixed>
|
|
89
|
+
<sd-header class="max-w-[650px]" fixed shadow>
|
|
90
90
|
<div class="flex justify-between items-center">
|
|
91
91
|
<a class="flex flex-shrink" href="#">
|
|
92
92
|
<img class="h-8 w-auto object-contain" src="${currentTheme.logoLg}" alt="${currentTheme.alt}" />
|
|
@@ -124,10 +124,8 @@ version: 1.0.0
|
|
|
124
124
|
alt="A parent and child reading a book together on the couch."
|
|
125
125
|
/>
|
|
126
126
|
</div>
|
|
127
|
-
<h3 slot="headline">
|
|
128
|
-
|
|
129
|
-
Steuerliche und rechtliche Basics beim Sparen fürs Kind</span
|
|
130
|
-
>
|
|
127
|
+
<h3 slot="headline" class="sd-headline sd-headline--size-base">
|
|
128
|
+
Steuerliche und rechtliche Basics beim Sparen fürs Kind
|
|
131
129
|
</h3>
|
|
132
130
|
<p class="sd-paragraph">
|
|
133
131
|
Beim Sparen fürs Kind gibt es neben der Finanzplanung auch wichtige steuerliche und rechtliche Punkte zu
|
|
@@ -31,7 +31,7 @@ version: 1.0.0
|
|
|
31
31
|
}
|
|
32
32
|
</style>
|
|
33
33
|
|
|
34
|
-
<sd-header id="horizontal" fixed>
|
|
34
|
+
<sd-header id="horizontal" fixed shadow>
|
|
35
35
|
<div class="flex justify-between items-center my-0 lg:my-3">
|
|
36
36
|
<a class="inline-flex sd-interactive" href="#">
|
|
37
37
|
<img class="h-8 md:h-12 lg:h-14 w-auto object-contain" src="${currentTheme.logoLg}" alt="${currentTheme.alt}" />
|
|
@@ -18,16 +18,6 @@ version: 1.0.0
|
|
|
18
18
|
## Template: Dialog with Button Group
|
|
19
19
|
|
|
20
20
|
```html
|
|
21
|
-
<!-- TODO: remove once this bugfix is addressed: https://github.com/solid-design-system/solid/issues/1325 -->
|
|
22
|
-
<style>
|
|
23
|
-
@media (min-width: 414px) {
|
|
24
|
-
sd-dialog::part(footer) {
|
|
25
|
-
width: 100%;
|
|
26
|
-
margin: 0;
|
|
27
|
-
}
|
|
28
|
-
}
|
|
29
|
-
</style>
|
|
30
|
-
|
|
31
21
|
<sd-button id="drawer-trigger">Open Dialog</sd-button>
|
|
32
22
|
<sd-dialog id="dialog" open>
|
|
33
23
|
<span slot="headline" class="sd-headline sd-headline--size-3xl">Cancel your subscription?</span>
|
|
@@ -63,7 +63,7 @@ version: 1.0.0
|
|
|
63
63
|
}
|
|
64
64
|
</style>
|
|
65
65
|
|
|
66
|
-
<sd-header id="horizontal" fixed>
|
|
66
|
+
<sd-header id="horizontal" fixed shadow>
|
|
67
67
|
<div class="flex justify-between items-center my-0 lg:my-3">
|
|
68
68
|
<a class="inline-flex sd-interactive" href="#">
|
|
69
69
|
<img class="h-8 md:h-12 lg:h-14 w-auto object-contain" src="${currentTheme.logoLg}" alt="${currentTheme.alt}" />
|
|
@@ -776,7 +776,7 @@ version: 1.0.0
|
|
|
776
776
|
## Template: Header Sample A-01
|
|
777
777
|
|
|
778
778
|
```html
|
|
779
|
-
<sd-header id="sample-a-header" fixed>
|
|
779
|
+
<sd-header id="sample-a-header" fixed shadow>
|
|
780
780
|
<div class="flex justify-between items-center">
|
|
781
781
|
<!-- top-left-area start !-->
|
|
782
782
|
<a class="flex flex-shrink" href="#">
|
|
@@ -923,7 +923,7 @@ version: 1.0.0
|
|
|
923
923
|
## Template: Header Sample A-02
|
|
924
924
|
|
|
925
925
|
```html
|
|
926
|
-
<sd-header id="sample-a02-header" fixed>
|
|
926
|
+
<sd-header id="sample-a02-header" fixed shadow>
|
|
927
927
|
<div class="flex justify-between items-center">
|
|
928
928
|
<!-- top-left-area start !-->
|
|
929
929
|
<a class="flex flex-shrink" href="#">
|
|
@@ -1094,7 +1094,7 @@ version: 1.0.0
|
|
|
1094
1094
|
}
|
|
1095
1095
|
</style>
|
|
1096
1096
|
<div class="min-h-screen grid grid-cols-[auto_1fr] grid-rows-[auto_1fr]">
|
|
1097
|
-
<sd-header id="vertical" fixed class="col-span-2">
|
|
1097
|
+
<sd-header id="vertical" fixed shadow class="col-span-2">
|
|
1098
1098
|
<div class="flex justify-between items-center">
|
|
1099
1099
|
<a class="inline-flex sd-interactive" href="#">
|
|
1100
1100
|
<img class="h-8 md:h-12 w-auto object-contain" src="${currentTheme.logoLg}" alt="${currentTheme.alt}" />
|
|
@@ -1373,7 +1373,7 @@ version: 1.0.0
|
|
|
1373
1373
|
## Template: Header Variant B-01
|
|
1374
1374
|
|
|
1375
1375
|
```html
|
|
1376
|
-
<sd-header id="sample-b-01-header" fixed>
|
|
1376
|
+
<sd-header id="sample-b-01-header" fixed shadow>
|
|
1377
1377
|
<div class="flex justify-between items-center">
|
|
1378
1378
|
<!-- top-left-area: logo + 2nd sender -->
|
|
1379
1379
|
<div class="flex items-center lg:justify-between lg:w-full">
|
|
@@ -1509,7 +1509,7 @@ version: 1.0.0
|
|
|
1509
1509
|
## Template: Header Variant B-02
|
|
1510
1510
|
|
|
1511
1511
|
```html
|
|
1512
|
-
<sd-header id="sample-b-02-header" fixed>
|
|
1512
|
+
<sd-header id="sample-b-02-header" fixed shadow>
|
|
1513
1513
|
<div class="flex justify-between items-center">
|
|
1514
1514
|
<div class="flex items-center lg:justify-between lg:w-full">
|
|
1515
1515
|
<div class="flex px-2 py-4 items-center justify-center bg-neutral-100 text-primary text-sm">2nd Sender</div>
|
|
@@ -4,7 +4,7 @@ title: Status Badge
|
|
|
4
4
|
components:
|
|
5
5
|
- sd-button
|
|
6
6
|
- sd-chip
|
|
7
|
-
- sd-chip--
|
|
7
|
+
- sd-chip--shade-low
|
|
8
8
|
- sd-container
|
|
9
9
|
- sd-container--variant-neutral-100
|
|
10
10
|
- sd-headline
|
|
@@ -131,7 +131,7 @@ version: 1.0.0
|
|
|
131
131
|
Available
|
|
132
132
|
</div>
|
|
133
133
|
</div>
|
|
134
|
-
<span class="sd-chip sd-chip--
|
|
134
|
+
<span class="sd-chip sd-chip--shade-low">Authorized for telephone information</span>
|
|
135
135
|
</div>
|
|
136
136
|
|
|
137
137
|
<sd-button class="edit-button" variant="secondary">
|
|
@@ -179,7 +179,7 @@ version: 1.0.0
|
|
|
179
179
|
Be right back
|
|
180
180
|
</div>
|
|
181
181
|
</div>
|
|
182
|
-
<span class="sd-chip sd-chip--
|
|
182
|
+
<span class="sd-chip sd-chip--shade-low">Not authorized for telephone information</span>
|
|
183
183
|
</div>
|
|
184
184
|
|
|
185
185
|
<sd-button class="edit-button" variant="secondary">
|
|
@@ -4,13 +4,11 @@ title: Teaser
|
|
|
4
4
|
components:
|
|
5
5
|
- sd-button
|
|
6
6
|
- sd-chip
|
|
7
|
-
- sd-chip--
|
|
8
|
-
- sd-chip--
|
|
9
|
-
- sd-chip--
|
|
10
|
-
- sd-
|
|
11
|
-
- sd-
|
|
12
|
-
- sd-flag--neutral-300
|
|
13
|
-
- sd-flag--white
|
|
7
|
+
- sd-chip--color-neutral
|
|
8
|
+
- sd-chip--color-white
|
|
9
|
+
- sd-chip--shade-low
|
|
10
|
+
- sd-chip--sharp
|
|
11
|
+
- sd-chip--size-lg
|
|
14
12
|
- sd-headline
|
|
15
13
|
- sd-headline--inverted
|
|
16
14
|
- sd-headline--size-3xl
|
|
@@ -165,7 +163,7 @@ version: 1.0.0
|
|
|
165
163
|
</div>
|
|
166
164
|
```
|
|
167
165
|
|
|
168
|
-
## Template: Teaser with Chip
|
|
166
|
+
## Template: Teaser with Chip
|
|
169
167
|
|
|
170
168
|
```html
|
|
171
169
|
<div class="flex flex-col gap-8">
|
|
@@ -179,8 +177,10 @@ version: 1.0.0
|
|
|
179
177
|
alt="Colleagues in a casual office meeting, smiling and interacting, symbolizing collaboration and the value of office spaces."
|
|
180
178
|
class="aspect-video object-cover"
|
|
181
179
|
/>
|
|
182
|
-
<span class="absolute top-3 left-4 sd-chip sd-chip--
|
|
183
|
-
<span class="absolute top-
|
|
180
|
+
<span class="absolute top-3 left-4 sd-chip sd-chip--color-white">Remote Work</span>
|
|
181
|
+
<span class="absolute top-3 right-0 sd-chip sd-chip--color-neutral sd-chip--shade-low sd-chip--size-lg"
|
|
182
|
+
>Research</span
|
|
183
|
+
>
|
|
184
184
|
</div>
|
|
185
185
|
<div slot="meta" class="meta-info">
|
|
186
186
|
<span class="sd-meta sd-meta--inverted sd-meta--light sd-meta--size-sm sd-meta--pipe">05.06.2024</span>
|
|
@@ -200,8 +200,11 @@ version: 1.0.0
|
|
|
200
200
|
<h3 slot="headline" class="sd-headline sd-headline--size-lg">
|
|
201
201
|
ECB interest rate cut: a trend reversal on the real estate markets?
|
|
202
202
|
</h3>
|
|
203
|
-
<span class="absolute top-3 left-4 sd-chip
|
|
204
|
-
<span
|
|
203
|
+
<span class="absolute top-3 left-4 sd-chip">Investment</span>
|
|
204
|
+
<span
|
|
205
|
+
class="absolute top-3 right-0 sd-chip sd-chip--color-neutral sd-chip--shade-low sd-chip--size-lg sd-chip--sharp"
|
|
206
|
+
>Trends</span
|
|
207
|
+
>
|
|
205
208
|
<div slot="media" class="flex flex-wrap h-[189px] content-center justify-center">
|
|
206
209
|
<sd-icon class="text-[96px]" name="content/house-percent" color="primary"></sd-icon>
|
|
207
210
|
</div>
|
|
@@ -232,8 +235,11 @@ version: 1.0.0
|
|
|
232
235
|
alt="City skyline, highlighting growth in real estate transactions."
|
|
233
236
|
class="aspect-video sm:aspect-[3/4] md:aspect-[16/9] object-cover w-full"
|
|
234
237
|
/>
|
|
235
|
-
<span class="absolute top-3 left-4 sd-chip sd-chip--white">Real Estate</span>
|
|
236
|
-
<span
|
|
238
|
+
<span class="absolute top-3 left-4 sd-chip sd-chip--color-white">Real Estate</span>
|
|
239
|
+
<span
|
|
240
|
+
class="absolute top-3 right-0 sd-chip sd-chip--color-neutral sd-chip--shade-low sd-chip--size-lg sd-chip--sharp"
|
|
241
|
+
>Analytics</span
|
|
242
|
+
>
|
|
237
243
|
</div>
|
|
238
244
|
</sd-teaser>
|
|
239
245
|
</div>
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
This page guides you through installing and setting up the `@solid-design-system/tokens` package to use themes and/or design tokens in your project.
|
|
4
4
|
|
|
5
|
-
<sd-notification
|
|
5
|
+
<sd-notification variant="info" open>
|
|
6
6
|
The `components`, `styles`, and `tokens` packages always share the same version. We use fixed versioning to keep them
|
|
7
7
|
fully in sync, so every release updates all three packages, even if only one of them changed. Make sure to install or
|
|
8
8
|
update them using the same version number.
|
|
@@ -23,29 +23,12 @@ npm install @solid-design-system/tokens
|
|
|
23
23
|
|
|
24
24
|
## Import a theme
|
|
25
25
|
|
|
26
|
-
Load at least one theme
|
|
26
|
+
Load at least one theme via NPM import. This only needs to be done **once per document**. Every component and embedded consumer on the page will automatically inherit the theme.
|
|
27
27
|
|
|
28
|
-
<sd-tab-group>
|
|
29
|
-
{/* prettier-ignore */}
|
|
30
|
-
<sd-tab slot="nav" panel="npm" variant="container">NPM</sd-tab>
|
|
31
|
-
{/* prettier-ignore */}
|
|
32
|
-
<sd-tab slot="nav" panel="cdn" variant="container">CDN</sd-tab>
|
|
33
|
-
<sd-tab-panel name="npm">
|
|
34
28
|
```js
|
|
35
|
-
```
|
|
36
29
|
|
|
37
|
-
</sd-tab-panel>
|
|
38
|
-
<sd-tab-panel name="cdn">
|
|
39
|
-
```html
|
|
40
|
-
<link
|
|
41
|
-
rel="stylesheet"
|
|
42
|
-
href="https://solid-design-system.fe.union-investment.de/tokens/%TOKENS-VERSION%/cdn/themes/ui-light/ui-light.css"
|
|
43
|
-
/>
|
|
44
30
|
```
|
|
45
31
|
|
|
46
|
-
</sd-tab-panel>
|
|
47
|
-
</sd-tab-group>
|
|
48
|
-
|
|
49
32
|
## Next steps
|
|
50
33
|
|
|
51
34
|
Depending on the theme, make sure the following page-level concerns are covered.
|
|
@@ -416,10 +399,6 @@ Deprecated variables:
|
|
|
416
399
|
- `--sd-button--size-md-border-radius` replace with `--sd-button-border-radius`
|
|
417
400
|
- `--sd-button--size-sm-border-radius` replace with `--sd-button-border-radius`
|
|
418
401
|
- `--sd-button--secondary--inverted--color-border` replace with `--sd-button-secondary-inverted-color-border`
|
|
419
|
-
- `--sd-chip-font-size` replace with `--sd-marker-font-size`
|
|
420
|
-
- `--sd-chip-border-width` replace with `--sd-marker-border-width`
|
|
421
|
-
- `--sd-chip-font-weight` replace with `--sd-marker-font-weight`
|
|
422
|
-
- `--sd-flag-border-width` replace with `--sd-marker-border-width`
|
|
423
402
|
- `--sd-form-control-color-icon` replace with `--sd-form-control-color-icon-fill`
|
|
424
403
|
- `--sd-menu-color-icon` replace with `--sd-menu-item-color-icon-fill`
|
|
425
404
|
- `--sd-menu-color-text` replace with `--sd-menu-item-color-text`
|
|
@@ -16,17 +16,9 @@ This page covers advanced usage patterns for `@solid-design-system/tokens`. Make
|
|
|
16
16
|
|
|
17
17
|
To automatically respect the user's OS-level preference, use the `prefers-color-scheme` media query on your `<link>` tags:
|
|
18
18
|
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
href="https://solid-design-system.fe.union-investment.de/tokens/%TOKENS-VERSION%/cdn/themes/ui-light/ui-light.css"
|
|
23
|
-
media="(prefers-color-scheme: light)"
|
|
24
|
-
/>
|
|
25
|
-
<link
|
|
26
|
-
rel="stylesheet"
|
|
27
|
-
href="https://solid-design-system.fe.union-investment.de/tokens/%TOKENS-VERSION%/cdn/themes/ui-dark/ui-dark.css"
|
|
28
|
-
media="(prefers-color-scheme: dark)"
|
|
29
|
-
/>
|
|
19
|
+
```css
|
|
20
|
+
@import '@solid-design-system/tokens/dist/themes/ui-light/ui-light.css' (prefers-color-scheme: light);
|
|
21
|
+
@import '@solid-design-system/tokens/dist/themes/ui-dark/ui-dark.css' (prefers-color-scheme: dark);
|
|
30
22
|
```
|
|
31
23
|
|
|
32
24
|
For further information on how to make this more dynamic, check out [this article](https://pepelsbey.dev/articles/native-light-dark/).
|
|
@@ -136,22 +128,6 @@ The following CSS variables (tokens) are deprecated and will be removed in a fut
|
|
|
136
128
|
<td>`--sd-button--secondary--inverted--color-border`</td>
|
|
137
129
|
<td>`--sd-button-secondary-inverted-color-border`</td>
|
|
138
130
|
</tr>
|
|
139
|
-
<tr>
|
|
140
|
-
<td>`--sd-chip-font-size`</td>
|
|
141
|
-
<td>`--sd-marker-font-size`</td>
|
|
142
|
-
</tr>
|
|
143
|
-
<tr>
|
|
144
|
-
<td>`--sd-chip-border-width`</td>
|
|
145
|
-
<td>`--sd-marker-border-width`</td>
|
|
146
|
-
</tr>
|
|
147
|
-
<tr>
|
|
148
|
-
<td>`--sd-chip-font-weight`</td>
|
|
149
|
-
<td>`--sd-marker-font-weight`</td>
|
|
150
|
-
</tr>
|
|
151
|
-
<tr>
|
|
152
|
-
<td>`--sd-flag-border-width`</td>
|
|
153
|
-
<td>`--sd-marker-border-width`</td>
|
|
154
|
-
</tr>
|
|
155
131
|
<tr>
|
|
156
132
|
<td>`--sd-form-control-color-icon`</td>
|
|
157
133
|
<td>`--sd-form-control-color-icon-fill`</td>
|
|
@@ -32,6 +32,8 @@
|
|
|
32
32
|
"--background-color-neutral-500",
|
|
33
33
|
"--background-color-neutral-600",
|
|
34
34
|
"--background-color-neutral-800",
|
|
35
|
+
"--background-color-neutral-blue",
|
|
36
|
+
"--background-color-neutral-grey",
|
|
35
37
|
"--background-color-primary-100",
|
|
36
38
|
"--background-color-primary-200",
|
|
37
39
|
"--background-color-primary-300",
|
|
@@ -40,6 +42,7 @@
|
|
|
40
42
|
"--background-color-primary",
|
|
41
43
|
"--background-color-success",
|
|
42
44
|
"--background-color-warning",
|
|
45
|
+
"--background-color-white-translucent",
|
|
43
46
|
"--background-color-white",
|
|
44
47
|
"--border-color-accent-550",
|
|
45
48
|
"--border-color-accent",
|
|
@@ -49,6 +52,7 @@
|
|
|
49
52
|
"--border-color-neutral-500",
|
|
50
53
|
"--border-color-neutral-600",
|
|
51
54
|
"--border-color-neutral-800",
|
|
55
|
+
"--border-color-neutral-blue",
|
|
52
56
|
"--border-color-primary-100",
|
|
53
57
|
"--border-color-primary-200",
|
|
54
58
|
"--border-color-primary-400",
|
package/package.json
CHANGED
|
@@ -20,9 +20,9 @@
|
|
|
20
20
|
"prettier": "^3.9.5",
|
|
21
21
|
"tsx": "^4.23.1",
|
|
22
22
|
"typescript": "^5.9.3",
|
|
23
|
-
"@solid-design-system/
|
|
24
|
-
"@solid-design-system/
|
|
25
|
-
"@solid-design-system/
|
|
23
|
+
"@solid-design-system/components": "7.0.0-next.10",
|
|
24
|
+
"@solid-design-system/styles": "7.0.0-next.10",
|
|
25
|
+
"@solid-design-system/tokens": "7.0.0-next.10"
|
|
26
26
|
},
|
|
27
27
|
"exports": {
|
|
28
28
|
".": {
|
|
@@ -59,7 +59,7 @@
|
|
|
59
59
|
"directory": "packages/mcp"
|
|
60
60
|
},
|
|
61
61
|
"type": "module",
|
|
62
|
-
"version": "
|
|
62
|
+
"version": "7.0.0-next.10",
|
|
63
63
|
"scripts": {
|
|
64
64
|
"build": "pnpm run build:components && pnpm run build:tokens && pnpm run build:ts && pnpm run build:metadata && cd ../.. && pnpm exec prettier --write --log-level warn packages/mcp/metadata",
|
|
65
65
|
"build:components": "cd ../components && pnpm exec node scripts/make-metadata.js --outdir dist",
|
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
## Overview
|
|
2
|
-
|
|
3
|
-
`<sd-spinner>` — Used as a visual indicator with a looping animation that shows loading is in process.
|
|
4
|
-
|
|
5
|
-
## API
|
|
6
|
-
|
|
7
|
-
### Examples
|
|
8
|
-
|
|
9
|
-
Use the components tool by passing the args `component` and `example` for any of these combinations:
|
|
10
|
-
|
|
11
|
-
- component: sd-spinner, example: variants
|
|
12
|
-
- component: sd-spinner, example: size
|
|
13
|
-
|
|
14
|
-
### Key Properties
|
|
15
|
-
|
|
16
|
-
- prop.color: 'primary'|'white'|'currentColor', default='currentColor' — The color color of the spinner.
|
|
17
|
-
- prop.dir: 'ltr'|'rtl'|'auto' — The element's directionality.
|
|
18
|
-
- prop.lang: string — The element's language.
|
|
19
|
-
|
|
20
|
-
## Guidelines
|
|
21
|
-
|
|
22
|
-
### Use Cases
|
|
23
|
-
|
|
24
|
-
- Indicate that content is being loaded, such as when fetching data from a server or loading a new page.
|
|
25
|
-
- Show ongoing background processes, like file uploads or data processing tasks.
|
|
26
|
-
- Used within buttons or interactive elements to indicate that an action is being processed.
|
|
27
|
-
- Apply to sections of a page that are loading independently, such as widgets or panels.
|
|
28
|
-
- Display when a form is being submitted to show that the submission is in progress.
|
|
29
|
-
|
|
30
|
-
### Rules
|
|
31
|
-
|
|
32
|
-
### Content
|
|
33
|
-
|
|
34
|
-
- Include a label or message to provide context about what is being loaded, especially if the loading time is long.
|
|
35
|
-
|
|
36
|
-
### Behavior and Placement
|
|
37
|
-
|
|
38
|
-
- Use for processes that take a short amount of time (typically under 4 seconds).
|
|
39
|
-
- Apply within specific sections rather than blocking the entire page, unless absolutely necessary.
|
|
40
|
-
- Place in a consistent location relative to the content it is loading.
|
|
41
|
-
|
|
42
|
-
### Styling
|
|
43
|
-
|
|
44
|
-
- Maintain consistency in size and style; avoid using spinners of varying sizes on the same page.
|
|
45
|
-
|
|
46
|
-
### Background
|
|
47
|
-
|
|
48
|
-
- Use light background options like white, neutral-100, primary-100, or use a primary background when inverted.
|
|
49
|
-
|
|
50
|
-
### Accessibility
|
|
51
|
-
|
|
52
|
-
- Assign role="status" or use a live region (e.g., aria-live="polite") to inform screen reader users of ongoing loading.
|
|
53
|
-
- A spinner shouldn’t itself be focusable or interactive, nor prevent from navigating to other parts of the page while loading continues.
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
Use the CSS property `font-size` to scale the spinner proportionally.
|
|
2
|
-
|
|
3
|
-
```html
|
|
4
|
-
<div class="flex flex-row gap-12">
|
|
5
|
-
<div style="font-size: inherit">
|
|
6
|
-
<sd-spinner color="primary"></sd-spinner>
|
|
7
|
-
</div>
|
|
8
|
-
<div style="font-size: 2rem">
|
|
9
|
-
<sd-spinner color="primary"></sd-spinner>
|
|
10
|
-
</div>
|
|
11
|
-
<div style="font-size: 4rem">
|
|
12
|
-
<sd-spinner color="primary"></sd-spinner>
|
|
13
|
-
</div>
|
|
14
|
-
</div>
|
|
15
|
-
```
|
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
<sd-notification variant="warning" open class="mb-4">**Warning:** The `sd-spinner` will be deprecated in the future. Please use the `sd-loader` component instead.</sd-notification>
|
|
2
|
-
**Known browser issues:**
|
|
3
|
-
|
|
4
|
-
- The 'sd-spinner' component may experience spinner animation issues in Safari, causing them to appear wobbly.
|
|
5
|
-
/
|
|
6
|
-
export default {
|
|
7
|
-
title: 'Components/sd-spinner',
|
|
8
|
-
component: 'sd-spinner',
|
|
9
|
-
tags: ['!dev', 'autodocs'],
|
|
10
|
-
args: overrideArgs({ type: 'attribute', name: 'color', value: 'primary' }),
|
|
11
|
-
argTypes,
|
|
12
|
-
parameters: {
|
|
13
|
-
...parameters,
|
|
14
|
-
design: {
|
|
15
|
-
type: 'figma',
|
|
16
|
-
url: 'https://www.figma.com/design/YDktJcseQIIQbsuCpoKS4V/Component-Docs?node-id=2115-17681&node-type=section&t=5PpAC3TA3kYF7ufX-0'
|
|
17
|
-
}
|
|
18
|
-
}
|
|
19
|
-
};
|
|
20
|
-
export const Default = {
|
|
21
|
-
render: (args: any) => {
|
|
22
|
-
return generateTemplate({ args });
|
|
23
|
-
}
|
|
24
|
-
};
|
|
25
|
-
/**
|
|
26
|
-
Use the `color` attribute to set the spinner's color:
|
|
27
|
-
- `currentColor` (default): used to inherit the `text-color` from the parent element
|
|
28
|
-
- `primary`: used on light backgrounds
|
|
29
|
-
- `white`: used on primary backgrounds
|
|
30
|
-
|
|
31
|
-
```html
|
|
32
|
-
<div class="flex flex-row items-center gap-12">
|
|
33
|
-
<div class="p-4">
|
|
34
|
-
<sd-spinner color="currentColor"></sd-spinner>
|
|
35
|
-
</div>
|
|
36
|
-
<div class="p-4">
|
|
37
|
-
<sd-spinner color="primary"></sd-spinner>
|
|
38
|
-
</div>
|
|
39
|
-
<div class="bg-primary p-4">
|
|
40
|
-
<sd-spinner color="white"></sd-spinner>
|
|
41
|
-
</div>
|
|
42
|
-
</div>
|
|
43
|
-
```
|
|
@@ -1,45 +0,0 @@
|
|
|
1
|
-
## Overview
|
|
2
|
-
|
|
3
|
-
`sd-flag` – Used as a small, non-interactive label that represents a category.
|
|
4
|
-
|
|
5
|
-
## API
|
|
6
|
-
|
|
7
|
-
### Examples
|
|
8
|
-
|
|
9
|
-
Use the styles tool (with `style` + `example` args) to retrieve the HTML for any of these examples:
|
|
10
|
-
|
|
11
|
-
- sd-flag/variants
|
|
12
|
-
|
|
13
|
-
## Guidelines
|
|
14
|
-
|
|
15
|
-
### Use Cases
|
|
16
|
-
|
|
17
|
-
- Indicate the status of items with visual labels, such as “New,” “Featured,” “Expired,” or “Limited Stock”.
|
|
18
|
-
- Label content type, like “Video,” “Article,” or “Podcast” to help users quickly identify the nature of the content.
|
|
19
|
-
|
|
20
|
-
### Rules
|
|
21
|
-
|
|
22
|
-
### Label and Styling
|
|
23
|
-
|
|
24
|
-
- Keep flag text short and easily scannable. Long text disrupts layouts and diminishes the flag’s visual impact.
|
|
25
|
-
- Use the “&--variant” property to apply the color variant that best works on the background, keeping it consistent throughout the product.
|
|
26
|
-
|
|
27
|
-
### Chips and Flags
|
|
28
|
-
|
|
29
|
-
- [sd-chip](./?path=/docs/styles-sd-chip--docs) and sd-flag can be used for similar purposes. Use them consistently throughout your product and, if both are needed, be sure to define which categories each should be used for (e.g. a chip on an article teaser informs about its subject, the flag about the type of article).
|
|
30
|
-
|
|
31
|
-
### Chips and Tags
|
|
32
|
-
|
|
33
|
-
- Use only as a non-interactive element; for interactive elements (e.g., a dynamic filter), use [sd-tag](./?path=/docs/styles-sd-tag--docs) instead.
|
|
34
|
-
|
|
35
|
-
### Accessibility
|
|
36
|
-
|
|
37
|
-
- Present flags as static labels (no focus or click behavior) to ensure screen readers don’t treat them as actionable elements.
|
|
38
|
-
- If the flag conveys crucial information (e.g., “Expired”), include that text in the accessible name or description for the surrounding context.
|
|
39
|
-
|
|
40
|
-
### Related Templates
|
|
41
|
-
|
|
42
|
-
- flag--docs
|
|
43
|
-
- teaser--docs
|
|
44
|
-
|
|
45
|
-
Use the templates tool (with `template` arg) to retrieve the full code for any of these templates.
|