scb-wc-test 0.1.95 → 0.1.97
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/README.md +75 -23
- package/all.js +2 -0
- package/mvc/components/scb-toc/scb-toc-item.js +3 -2
- package/mvc/scb-blazor-bridge.js +1922 -0
- package/mvc/scb-wc-test.css +1 -1
- package/package.json +10 -2
- package/scb-toc/scb-toc-item.js +15 -14
- package/scb-wc-test.bundle.js +1 -0
- package/scb-wc-test.css +1 -1
package/README.md
CHANGED
|
@@ -1,34 +1,55 @@
|
|
|
1
1
|
# Om SCB Web Components Test
|
|
2
2
|
|
|
3
3
|
> ⚠️ **Testpaket**
|
|
4
|
-
>
|
|
4
|
+
> `scb-wc-test` innehåller komponenter under utveckling. API, utseende och beteende kan ändras eller tas bort mellan versioner.
|
|
5
5
|
|
|
6
|
-
SCB Web Components
|
|
6
|
+
SCB Web Components(test) finns för att underlätta skapandet av enhetliga, tillgängliga och användbara webbapplikationer.
|
|
7
|
+
|
|
8
|
+
Komponenterna bygger på:
|
|
9
|
+
- [Lit](https://lit.dev/)
|
|
10
|
+
- [Material Web Components](https://material-web.dev/about/intro/)
|
|
11
|
+
|
|
12
|
+
## Storybook och dokumentation (internt)
|
|
13
|
+
|
|
14
|
+
Testkomponenterna dokumenteras och demonstreras i Storybook på SCB:s interna testadress:
|
|
15
|
+
|
|
16
|
+
- Test: <https://webcomponentstest.scb.intra>
|
|
17
|
+
|
|
18
|
+
Produktionskomponenterna finns på:
|
|
19
|
+
|
|
20
|
+
- Prod: <https://webcomponents.scb.intra>
|
|
7
21
|
|
|
8
22
|
---
|
|
9
23
|
|
|
10
24
|
## Kom igång
|
|
11
25
|
|
|
12
|
-
**Obs:** Kör alla kommandon i mappen där din `package.json` ligger.
|
|
26
|
+
> **Obs:** Kör alla kommandon i mappen där din `package.json` ligger.
|
|
27
|
+
> Har du ingen? Kör `npm init -y` i projektroten (eller annan lämplig mapp).
|
|
13
28
|
|
|
14
29
|
Installera paketet:
|
|
30
|
+
|
|
15
31
|
```sh
|
|
16
32
|
npm install scb-wc-test
|
|
17
33
|
```
|
|
18
34
|
|
|
19
35
|
---
|
|
20
36
|
|
|
21
|
-
## Alternativ 1: Använd som ES
|
|
37
|
+
## Alternativ 1: Använd som ES‑moduler (t.ex. i React, Vue, SPA)
|
|
38
|
+
|
|
39
|
+
Importera CSS och de testkomponenter du använder (bäst för tree‑shaking):
|
|
22
40
|
|
|
23
|
-
Importera enskilda komponenter (bäst för tree‑shaking):
|
|
24
41
|
```js
|
|
42
|
+
// Global CSS + tokens (måste bara importeras en gång)
|
|
25
43
|
import 'scb-wc-test/scb-wc-test.css';
|
|
26
44
|
import 'scb-wc-test/scb-typography.css';
|
|
45
|
+
|
|
46
|
+
// Enskilda web components
|
|
27
47
|
import 'scb-wc-test/scb-button';
|
|
28
48
|
import 'scb-wc-test/scb-accordion';
|
|
29
49
|
```
|
|
30
50
|
|
|
31
|
-
|
|
51
|
+
Vill du ladda allt finns en samlingsfil (inte rekommenderat i större appar):
|
|
52
|
+
|
|
32
53
|
```js
|
|
33
54
|
import 'scb-wc-test/scb-wc-test.css';
|
|
34
55
|
import 'scb-wc-test/scb-typography.css';
|
|
@@ -39,11 +60,16 @@ import 'scb-wc-test/all';
|
|
|
39
60
|
|
|
40
61
|
## Alternativ 2: Använd i MVC/MPA via `<script type="module">`
|
|
41
62
|
|
|
42
|
-
Det här läget använder den färdig‑
|
|
63
|
+
Det här läget använder den färdig‑splittade **MVC‑ESM**‑builden som följer med paketet under:
|
|
43
64
|
|
|
44
|
-
|
|
65
|
+
```text
|
|
66
|
+
node_modules/scb-wc-test/mvc/
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### 2.1) Rekommenderat: ett npm‑script för att kopiera UI‑filer
|
|
45
70
|
|
|
46
71
|
Lägg till i din apps `package.json`:
|
|
72
|
+
|
|
47
73
|
```jsonc
|
|
48
74
|
{
|
|
49
75
|
"scripts": {
|
|
@@ -53,63 +79,89 @@ Lägg till i din apps `package.json`:
|
|
|
53
79
|
```
|
|
54
80
|
|
|
55
81
|
Kör sedan:
|
|
82
|
+
|
|
56
83
|
```sh
|
|
57
84
|
npm run ui:install
|
|
58
85
|
```
|
|
59
86
|
|
|
60
|
-
Det kopierar hela `mvc/` till `wwwroot/ui/` (komponenter, vendor och CSS).
|
|
87
|
+
Det kopierar hela `node_modules/scb-wc-test/mvc/` till `wwwroot/ui/` i din applikation (komponenter, vendor och CSS).
|
|
61
88
|
|
|
62
|
-
### Ladda filer i din layout
|
|
89
|
+
### 2.2) Ladda filer i din layout (Razor, .cshtml, klassisk MVC)
|
|
63
90
|
|
|
64
91
|
```html
|
|
65
92
|
<!-- Lägg helst i <head> -->
|
|
66
93
|
<link rel="stylesheet" href="~/ui/scb-wc-test.css" />
|
|
67
94
|
<link rel="stylesheet" href="~/ui/scb-typography.css" />
|
|
68
95
|
|
|
69
|
-
|
|
70
96
|
<!-- Ladda ENDAST de komponenter du använder på sidan, gärna precis före </body> -->
|
|
71
97
|
<script type="module" src="~/ui/components/scb-link/scb-link.js"></script>
|
|
72
98
|
<script type="module" src="~/ui/components/scb-button/scb-button.js"></script>
|
|
73
|
-
|
|
74
99
|
```
|
|
75
100
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
### 2.1) CI/CD (exempel)
|
|
101
|
+
### 2.3) CI/CD‑exempel
|
|
79
102
|
|
|
80
103
|
Kör samma script i din pipeline:
|
|
104
|
+
|
|
81
105
|
```yaml
|
|
82
106
|
steps:
|
|
83
107
|
- script: npm ci
|
|
84
108
|
- script: npm run ui:install
|
|
85
109
|
```
|
|
86
110
|
|
|
87
|
-
Behöver du annan webbrotsökväg
|
|
111
|
+
Behöver du en annan webbrotsökväg (t.ex. om din `wwwroot` ligger någon annanstans) kan du ange flaggan:
|
|
112
|
+
|
|
88
113
|
```yaml
|
|
89
114
|
- script: npm run ui:install --ui_wwwroot=../wwwroot
|
|
90
115
|
```
|
|
91
116
|
|
|
92
117
|
---
|
|
93
118
|
|
|
94
|
-
## Alternativ 3:
|
|
119
|
+
## Alternativ 3: Bundlad version (IIFE) för äldre miljöer
|
|
95
120
|
|
|
96
|
-
Om ESM inte stöds
|
|
121
|
+
Om ESM inte stöds kan du använda den bundlade test‑varianten från paketroten.
|
|
97
122
|
Flytta följande två filer från `node_modules/scb-wc-test` och använd dem i applikationen:
|
|
98
|
-
|
|
123
|
+
|
|
124
|
+
```text
|
|
99
125
|
node_modules/scb-wc-test/scb-wc-test.bundle.js
|
|
100
126
|
node_modules/scb-wc-test/scb-wc-test.css
|
|
101
127
|
```
|
|
128
|
+
|
|
102
129
|
```html
|
|
103
130
|
<link rel="stylesheet" href="scb-wc-test.css">
|
|
104
131
|
<link rel="stylesheet" href="scb-typography.css" />
|
|
105
132
|
<script src="scb-wc-test.bundle.js"></script>
|
|
106
133
|
```
|
|
107
134
|
|
|
135
|
+
> **Obs:** Blanda inte MVC‑ESM och IIFE på samma sida.
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
## Alternativ 4: Blazor (Server och WebAssembly)
|
|
140
|
+
|
|
141
|
+
Även testkomponenterna kan användas i Blazor‑appar när du vill prova nya komponenter innan de flyttas till produktionspaketet.
|
|
142
|
+
|
|
143
|
+
Grundprincipen är samma som för `scb-wc`:
|
|
144
|
+
|
|
145
|
+
1. Använd MVC‑ESM‑builden (`node_modules/scb-wc-test/mvc`) och kopiera den till `wwwroot/ui` med `ui:install`.
|
|
146
|
+
2. Ladda `scb-blazor-bridge.js` från `wwwroot/ui` i din Blazor‑layout.
|
|
147
|
+
3. Lägg till (eller återanvänd) `ScbBlazorInteropBase` i din lösning.
|
|
148
|
+
|
|
149
|
+
Exempel på layout:
|
|
150
|
+
|
|
151
|
+
```html
|
|
152
|
+
<link rel="stylesheet" href="~/ui/scb-wc-test.css" />
|
|
153
|
+
<link rel="stylesheet" href="~/ui/scb-typography.css" />
|
|
154
|
+
|
|
155
|
+
<script type="module" src="~/ui/scb-blazor-bridge.js"></script>
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
`ScbBlazorInteropBase` är samma bas‑klass som används med prodpaketet. Du kan därför dela samma C#‑fil mellan projekt som använder `scb-wc` och `scb-wc-test`.
|
|
159
|
+
|
|
108
160
|
---
|
|
109
161
|
|
|
110
162
|
## Viktigt
|
|
111
163
|
|
|
112
|
-
- **
|
|
113
|
-
- **Placeringen av `package.json` styr
|
|
114
|
-
- **Blanda inte
|
|
115
|
-
- `scb-
|
|
164
|
+
- `scb-wc-test` är ett **testpaket**. Komponenter kan ändras eller tas bort mellan versioner. Använd inte paketet i externa produktionsmiljöer.
|
|
165
|
+
- **Kör kommandon i mappen med din `package.json`.** Placeringen av `package.json` styr standardmål för `ui:install` (rot → `wwwroot/ui`, `ClientApp/` → använd `--ui_wwwroot=../wwwroot`).
|
|
166
|
+
- **Blanda inte MVC‑ESM och IIFE på samma sida.** Välj en distributionsform per sida/app.
|
|
167
|
+
- **Blazor:** Se till att `scb-blazor-bridge.js` laddas efter att komponent‑JS:et finns på sidan, och att `ScbBlazorInteropBase` inte dupliceras i flera namespaces i samma lösning.
|
package/all.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import './all.js';
|
|
2
|
+
import './blazor/blazor/scb-blazor-bridge.js';
|
|
2
3
|
import './index.js';
|
|
3
4
|
import './mvc/components/all.js';
|
|
4
5
|
import './mvc/components/scb-accordion/scb-accordion-item.js';
|
|
@@ -65,6 +66,7 @@ import './mvc/components/scb-toc/scb-toc-item.js';
|
|
|
65
66
|
import './mvc/components/scb-toc/scb-toc.js';
|
|
66
67
|
import './mvc/components/scb-tooltip/scb-tooltip.js';
|
|
67
68
|
import './mvc/components/scb-viz/scb-viz.js';
|
|
69
|
+
import './mvc/scb-blazor-bridge.js';
|
|
68
70
|
import './mvc/vendor/preload-helper.js';
|
|
69
71
|
import './mvc/vendor/vendor-lit.js';
|
|
70
72
|
import './mvc/vendor/vendor-material.js';
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{a as p,n as d,i as
|
|
1
|
+
import{a as p,n as d,i as b,x as l,t as h}from"../../vendor/vendor.js";import"../scb-icon-button/scb-icon-button.js";import"../scb-divider/scb-divider.js";import"../../vendor/vendor-material.js";import"../../vendor/preload-helper.js";import"../scb-tooltip/scb-tooltip.js";import"../scb-button/scb-button.js";(function(){try{var e=typeof globalThis<"u"?globalThis:window;if(!e.__scb_ce_guard_installed__){e.__scb_ce_guard_installed__=!0;var s=customElements.define.bind(customElements);customElements.define=function(i,t,o){try{customElements.get(i)||s(i,t,o)}catch(n){var a=String(n||"");if(a.indexOf("already been used")===-1&&a.indexOf("NotSupportedError")===-1)throw n}}}}catch{}})();var u=Object.defineProperty,m=Object.getOwnPropertyDescriptor,c=(e,s,i,t)=>{for(var o=t>1?void 0:t?m(s,i):s,a=e.length-1,n;a>=0;a--)(n=e[a])&&(o=(t?n(s,i,o):n(o))||o);return t&&o&&u(s,i,o),o};let r=class extends b{constructor(){super(...arguments),this.expanded=!1,this.label="",this.supportingText="",this.itemHref="#",this.divider=!0,this._unique=crypto.randomUUID(),this._slotHasContent=!1,this._onSlotChange=()=>{const e=this.renderRoot.querySelector("slot");this._slotHasContent=!!e&&e.assignedNodes().length>0,this.requestUpdate(),this._updateTabbable()},this.toggleAccordion=()=>{const e=this.closest("scb-toc");e?.hasAttribute("detached")||e.querySelectorAll("scb-toc-item").forEach(t=>{t!==this&&t.expanded&&(t.expanded=!1,this.toggleBottom(t),t.dispatchEvent(new CustomEvent("expanded-changed",{detail:{expanded:!1},bubbles:!0,composed:!0})))});const s=this.expanded;this.expanded=!this.expanded,this.toggleBottom(this),s!==this.expanded&&this.dispatchEvent(new CustomEvent("expanded-changed",{detail:{expanded:this.expanded},bubbles:!0,composed:!0}))}}connectedCallback(){super.connectedCallback(),this.addEventListener("slotchange",this._onSlotChange)}disconnectedCallback(){super.disconnectedCallback(),this.removeEventListener("slotchange",this._onSlotChange)}updated(e){e.has("expanded")&&this._updateTabbable()}_updateTabbable(){if(typeof window>"u")return;const e=this.renderRoot.querySelector("slot");if(!e)return;e.assignedElements({flatten:!0}).forEach(i=>{i.matches("a,button,input,select,textarea,[tabindex]")&&(this.expanded?i.removeAttribute("tabindex"):i.setAttribute("tabindex","-1")),i.querySelectorAll?.("a,button,input,select,textarea,[tabindex]").forEach(t=>{const o=t;this.expanded?o.removeAttribute("tabindex"):o.setAttribute("tabindex","-1")})})}toggleBottom(e){const s=e.renderRoot.querySelector(".scb-toc-item-bottom");s&&(e.expanded?(s.style.maxHeight=`${s.scrollHeight}px`,setTimeout(()=>s.style.maxHeight="unset",160)):(s.style.maxHeight=`${s.scrollHeight}px`,requestAnimationFrame(()=>s.style.maxHeight="0")))}_onKeyDown(e){const s=this.closest("scb-toc"),t=Array.from(s?.querySelectorAll("scb-toc-item")||[]).map(n=>n.renderRoot.querySelector(".scb-toc-item")).filter(n=>!!n),o=e.currentTarget,a=t.indexOf(o);switch(e.key){case"Enter":case" ":e.preventDefault(),this.toggleAccordion();break;case"ArrowDown":e.preventDefault(),a<t.length-1&&t[a+1].focus();break;case"ArrowUp":e.preventDefault(),a>0&&t[a-1].focus();break;case"Home":e.preventDefault(),t.length&&t[0].focus();break;case"End":e.preventDefault(),t.length&&t[t.length-1].focus();break}}render(){const e=`bottom-${this._unique}`,s=`toc-label-${this._unique}`;return l`
|
|
2
2
|
<div
|
|
3
3
|
class="scb-toc-item"
|
|
4
4
|
role="listitem"
|
|
@@ -95,5 +95,6 @@ import{a as p,n as d,i as h,x as l,t as b}from"../../vendor/vendor.js";import"..
|
|
|
95
95
|
}
|
|
96
96
|
.scb-toc-item {
|
|
97
97
|
color: var(--md-sys-color-on-surface);
|
|
98
|
+
font-family: var(--brand-font, 'Inter', sans-serif);
|
|
98
99
|
}
|
|
99
|
-
`];c([d({type:Boolean})],r.prototype,"expanded",2);c([d({type:String,reflect:!0})],r.prototype,"label",2);c([d({type:String,attribute:"supporting-text"})],r.prototype,"supportingText",2);c([d({type:String,attribute:"item-href"})],r.prototype,"itemHref",2);c([d({type:Boolean,attribute:"divider"})],r.prototype,"divider",2);r=c([
|
|
100
|
+
`];c([d({type:Boolean})],r.prototype,"expanded",2);c([d({type:String,reflect:!0})],r.prototype,"label",2);c([d({type:String,attribute:"supporting-text"})],r.prototype,"supportingText",2);c([d({type:String,attribute:"item-href"})],r.prototype,"itemHref",2);c([d({type:Boolean,attribute:"divider"})],r.prototype,"divider",2);r=c([h("scb-toc-item")],r);
|