SlideY

Utilities & Providers
stable

CSS-driven Vue transition that slides a child element vertically (translateY −15px → identity) combined with an opacity fade. Sub-component of the Transition family.

Structure

Anatomy

Visual breakdown of the component's internal structure with BEM class call-outs.

Anatomy of OrigamSlideYSchematic of the slide-y transition with enter and leave phases. enter-active translateY(−15px) → 0 opacity: 0 → 1 leave-active 0 → translateY(−15px) opacity: 1 → 0 1 2 →
Anatomy of <origam-slide-y> — enter ① slides from translateY(−15px) + opacity:0 to identity. Leave ② reverses the same transform + fades out. Duration: 0.3 s; move: 0.5 s.
1.origam-transition--slide-y-enter-active
Enter phase. Child animates from translateY(−15px) + opacity:0 to identity. Duration: 0.3 s, easing: cubic-bezier(0.4,0,0.2,1).
2.origam-transition--slide-y-leave-active
Leave phase. Child slides back to translateY(−15px) + opacity:0 over 0.3 s.

API

Props

All props accepted by this component, with their type, default value and description.

Vue transition mode: "in-out" or "out-in".
disabled
boolean
false
Disables the animation. Content appears/disappears instantly.
name
string
'origam-transition--slide-y'
Vue transition name class prefix. Defaults to origam-transition--slide-y.
group
boolean
false
When true, renders a <transition-group> to enable list-move animation.
hideOnLeave
boolean
false
Sets the leaving element to visibility: hidden immediately.
leaveAbsolute
boolean
false
Positions the leaving element absolutely during leave to prevent layout jank.
origin
string
CSS transform-origin applied during the transition.

API

Slots

Content slots exposed by this component.

#default
A single child element (or multiple when group=true) that receives the vertical slide transition.

API

Exposed members

Properties and methods accessible via template ref (defineExpose). Use them for programmatic control.

<T extends object>(props: T, exclude?: string[]) => Partial<T>
Forwards a filtered subset of props to the underlying transition.

Customisation

CSS variables

CSS custom properties exposed by this component. Override them to customise the component without losing theme compatibility.

Vertical translate distance token. The component hardcodes −15px in its CSS class; this token is the declared reference value.
Default transition duration (0.3 s hardcoded in CSS class).
Easing function for slide-y (decelerate: cubic-bezier(0.4,0,0.2,1)).

Inclusion

Accessibility

ARIA roles, keyboard navigation and focus management. Sourced from the real component template.

Notes

  • Animation is disabled automatically when prefers-reduced-motion: reduce is detected (disabled=true via useCssTransition).
  • The wrapper is transparent to the accessibility tree. Only the slotted child is announced by screen readers.

Interactive

Playground

Edit props live and see the component update in real time. The generated code snippet updates as you change values.

Rendering the live preview…

Usage

Examples

Ready-to-paste code snippets for your templates.

Basic vertical slide

vue

out-in mode (accordion item)

vue

Animated list (group)

vue

Ecosystem

Family

Components from the same folder that share conventions and often compose together.