Enter and exit
How things appear and disappear: overlays rise a few pixels and scale up from 0.96 on the smooth spring while they fade in fast; they leave in 180 ms on the exit curve, quieter than they came, along the same path. Things joining a list fade in from a small blur.
Usage
Use it when
- An overlay opens or closes: dropdown menu, popover, dialog, modal, sheet, drawer, command palette, toast.
- One new item joins something already on screen: a file row after an upload starts, a tag after Enter, a new chat message.
- An item leaves for good: a toast times out, a dismissed alert, a deleted row.
Use something else when
- Content opening in the flow and pushing what is below: use Height expand.
- Many items arriving together (results, a feed): use List stagger.
- One view replacing another in the same place: use View swap.
- A picture growing out of its thumbnail: use Shared element.
- Content appearing as the page scrolls: use Reveal on scroll.
- A word or label changing in place: use Text morph.
Where it goes. On the layer itself. Floating layers grow from the edge nearest their trigger (transform-origin); panels slide from the edge they live on; centered dialogs rise from just below center.
Examples
menu--right). Both shrink back to where they came from in 180 ms.<div class="docs-row" style="justify-content: space-between; width: 100%;">
<div style="position: relative;">
<button class="btn btn--gray btn--md" data-lds-menu="ee-sort" aria-haspopup="menu" aria-expanded="false">Sort by<span class="ic" aria-hidden="true">expand_more</span></button>
<div class="menu" id="ee-sort" role="menu" style="top: calc(100% + 6px); left: 0;">
<button class="menu__item" role="menuitem">Due date</button>
<button class="menu__item" role="menuitem">Course</button>
<button class="menu__item" role="menuitem">Recently added</button>
</div>
</div>
<div style="position: relative;">
<button class="icon-btn" data-lds-menu="ee-more" aria-haspopup="menu" aria-expanded="false" aria-label="More actions"><span class="ic" aria-hidden="true">more_horiz</span></button>
<div class="menu menu--right" id="ee-more" role="menu" style="top: calc(100% + 6px); right: 0;">
<button class="menu__item" role="menuitem"><span class="ic" aria-hidden="true">edit</span>Rename</button>
<button class="menu__item" role="menuitem"><span class="ic" aria-hidden="true">content_copy</span>Duplicate</button>
<div class="menu__sep"></div>
<button class="menu__item menu__item--danger" role="menuitem"><span class="ic" aria-hidden="true">delete</span>Delete</button>
</div>
</div>
</div><div class="viewport docs-box">
<div class="viewport__content">
<p class="card__title">Database Systems</p>
<div class="docs-row">
<button class="btn btn--secondary btn--md" data-lds-open="ee-dialog" aria-haspopup="dialog">Rename course</button>
<button class="btn btn--secondary btn--md" data-lds-open="ee-drawer" aria-haspopup="dialog"><span class="ic" aria-hidden="true">tune</span>Filters</button>
</div>
</div>
<div class="scrim" data-lds-scrim="ee-dialog"></div>
<div class="dialog" id="ee-dialog" role="dialog" aria-modal="true" aria-labelledby="ee-dialog-t" data-lds-layer>
<h3 class="dialog__title" id="ee-dialog-t">Rename course</h3>
<p class="dialog__body">Students see the new name the next time they open the app.</p>
<div class="control" style="margin-top: 16px;"><input aria-label="Course name" value="Database Systems" data-lds-autofocus></div>
<div class="dialog__actions"><button class="btn btn--secondary btn--md" data-lds-close>Cancel</button><button class="btn btn--primary btn--md" data-lds-close>Save name</button></div>
</div>
<div class="scrim" data-lds-scrim="ee-drawer"></div>
<aside class="drawer" id="ee-drawer" role="dialog" aria-modal="true" aria-labelledby="ee-drawer-t" data-lds-layer>
<div class="sheet__head" style="margin: 0;"><h3 class="sheet__title" id="ee-drawer-t">Filters</h3><button class="icon-btn" aria-label="Close filters" data-lds-close style="margin: -10px -10px -10px 0;"><span class="ic" aria-hidden="true">close</span></button></div>
<button class="btn btn--primary btn--block" style="margin-top: auto;" data-lds-close>Show 8 courses</button>
</aside>
</div>import { toast } from 'lampung-design-system/js';
toast({ title: 'Draft saved', icon: 'check_circle' });<div class="docs-col" style="max-width: 420px;">
<div><div class="file-row"><span class="file-row__icon"><span class="ic" aria-hidden="true">description</span></span><span class="file-row__body"><span class="file-row__name">lab-report.pdf</span><span class="file-row__meta">1.2 MB</span></span><button class="icon-btn" aria-label="Remove lab-report.pdf"><span class="ic" aria-hidden="true">close</span></button></div></div>
<button class="btn btn--secondary btn--sm" style="align-self: flex-start;" onclick="const list = this.previousElementSibling; const row = list.firstElementChild.cloneNode(true); row.querySelector('.file-row__name').textContent = 'week-' + (list.children.length + 3) + '-notes.pdf'; row.querySelector('.file-row__meta').textContent = '340 KB'; list.append(row);"><span class="ic" aria-hidden="true">add</span>Add a file</button>
</div>dialog.modal rises from 8 px below and 0.96 on the smooth spring, its backdrop fades over 240 ms; it leaves to 0.97 in 180 ms. Below 600 px it becomes a bottom sheet that rises and drops.<button class="btn btn--secondary" data-lds-modal="ee-modal">Report a mistake</button> <dialog class="modal" id="ee-modal" aria-labelledby="ee-modal-t"> <button class="icon-btn dialog__close" data-lds-modal-close aria-label="Close"><span class="ic" aria-hidden="true">close</span></button> <h2 class="dialog__title" id="ee-modal-t">Report a mistake</h2> <p class="dialog__body">Tell us what is wrong in question 12 and what it should say.</p> <div class="dialog__actions"><button class="btn btn--secondary" data-lds-modal-close>Cancel</button><button class="btn btn--primary" data-lds-modal-close>Send report</button></div> </dialog>
Variants and sizes
| Class or attribute | When |
|---|---|
Menu, popover | In: opacity --d-fast on --ease-enter, transform from scale(0.96) translateY(-4px) on --spring-smooth (560 ms), from transform-origin. Out: both over --d-exit on --ease-exit, then visibility: hidden after 180 ms. |
Dialog, command palette | In: opacity --d-fast, transform from translateY(4px) scale(0.98) (palette scale(0.97)) on --spring-smooth. Out: back to that state over --d-exit on --ease-exit. |
Page modal (.modal, .overlay) | In: lds-modal-in from translateY(8px) scale(0.96) on --spring-smooth; backdrop lds-fade-in 240 ms. Out: add .is-closing, lds-modal-out to scale(0.97) in 180 ms; closeModal() waits, then closes. Phones: lds-sheet-up / lds-sheet-down (260 ms). |
Sheet | In: from translateY(105%) on --spring-smooth. Out: 260 ms on --ease-exit (it travels its full height). Flung: --spring-momentum (600 ms). |
Drawer | In: from off-screen right on --spring-smooth. Out: 240 ms on --ease-exit. |
Scrim | In: 240 ms --ease-enter. Out: 180 ms --ease-exit. |
Toast | In: lds-toast-in from translateY(24px) scale(0.96) on --spring-smooth. Out: .is-leaving, 180 ms on --ease-exit, removed after 200 ms. |
Item joining (file row, tab panel) | lds-blur-in: from 4 px below, 4 px blur, transparent; --d-standard on --ease-enter. Tags and OTP digits use lds-pop-in (from 0.6) on --spring-snappy. |
Tooltip, hover card | Wait 500 ms (hover card 600 ms) before entering on --spring-snappy / --spring-smooth; leave in 100 to 120 ms. No delay on the way out. |
Motion and microinteractions
- Opacity is always faster than transform on the way in (160 ms against 560 ms): the layer is readable almost at once and keeps settling while people already read it.
- Exits are shorter than entrances (180 ms against 560 ms) and accelerate (
--ease-exit). Nothing bounces on the way out. - Overlays use transitions on
.is-open, so closing mid-entrance reverses from the current position;visibilityswitches after the exit so a half-closed layer never catches clicks. - Same path back: menus shrink to their origin corner, sheets drop, drawers slide to their side, toasts drop 12 px.
- Reduced motion: dialogs, menus, popovers and the palette stop scaling (opacity only); page modals skip their animation and close at once; every remaining transition runs 120 ms linear.
Accessibility
- Focus moves into an overlay when it opens and back to the trigger when it closes (
openLayer/closeLayer,openModal/closeModaldo this). - Closed overlays are
visibility: hiddenandinert, so they are out of the tab order even during the exit. - Toasts are announced by their
role="status"container; items joining a list are announced by the list owner if they matter (a live region or a toast), not by the motion.
Do and don't
Do
- Open overlays with the system hooks (
data-lds-open,data-lds-menu,data-lds-modal) so enter, exit and focus come together. - Close page modals with
closeModal(el)so the exit plays before the dialog closes. - Pick
menu--rightormenu--upso the menu grows from the side of its trigger.
Don't
- Remove an element in the same frame you start its exit; wait
--d-exit. - Slide an overlay in from a side it does not live on.
- Fade every new element in a page in; most content should just be there.
Behavior and code
Plain HTML. openLayer(id) / closeLayer(id) for [data-lds-layer] overlays; openModal(el) / closeModal(el, done) for dialog.modal and .overlay (adds .is-closing, waits --d-exit, then closes); toast({ … }); menus through data-lds-menu. All respect reduced motion.
React. From lampung-design-system/react.
import { closeModal } from 'lampung-design-system/react';
// Render .overlay > .overlay__panel while open; on close, play the exit first:
closeModal(overlayRef.current, () => setOpen(false));