@sb1/ffe-icons-react 12.0.6 → 12.0.8
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/package.json +2 -2
- package/src/Icon.mdx +35 -34
- package/src/Icon.stories.tsx +0 -6
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sb1/ffe-icons-react",
|
|
3
|
-
"version": "12.0.
|
|
3
|
+
"version": "12.0.8",
|
|
4
4
|
"description": "React-komponenter for ffe-icons",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "SpareBank 1",
|
|
@@ -41,5 +41,5 @@
|
|
|
41
41
|
"publishConfig": {
|
|
42
42
|
"access": "public"
|
|
43
43
|
},
|
|
44
|
-
"gitHead": "
|
|
44
|
+
"gitHead": "9fc62c5c79e9dece50b7803b79484ae607859f9b"
|
|
45
45
|
}
|
package/src/Icon.mdx
CHANGED
|
@@ -16,69 +16,70 @@ Ikonene vi bruker kommer fra ikonbiblioteket Material Symbols. [Les mer om ikone
|
|
|
16
16
|
|
|
17
17
|
<InstallImport packageName="@sb1/ffe-icons-react" dependencies={dependencies} />
|
|
18
18
|
|
|
19
|
-
##
|
|
20
|
-
|
|
21
|
-
|
|
19
|
+
## Kode
|
|
20
|
+
For å bruke et ikon i kode må du gjøre 3 ting:
|
|
21
|
+
1. Importere styling `@import '@sb1/ffe-icons/less/ffe-icons';`
|
|
22
|
+
2. Importere ikonet `import closeIcon from '@sb1/ffe-icons/icons/open/300/md/close.svg';`
|
|
23
|
+
3. Importere React-komponenten som skal holde ikonet `import { Icon } from '@sb1/ffe-icons-react';`
|
|
22
24
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
25
|
+
Sammen ser det slik ut:
|
|
26
|
+
```
|
|
27
|
+
import { Icon } from '@sb1/ffe-icons-react';
|
|
28
|
+
import closeIcon from '@sb1/ffe-icons/icons/open/300/md/close.svg'; //{open eller filled} / {vekt} / {størrelse} / {navn}
|
|
29
|
+
//@import '@sb1/ffe-icons/less/ffe-icons'; //I en css-fil
|
|
30
|
+
.....
|
|
31
|
+
<Icon fileUrl={closeIcon} size="md" ariaLabel="lukk" />
|
|
32
|
+
```
|
|
33
|
+
Det er viktig at du setter en `size`-prop som stemmer overens med SVG-størrelsen, slik at ikonet vises riktig.
|
|
27
34
|
|
|
28
|
-
|
|
35
|
+
For å finne navnet på ikonet ("close" fra eksempelet) kan du enten finne ikonet via [Google Symbols](https://fonts.google.com/icons) eller se på navnet som er brukt på
|
|
36
|
+
ikonet i Figma, hvis du jobber ut i fra Figma-skisser.<br/>
|
|
29
37
|
|
|
30
|
-
|
|
38
|
+
I `ffe-icons` finner du alle varianter av ikonene som SVG-filer.
|
|
39
|
+
`Icon`-komponenten tar inn en filbane eller [data-URL](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs), og setter SVG-ikonet som en mask.
|
|
40
|
+
Det gjør at ikonet kan arve color-verdien fra et parent-element. Dersom du ønsker å legge inn ikoner som data-URL må man selv konvertere
|
|
41
|
+
ikonene til et passende format, for eksempel [base64](https://developer.mozilla.org/en-US/docs/Glossary/Base64).
|
|
31
42
|
|
|
32
|
-
|
|
43
|
+
### Ikonet vises ikke?
|
|
33
44
|
|
|
34
|
-
|
|
45
|
+
Hvis ikonet ikke vises, men i stedet blir en firkantet boks etter deploy, kan det skyldes at SVG-filen ikke blir
|
|
46
|
+
riktig håndtert av byggeverktøyet. Prøv å legge til `build.assetsInlineLimit: 0` i `vite.config.ts`
|
|
47
|
+
for å sikre at SVG-ikonene ikke blir inlinet som data-URL-er.
|
|
35
48
|
|
|
36
|
-
## SVG-implementasjon
|
|
37
49
|
|
|
38
|
-
|
|
39
|
-
SVG-filene er sortert på `weight`, om de er fylt eller ikke, samt størrelse. Hvilken størrelse du skal bruke kan variere fra komponent til komponent.
|
|
50
|
+
## Figma
|
|
40
51
|
|
|
41
|
-
|
|
52
|
+
Når du bruker komponenter fra designsystem-biblioteket i Figma ligger ikonene tilgjengelig som en del av komponentene.
|
|
42
53
|
|
|
43
|
-
|
|
44
|
-
|
|
54
|
+
For å bytte ikon klikker du deg bare inn på ikonet og skriver navnet på ikonet du vil ha. Du får oversikt over alle ikonene og navnene med plugin «Material Symbols»
|
|
55
|
+
i Figma eller på [https://fonts.google.com/icons?icon.style=Rounded](https://fonts.google.com/icons?icon.style=Rounded).
|
|
45
56
|
|
|
46
|
-
|
|
47
|
-
import homeIcon from '@sb1/ffe-icons/icons/open/300/md/home.svg';
|
|
57
|
+
<img src={bytteIkonSrc} alt="Hvordan man bytter ikon i Figma" />
|
|
48
58
|
|
|
49
|
-
|
|
50
|
-
```
|
|
59
|
+
Når du trenger et ikon utenfor komponentene lager du et nytt tekstelement, skriver navnet på ikonet, og velger en av tekststilene for ikoner under Text Styles.
|
|
51
60
|
|
|
52
|
-
|
|
61
|
+
<img src={velgerTextStilSrc} alt="Hvordan man velger tekststil for ikoner" />
|
|
53
62
|
|
|
54
63
|
## Forhåndsvisning
|
|
64
|
+
`aria-hidden` settes automatisk til true, dersom du ikke sender med en verdi i `ariaLabel`.
|
|
55
65
|
|
|
56
66
|
<Canvas of={IconStories.Standard} />
|
|
57
67
|
<Controls of={IconStories.Standard} />
|
|
58
68
|
|
|
59
|
-
`mask` fungerer på samme måte som bakgrunn. Det er derfor viktig at du setter en `size`-prop som stemmer overens med SVG-størrelsen, slik at ikonet vises riktig.
|
|
60
|
-
Setter du en verdi i `size` som ikke stemmer overens med SVG-en, vil resultatet se slik ut:
|
|
61
|
-
|
|
62
|
-
<Canvas of={IconStories.WrongSize} />
|
|
63
|
-
|
|
64
|
-
Dette er gjort med vilje for at man skal bli klar over at man bruker feil SVG, da linjetykkelsen varierer fra størrelse til størrelse.
|
|
65
|
-
|
|
66
|
-
`aria-hidden` settes automatisk til true, dersom du ikke sender med en verdi i `ariaLabel`:
|
|
67
|
-
|
|
68
|
-
<Canvas of={IconStories.NoAriaLabel} />
|
|
69
|
-
|
|
70
69
|
## Stil
|
|
71
70
|
|
|
72
71
|
Vi bruker stilen «rounded». Den harmonerer godt med resten av den visuelle identiteten til SpareBank 1.
|
|
73
72
|
|
|
74
73
|
## Størrelser
|
|
75
74
|
|
|
76
|
-
Velg mellom
|
|
75
|
+
Velg mellom størrelsene `sm`, `md`, `lg` og `xl`.
|
|
77
76
|
|
|
78
77
|
<Canvas of={IconStories.Sizes} />
|
|
79
78
|
|
|
80
79
|
## Tykkelser
|
|
81
80
|
|
|
81
|
+
Velg mellom tykkelsene 300, 400 og 500. 300 er mest vanlig.
|
|
82
|
+
|
|
82
83
|
<Canvas of={IconStories.Weights} />
|
|
83
84
|
|
|
84
85
|
## Farger
|
package/src/Icon.stories.tsx
CHANGED
|
@@ -19,12 +19,6 @@ export const Standard: Story = {
|
|
|
19
19
|
render: args => <Icon {...args} />,
|
|
20
20
|
};
|
|
21
21
|
|
|
22
|
-
export const WrongSize: Story = {
|
|
23
|
-
tags: ['!dev'],
|
|
24
|
-
args: { ...Standard.args, size: 'lg' },
|
|
25
|
-
render: args => <Icon {...args} />,
|
|
26
|
-
};
|
|
27
|
-
|
|
28
22
|
export const NoAriaLabel: Story = {
|
|
29
23
|
args: { ...Standard.args, ariaLabel: undefined },
|
|
30
24
|
render: args => <Icon {...args} />,
|