Sprite SVG de symboles

Les listes vides échouent avec invalid_input afin que les pipelines ne publient jamais un sprite creux.

Qu’est-ce qu’un sprite SVG de symboles et pourquoi les listes d’ids comptent

Quand la liste est vide il n’y a rien à publier : cet endpoint rejette les tableaux d’ids vides au lieu de renvoyer un sprite à zéro symboles, ce qui passerait un build négligent et livrerait une UI cassée. L’id_prefix optionnel (par exemple icon-) permet aux monorepos d’espacer les symboles pour que des widgets tiers n’entrent pas en collision avec votre propre id home. Le view_box optionnel vaut par défaut le canevas courant 0 0 24 24 des jeux style Material, mais vous pouvez passer tout viewBox à quatre nombres pour que des artboards 16 pixels ou personnalisés restent cohérents sur tout le sprite.

Contrat d’entrée, forme de la réponse et règles de validation

Envoyez en POST un corps JSON avec ids, un tableau non vide obligatoire de chaînes (les alias icon_ids et icons sont acceptés). Les ids de symbole finaux en double—après application de l’id_prefix optionnel—échouent avec un message invalid_input clair pour que vous corrigiez le catalogue au lieu d’écraser des symboles dans le navigateur. view_box est optionnel et vaut par défaut 0 0 24 24 ; s’il est fourni, il doit être quatre nombres séparés par des espaces avec largeur et hauteur positives. id_prefix est optionnel et vide par défaut ; s’il est défini, il doit être un jeton de nom valide pour que l’id de symbole concaténé reste légal. En cas de succès le corps inclut count, le view_box et l’id_prefix normalisés, symbol_ids dans l’ordre d’entrée, sprite_markup comme un svg masqué multiligne contenant un symbol vide par id, use_snippets comme objets avec champs id et snippet prêts à coller, et use_list_markup joignant ces extraits par des sauts de ligne pour des démos rapides. Les appels réussis utilisent le solde KIT prépayé au prix de base publié $0.002 car c’est un travail de parse pur, sans jetons de modèle ni réseau sortant.

Où la génération de sprite et de use apporte de la valeur

Les équipes de design system génèrent l’enveloppe du sprite dès qu’un fichier de tokens d’icônes change, puis ouvrent une PR qui n’ajoute que des enfants path dans les symboles existants. Sites marketing et thèmes CMS collent des extraits use dans le rich text ou des bibliothèques de shortcodes sans enseigner aux auteurs la syntaxe SVG complète. Gardez les listes d’ids en contrôle de version, refusez les publications vides, et vous obtenez une source unique de vérité pour les sprites SVG de symboles sans déployer un CDN d’icônes pour le seul balisage d’enveloppe. Les bibliothèques de composants livrent des contrôles Storybook qui listent les ids de symbole de la même réponse API pour que la documentation n’invente jamais un id que le sprite ne définit pas. Les revues d’accessibilité vérifient que le bloc de définitions est aria-hidden et que les uses décoratifs portent aria-hidden et focusable false comme cet endpoint émet par défaut—les auteurs ajoutent encore aria-label ou title lorsqu’une icône est le seul nom visible d’un contrôle. Les produits multi-marques mappent les préfixes de marque via id_prefix pour qu’un seul pipeline émette brand-a-home et brand-b-home sans bifurquer les handlers. Workers de bord et générateurs statiques peuvent appeler la même forme de module sur le chemin gratuit du navigateur pour les aperçus et sur le chemin API pour des reconstructions en masse après un dump de design.