Saltar al contenido

Íconos

El set completo de Lucide más tus SVGs custom, con validación en tiempo de build: es imposible publicar un ícono que no existe.

Uso

En HTML el ícono es un <svg> con la clase ts icon y un tamaño (icon-16, icon-20…, los pasos de la escala; la utilidad general size-20 también sirve). Hereda el color del texto (currentColor). Con npx taisho generate, el <use> apunta al sprite que el comando arma con sólo los íconos que se usan, y el nombre sale del fragmento #ts-<nombre>.

html
<svg class="ts icon icon-20" aria-hidden="true"><use href="taisho/taisho.icons.svg#ts-search"></use></svg>

Los íconos de Lucide salen del paquete lucide-static, que no viene con el Core. npx taisho init ofrece instalarlo (y --install-icons lo instala sin preguntar); también se instala a mano con npm i -D lucide-static. Sin él, un proyecto que no usa íconos compila igual; si el código usa alguno, taisho generate avisa con ese comando y termina con error.

Sin build, con el CDN, no hay sprite: se copia el SVG del ícono desde lucide.dev, se pega en el HTML y se le pone class="ts icon icon-20". Es lo que traen los ejemplos de cada componente.

html

Si el ícono va solo, sin texto al lado, el botón o el enlace que lo contiene necesita un aria-label; si acompaña a un texto, queda con aria-hidden="true". La página del componente Icon tiene los tamaños y los ejemplos.


Validación en build

Si un #ts-<nombre> de tu HTML no existe (ni en Lucide ni en tus custom), taisho generate termina con error y sugiere el más parecido, por distancia de edición.


Íconos custom

Se pone un .svg en src/icons. El nombre del archivo (kebab, sin .svg) pasa a ser el nombre del ícono. El CLI del Core (taisho generate) siempre mira esa carpeta.

bash
# src/icons/taisho-mark.svg  →  #ts-taisho-mark

Resolución: primero Lucide, si no existe la carpeta custom, si tampoco, error de build. Auto-detecta el estilo: stroke (tipo Lucide, hereda currentColor) vs. raw (con sus propios fills).

Pauta para SVGs estilo Lucide

viewBox="0 0 24 24", fill="none", trazos con stroke — así heredan color y grosor como los de Lucide.

Íconos armados en runtime

El escáner lee el texto de tus archivos: si el nombre del ícono sólo existe en tiempo de ejecución (se arma con una variable, o viene de una API), no lo ve y el ícono queda fuera del sprite. Para esos casos, se listan en la opción icons de taisho.config.ts:

taisho.config.ts
// taisho.config.ts
export default {
  // ...
  icons: ['check', 'x', 'triangle-alert'],
};

Es la excepción, no el camino normal: un nombre escrito completo en el href no hace falta declararlo. Un nombre que no existe en Lucide ni en tus íconos custom corta el taisho generate.


El sprite desde JS, con Vite

Con el plugin taisho() de Vite, el sprite queda en taisho/taisho.icons.svg, fuera de public/. Las referencias que se escriben en un HTML las reescribe vite build con el nombre final del archivo (con hash). Las que se arman en JS con un texto, como '/taisho/taisho.icons.svg#ts-moon', Vite no las ve: en producción apuntan a un archivo que no existe. Se importa el sprite y se usa la ruta que devuelve:

js
import sprite from '../taisho/taisho.icons.svg?no-inline';

boton.innerHTML = `<svg class="ts icon icon-20" aria-hidden="true"><use href="${sprite}#ts-moon"></use></svg>`;

?no-inline pide el archivo: sin él, Vite incrusta los archivos chicos en el JS como data: y no queda un archivo que referenciar. El ícono entra al sprite porque el escáner lee el href="…#ts-moon" de ese archivo, siempre que esté cubierto por content.