Icons
Icons reúne en un solo lugar todos los íconos disponibles para los componentes de Monkey. Al estar centralizados en una instancia única, se reutilizan en cualquier parte del diseño y garantizan una interfaz coherente y uniforme.
Previsualización rápida
Section titled “Previsualización rápida”Propósito
Section titled “Propósito”Los íconos refuerzan el significado de acciones, estados y secciones, y ayudan a escanear la interfaz más rápido. Icons asegura que todos compartan el mismo lienzo, el mismo peso de trazo y el mismo comportamiento de color, sin importar en qué componente aparezcan.
El diseñador debe llamar siempre al componente Icons y elegir el ícono por su nombre. No se insertan íconos sueltos ni se dibujan versiones propias dentro de un componente.
Anatomía del componente
Section titled “Anatomía del componente”- Lienzo: 24 × 24 px
- Trazo: 1.75 px, convertido a forma
- Color: uno solo, heredado del contexto
- Lienzo base: cuadrado de 24 × 24 px. Todos los íconos se diseñan y se exportan sobre este lienzo.
- Trazo: el trazo inicial es de 1.75 px. En los íconos curados ese trazo ya está convertido a forma, así que al escalar el ícono el grosor crece en proporción y mantiene una apariencia coherente en todos los tamaños.
- Forma: terminaciones y uniones redondeadas, heredadas del estilo de Lucide.
- Color: un único color que el ícono toma de su contexto (el texto o el componente que lo contiene). Solo los íconos de marca conservan sus colores originales.
Cómo usar
Section titled “Cómo usar”- Llamá al componente Icons y elegí el ícono por su nombre, tal como figura en el catálogo de esta página.
- Elegí un tamaño de la escala de íconos. Si ninguno encaja, podés usar un tamaño custom, siempre múltiplo de 4 px.
- El color lo define el componente que contiene al ícono. En un botón, por ejemplo, el ícono toma el color del texto del botón.
- Si necesitás un ícono que no está en el catálogo, pedilo al equipo de Design System para que se cure y se sume a la librería. Mientras tanto, el sistema lo toma directamente de Lucide.
Librería
Section titled “Librería”Monkey usa la librería Lucide como base y suma íconos propios para conceptos del negocio que Lucide no cubre, como eCheq, CiDi o MODO.
- Librería de íconos Lucide: catálogo completo de Lucide, exportable en SVG.
- Librería de íconos curados en SVG: carpeta de Drive con los íconos ya curados y listos para usar.
Un ícono curado es un ícono de Lucide o propio que ya pasó por la revisión del sistema: lienzo de 24 × 24 px, trazo de 1.75 px convertido a forma y un único color. Los íconos del catálogo de esta página son los curados.
Escala de tamaños
Section titled “Escala de tamaños”Base: 16 px (1 rem).
| Nombre | Valor | Uso sugerido |
|---|---|---|
| 2xs | 10 px | Indicadores mínimos junto a texto legal o captions. |
| xs | 12 px | Acompañar texto pequeño, badges y chips. |
| sm | 16 px | Íconos dentro de botones e inputs de tamaño estándar. |
| md | 20 px | Botones grandes, ítems de menú y listas. |
| lg | 24 px | Tamaño base. Navegación, headers y acciones independientes. |
| xl | 32 px | Destacados dentro de tarjetas y accesos rápidos. |
| 2xl | 36 px | Accesos principales de un dashboard. |
| 3xl | 48 px | Estados vacíos compactos y mensajes de confirmación. |
| 4xl | 64 px | Estados vacíos, pantallas de éxito o error. |
| Custom | Múltiplo de 4 px | Lo elige el diseñador cuando ningún valor de la escala encaja. |
Estados de interacción
Section titled “Estados de interacción”El ícono no tiene estados propios. Hereda el estado del componente que lo contiene: cuando un botón pasa a Hover, Focus, Active o Disabled, el ícono cambia de color junto con el texto del botón.
- Default: toma el color de texto del contenedor.
- Hover / Active: cambia junto al texto o al fondo del componente; nunca por separado.
- Focus: el indicador de foco lo dibuja el componente interactivo, no el ícono.
- Disabled: baja su contraste junto al resto del componente.
Usos recomendados y guía de UX
Section titled “Usos recomendados y guía de UX”Cuándo usar
Section titled “Cuándo usar”- Para reforzar el significado de una acción o de una etiqueta de texto.
- En acciones universales que el usuario reconoce sin texto: buscar, cerrar, editar, eliminar, descargar.
- Para diferenciar secciones de navegación, categorías o tipos de operación.
- Para comunicar estados (éxito, advertencia, error, información) junto con color y texto.
Cuándo NO usar
Section titled “Cuándo NO usar”- Como único medio de comunicar algo importante: acompañalo de texto o de un nombre accesible.
- Con significados ambiguos: si el ícono admite varias lecturas, usá un botón con texto.
- Como decoración que compite con el contenido: menos íconos, mejor jerarquía.
- Mezclando estilos: no combines íconos de otras librerías, rellenos distintos o trazos de otro grosor.
- Recoloreando íconos de marca: los íconos de marca (etiqueta Marca en el catálogo) se usan siempre con sus colores originales.
Variantes / Opciones
Section titled “Variantes / Opciones”- Tamaño: cualquier valor de la escala o un tamaño custom múltiplo de 4 px.
- Color: por defecto hereda el color del contexto. Se puede fijar con un token de color del sistema, por ejemplo el primario o los de estado (info, éxito, advertencia, error).
- Ícono de marca: íconos con más de un color, como CiDi. Mantienen sus colores y no se adaptan al contexto.
- Decorativo o con significado: si el ícono acompaña a un texto que ya dice lo mismo, es decorativo y se oculta al lector de pantalla. Si el ícono está solo y transmite información, necesita un nombre accesible.
Accesibilidad
Section titled “Accesibilidad”Siempre debemos tener un contraste mínimo de 3:1 entre el ícono y su fondo.
| Principio | Pauta | Criterio | Comentario |
|---|---|---|---|
| Distinguible | 1.4.11 Non-text Contrast (Level AA) | 3:1 | Un buen contraste entre el ícono y el fondo es esencial para que se reconozca. |
| Operable | 2.5.8 Target Size (Minimum) (Level AA) | 24 × 24 px | Si el ícono es accionable, su área interactiva debe medir al menos 24 × 24 px, aunque el ícono sea más chico. |
- Íconos decorativos: se ocultan al lector de pantalla para no repetir información.
- Íconos con significado: anuncian un nombre claro de la acción, por ejemplo “Descargar comprobante” y no “flecha abajo”.
- Íconos accionables: usá ActionIcon o Button, que ya resuelven el área mínima, el foco visible y el nombre accesible.
Catálogo
Section titled “Catálogo”Buscá un ícono por su nombre y hacé click para copiarlo.
ChangeLog
Section titled “ChangeLog”El historial de cambios de todos los componentes de Monkey se registra en la Sheet de ChangeLog.