translateTranslate
Combine translation, scale, rotation, skew, perspective, and transform origin.
Preview
A transform shifts visual coordinates horizontally, vertically, or both while leaving layout flow unchanged.
Implement Translate: Combine translation, scale, rotation, skew, perspective, and transform origin. Use Duration 280ms, Transform translate, Distance 36px, Angle 12deg, Start scale 92%, Origin center, Easing soft. Trigger it once when state changes and keep it replayable. Use semantic HTML, scope CSS to .motion-demo--translate. Provide equivalent low-motion behavior for prefers-reduced-motion and .force-reduced-motion.
<div class="motion-demo motion-demo--translate" data-motion="translate" aria-label="Translate demo">
<article class="motion-surface">
<strong>Translate</strong>
<span class="motion-line"></span>
<span class="motion-line"></span>
</article>
</div>.motion-demo.motion-demo--translate {
box-sizing: border-box;
position: relative;
display: grid;
place-items: center;
width: min(100%, 34rem);
min-height: 15rem;
padding: 2rem;
overflow: hidden;
color: #18181b;
background: #fafafa;
border: 1px solid #e4e4e7;
border-radius: 16px;
isolation: isolate;
}
.motion-demo.motion-demo--translate *, .motion-demo.motion-demo--translate *::before, .motion-demo.motion-demo--translate *::after {
box-sizing: border-box;
}
.motion-demo.motion-demo--translate .motion-surface {
position: relative;
display: grid;
gap: 0.65rem;
width: min(100%, 18rem);
padding: 1.25rem;
background: #ffffff;
border: 1px solid #e4e4e7;
border-radius: 16px;
box-shadow: none;
}
.motion-demo.motion-demo--translate .motion-surface strong { font-weight: 500; }
.motion-demo.motion-demo--translate .motion-line {
display: block;
width: 100%;
height: 0.5rem;
background: #e4e4e7;
border-radius: 999px;
}
.motion-demo.motion-demo--translate .motion-line:last-child { width: 62%; }
.motion-demo.motion-demo--translate .motion-button {
position: relative;
min-height: 2.75rem;
padding: 0.75rem 1.1rem;
color: white;
font: inherit;
font-weight: 700;
background: #18181b;
border: 0;
border-radius: 999px;
cursor: pointer;
}
.motion-demo.motion-demo--translate .motion-button:focus-visible { outline: 3px solid rgb(37 99 235 / 32%); outline-offset: 3px; }
.motion-demo.motion-demo--translate .motion-action-row {
display: flex;
justify-content: center;
gap: 0.5rem;
margin-top: 0.85rem;
}
.motion-demo.motion-demo--translate .motion-replay-scene {
width: min(100%, 22rem);
display: grid;
place-items: center;
}
.motion-demo.motion-demo--translate .motion-pausable-scene {
width: min(100%, 22rem);
display: grid;
place-items: center;
}
.motion-demo.motion-demo--translate button.motion-surface {
color: inherit;
font: inherit;
text-align: start;
cursor: pointer;
}
.motion-demo.motion-demo--translate .motion-replay-button,
.motion-demo.motion-demo--translate .motion-undo-button,
.motion-demo.motion-demo--translate .motion-dismiss-button,
.motion-demo.motion-demo--translate .motion-pause-button {
min-height: 2.75rem;
padding: 0.65rem 0.9rem;
color: #18181b;
font: 650 0.78rem/1 ui-sans-serif, system-ui, sans-serif;
background: #ffffff;
border: 1px solid #d4d4d8;
border-radius: 8px;
cursor: pointer;
}
.motion-demo.motion-demo--translate .motion-replay-button:focus-visible,
.motion-demo.motion-demo--translate .motion-undo-button:focus-visible,
.motion-demo.motion-demo--translate .motion-dismiss-button:focus-visible,
.motion-demo.motion-demo--translate .motion-pause-button:focus-visible,
.motion-demo.motion-demo--translate [data-reorder-item]:focus-visible,
.motion-demo.motion-demo--translate [data-swipe-target]:focus-visible {
outline: 3px solid rgb(37 99 235 / 32%);
outline-offset: 3px;
}
.motion-demo.motion-demo--translate .motion-status {
position: absolute;
width: 1px;
height: 1px;
padding: 0;
margin: -1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
white-space: nowrap;
border: 0;
}
.motion-demo.motion-demo--translate .motion-ripple-ink {
position: absolute;
width: 12px;
height: 12px;
pointer-events: none;
background: rgb(255 255 255 / 72%);
border-radius: 50%;
transform: translate(-50%, -50%) scale(0.95);
opacity: 0;
}
.motion-demo.motion-demo--translate .motion-state-stack { position: relative; width: min(100%, 18rem); height: 9rem; }
.motion-demo.motion-demo--translate .motion-state { position: absolute; inset: 0; display: grid; place-items: center; padding: 1rem; background: #ffffff; border: 1px solid #e4e4e7; border-radius: 16px; }
.motion-demo.motion-demo--translate .motion-state--to { background: #18181b; color: white; }
.motion-demo.motion-demo--translate .motion-scroll-track > span { color: #71717a; font: 600 0.72rem/1.2 ui-monospace, monospace; letter-spacing: 0.08em; text-transform: uppercase; }
.motion-demo.motion-demo--translate .motion-orbit-item { display: grid; place-items: center; width: 2.5rem; height: 2.5rem; color: white; background: #2563eb; border-radius: 50%; }
.motion-demo.motion-demo--translate .motion-text-stack { position: relative; width: min(100%, 18rem); min-height: 4rem; }
.motion-demo.motion-demo--translate svg { width: min(100%, 20rem); height: auto; }
.motion-demo.motion-demo--translate .motion-surface { transform-origin: center; animation: motion-translate 280ms cubic-bezier(0.23, 1, 0.32, 1) both; }
@keyframes motion-translate { from { opacity: 0.6; transform: translateX(36px); } to { opacity: 1; transform: none; } }
@keyframes motion-translate-reduced-fade {
from { opacity: 0.84; }
to { opacity: 1; }
}
.force-reduced-motion .motion-demo.motion-demo--translate {
animation: motion-translate-reduced-fade 160ms cubic-bezier(0.23, 1, 0.32, 1) both !important;
}
.force-reduced-motion .motion-demo.motion-demo--translate *,
.force-reduced-motion .motion-demo.motion-demo--translate *::before,
.force-reduced-motion .motion-demo.motion-demo--translate *::after {
animation: none !important;
animation-delay: 0ms !important;
animation-iteration-count: 1 !important;
transition-property: opacity, color, background-color, border-color !important;
transition-duration: 160ms !important;
transition-delay: 0ms !important;
scroll-behavior: auto !important;
}
.force-reduced-motion .motion-demo.motion-demo--translate .motion-button,
.force-reduced-motion .motion-demo.motion-demo--translate [data-reorder-item],
.force-reduced-motion .motion-demo.motion-demo--translate [data-swipe-target],
.force-reduced-motion .motion-demo.motion-demo--translate [data-spring-target] {
transform: none !important;
}
.force-reduced-motion .motion-demo.motion-demo--translate .motion-path { stroke-dashoffset: 0 !important; }
.force-reduced-motion .motion-demo.motion-demo--translate .motion-word--from { opacity: 0 !important; visibility: hidden; }
.force-reduced-motion .motion-demo.motion-demo--translate .motion-word:not(.motion-word--from) { opacity: 1 !important; filter: none !important; transform: none !important; }
@media (prefers-reduced-motion: reduce) {
.motion-demo.motion-demo--translate {
animation: motion-translate-reduced-fade 160ms cubic-bezier(0.23, 1, 0.32, 1) both !important;
}
.motion-demo.motion-demo--translate *, .motion-demo.motion-demo--translate *::before, .motion-demo.motion-demo--translate *::after {
animation: none !important;
animation-delay: 0ms !important;
animation-iteration-count: 1 !important;
transition-property: opacity, color, background-color, border-color !important;
transition-duration: 160ms !important;
transition-delay: 0ms !important;
scroll-behavior: auto !important;
}
.motion-demo.motion-demo--translate .motion-button,
.motion-demo.motion-demo--translate [data-reorder-item],
.motion-demo.motion-demo--translate [data-swipe-target],
.motion-demo.motion-demo--translate [data-spring-target] {
transform: none !important;
}
.motion-demo.motion-demo--translate .motion-path { stroke-dashoffset: 0 !important; }
.motion-demo.motion-demo--translate .motion-word--from { opacity: 0 !important; visibility: hidden; }
.motion-demo.motion-demo--translate .motion-word:not(.motion-word--from) { opacity: 1 !important; filter: none !important; transform: none !important; }
}Learn more
Terms and distinctions
translateTranslate
位移A transform shifts visual coordinates horizontally, vertically, or both while leaving layout flow unchanged.
沿 X 轴或 Y 轴移动元素。
scaleScale
缩放A transform multiplies an element's rendered width and height around a chosen origin.
放大或缩小元素。
Scale changes an element's size; Translate changes its position.
rotateRotate
旋转A transform changes an element's angular orientation around its transform origin.
让元素围绕一个点旋转。
Rotate changes an element's angle around an anchor; Translate changes its position.
skewSkew
倾斜A shear transform offsets one axis in proportion to the other, producing a slanted silhouette.
沿 X 轴或 Y 轴倾斜元素,使其从矩形形态产生切变。
Skew shears an element's shape; Translate moves it along an axis.
perspectivePerspective
透视Perspective sets the viewer-to-plane distance used to project three-dimensional transforms; shorter distances amplify depth.
控制 3D 效果的强弱;较小的值会夸大纵深,像观察者距离更近。
Perspective controls the depth of a 3D projection; Translate controls spatial position.
transform-originTransform origin
变换原点The transform origin defines the local pivot from which scaling and rotation are calculated.
缩放展开或旋转所围绕的锚点。
Transform origin anchors scale or rotation; a pure translation keeps the same path across origins.
Before implementation
- Purpose
- Compare translation, scale, rotation, skew, perspective, and transform origin in one controlled playground.
- Frequency
- Use during implementation tuning; production UI keeps only transforms that explain the state relationship.
- Trigger
- Trigger from mode selection or state change, emphasizing one primary transform dimension at a time.
- Enter / exit
- Enter from an explainable offset toward none; exit in a direction with spatial meaning.
- Interruptibility
- Continue from the current transform matrix when switching modes to avoid decomposition jumps.
- Gesture and keyboard
- Map drag experiments directly to pointer travel, with keyboard steps for scale and rotation controls.
- Reduced-motion strategy
- Remove large translation, rotation, and perspective, keeping a state-color change or short fade.
Accessibility
Remove large translation, rotation, and perspective, keeping a state-color change or short fade.
Parameter reference
| Parameter | Range / options | Default | Purpose |
|---|---|---|---|
duration | 80ms–1200ms | 280ms | Controls the time required for one motion cycle. |
transform | Translate / Scale / Rotate / Skew / Perspective | Translate | Selects transform. |
distance | 0px–120px | 36px | Controls how far the element travels. |
angle | -45deg–45deg | 12deg | Adjusts angle. |
scale | 70%–105% | 92% | Controls the starting size relative to the final state. |
origin | Center / Top / Bottom / Left / Right | Center | Selects origin. |
ease | Soft / Snap / Calm / Linear | Soft | Controls how velocity changes over time. |
Pre-delivery review
- Confirm transforms preserve document flow and hit-area semantics.
- Verify that transform-origin is visibly meaningful in scale and rotation modes.