Sistema de diseño
Una sola fuente de tokens (assets/css/tokens.css) para la portada y la aplicación. Esta página carga las mismas hojas y los mismos scripts de la app: cada ejemplo usa sus clases, sin estilos copiados. Lo que se ve aquí es lo que se ve en consulta.
VALAD es una herramienta de referencia y cálculo para profesionales de la salud. Con los datos que escribes, aplica escalas y fórmulas publicadas y muestra lo que dicen las guías y las fichas técnicas, con la fuente a la vista. No está dirigida a pacientes ni al público general.
Color
Neutros fríos con leve matiz verde y un solo acento: petróleo. El acento va en el logo, el botón primario (uno por vista), los enlaces, el foco, lo activo o seleccionado y las fichas V-A-L-A-D; nunca como adorno. Los bordes de los controles usan --control, con 3:1 o más sobre toda superficie. Cada valor se lee del tema actual.
Riesgo clínico
Seis rellenos, cada uno con su tinta legible (--risk-* y --risk-*-ink). Solo dicen riesgo clínico o seguridad de un fármaco; nunca decoran. La cifra de cada muestra es el contraste de la tinta sobre el relleno en el tema actual.
Se usa en
- La píldora del resultado de cada escala (riesgo cardiovascular, riesgo renal combinado, FINDRISC…).
- La píldora de riesgo renal combinado (
.h-va.h-rr) y el ajuste de dosis por función renal (.dz-*). - El estado del fármaco «Preferido» y «Evitar» (
.st-pref,.st-no) y la gravedad de las interacciones.
Nunca en
- Íconos de módulo, el riel V-A-L-A-D, botones ni enlaces.
- Recuadros de alerta: usan
--danger-*y--warn-*. - Fondos, bordes o adornos. En una pantalla de conducta, un color que no dice riesgo sobra.
Tipografía
Geist para interfaz y titulares; Geist Mono para cifras de referencia, unidades, letras del riel y metadatos. Ambas autoalojadas en assets/fonts (licencia SIL OFL). Solo pesos 400, 500 y 600; cifras tabulares en todo resultado. El tamaño junto a cada muestra se mide en este ancho de pantalla.
42 mL/min/1,73 m²Enfermedad renal crónicaModo consultaTratamiento según comorbilidadesControlar TFGe y ACR 3 veces al año. Con albuminuria, la guía sugiere IECA o ARA II a la dosis máxima tolerada.Creatinina (mg/dL)KDIGO 2024 · doi:10.1016/j.kint.2023.10.018Forma y espacio
Etiquetas de evidencia y teclas con --r-xs; controles, filas y chips con --r-sm; tarjetas, paleta, diálogos y vista previa con --r-md. Las fichas V-A-L-A-D usan --r-token (×4/3 en el riel). La píldora queda para estados clínicos y contadores. Espaciado en base 4.
Íconos de módulo
Un sprite (assets/img/modulos.svg) con un símbolo por módulo, en el estilo de las infografías: lienzo de 100 × 100, trazo grueso redondeado y rellenos planos. Dos tonos de la marca que cambian con el tema: --ico-1 (trazo y rellenos plenos) e --ico-2 (relleno suave). Nunca rojo, ámbar ni piel. assets/js/iconos.js los pone solos junto al nombre de cada fila.
Los 21 símbolos
En contexto
.home-row con su ícono de 22 px, como en Recientes. Abren su módulo en la app.- Tamaños: 20 px en el menú lateral; 22 px en el índice de módulos, Favoritas, Recientes y la portada. No agrandan la fila: se centran en la línea del nombre.
- Son decorativos: el nombre ya dice qué es (
aria-hidden="true", fuera del orden de foco). - Sin animación ni transición. En alto contraste de Windows toman los colores del sistema.
- Un módulo nuevo necesita su símbolo en el sprite y en el mapa de
iconos.js(lo compruebatests/iconos.test.js).
<svg class="mod-ico" aria-hidden="true" focusable="false">
<use href="assets/img/modulos.svg#ico-rinon"></use>
</svg>
Componentes
Botones, campos, etiquetas de estado y de evidencia, recuadros y el panel de resultado, tal como los pinta la aplicación.
CalculadoraPatrón de herramienta: datos, resultado e interpretación
Datos básicos
Factores
Conducta
- La guía sugiere IECA o ARA II a la dosis máxima tolerada [Evidencia]
- Remisión a Nefrología
Riel V-A-L-A-D
El mapa de Modo consulta: Variables, Análisis, Lógica, Acción y Decisión, siempre en ese orden, en mayúscula y con tilde. Es una navegación, no pestañas ni un asistente: todo está en la página y tocar una letra solo desplaza. Cada letra se enciende según lo resuelto, sin chulos ni «completo». Toca una letra: la pastilla de la parte visible salta, no se desliza.
Mismo marcado que #wsRail de app.html: nav.valad-rail con botones .vr-step (.vr-tile, .vr-name, .vr-n). El número no se muestra cuando vale 0. Cambia el ancho de la ventana para ver sus tres formas.
Estados de la ficha
El contorno de «en curso» la distingue de «vacío» por la forma, no solo por el color. La cifra es el contraste de la letra en el tema actual.
Análisis
5.ws-ph): la misma ficha y el mismo estado que en el riel, a la izquierda del título, y el número a la derecha.Medidas
--rail-h es el alto visible del riel pegado bajo la barra superior; por debajo de 1100 px va encima la leyenda (--rail-cap, 20 px). Para videos e infografías la especificación completa está en docs/riel-valad.md.
| Ancho | Riel visible | Leyenda | Ficha | Paso |
|---|---|---|---|---|
| ≥1100 px | 64 px | Oculta | 36 px, letra 17 | 52 px de alto, en fila con conectores de 2 px |
| 768 a 1099 px | 64 px | 20 px | 36 px, letra 17 | 56 px; ficha a la izquierda, nombre y número a la derecha |
| 376 a 767 px | 68 px | 20 px | 36 px, letra 17 | 64 px; ficha arriba y nombre debajo |
| 341 a 375 px | 64 px | 20 px | 32 px, letra 15 | 60 px |
| ≤340 px | 64 px | 20 px | 32 px, letra 15 | 60 px; nombre de 11,5 px y sin número |
- Letra: Geist Mono 600. Nombre: Geist 500 (15 px en escritorio, 14 en tableta, 13 en el celular), 600 en la parte visible. Número: Geist Mono 500,
--muted. - Parte visible (
aria-current="true"): pastilla fija en su paso, fondo--accent-soft, contorno interior de 1,5 px--accenty radio de 12 px. - Ficha de la cabecera de cada parte: 28 px (letra 13) desde 768 px; 24 px (letra 12) en el celular.
- Captura a 390 px: riel de 68 px más 20 px de leyenda. Para una imagen de 1170 px, todo ×3. El riel nunca usa rojo.
Decisión: la frase fija y el lenguaje
VALAD muestra lo que dice la evidencia; la decisión es del médico. Todo panel de decisión lleva esta frase en negrilla, con el texto exacto y a la vista sin desplegar nada.
Única fuente del texto: assets/js/frase-decision.js (VALAD.fraseDecision), que pinta esta muestra. Estilo .frase-decision de app.css: 14 px, peso 600, --ink.
Dónde va
- Modo consulta: panel Decisión, bajo el título y antes de la nota.
- Apnea obstructiva del sueño: «Qué hago ya», bajo su título.
- Nunca dentro de un desplegable, oculta, atenuada ni con otras palabras: una prueba compara cada panel con la constante.
Cómo habla VALAD
| Así | No así |
|---|---|
| «Disposición que sugiere la guía: Observación» | «Observación» o «Dejar en observación» |
| «La guía sugiere…», con la guía y la recomendación que lo dicen | «Haga…», «Debe…», «Inicie…» |
| Al pie de la nota: «[Inferencia]… No es una orden médica» | Una nota sin esa etiqueta ni ese aviso |
| «Persona con hipertensión», «fuma actualmente» | Nombrar a la persona por su condición |
Movimiento
El movimiento orienta y confirma, nunca decora. Solo se animan transform, opacity y colores. Con movimiento reducido todo pasa al estado final de inmediato.
420 ms · ease-out420 ms · ease-out90 ms150 msease-out600 ms · ease-out--accent-soft 1 s y se desvanece. 600 ms420 ms · ease-out