Union di stringhe e completamento automatico
Ottenga il completamento automatico nell’editor per i valori stringa noti.
Union di stringhe e completamento automatico è una lezione TypeScript Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento TypeScript Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso TypeScript Academy include 4 lezioni in totale.
Le unioni alimentano il completamento automatico
Un'unione di stringhe letterali svolge una doppia funzione: limita i valori consentiti e alimenta il completamento automatico dell'editor. A volte, però, si desiderano sia i suggerimenti sia la libertà di passare qualsiasi stringa: un trucco ingegnoso consente di ottenere entrambi.
Unione di base di stringhe letterali
Dichiari un'unione delle stringhe consentite. L'editor propone esattamente queste opzioni e i valori non validi generano errori di compilazione.
type Variant = "primary" | "secondary" | "danger"
const v: Variant = "primary"
console.log(v)
// const bad: Variant = "warning" // ErrorCompletamento automatico nell'editor
Quando un parametro è un'unione di stringhe letterali, durante la digitazione nella chiamata vengono visualizzati esattamente i suoi membri. È una delle caratteristiche ergonomiche di TypeScript più apprezzate.
type Color = "red" | "green" | "blue"
function paint(c: Color) { return c }
console.log(paint("green")) // editor suggests red/green/blueIl limite
Un'unione rigida vieta qualsiasi valore al di fuori dell'elenco. A volte si desidera suggerire i valori comuni consentendo comunque stringhe personalizzate arbitrarie: una semplice unione non può fare entrambe le cose.
type Color = "red" | "green"
// You cannot pass "#ff8800" — it is not in the union
function paint(c: Color) { return c }
console.log(paint("red"))L'ampliamento fa perdere i suggerimenti
Se usa semplicemente string, qualsiasi valore è valido, ma il completamento automatico scompare del tutto. Ha scambiato tutti i suggerimenti con una flessibilità totale, una soluzione non ideale.
function paint(c: string) { return c }
console.log(paint("#ff8800")) // works, but no suggestionsIl trucco di string e delle unioni letterali
Il trucco consiste nell'unire i letterali con string & {}. I letterali continuano a comparire nel completamento automatico, mentre string & {} consente qualsiasi altra stringa senza ridurre l'unione.
type Color = "red" | "green" | (string & {})
const a: Color = "red" // suggested
const b: Color = "#ff8800" // also allowed
console.log(a, b)Perché string e l'oggetto vuoto funzionano
Normalmente 'red' | string si semplifica nella sola string, eliminando i letterali. L'intersezione con {} crea un tipo leggermente diverso che TypeScript mantiene separato, così i letterali restano disponibili per il completamento, mentre qualsiasi stringa continua a essere valida.
type A = "red" | string // collapses to string — no hints
type B = "red" | (string & {}) // keeps "red" as a suggestion
const x: B = "red"
console.log(x)Un helper riutilizzabile
Racchiuda il trucco in un alias generico, così l'intento risulta chiaro e riutilizzabile in tutta la codebase.
type LiteralUnion<T extends string> = T | (string & {})
type Size = LiteralUnion<"sm" | "md" | "lg">
const s: Size = "custom-size"
console.log(s)Applicarlo a una funzione
Usi l'helper in un'API per offrire ai chiamanti suggerimenti per gli input comuni, accettando comunque valori personalizzati.
type LiteralUnion<T extends string> = T | (string & {})
function setIcon(name: LiteralUnion<"home" | "search">) { return name }
console.log(setIcon("home")) // suggested
console.log(setIcon("my-icon")) // allowedQuando utilizzare il trucco
Vi ricorra quando un'API presenta valori noti ma deve rimanere aperta: nomi di icone, unità CSS, token del tema e preset del framework. Per gli insiemi chiusi, preferisca un'unione rigida per ottenere la massima sicurezza.
type LiteralUnion<T extends string> = T | (string & {})
type Unit = LiteralUnion<"px" | "rem" | "%">
const u: Unit = "vh"
console.log(u)Compromessi
Il trucco mantiene i suggerimenti ma riduce la sicurezza: gli errori di battitura nelle stringhe personalizzate non vengono più rilevati. Lo utilizzi consapevolmente quando l'apertura è una caratteristica desiderata, non come impostazione predefinita.
type LiteralUnion<T extends string> = T | (string & {})
type Status = LiteralUnion<"active" | "inactive">
const s: Status = "actvie" // typo NOT caught — the cost of openness
console.log(s)Verifica rapida
Verifichi la sua comprensione del trucco per il completamento automatico.
Riepilogo
Le unioni di stringhe letterali alimentano il completamento automatico dell'editor e limitano i valori, ma un'unione rigida vieta le stringhe personalizzate, mentre la semplice string elimina tutti i suggerimenti. Il trucco T | (string & {}) mantiene i letterali come suggerimenti accettando qualsiasi stringa. Lo racchiuda in un helper LiteralUnion<T> e lo utilizzi soltanto quando l'apertura è intenzionale: sacrifica la sicurezza che consente di rilevare gli errori di battitura.
Domande Frequenti
La lezione «Union di stringhe e completamento automatico» è gratuita?
Sì — il testo completo di «Union di stringhe e completamento automatico» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso TypeScript Academy, passa a CoddyKit PRO. Il corso TypeScript Academy include 4 lezioni in totale.
Cosa imparerò in «Union di stringhe e completamento automatico»?
Ottenga il completamento automatico nell’editor per i valori stringa noti. Eserciti TypeScript Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare TypeScript Academy?
Non è richiesta alcuna esperienza precedente. TypeScript Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.
Quanto tempo richiede la lezione «Union di stringhe e completamento automatico»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione TypeScript Academy?
Sì. Ogni lezione TypeScript Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Basi dei tipi literal template
- Modellare stringhe strutturate
- Union di stringhe e completamento automatico
- Tipi intrinseci di manipolazione delle stringhe