2.1 · General

Botón

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.

Fase · F1 Estado · Revisado en General Variantes · 69 Jerarquías · 3 Tamaños · L · M · S
01

La familia

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.

Combinación típica Orden: principal primero (izq. Desktop · arriba Mobile).
02

Iconografía

El ícono refuerza la etiqueta; no la reemplaza. Izquierdo = tipo de acción; derecho = dirección o despliegue. Nunca los dos a la vez.

Solo texto · por defecto
Ícono izquierdo · tipo de acción
Ícono derecho · avanzar / desplegar
Botón de ícono · otro componente, nombre accesible obligatorio
03

Estados

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.

Default Hover Pressed Foco Disabled Loading
Primario
Secundario
Terciario — no aplica
Foco +

Hover #0376BB y Pressed #024D7A (más claros que el base institucional). Secundario: Hover sin relleno + borde #0376BB; Pressed #F5F7F8 + borde #024D7A.

04

Tamaños y espaciado

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)

05

Propiedades

PropiedadValoresUso
JerarquíaPrimario · Secundario · TerciarioVer 01.
TamañoL · M · SVer 04.
EstadoDefault · Hover · Pressed · Disabled · Loading + FocoLoading solo en Primario y Secundario.
EtiquetaTextoVerbo + objeto: «Agendar cita».
Ícono izq./der.Booleanas + glifoEl glifo toma el color de la etiqueta.
Servicio · SuperficieModos de variableNo son props: se heredan del contenedor.
FocoBooleanaAnillo doble; se suma a Default/Hover/Pressed (ARQ-027).
06

Servicio y superficie

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

07

Responsive y etiquetas largas

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

08

Accesibilidad

CriterioRegla
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).
Disabledaria-disabled, sin interacción, con explicación cercana.
Loadingaria-busy="true", ancho estable, texto conservado para lectores.
Semántica<button> para acciones; <a> (Enlace) para navegar.
09

Correcto e incorrecto

✓ Un primario por sección

× Dos primarios compitiendo

✓ Loading conserva color y ancho

× Deshabilitar el botón mientras carga

Uso

<!-- 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>