@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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sb1/ffe-icons-react",
3
- "version": "12.0.6",
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": "0f26027df58d561ce8d5310c91033c5e62e50f51"
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
- ## Figma
20
-
21
- Når du bruker komponenter fra designsystem-biblioteket i Figma ligger ikonene tilgjengelig som en del av komponentene.
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
- 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»
24
- i Figma eller på [https://fonts.google.com/icons?icon.style=Rounded](https://fonts.google.com/icons?icon.style=Rounded).
25
-
26
- <img src={bytteIkonSrc} alt="Hvordan man bytter ikon i Figma" />
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
- 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.
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
- <img src={velgerTextStilSrc} alt="Hvordan man velger tekststil for ikoner" />
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
- Bruk Color Styles for å bytte farge på ikonet.
43
+ ### Ikonet vises ikke?
33
44
 
34
- <img src={velgerColorSrc} alt="Hvordan man velger color style for ikonet" />
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
- Bruk pakkene `ffe-icons` og `ffe-icons-react`. I `ffe-icons` finner du alle varianter av ikonene som SVG-filer, i tillegg til styling-filene som brukes i React-komponenten.
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
- `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. Det gjør at ikonet kan arve color-verdien fra et parent-element.
52
+ Når du bruker komponenter fra designsystem-biblioteket i Figma ligger ikonene tilgjengelig som en del av komponentene.
42
53
 
43
- Filbane er anbefalt metode for å importere ikoner. På denne måten kan man i tillegg til selve ikonet spesifisere variant, vekt og størrelse i URL-en ikonet hentes fra.
44
- For eksempel vil et åpent hjem-ikon med vekt 300 og størrelse md kunne tas i bruk slik:
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
- return <Icon fileUrl={homeIcon} size="md" ariaLabel="hjem" />;
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
- Dersom man ønsker å legge inn ikoner som data-URL må man selv konvertere ikonene til et passende format, for eksempel [base64](https://developer.mozilla.org/en-US/docs/Glossary/Base64).
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 tykkelsene 300, 400 og 500.
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
@@ -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} />,