Sprite SVG di simboli

Gli elenchi vuoti falliscono con invalid_input così le pipeline non pubblicano mai uno sprite vuoto.

Cos’è uno sprite SVG di simboli e perché contano gli elenchi di id

Quando l’elenco è vuoto non c’è nulla da pubblicare: questo endpoint rifiuta array di id vuoti invece di restituire uno sprite con zero simboli, che passerebbe un build disattento e spedirebbe UI rotta. Il view_box opzionale usa di default il canvas comune 0 0 24 24 dei set stile Material, ma può passare qualsiasi viewBox a quattro numeri così artboard da 16 pixel o personalizzati restano coerenti su tutto lo sprite.

Contratto di input, forma della risposta e regole di validazione

Invii con POST un corpo JSON con ids, un array non vuoto obbligatorio di stringhe (sono accettati gli alias icon_ids e icons). Id di simbolo finali duplicati—dopo l’applicazione dell’id_prefix opzionale—falliscono con un messaggio invalid_input chiaro così Lei corregge il catalogo invece di sovrascrivere simboli nel browser. view_box è opzionale e di default è 0 0 24 24; se fornito deve essere quattro numeri separati da spazio con larghezza e altezza positive. id_prefix è opzionale e vuoto di default; se impostato deve essere un token di nome valido affinché l’id di simbolo concatenato resti legale. In caso di successo il corpo include count, view_box e id_prefix normalizzati, symbol_ids nell’ordine di input, sprite_markup come svg nascosto multilinea con un symbol vuoto per id, use_snippets come oggetti con campi id e snippet pronti da incollare, e use_list_markup che unisce quegli snippet con a capo per demo rapide. Le chiamate riuscite usano il saldo KIT prepagato al prezzo base pubblicato $0.002 perché è lavoro di parse puro, senza token di modello e senza rete in uscita.

Dove la generazione di sprite e use porta valore concreto

I team di design system generano il guscio dello sprite quando cambia un file di token icone e aprono una PR che aggiunge solo figli path dentro i simboli esistenti. Siti marketing e temi CMS incollano snippet use in rich text o librerie di shortcode senza insegnare agli autori la sintassi SVG completa. Tenga gli elenchi di id nel controllo di versione, rifiuti le pubblicazioni vuote, e otterrà un’unica fonte di verità per gli sprite SVG di simboli senza erigere un CDN di icone solo per il markup del guscio. Le librerie di componenti spediscono controlli Storybook che elencano gli id di simbolo dalla stessa risposta API così la documentazione non inventa un id che lo sprite non definisce. Le revisioni di accessibilità verificano che il blocco di definizioni sia aria-hidden e che gli use decorativi portino aria-hidden e focusable false come questo endpoint emette di default—gli autori aggiungono ancora aria-label o title quando un’icona è l’unico nome visibile di un controllo. Worker di edge e generatori statici possono chiamare la stessa forma di modulo sul percorso gratuito del browser per le anteprime e sul percorso API per ricostruzioni massive dopo un dump di design.