Transición de tamaño
Envuelve un contenido cuyo tamaño cambia (un mensaje que crece, una sección que gana una línea, un panel que pierde una fila) y lleva su propio tamaño al nuevo tamaño del contenido en un solo movimiento, de modo que lo que viene después se desplaza con suavidad en lugar de saltar, mientras el borde al que está anclada no se mueve.
- Categoría
- Contención
- Tokens
comp.size-transition- Nivel
- Base
- Web
tanrei-size-transitionclock_loader_40 - SwiftUI
TanreiSizeTransitionradio_button_unchecked - Jetpack Compose
TanreiSizeTransitionradio_button_unchecked - Flutter
TanreiSizeTransitionradio_button_unchecked - React Native
SizeTransitionradio_button_unchecked
Generado a partir de docs/status/status.json, specs/size-transition.spec.json
Un bloque que sigue a su párrafo y una caja en línea que sigue a su palabra
El informe trimestral está listo. Desde la última versión se han añadido tres secciones: costes, personal y el plan para el próximo trimestre.
Cuando el contenido que lleva dentro cambia de tamaño, la caja pasa del tamaño que muestra al nuevo en un solo movimiento. Lo que viene después en el diseño se desplaza con ella en lugar de saltar de un fotograma a otro. No dibuja nada propio: ni fondo, ni borde, ni esquinas redondeadas, ni relleno.
Los ejemplos de Web y React muestran la especificación actual. SwiftUI, Compose, Flutter y React Native están previstos: todavía no ofrecen una transición de tamaño.
<tanrei-size-transition>
<div id="details"></div>
</tanrei-size-transition>
<p>Todo lo que hay debajo se desplaza con suavidad cuando cambian los detalles.</p>
<!-- Anclada abajo: crece hacia arriba y su última línea no se mueve. -->
<tanrei-size-transition anchor="end">
<div id="draft"></div>
</tanrei-size-transition>
<script type="module">
import '@tanrei/web/components/size-transition';
const box = document.querySelector('tanrei-size-transition');
box.addEventListener('settle', (event) => console.log(event.detail.height));
document.querySelector('#details').textContent = longerText; // se desplaza, no salta
</script>import { SizeTransition } from '@tanrei/react';
<SizeTransition onSettle={(event) => setHeight(event.detail.height)}>
{expanded ? <FullDetails /> : <Summary />}
</SizeTransition>
<SizeTransition axis="inline">
<span>{saving ? 'Guardando…' : 'Guardado'}</span>
</SizeTransition>Anclajes: start (el predeterminado), end y center
Start: la primera línea no se mueve y las líneas nuevas aparecen debajo.
End: la última línea se queda pegada al final de la caja y las nuevas aparecen encima.
Center: cada borde se mueve la mitad del cambio.
Anatomía
Anatomía
block, tal como lo dibuja el paquete web.| Parte | Descripción |
|---|---|
1 box | The size transition itself: a box with no look of its own, laid out where it stands, whose size along its axis is the one that moves. It clips what lies beyond it while it moves. |
2 content | Whatever the product puts in it, laid out at its own natural size and fixed to the box's anchor edge. It is measured, never scaled or stretched. |
Propiedades
| Propiedad | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
axis | block | inline | both | "block" | Which of its sizes follows the content. block: its height in a horizontal writing mode (the size across lines); its width is the layout's. inline: its width (the size along a line); its height is the layout's. both: both sizes. |
anchor | start | end | center | "start" | Which edge stays still while the box grows or shrinks. start: the block-start edge (the top) for block, the inline-start edge for inline, so that a growing box uncovers what is new below or after and never moves the first line. end: the opposite edges, for a box docked at its container's end that grows upward (a composer above the keyboard). center: both edges move by half. |
duration | number | null | How long one change takes, in milliseconds, used as given for every distance. Null, the default, takes the system's answer, which grows with the distance moved (SZT-3). Set it only where one place needs another tempo than every other size transition of the product. |
disabled | boolean | false | Makes the box follow its content's size at once, without a motion: for a change the person should not watch (a list replaced by a search's results) or a stretch of time in which the content changes at every frame. |
Slots
| Slot | Descripción |
|---|---|
default | The content whose size the box follows. Any content: text, a list, another component. |
Eventos
| Evento | Descripción |
|---|---|
settle | The box's size has come to rest after a change, by a motion or at once: emitted once per change, after the last frame, with the box's new width and height in the platform's layout units. A motion that is turned round or retargeted (SZT-2) emits once, at its final rest. |
Estados
Comportamiento
Requisitos en formato EARS. Cada implementación de plataforma se prueba contra estos identificadores. El texto de los requisitos se muestra tal como está en la especificación, en inglés.
| ID | Requisito |
|---|---|
SZT-1 | WHEN the size transition is first drawn THE size transition SHALL take its content's size along its axis in its first frame, without a motion, as every component draws its first frame at rest (MOT-3); content that arrives or changes before that frame is drawn is part of the first frame. |
SZT-2 | WHEN its content's size along its axis changes after the first frame THE size transition SHALL move its own size in the layout, at every frame, from the size it shows to the new one, over the duration SZT-3 gives with comp.size-transition.motion.easing, so that what stands after it moves with it; WHEN the content changes again during the motion THE size transition SHALL go on from the size then shown towards the newest size as one motion, never jumping to the old target or restarting from the old size (MOT-2). |
SZT-3 | WHILE duration is null THE size transition SHALL take the duration of a change from the distance its size moves: comp.size-transition.motion.duration for a distance of up to comp.size-transition.motion.distance-step, plus comp.size-transition.motion.duration-step for each further distance-step begun, and never more than comp.size-transition.motion.duration-max; WHILE duration is a number THE size transition SHALL take that many milliseconds for every distance, 0 meaning at once. The duration of a retargeted motion SHALL be computed from the distance between the size shown and the newest size. |
SZT-4 | WHILE its size differs from its content's THE size transition SHALL clip what lies beyond its box and keep the content fixed to the edge anchor names, mirrored for inline in a right-to-left layout: WHILE anchor is start a growing box SHALL uncover what is new at its block-end (or inline-end) edge and never move its first line, WHILE anchor is end it SHALL uncover what is new at its start edge, the content moving with its end edge, and WHILE anchor is center both edges SHALL move by half the change. |
SZT-5 | WHILE it moves THE size transition SHALL scroll nothing — neither itself nor its content nor an ancestor — to bring a part of the content into view, also WHILE an element inside it has focus, and SHALL leave focus, the caret and a selection where they are (MOT-5). |
SZT-6 | WHEN its content's size changes because the room the layout gives it changed — the window or a pane was resized or turned, the text size changed, the layout direction changed — THE size transition SHALL take the new size at once, so that it never lags behind a person resizing the window; and WHILE a size transition inside its content is moving THE size transition SHALL follow its content at every frame, so that two nested motions move as one and do not compound. |
SZT-7 | WHERE motion is reduced THE size transition SHALL take every new size at once, as size changes are made where motion is reduced (MOT-6), and SHALL still emit settle once per change. |
SZT-8 | WHILE disabled is true THE size transition SHALL follow its content's size at once; WHEN disabled becomes true during a motion THE size transition SHALL take the newest size at once and emit settle. |
SZT-9 | WHILE the size transition is not drawn — hidden, outside a view that is shown, or in an app in the background — THE size transition SHALL take every new size at once, and WHEN it is drawn again it SHALL show its content's size without a motion. |
SZT-10 | THE size transition SHALL expose nothing of its own to assistive technology — no role, no name, no state — and SHALL NOT be a focus stop: its content is read and reached as if the box were not there, including content that the box clips during a motion. |
SZT-11 | WHEN its size has come to rest after a change, by a motion or at once, THE size transition SHALL emit settle exactly once, after the last frame, with its new width and height; it SHALL emit nothing WHEN its content changes without changing its size along its axis. |
SZT-12 | THE size transition SHALL draw nothing of its own — no color, edge, shadow, corner or padding — and SHALL take, on the axes it does not follow, the size its layout gives it; WHILE axis is both it SHALL follow the content's width and height together in one motion of one duration, computed from the larger of the two distances (SZT-3). |
SZT-13 | THE size transition SHALL take its layout direction from where it is used and SHALL have no direction setting of its own; WHEN axis or anchor names a value it does not define THE size transition SHALL use the default value and in debug builds report the unknown value; WHILE duration is a negative number or not a finite number THE size transition SHALL treat it as null and in debug builds report it. |
Correspondencia de nombres por plataforma
Paridad no significa API idénticas. Cada plataforma expresa el mismo contrato con su propio estilo.
| Especificación | Web | SwiftUI | Jetpack Compose | Flutter | React Native |
|---|---|---|---|---|---|
| Componente | tanrei-size-transition | TanreiSizeTransition | TanreiSizeTransition | TanreiSizeTransition | SizeTransition |
axis · Propiedad | axis | axis | axis | axis | axis |
anchor · Propiedad | anchor | anchor | anchor | anchor | anchor |
duration · Propiedad | duration | duration | durationMillis | duration | duration |
disabled · Propiedad | disabled | isDisabled | enabled | disabled | disabled |
settle · Evento | settle | onSettle | onSettle | onSettle | onSettle |
| Notas | <tanrei-size-transition axis="block" anchor="start">…</tanrei-size-transition>, built on the package's size-motion primitive (AnimatedSize). The shadow root holds a box and, in it, a wrapper around the slot at its natural size. A resize observer of the wrapper sees a change of the content's size after layout and before the frame is painted; the box then moves from the size the last frame drew to the new one in pixels, with a CSS transition, clipped with overflow: clip (never hidden, which lets a focused descendant scroll the box). The box is a flex container that justifies the wrapper to the anchor's edge (flex-start, flex-end, center), so that the content is laid out at its own size and overflows the edge that moves; justification follows the direction, so the inline axis mirrors in right-to-left. interpolate-size: allow-keywords is not used: it is experimental and not Baseline. SZT-6: a change of the window's size, of the box's own inline size (the room it is given, for axis block), of its font size or of its direction is applied at once, as is any change while a size transition in its content carries data-resizing (the host carries it while it moves). settle is a CustomEvent that does not bubble, whose detail is { width, height } in CSS pixels; a run that is retargeted ends with the run that replaced it. duration is a number property, the duration attribute parsed as the tooltip's delays are (an empty attribute is not a number). The host is display: block (axis inline or both: display: inline-block), as large as the box. | A container view that measures its content with a geometry reader and animates its frame with withAnimation on the measured size, .clipped(), aligned by anchor; reduced motion from accessibilityReduceMotion. | A Box with Modifier.animateContentSize(animationSpec, alignment) and clipToBounds(); enabled is the inverse of disabled. The spec of SZT-3 is computed from the measured distance before each animation. | Built on AnimatedSize with alignment from anchor and clipBehavior: Clip.hardEdge; the duration of SZT-3 is set from the size the child reports before the animation starts. | A View that measures its child with onLayout and animates its own height or width with Reanimated, overflow: 'hidden' (React Native has no clip distinction). |
Tokens
| Token | Alias de | Valor resuelto (claro) |
|---|---|---|
--tanrei-comp-size-transition-motion-distance-step | sys.space.space800 | 64px |
--tanrei-comp-size-transition-motion-duration | sys.motion.role.resize.default | 300ms |
--tanrei-comp-size-transition-motion-duration-max | sys.motion.role.resize.large | 400ms |
--tanrei-comp-size-transition-motion-duration-step | sys.motion.duration.short1 | 50ms |
--tanrei-comp-size-transition-motion-easing | sys.motion.easing.spatial | cubic-bezier(0.2, 0, 0, 1) |
Fixtures
Representaciones canónicas. Todas las plataformas capturan cada fixture con el mismo identificador para poder comparar los resultados.
block
{} inline
axis: inline anchor-end
anchor: end anchor-center
anchor: center both
axis: both rtl-inline
axis: inline direction: rtl Generado a partir de specs/size-transition.spec.json, tokens/comp/size-transition.tokens.json, design/tokens/
Usa una transición de tamaño alrededor de un contenido propio cuyo tamaño cambia mientras la persona lo está mirando: el borrador de una respuesta que pasa a una segunda línea, un resumen que sustituyes por el texto completo, una línea de error que aparece bajo un campo que has construido tú, una etiqueta de estado cuya palabra se alarga. Sin ella, todo lo que hay debajo salta de golpe y la persona pierde el punto por donde iba.
Los componentes de Tanrei ya mueven sus propios cambios de tamaño: un campo de entrada de texto que crece, un snackbar que se despliega, un acordeón que se abre. No hace falta envolverlos en una transición de tamaño para eso.
Para mostrar u ocultar una sección entera a petición de la persona, usa un acordeón: abrir y cerrar es su trabajo. Una transición de tamaño no abre ni cierra nada; solo sigue a lo que lleva dentro.
La duración crece con la distancia. En el sistema predeterminado, un cambio de hasta 64 píxeles dura 300 ms. Cada 64 píxeles más, o una parte de ellos, suma 50 ms, hasta un máximo de 400 ms. Así, un cambio grande no parece precipitado junto a uno pequeño, y uno lejano nunca hace esperar. Define duration solo donde un lugar necesite un ritmo distinto del de todas las demás transiciones de tamaño de tu producto. Con 0, el cambio es inmediato.
| Eje | Úsalo para |
|---|---|
| Block (predeterminado) | Contenido cuya altura cambia: párrafos, listas, una sección que gana una fila. Su anchura es la del diseño. |
| Inline | Una etiqueta cuya anchura cambia: una palabra de estado, un recuento, el texto de un botón. Es tan ancha como su contenido. |
| Both | Una caja pequeña cuya anchura y altura cambian a la vez, como una insignia que pasa a una segunda línea. Las dos se mueven en un solo movimiento. |
| Anclaje | Úsalo para |
|---|---|
| Start (predeterminado) | La mayoría de los contenidos. La primera línea no se mueve nunca y lo nuevo aparece después. |
| End | Contenido anclado al final de su contenedor, como el campo para escribir un mensaje encima del teclado. Su última línea se queda donde está y la caja crece hacia el principio. |
| Center | Algo centrado en su espacio, como un aviso en medio de un panel vacío. |
- Envuelve el contenido que cambia, y solo ese. Una transición de tamaño alrededor de toda una página lo mueve todo a la vez.
- Usa
disabledmientras el contenido cambia en cada fotograma (por ejemplo, mientras la persona arrastra algo dentro) y para un cambio que no hace falta que la persona vea, como una lista que se sustituye por los resultados de una búsqueda. - Espera a
settlecuando necesites medir o desplazarte después del cambio: llega una sola vez, después del último fotograma.
- No la uses para que algo aparezca o desaparezca con un fundido. Solo mueve el tamaño; el fundido le corresponde al contenido.
- No envuelvas en una transición de tamaño un componente de Tanrei que ya mueve su propio tamaño.
- No cuentes con ella para eliminar el desplazamiento de diseño (layout shift) de tus métricas. Los navegadores siguen contando un elemento que se mueve por un cambio de diseño. Lo que elimina es el salto que ve la persona.
- Rol
none (a generic container that exposes nothing of its own)- Etiquetado
- The size transition names nothing and is not named; its content keeps its own names, roles and order.
- Objetivo mínimo
- El área de pulsación cumple el tamaño mínimo de objetivo aunque el tamaño visual sea menor. minimum 36px · pointer 36px · spacing 8px · touch 36px
Teclado
| Teclas | Acción |
|---|
Notas
- It takes no input, so it has no target of its own; its content keeps its own hit areas.
- A size change is a motion in the sense of WCAG 2.3.3 (animation from interactions): where motion is reduced it happens at once (SZT-7). The opacity of the content is never changed by this component.
- Content that the box clips while it moves stays in the reading and focus order: a person who tabs into it during the motion reaches it, and nothing scrolls to show it (SZT-5) — the motion ends within comp.size-transition.motion.duration-max.
- Browsers count an element moved by a layout change as a layout shift unless a person's input preceded it within a short window. Moving what follows over a motion does not remove it from that count; it removes the jump a person sees. Measure layout shift in a product's own pages.
Generado a partir de specs/size-transition.spec.json, tokens/sys/measure.tokens.json
- No expone nada propio a la tecnología de apoyo: ni rol, ni nombre, ni estado. Nunca es una parada del foco. Su contenido se lee y se alcanza como si la caja no estuviera.
- El contenido que la caja recorta durante un movimiento sigue en el orden de lectura y en el orden del foco. Quien entra con Tab durante el movimiento lo alcanza, y en el sistema predeterminado el movimiento termina en menos de 400 ms.
- Mientras se mueve no se desplaza nada: ni la caja, ni su contenido, ni la página. El foco, el cursor de texto y la selección se quedan donde están.
- Cuando se pide reducir movimiento, todos los cambios de tamaño son inmediatos.
settlesigue llegando una vez por cambio. - Un cambio del espacio que le da el diseño (se cambia el tamaño de la ventana, el tamaño del texto o la dirección) es inmediato, para que la caja nunca vaya por detrás de quien está cambiando el tamaño de la ventana.
- Las compilaciones de depuración notifican un
axiso unanchordesconocido y unadurationnegativa o que no es un número.
- Anuncia tú un cambio que importe, en una región activa (live region) o en un aviso que la persona vaya a ver. Una transición de tamaño solo mueve su tamaño y no dice nada.
- Mantén correctos los nombres, los roles y el orden del propio contenido. La transición de tamaño no añade ninguno.