Icone React: come usare le icone in React

Icone React: come usare le icone in React (pacchetti, SVG, sprite) | We.Inc

Come aggiungere icone in React: lucide-react, react-icons, SVG inline o sprite a confronto, dimensioni del bundle misurate, dimensionamento con currentColor, accessibilità e configurazione in Next.js.

Icone React: come usare le icone in React

Installa un pacchetto di icone come lucide-react o react-icons e importa ogni icona per nome, per esempio import { Camera } from "lucide-react". Gli import con nome permettono il tree-shaking, quindi nel bundle finiscono solo le icone che usi. Dimensiona le icone con le props o con 1em, colorale tramite currentColor e nascondi quelle decorative con aria-hidden.

Scelte rapide

  • Se vuoi
  • Usa
  • Un solo set pulito e coerente
  • Icone da molti set
  • Due o tre icone personalizzate
  • Un componente SVG inline
  • Le stesse icone ripetute molte volte
  • Uno sprite SVG con <use>

Questa guida spiega come collegare le icone al codice React. Per sapere quali set di icone gratuiti scegliere e con quali licenze, vedi la nostra lista delle migliori librerie di icone gratuite. Le dimensioni riportate qui vengono dalle nostre build, con strumento e impostazioni indicati.

  • Scegli un approccio dalla tabella di confronto.
  • Installa il pacchetto, oppure incolla l'SVG in un componente o in uno sprite.
  • Importa ogni icona per nome; non importare mai l'intero pacchetto come namespace.
  • Imposta la dimensione con una prop o con 1em, e il colore tramite il colore del testo del genitore.
  • Aggiungi aria-hidden alle icone decorative e un'etichetta ai pulsanti con sola icona.
  • Quando puoi, scegli un solo set di icone per prodotto. Spessori di tratto diversi uno accanto all'altro sembrano disordinati.
  • Dai alle icone width e height (o una prop size) così non lampeggiano a piena dimensione prima che si carichi il CSS.
  • Controlla le dimensioni del bundle dopo aver aggiunto icone con l'analizzatore del tuo bundler; un solo import con wildcard può aggiungere centinaia di kilobyte.
  • Per i pulsanti con sola icona, metti l'etichetta sul pulsante, non sull'svg, così gli screen reader annunciano un pulsante con un nome.

Domande frequenti

È più piccolo lucide-react o react-icons?

Nel nostro test entrambi erano piccoli con un solo import con nome: 874 byte con gzip per un'icona lucide-react e circa 1.3 KB per un'icona react-icons, perché react-icons aggiunge un piccolo wrapper condiviso. Entrambi crescono solo di qualche centinaio di byte per ogni icona in più.

Come cambio il colore di un'icona in React?

La maggior parte dei componenti di icone React disegna con currentColor, quindi imposta la proprietà CSS color sull'icona o sul suo genitore, per esempio con una classe di colore del testo. lucide-react e react-icons accettano anche una prop color.

Le icone devono avere un testo alternativo?

Solo quando l'icona è l'unico elemento che trasmette un significato. In quel caso dalle role="img" e un aria-label, oppure dai un'etichetta al pulsante che la contiene. Le icone accanto a testo visibile vanno nascoste con aria-hidden="true".

I componenti di icone funzionano nei Server Components di Next.js?

Sì. I componenti di lucide-react e react-icons sono SVG senza stato e fanno il render sul server. Ti serve "use client" solo in un componente che usa stato o gestori di eventi.

Quando uno sprite SVG è meglio di un pacchetto?

Quando le stesse icone compaiono molte volte o su pagine che non sono React. Ogni <use> è un breve riferimento a un unico file in cache, invece di ripetere tutti i dati dei path nell'HTML.

Perché gli import contano

  • Entrambi i pacchetti mettono ogni icona in un modulo a sé, così un bundler può scartare tutto ciò che non hai importato. Funziona solo con gli import con nome. Un import namespace di lucide-react ha misurato 137 KB con gzip nel nostro test, contro meno di 1 KB per una sola icona.
  • Alcune configurazioni più vecchie, come Jest o un bundler senza supporto ai moduli ES, possono ancora caricare un intero file di famiglia. Se una build è lenta o pesante, controlla a quale file si risolve l'import dell'icona.

Errori comuni

  • Impostare fill su un'icona outline. I set outline disegnano con stroke, quindi un colore di riempimento appare come una macchia piena.
  • Lasciare i pulsanti con sola icona senza nome, così gli screen reader dicono solo "pulsante".
  • Impostare nel CSS una larghezza senza altezza su un svg che non ha viewBox, il che lo deforma.
  • Caricare uno sprite esterno da una CDN su un altro dominio. I browser bloccano i riferimenti <use> cross-origin.

Pacchetti, SVG inline o sprite

Quattro modi per mettere icone in un'app React

  • Approccio
  • Installazione
  • Tree-shaking
  • Ideale per
  • npm i lucide-react
  • Sì, un modulo per icona
  • Un unico set outline coerente
  • npm i react-icons
  • Sì con un bundler moderno; importa dal percorso di una famiglia
  • Mescolare icone da molti set
  • Componente SVG inline
  • Niente; incolla l'SVG in un componente
  • Solo ciò che scrivi
  • Una manciata di icone personalizzate o di brand
  • Sprite SVG + <use href>
  • Un unico file sprite che servi tu
  • Non serve; il browser carica un solo file
  • Molte icone ripetute in una pagina, o pagine non React

Come usare ciascuno

Ogni icona è un export con nome. size, color e strokeWidth sono props, e ogni altra prop viene passata all'svg.

Importa dal percorso della famiglia (fa, md, lu, fi e così via). IconContext.Provider imposta i valori predefiniti per ogni icona al suo interno.

Il tuo componente SVG

Incolla i dati del path una volta e riusalo come qualsiasi componente. width e height a 1em lo fanno seguire la dimensione del testo.

Tree-shaking e dimensioni del bundle

Abbiamo creato il bundle di import da una sola icona con esbuild in modalità produzione e compresso il risultato con gzip. Gli import con nome da entrambi i pacchetti restano piccoli; un import namespace porta dentro l'intero set. React stesso non è conteggiato.

Dimensioni misurate aggiunte dagli import di icone (minificato, poi gzip -9; React non conteggiato)

  • Import
  • Minificato
  • Gzip
  • Componente SVG inline (un'icona fotocamera)
  • lucide-react 0.462: 1 icona (Camera)
  • lucide-react 0.462: 5 icone
  • react-icons 5.7: 1 icona da react-icons/fa
  • react-icons 5.7: 1 icona da react-icons/lu
  • lucide-react 0.462: import * (tutte le icone)

Sprite SVG

Uno sprite SVG con <use href>

Definisci ogni icona una volta come <symbol>, poi disegnala ovunque con <use>. Modifica il colore sul contenitore ed entrambe le icone lo seguono, perché i path usano currentColor.

Usare un file sprite da React

Servi i simboli come /icons.svg e punta ogni icona a un id al suo interno. Il browser scarica e mette in cache il file una sola volta. Uno sprite esterno deve trovarsi sulla stessa origine.

Dimensioni, colore e accessibilità

Dimensioni e colore con currentColor

Le icone che usano currentColor prendono il colore del testo del genitore, quindi gli stili di hover e dark mode non richiedono CSS specifico per le icone. Cambia il valore di color e guarda entrambe le icone seguirlo.

Icone decorative e icone con significato

Un'icona accanto a testo visibile è decorazione: nascondila. Un'icona che è l'unico contenuto di un pulsante richiede un nome sul pulsante.

Note su Next.js

App Router di Next.js

I componenti di lucide-react e react-icons fanno il render senza problemi nei Server Components perché sono semplici SVG senza stato. Solo il componente che gestisce un clic ha bisogno di "use client".

Next.js: optimizePackageImports

Next.js ottimizza già gli import per una lista di pacchetti di icone comuni, tra cui lucide-react e react-icons. Aggiungi qui qualsiasi altro pacchetto di icone che usi così le build di sviluppo restano veloci.

Devi prima scegliere un set? Vedi

le migliori librerie di icone gratuite

Inizia gratis · Nessuna carta di credito richiesta

Correlati: Guide

Prodotto

Per chi è

Funzionalità

Risorse

Azienda

Mappa del sito