SlideY
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.
<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.
- mode
- Vue transition mode: "in-out" or "out-in".
- disabledbooleanfalse
- Disables the animation. Content appears/disappears instantly.
- namestring'origam-transition--slide-y'
- Vue transition name class prefix. Defaults to origam-transition--slide-y.
- groupbooleanfalse
- When true, renders a <transition-group> to enable list-move animation.
- hideOnLeavebooleanfalse
- Sets the leaving element to visibility: hidden immediately.
- leaveAbsolutebooleanfalse
- Positions the leaving element absolutely during leave to prevent layout jank.
- originstring
- 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
out-in mode (accordion item)
Animated list (group)
Ecosystem
Family
Components from the same folder that share conventions and often compose together.
Transition
CSS-driven Vue transition wrappers. Fade, SlideX, SlideY, ExpandX, ExpandY, ScaleRotate.
Fade
Opacity-only enter/leave transition.
SlideX
Horizontal slide + fade transition.
ExpandX
Horizontal width expand/collapse transition.
ExpandY
Vertical height expand/collapse transition.
ScaleRotate
Scale + rotate + fade combined transition.