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 dedisplay,position,visibilityo 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-half | margin-inline-start con el ritmo half |
| p-24 | padding de 24px (un entero es siempre px) |
| mb-neg-1 | margin-bottom negativo (neg- va delante del valor) |
| border-b-2-gray-1000 | borde inferior de 2px, en gray-1000 (valor compuesto ancho-color) |
| grid-cols-3 | tres columnas |
| radius-lg | border-radius del talle lg |
| flex | display: flex (palabra sola) |
| hidden | display: none (palabra sola) |
| button | un 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-8 | margin de -8px en los cuatro lados |
| mx-neg-base | margin horizontal negativo con el ritmo base: baja con la densidad compact |
| my-neg-8 | margin vertical (arriba y abajo) de -8px |
| mt-neg-16 | margin-top de -16px |
| mb-neg-16 | margin-bottom de -16px |
| ms-neg-16 | margin-inline-start de -16px: sigue el sentido de lectura (RTL) |
| me-neg-16 | margin-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).
<article class="ts flex flex-col gap-base p-base radius-lg bg-gray-100">
<h3 class="ts type-heading-20">Plan anual</h3>
<div class="ts mx-neg-base px-base py-half bg-gray-300 type-label-14-strong">Ahorra dos meses</div>
<p class="ts type-copy-14">La banda llega de borde a borde de la tarjeta.</p>
</article>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-14 | sólo el tamaño de letra (font-size) |
| type-heading-14 | compuesto: fuente, interlineado y espaciado de un título de 14 |
| Clase | Qué hace |
|---|---|
| p-base | ritmo: una palabra de la escala, que cambia con la densidad |
| p-16 | medida fija: 16px, en cualquier densidad |
| Clase | Qué hace |
|---|---|
| align-center | centra el texto (text-align) |
| items-center | centra 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.
<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.
<section class="ts flex gap-base p-double md:hidden">
<button class="ts button variant-primary size-sm">Guardar</button>
</section>Utilidades propias
Las que se declaran en taisho.config.ts se componen con esos mismos nombres cortos.
// taisho.config.ts
import type { TaishoConfig } from '@taishods/core/generate';
const config: TaishoConfig = {
themes: { principal: { colors: { brand: '#4F46E5' } } },
fontFaces: [],
fonts: { sans: 'ui-sans-serif, system-ui, sans-serif' },
defaultStates: { success: '#16A34A', warning: '#D97706', info: '#2563EB', danger: '#DC2626' },
utilities: { 'card-hero': ['p-double', 'radius-lg'] }, // nombres cortos
};
export default config;Qué hay que saber
- La llave va en el mismo elemento. Un elemento con una clase
del sistema pero sin
tsno 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
tses del sistema. Si tu app ya usa una clase llamada así, choca. Tus utilidades propias no pueden llamarsetsni 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
compacty también lleva la llave.