Saltar al contenido

Nombres de clases

Cómo se llama cada clase de TaishoDS Core y por qué se llama así: la gramática, los modificadores y la llave ts.

La gramática

Un nombre de clase se puede predecir. Tiene una de dos formas:

  • ts-propiedad-valor (a veces con un eje en el medio: ts-propiedad-eje-valor). La propiedad sale de una lista cerrada y corresponde a una sola propiedad CSS, o a un shorthand con sus longhands.
  • ts-palabra: una palabra sola, sólo si es un valor de display, position, visibility o decoración de texto (flex, absolute, underline), más unos pocos casos de un solo uso.

Para leer una clase se busca el prefijo más largo de la lista, nunca se corta por guiones: select, gap-x y ring-shadow son prefijos enteros. Los componentes siguen ts-raíz o ts-raíz-parte. La lista completa de utilidades, con su CSS, está en Utilidades.

Clase Qué hace
ms-halfmargin-inline-start con el ritmo half
p-24padding de 24px (un entero es siempre px)
mb-neg-1margin-bottom negativo (neg- va delante del valor)
border-b-2-gray-1000borde inferior de 2px, en gray-1000 (valor compuesto ancho-color)
grid-cols-3tres columnas
radius-lgborder-radius del talle lg
flexdisplay: flex (palabra sola)
hiddendisplay: none (palabra sola)
buttonun componente

Las medidas: los enteros son píxeles (p-24 es 24px) y las palabras del ritmo (none, quarter, half, base, section, double) cambian con la densidad. Son dos intenciones distintas y conviven.

Las variantes van antes de los dos puntos y no cambian el nombre: md:hidden para una pantalla, @md:gap-base para el ancho del contenedor, hover:bg-gray-200 para un estado. Se pueden encadenar (md:hover:bg-gray-200), en un orden fijo. La lista cerrada está en Variantes, y la de pantallas en Responsive.


Márgenes negativos

Un margen negativo lleva neg- delante del valor: mt-neg-16 es margin-top: -16px. No hay un signo menos ni un sufijo: el nombre sigue la misma gramática que el margen positivo. Existen en los siete lados (m, mx, my, mt, mb, ms y me) y con los mismos valores que el margen común: los enteros de la escala en píxeles (mx-neg-8) y las palabras del ritmo, de quarter a double (mx-neg-base). none y 0 no llevan neg-, porque un margen negativo de cero es cero.

Clase Qué hace
m-neg-8margin de -8px en los cuatro lados
mx-neg-basemargin horizontal negativo con el ritmo base: baja con la densidad compact
my-neg-8margin vertical (arriba y abajo) de -8px
mt-neg-16margin-top de -16px
mb-neg-16margin-bottom de -16px
ms-neg-16margin-inline-start de -16px: sigue el sentido de lectura (RTL)
me-neg-16margin-inline-end de -16px: sigue el sentido de lectura (RTL)

Sirven para que un bloque salga del relleno de su contenedor: una banda o una imagen que ocupa todo el ancho de una tarjeta que tiene p-base. Se compensa con el mismo valor del lado negativo (mx-neg-base deshace p-base).

html

No confundir

Hay pares que se leen parecido y hacen cosas distintas. En cada uno, la diferencia está en la propiedad, no en el número.

Clase Qué hace
text-14sólo el tamaño de letra (font-size)
type-heading-14compuesto: fuente, interlineado y espaciado de un título de 14
Clase Qué hace
p-baseritmo: una palabra de la escala, que cambia con la densidad
p-16medida fija: 16px, en cualquier densidad
Clase Qué hace
align-centercentra el texto (text-align)
items-centercentra los hijos de un flex o grid (align-items)

Modificadores

Las clases como variant-primary, size-sm, is-active, has-icon (familias variant-*, size-*, is-*, has-*, entre otras) son cortas y no llevan ts-. Tienen una condición: sólo valen compuestas con la clase base del componente, en el mismo elemento.

html
<button class="ts button variant-primary size-sm">Guardar</button>

Un variant-primary o un is-active de tu app, sin la base, no toma estilos del sistema: por eso se pueden tener clases propias con esos nombres sin que choquen.


La llave ts

Las clases se escriben flex, button, p-base, y el elemento lleva además la clase ts como llave. Cada regla del CSS sale detrás de :where(.ts), así que nada del sistema toca elementos que no la tengan. Funciona igual desde el CDN, con taisho generate y con el paquete de componentes de Svelte.

html

Utilidades propias

Las que se declaran en taisho.config.ts se componen con esos mismos nombres cortos.

ts

Qué hay que saber

  • La llave va en el mismo elemento. Un elemento con una clase del sistema pero sin ts no toma estilos, y no da error. La llave de un contenedor no alcanza a los hijos. En una etiqueta de componente de Svelte (<Button>) la pone el componente.
  • El ts es del sistema. Si tu app ya usa una clase llamada así, choca. Tus utilidades propias no pueden llamarse ts ni igual a un nombre corto del sistema.
  • La especificidad es la de una clase. :where() no suma, así que una regla tuya de una clase le gana al sistema si va después en la misma capa, y una sin capa le gana siempre al CSS del sistema, que vive en capas.
  • El reset es global. Lo que va en @layer base (*, html, body, button…) no está detrás de la llave y aplica a toda la página.
  • El JS del Core crea sus clases con la llave. La clase que compacta un subárbol se llama compact y también lleva la llave.