Skip to content

CSS: hero

div[class~="instui-hero"] — Sección de encabezado de ancho completo con título, subtítulo y imagen de fondo opcional.

✅ Usar Hero cuando:

  • Necesites un encabezado de página prominente con jerarquía visual

  • La página se beneficie de una sección de apertura grande y llamativa

  • Quieras incluir imágenes de fondo o acentos de degradado 🚫 No usar Hero cuando:

  • Estés construyendo un encabezado de página simple — usa Page-Layout en su lugar

  • El hero compita con contenido crítico — prioriza la legibilidad

Accesibilidad

  • Asegúrate de que el título esté en una etiqueta <h1> para la estructura semántica
  • Si usas imágenes de fondo, proporciona suficiente contraste de color para el texto
  • Evita la reproducción automática de video o animaciones que puedan distraer del contenido

Uso

css
@import "@pantoken/plugin-layouts/layouts.css";

Ranuras

RanuraDescripción
subtitleContenido del subtítulo del Hero
titleContenido del título del Hero

Partes

ParteDescripción
.instui-actionsBotones de acción o enlaces opcionales.
.instui-backgroundCapa de fondo opcional (imagen o degradado).
.instui-contentContenedor para el texto y las acciones del hero.
.instui-overlaySuperposición semi-transparente opcional para el contraste del texto.
.instui-subtitleTexto de apoyo u descripción opcional.
.instui-titleTítulo principal del hero (típicamente <h1>).

Pseudoelementos

PseudoelementoDescripción
::before

Estados

EstadoDescripción
:optional

Tokens consumidos

TokenTipoValor
--instui-color-primary-background
--instui-font-size-hero<length>
--instui-font-size-large<length>
--instui-font-weight-bold
--instui-space-large
--instui-space-medium

Relacionado