Appearance
OrigamExpandX
<OrigamExpandX> animates the width of its slot from 0 to its natural pixel width on enter, and the reverse on leave. Use for horizontally collapsing rails, sidebars, or chip rows.
The transition is JS-driven: it measures offsetWidth and toggles overflow: hidden so the content doesn't spill mid-flight.
Basic usage
vue
<template>
<OrigamExpandX>
<div v-if="open">{{ content }}</div>
</OrigamExpandX>
</template>Grouped / list usage
Set group to animate a keyed list of items instead of a single element — the root switches from Vue's Transition to TransitionGroup, which is what makes the -move CSS var below apply: as an item enters or leaves, its siblings smoothly translate into their new position (FLIP) instead of jumping.
vue
<template>
<OrigamExpandX group>
<div v-for="chip in chips" :key="chip.id">{{ chip.label }}</div>
</OrigamExpandX>
</template>mode (in-out / out-in / default) only applies to the single-child form — Vue's TransitionGroup doesn't support it, so it's silently omitted from the underlying transition when group is true (no dev warning either way).
CSS variables consumed
Declared in assets/css/tokens/light.css.
| Variable | Default |
|---|---|
--origam-transition--expand-x-enter-active---transition-duration | 0.5s |
--origam-transition--expand-x-enter-active---transition-timing-function | var(--origam-motion__easing---standard) |
--origam-transition--expand-x-enter-active---transition-property | width |
--origam-transition--expand-x-leave-active---transition-duration | 0.5s |
--origam-transition--expand-x-leave-active---transition-timing-function | var(--origam-motion__easing---standard) |
--origam-transition--expand-x-leave-active---transition-property | width |
--origam-transition--expand-x-move---transition-duration | 0.5s — only reachable via group (see above) |
--origam-transition--expand-x-move---transition-timing-function | var(--origam-motion__easing---standard) — idem |
--origam-transition--expand-x-move---transition-property | transform — idem |
Override at the document root or on a specific instance:
css
.my-rail {
--origam-transition--expand-x-enter-active---transition-duration: 0.25s;
}Deprecated: the -enter-leave- name
The leave rule used to read --origam-transition--expand-x-enter-leave---*, a misnomer that had already shipped. -leave-active- is now the reference and is what the stylesheet declares. The old name is still honoured — as a fallback read inside the component — and will be removed at the next major: migrate any override you have.
The old name is deliberately declared nowhere. Were it declared, it would always resolve and -leave-active- would become unreachable. It works only because the component reads var(--…-enter-leave---x, var(--…-leave-active---x)) — which is also why setting it directly on an element still works, whereas an alias written as a declaration in the token sheet would only ever substitute at :root.
Props
ITransitionNoOriginProps (ITransitionProps minus origin):
| Prop | Effect |
|---|---|
name | CSS class prefix passed to the underlying transition. |
disabled | Short-circuits both the JS measurement and the CSS path — mounts/unmounts instantly. |
mode | in-out (default) / out-in / default. Single-child form only (see Grouped usage). |
group | Switches the root to TransitionGroup for a keyed list; unlocks the -move reflow. |
leaveAbsolute | On leave, pulls the element out of flow (position: absolute, frozen at its current box) so siblings reflow immediately instead of waiting for the width to reach 0. Restored once the leave completes. |
hideOnLeave | Skips the visible width-collapse on leave entirely — the element is hidden (display: none) instantly instead. |
⛔ origin was removed (breaking change, #538/#548). It set transform-origin, which is meaningless for a width-only animation (no transform: scale(...) anywhere in this component's enter/leave) — the prop was declared but never produced any observable effect. Consumers passing origin now get a compile-time TypeScript error rather than a silent no-op.
Notes
- The slot must be a single root element with a measurable width (or, with
group, one measurable element per keyed list item). disabledshort-circuits both the JS measurement and the CSS path.leaveAbsoluteandhideOnLeaveare most useful together withgroup(removing one item from a horizontal list without the others waiting on its full collapse animation), but both also work on a single-child<OrigamExpandX>withoutgroup.
Accessibility
Reduced motion is handled by the component itself — you do NOT need to pass disabled from a matchMedia listener. Every member of the family emits a @media (prefers-reduced-motion: reduce) block (shared ds-reduced-motion mixin, issue #494) that collapses the duration to 0.01ms.
That override wins over the CSS variables above, deliberately: it zeroes the PROPERTY, not the variable, so a theme or a per-instance duration cannot resurrect the motion for a user who asked for none. Verified in Chromium — setting a 9 s duration through the token under prefers-reduced-motion: reduce still measures 0.01ms.
disabled remains available for the unrelated case of skipping the transition on purpose.