Saltar al contenido
menu palettetanreidark_modetranslate

Modo de color

Contraste

Sistema de diseño

Los sistemas de la galería imitan otros sistemas de diseño para mostrar hasta dónde llega Tanrei. Son ejemplos, no diseños con soporte de Tanrei.

Copiar enlaceEditar tema
palettetanrei

Modo de color

Contraste

Sistema de diseño

Los sistemas de la galería imitan otros sistemas de diseño para mostrar hasta dónde llega Tanrei. Son ejemplos, no diseños con soporte de Tanrei.

Copiar enlaceEditar tema
Primeros pasosWebReactSwiftUIJetpack ComposeFlutterReact NativePreajustesTu propio sistema de diseñoUsar Tanrei con agentes de IAMarcaTokens de diseñoSistemas de diseño y personalizaciónTheme StudioColorTipografíaIconosFormaElevaciónMovimientoEstados de interacciónComportamientoDiseño de páginaTamaño y densidadAccesibilidadTextosTokens de colorTokens de la escala tipográficaTokens de formaTokens de elevaciónTokens de movimientoTokens de estadoTokens de espacio y de medidaComponentesBotónBotón de acción principalBotón segmentadoLo incluyen cupertino, m3-likeGrupo de botonesBotón con menúBarra de herramientasBotón de copiarCasilla de verificaciónBotón de opciónInterruptorChipMenúControl deslizanteCampo de control deslizanteCalendarioDateTimePickerGrupo de camposGrupo de botones de opciónGrupo de casillas de verificaciónSelectCampo de selecciónBarra de menúsSubida de archivosSelector de archivos AvanzadoZona de soltar archivosRatingEntrada de texto AvanzadoCampo de textoCampo de chipsCampoCuadro combinado AvanzadoCampo de cuadro combinadoEntrada numérica AvanzadoCampo numéricoEntrada de color AvanzadoCampo de colorEntrada de código de un solo uso AvanzadoCampo de código de un solo usoEntrada de texto incrustada AvanzadoCuadro de redacción de chatTarjetaDivisorCapa modal AvanzadoDiálogoListaFila de listaHoja inferiorHoja lateralCarruselBloque de códigoTablaPopoverPasosAcordeónLista de descripcionesFiguraEstructura de la aplicaciónCabecera de páginaVista de árbolLínea de tiempoVista previa de imágenesTirador de tamañoMarco redimensionableSplit viewÁrea de desplazamientoTransición de tamañoInsigniaIndicador de progresoMedidorContador animadoIndicador de cargaSnackbarTooltipAtajo de tecladoTagCódigo en líneaCalloutAvatarEstado vacíoGrupo de tagsEsqueletoElemento de archivoMuestraTexto en marquesinaPestañasVista de pestañasBarra de la aplicaciónBarra de navegaciónPanel de navegaciónBúsquedaEnlacePaginaciónEnlaces anterior y siguienteIndicador de pasosRuta de navegaciónTabla de contenidoTarjeta de enlaceMenú FABLo incluyen m3-likeEstadoCómo se construye TanreiCómo contribuirLicencia y atribución
InicioFundamentosTamaño y densidad

Tamaño y densidad

Una escala de cinco alturas para los tamaños de los controles, el tamaño mínimo al que se dibuja todo lo que se pulsa y un tamaño que un contenedor pasa a lo que contiene.

content_copyVer en Markdown

La altura de un control o de una fila sale de tres valores. La altura de control y el objetivo mínimo son de todo el sistema de diseño: un producto fija cada uno una sola vez, en su capa. El tamaño es de un componente o de un grupo de ellos: un botón es small, medium o large allí donde está.

La escala de tamaños

La escala son cinco alturas, tanrei.sys.control.height.*, que leen los tamaños de los controles: medium es la altura de control, tanrei.dial.control.height (40 de forma predeterminada), y las demás quedan un número entero de unidades de tamaño (dial.size.unit, 4px de forma predeterminada) por debajo y por encima: small dos y extra-small cuatro por debajo, large cuatro y extra-large ocho por encima. Estas son las alturas con algunas alturas de control, calculadas a partir de las reglas de los propios tokens:

Token dial.control.height 36px dial.control.height 40px dial.control.height 44px dial.control.height 48px dial.control.height 56px
--tanrei-sys-control-height-extra-small 20px 24px 28px 32px 40px
--tanrei-sys-control-height-small 28px 32px 36px 40px 48px
--tanrei-sys-control-height-medium 36px 40px 44px 48px 56px
--tanrei-sys-control-height-large 52px 56px 60px 64px 72px
--tanrei-sys-control-height-extra-large 68px 72px 76px 80px 88px

Generado a partir de design/tokens/tanrei.light.tokens.json, tokens/sys/measure.tokens.json

Muchos componentes toman sus alturas de estos escalones, y los que leen el mismo escalón miden lo mismo con cualquier altura de control: los tamaños small, medium y large del Button leen los escalones small, medium y large. La escala en sí no tiene suelo, porque extra-small es para lo que nadie pulsa, como un tag o un atajo de teclado.

El objetivo mínimo

tanrei.sys.target.minimum es la altura mínima a la que se dibuja todo lo que una persona pulsa, y el ancho mínimo de un control que solo tiene icono. Toda altura de una caja o de una fila que se pulsa se deriva con él como suelo, así que ningún tamaño la dibuja más baja. Es el valor del desarrollador: ningún dial lo escala, porque un suelo que encogiera con lo que limita no sería un suelo.

En el sistema predeterminado, el mínimo es 36, igual para un puntero que para un dedo. Las alturas del Button muestran cómo actúa: un valor entre paréntesis es lo que dan el tamaño y la altura de control, y la altura que lo precede es la que el mínimo mantiene en el botón.

Token dial.control.height 36px dial.control.height 40px dial.control.height 44px dial.control.height 48px dial.control.height 56px
--tanrei-comp-button-container-height-small 36px (28px) 36px (32px) 36px 40px 48px
--tanrei-comp-button-container-height-medium 36px 40px 44px 48px 56px
--tanrei-comp-button-container-height-large 52px 56px 60px 64px 72px

Generado a partir de design/tokens/tanrei.light.tokens.json, tokens/comp/button.tokens.json

Otros dos valores dicen desde qué área se recibe una pulsación: sys.target.touch bajo un dedo y sys.target.pointer bajo un puntero preciso. Ambos son el mínimo de forma predeterminada, así que un solo valor fija los tres. Un sistema que sigue las pautas de una plataforma los sube; entonces, un control que está solo recibe la pulsación desde esa área mayor, más allá de lo que dibuja, y una fila que toca a sus vecinas se dibuja con esa altura. Una marca que se dibuja más pequeña que el objetivo, como la caja de una casilla de verificación o un chip pequeño, conserva su tamaño y extiende su área de pulsación hasta el objetivo. Lo que fija cada sistema incluido:

Sistema de diseño minimum touch pointer
tanrei 36px 36px 36px
cupertino 28px 44px 28px
m3-like 32px 48px 44px

Generado a partir de tokens/systems/*.system.json, design/tokens/<system>/tanrei.light.tokens.json

La compilación comprueba cada sistema: ninguno de los tres por debajo de 24px (WCAG 2.5.8), touch y pointer nunca por debajo del mínimo, el mínimo nunca por encima de la altura de control y ninguna altura con suelo por debajo del mínimo. Si la capa de un producto fija un objetivo por debajo de 24px, se le avisa con una advertencia; un área de pulsación por debajo del mínimo, o un mínimo por encima de la altura de control, se rechaza en cualquier sistema.

Cómo fijarlos en una capa

Ambos son tokens que una capa fija con un motivo:

"tokens": {
  "tanrei.dial.control.height": { "$value": { "value": 32, "unit": "px" }, "reason": "A tool used all day with a mouse: controls and rows lower." },
  "tanrei.sys.target.minimum": { "$value": { "value": 32, "unit": "px" }, "reason": "Used with a mouse; 32 is the least we draw." }
}

En la web, las alturas son expresiones CSS de los diales, así que fijar --tanrei-dial-control-height en el elemento raíz mueve a la vez todas las alturas que la siguen, sin compilar de nuevo. En Theme Studio, la fila Tamaño reúne la altura de control, la unidad de tamaño y el objetivo mínimo.

Un tamaño fijado en un contenedor

El tamaño se fija donde están los componentes. En la web, el size de un grupo de botones, una vez fijado, es el tamaño de cada Button del grupo que no fija uno propio:

<tanrei-button-group size="small">
  <tanrei-button variant="outlined">Cancel</tanrei-button>
  <tanrei-button variant="filled">Publish</tanrei-button>
  <tanrei-button variant="text" size="medium">Details</tanrei-button>
</tanrei-button-group>
  • El tamaño propio de un componente gana. El tercer Button de arriba es medium.
  • Solo se pasa un tamaño que se ha fijado. Un grupo sin size no pasa ninguno, así que cada Button del grupo se dibuja con su propio tamaño predeterminado, medium, o con el que fije un contenedor que rodee al grupo; cuando hay contenedores anidados, decide el más cercano que fija un tamaño.
  • Un tamaño que el componente no tiene se convierte en el más cercano a lo largo de la escala, extra-small, small, medium, large, extra-large, y entre dos igual de cercanos, el mayor.
  • Un grupo de botones y una barra de herramientas no dibujan nada propio según su tamaño. Sus espacios, esquinas y divisores siguen siendo los de su variante, alrededor de elementos de la altura a la que se dibujan.

Un componente que se dibuja con el tamaño que le da su contenedor sigue la escala y el mínimo igual que con un tamaño propio. Al cambiar el tamaño del contenedor, o al meter un componente en él o sacarlo, se dibuja enseguida con su nuevo tamaño.

Qué pasa un tamaño y qué lo recibe

Tres contenedores pasan el tamaño fijado en ellos a lo que contienen:

Estos componentes toman el tamaño del más cercano de esos contenedores cuando no fijan uno propio, y son medium cuando ningún contenedor lo fija: el Button, el botón con menú, el botón de copiar y la fila de lista, y, dibujando con él cada fila o parte que les pertenece, la lista, la vista de árbol, el acordeón, la tabla de contenido, la lista de descripciones y la tabla.

El tamaño no llega más lejos. El acordeón, la lista de descripciones y la tabla no pasan ninguno a lo que pongas dentro: un Button en una celda de una tabla conserva su propio tamaño, o toma el de los contenedores que rodean la tabla. Y algunos componentes no toman ninguno de un contenedor:

  • Un menú, incluidos un menú contextual y los menús de una barra de menús, la vista de una búsqueda y la lista de un select o de un cuadro combinado. Cada uno se abre sobre la página, aparte de los controles que lo rodean, así que una barra de herramientas small no achica el menú que abre uno de sus Buttons. Un menú y una búsqueda son medium salvo que fijen su propio size; las opciones de un select o de un cuadro combinado siguen el tamaño de su caja.
  • Un select, una entrada numérica, una entrada de texto o un control deslizante dentro de una barra de herramientas, que conservan el tamaño que les des.
  • Una línea de tiempo, cuyo tamaño es el de su texto.