Zicon
@zuccadev-labs/zuix-zicon es el estándar iconográfico de la suite. Sale de Dazicon, el set de iconos de
DAZLABS.
Qué incluye
- 346 iconos en dos variantes:
outlineysolid. - Caja de 24 × 24 y color heredado (
currentColor). - 20 categorías con etiqueta en español e inglés.
- Palabras clave en ambos idiomas, por forma y por concepto de uso.
- Tabla de sustitución de 152 emojis.
Se pueden explorar en la página Iconos.
Uso con React
import { Icon } from "@zuccadev-labs/zuix-zicon";
<Icon name="magnifying-glass" /> // 16 px, decorativo
<Icon name="trash" size={20} label="Delete" /> // con nombre accesible
<Icon name="bookmark" variant="solid" />
| Prop | Valores | Por defecto |
|---|---|---|
name | Un nombre de manifest.json; uno inexistente no compila | — |
variant | outline, solid | outline |
size | Número (px) o longitud CSS | 16 |
label | Nombre accesible. Sin él, el icono es decorativo y se oculta a lectores de pantalla | — |
Un aria-label o aria-labelledby pasado directamente también vale como nombre: el icono deja de ir con
aria-hidden.
Uso sin React
<script type="module">import "@zuccadev-labs/zuix-zicon/element";</script>
<z-icon name="magnifying-glass"></z-icon>
<z-icon name="trash" size="20" label="Delete"></z-icon>
<z-icon name="bookmark" variant="solid"></z-icon>
Los atributos son los de las props. El elemento se dibuja también si se conecta antes de que su icono esté
registrado (lo hace al registrarlo), y respeta hidden.
| Forma | Uso | Cuándo |
|---|---|---|
| Elemento | <z-icon name="bell" variant="solid" size="20" label="Alerts"></z-icon> | Marcado escrito a mano o en una plantilla |
| Nodo | iconElement("bell", { size: 20 }) desde @zuccadev-labs/zuix-zicon/dom | Código que construye el DOM. No pasa por innerHTML |
| Cadena | iconSvg("bell", { size: 20 }) desde @zuccadev-labs/zuix-zicon/dom | Render en servidor o plantillas de texto |
| Sprite | <svg class="z-icon" width="16" height="16"><use href="sprite.svg#bell"/></svg> (#bell-solid para la variante sólida) | Páginas estáticas con muchos iconos repetidos |
| Archivo | @zuccadev-labs/zuix-zicon/svg/outline/bell.svg | Una imagen suelta |
- El color se hereda del texto que lo rodea.
- Tamaños recomendados: 16 en texto y botones, 20 a 22 en recuadros, 28 en estados vacíos.
<z-icon>eiconElement()funcionan con Trusted Types activos.iconSvg()devuelve una cadena con todos sus valores escapados; insertarla coninnerHTMLen una página con Trusted Types exige una política propia (CSP y Trusted Types).<use>hacia unsprite.svgexterno solo funciona si el sprite se sirve desde el mismo origen que la página: es una restricción del navegador. Desde un CDN hay que incrustar el sprite en el documento.
Incluir solo algunos iconos
@zuccadev-labs/zuix-zicon, /all y /element registran el set completo: unos 580 kB de trazados sin
comprimir. Una aplicación que necesite menos registra solo los que usa:
import { Icon, registerIcons } from "@zuccadev-labs/zuix-zicon/core";
import { trash } from "@zuccadev-labs/zuix-zicon/icons/trash";
registerIcons([trash]);
zui y zout importan desde @zuccadev-labs/zuix-zicon/core, así que no arrastran el set. La aplicación
decide: import "@zuccadev-labs/zuix-zicon/all" una vez, o un registro parcial. Con registro parcial hay que
incluir también los iconos que dibujan los propios componentes (x-mark, chevron-down, check…): un
icono sin registrar sale vacío y la consola lo avisa.
onIconsRegistered(fn) avisa cada vez que se registran iconos, por si una aplicación los carga bajo demanda.
Nombres
- En inglés, minúsculas y con guiones:
arrow-down,shopping-cart. - El nombre describe la forma. El concepto de uso está en las palabras clave:
trashresponde a "delete", "eliminar" y "borrar".
Limitaciones conocidas
- La variante
outlineestá dibujada como forma rellena. El grosor del trazo no se puede ajustar. - Hay una sola caja de 24 px; no existen versiones optimizadas para 16 o 20.
- 101 de los 346 iconos son iguales en
outliney ensolid: el dibujo de origen no distingue las dos variantes en ellos. Algunossolidno están rellenos (magnifying-glass,power). No lo corrijo en el código porque la regla del paquete es no dibujar SVG a mano: se arregla en el archivo de Figma y se vuelve a extraer. - Algunas categorías son muy cortas (Tiempo tiene un icono, Diseño dos).
- Cuatro dibujos del archivo original estaban rotos (
currency_dollarydocument_currency_dollar, en ambas variantes). Los sustituí por las versiones corregidas que el propio archivo trae al final de la categoría.
Regenerar desde Figma
No hace falta Figma: el extractor lee el archivo .fig directamente.
cd zicon
python3 -I scripts/extract.py "<ruta a Dazicon.fig>"
pnpm icons
La tabla de renombrado está en zicon/scripts/rename.json. La extracción falla si un icono queda sin
pareja outline/solid, y la generación valida cada icono: trazados dentro de la caja, identificador de módulo
único y categoría existente.
Licencia de los dibujos
Decidí publicar el set bajo MIT, igual que el código. Los trazados salen del archivo Dazicon de DAZLABS; los nombres siguen la nomenclatura de Heroicons, que también es MIT. Los dibujos que revisé al extraer son los del archivo; no he comparado los 346 uno a uno con otro set. Cómo lo extraje: Zicon: extracción de Dazicon.