Primario
La acción principal de la vista o de la sección. 1 por vista o sección.
2.1 · General
Familia de acciones con texto visible: ejecuta algo en la vista actual (agendar, enviar, descargar). Para navegar se usa Enlace; para una acción sin etiqueta, Botón de ícono. La jerarquía expresa importancia; el color lo pone el servicio.
Tres jerarquías. La jerarquía expresa la importancia de la acción, no su color.
Primario
La acción principal de la vista o de la sección. 1 por vista o sección.
Secundario · contorno
Alternativa a la principal, o acciones de igual peso. 2–3 junto al primario.
Terciario
Acción de menor peso con área visible al interactuar. En grupos y barras.
Solo texto + terciario
BTN-016 · texto solo cuando la acción es terciaria y el contexto ya es claro.
El ícono refuerza la etiqueta; no la reemplaza. Izquierdo = tipo de acción; derecho = dirección o despliegue. Nunca los dos a la vez.
Cinco estados + Foco (booleana ARQ-027). Hover/Pressed aclaran el color del servicio (#0376BB / #024D7A). Loading mantiene color y ancho; no se parece a Disabled.
Hover #0376BB y Pressed #024D7A (más claros que el base institucional). Secundario: Hover sin relleno + borde #0376BB; Pressed #F5F7F8 + borde #024D7A.
S se ve de 40 px pero su área táctil es de 44 px (EV-03).
Tamaño L · 56 px
padding space/32 · ícono 24 · gap 8
CTA de hero y bandas Desktop
Tamaño M · 48 px
padding space/24 · ícono 20 · gap 8
Por defecto en todos los breakpoints
Tamaño S · 40 visual · 44 área
padding space/16 · ícono 20 · gap 8
Desktop denso (tablas, filtros)
| Propiedad | Valores | Uso |
|---|---|---|
| Jerarquía | Primario · Secundario · Terciario | Ver 01. |
| Tamaño | L · M · S | Ver 04. |
| Estado | Default · Hover · Pressed · Disabled · Loading + Foco | Loading solo en Primario y Secundario. |
| Etiqueta | Texto | Verbo + objeto: «Agendar cita». |
| Ícono izq./der. | Booleanas + glifo | El glifo toma el color de la etiqueta. |
| Servicio · Superficie | Modos de variable | No son props: se heredan del contenedor. |
| Foco | Booleana | Anillo doble; se suma a Default/Hover/Pressed (ARQ-027). |
Dos tratamientos por servicio (ARQ-028). Clara = acción en color de servicio. Oscura = fondo del servicio y primario invertido (blanco). El glifo toma el color de la etiqueta.
Institucional · Clara
Institucional · Oscura
Banco de sangre · Clara
Banco de sangre · Oscura
Laboratorio clínico · Clara
Laboratorio clínico · Oscura
Unidad genómica · Clara
Unidad genómica · Oscura
Patología · Clara
Patología · Oscura
Celeste oficial Clínico · Clara
M en todos los breakpoints. En Mobile el primario ocupa el ancho completo y los grupos se apilan. Las etiquetas no se truncan: se reescriben más cortas (≤ 24 caracteres).
✓ Correcto · Etiqueta corta
× Evitar · Etiqueta larga
| Criterio | Regla |
|---|---|
| Contraste (1.4.3) | Texto ≥ 4,5:1 en todos los estados con texto (mín. 4,82:1, BTN-010). |
| Foco (2.4.7) | Doble anillo Estado/Foco; combinable con Hover y Pressed. |
| Área táctil (2.5.8) | L 56 · M 48 · S 44 (área) / 40 (visual). |
| Disabled | aria-disabled, sin interacción, con explicación cercana. |
| Loading | aria-busy="true", ancho estable, texto conservado para lectores. |
| Semántica | <button> para acciones; <a> (Enlace) para navegar. |
✓ Un primario por sección
× Dos primarios compitiendo
✓ Loading conserva color y ancho
× Deshabilitar el botón mientras carga
<!-- Color heredado del contenedor (servicio + superficie) -->
<div data-service="banco-sangre" data-surface="clara">
<button class="kds-btn" data-variant="primary" data-size="m">
<span class="kds-btn__label">Agendar cita</span>
</button>
</div>
<div data-service="unidad-genomica" data-surface="oscura">
<button class="kds-btn" data-variant="primary" data-size="m">Agendar</button>
<button class="kds-btn" data-variant="secondary" data-size="m">Descargar</button>
</div>