Sprite SVG de símbolos

Listas vazias falham com invalid_input para que os pipelines nunca publiquem um sprite oco.

O que é um sprite SVG de símbolos e por que listas de ids importam

Quando a lista está vazia não há nada a publicar: este endpoint rejeita arrays de ids vazios em vez de devolver um sprite com zero símbolos, o que passaria um build descuidado e enviaria UI quebrada. O id_prefix opcional (por exemplo icon-) permite monorepos darem namespace aos símbolos para que widgets de terceiros não colidam com o seu próprio id home. O view_box opcional usa por padrão o canvas comum 0 0 24 24 de conjuntos estilo Material, mas você pode passar qualquer viewBox de quatro números para artboards de 16 pixels ou personalizados ficarem consistentes em todo o sprite.

Contrato de entrada, formato da resposta e regras de validação

Envie por POST um corpo JSON com ids, um array não vazio obrigatório de strings (os aliases icon_ids e icons são aceitos). Ids de símbolo finais duplicados—após aplicar o id_prefix opcional—falham com uma mensagem invalid_input clara para você corrigir o catálogo em vez de sobrescrever símbolos no navegador. view_box é opcional e o padrão é 0 0 24 24; quando fornecido deve ser quatro números separados por espaço com largura e altura positivas. id_prefix é opcional e vazio por padrão; quando definido deve ser um token de nome válido para o id de símbolo concatenado permanecer legal. No sucesso o corpo inclui count, o view_box e id_prefix normalizados, symbol_ids na ordem de entrada, sprite_markup como um svg oculto multilinha com um symbol vazio por id, use_snippets como objetos com campos id e snippet prontos para colar, e use_list_markup unindo esses trechos com quebras de linha para demos rápidas. Chamadas bem-sucedidas usam saldo KIT pré-pago no preço base publicado US$ 0,002 porque é trabalho de parse puro, sem tokens de modelo e sem rede de saída.

Onde a geração de sprite e use realmente vale a pena

Equipes de design system geram a casca do sprite sempre que um arquivo de tokens de ícones muda e abrem um PR que só adiciona filhos path dentro dos símbolos existentes. Sites de marketing e temas CMS colam trechos use em rich text ou bibliotecas de shortcodes sem ensinar aos autores a sintaxe SVG completa. Mantenha listas de ids no controle de versão, rejeite publicações vazias, e você obtém uma única fonte de verdade para sprites SVG de símbolos sem levantar um CDN de ícones só pela marcação da casca. Bibliotecas de componentes enviam controles Storybook que listam ids de símbolo da mesma resposta da API para a documentação nunca inventar um id que o sprite não define. Revisões de acessibilidade verificam que o bloco de definições é aria-hidden e que uses decorativos levam aria-hidden e focusable false como este endpoint emite por padrão—os autores ainda adicionam aria-label ou title quando um ícone é o único nome visível de um controle. Produtos multi-marca mapeiam prefixos de marca via id_prefix para um único pipeline emitir brand-a-home e brand-b-home sem bifurcar handlers. Workers de borda e geradores estáticos podem chamar a mesma forma de módulo no caminho gratuito do navegador para pré-visualizações e no caminho da API para reconstruções em massa após um dump de design.