Components / Overlays
Drawer
A bottom or top sheet built on the dialog shell.
<button type="button" class="btn" data-variant="outline">
Open drawer
</button>
<dialog class="drawer" id="demo-drawer-default" data-side="block-end" aria-labelledby="drawer-default-title" aria-describedby="drawer-default-description">
<div>
<span data-slot="handle" aria-hidden="true"></span>
<header>
<h2 data-slot="title" id="drawer-default-title">Edit profile</h2>
<p data-slot="description" id="drawer-default-description">Make changes to your profile here.</p>
</header>
<section>
<div class="fieldset">
<div class="field">
<label class="label" for="drawer-default-name">Name</label>
<input class="input" id="drawer-default-name" value="Ada Lovelace">
</div>
<div class="field">
<label class="label" for="drawer-default-username">Username</label>
<input class="input" id="drawer-default-username" value="@ada">
</div>
</div>
</section>
<footer>
<button type="button" class="btn" data-variant="outline">Cancel</button>
<button type="button" class="btn">Save changes</button>
</footer>
</div>
</dialog>Installation
pnpm dlx loseta add drawernpx loseta add drawerExamples
Large
<button type="button" class="btn" data-variant="outline">
Open large drawer
</button>
<dialog class="drawer" id="demo-drawer-large" data-side="block-end" data-size="lg" aria-labelledby="drawer-large-title" aria-describedby="drawer-large-description">
<div>
<span data-slot="handle" aria-hidden="true"></span>
<header>
<h2 data-slot="title" id="drawer-large-title">Filters</h2>
<p data-slot="description" id="drawer-large-description">Narrow the results to the records you need.</p>
</header>
<section>
<div class="field">
<label class="label" for="drawer-large-query">Search</label>
<input class="input" id="drawer-large-query" placeholder="Name, owner or status">
</div>
</section>
<footer>
<button type="button" class="btn" data-variant="outline">Reset</button>
<button type="button" class="btn">Apply</button>
</footer>
</div>
</dialog>Small
<button type="button" class="btn" data-variant="outline">
Open small drawer
</button>
<dialog class="drawer" id="demo-drawer-small" data-side="block-end" data-size="sm" aria-labelledby="drawer-small-title" aria-describedby="drawer-small-description">
<div>
<span data-slot="handle" aria-hidden="true"></span>
<header>
<h2 data-slot="title" id="drawer-small-title">Quick action</h2>
<p data-slot="description" id="drawer-small-description">Confirm the action without leaving the page.</p>
</header>
<section>
<p>The small size keeps a short confirmation within reach.</p>
</section>
<footer>
<button type="button" class="btn" data-variant="outline">Cancel</button>
<button type="button" class="btn">Confirm</button>
</footer>
</div>
</dialog>Top
<button type="button" class="btn" data-variant="outline">
Open top drawer
</button>
<dialog class="drawer" id="demo-drawer-top" data-side="block-start" aria-labelledby="drawer-top-title" aria-describedby="drawer-top-description">
<div>
<header>
<h2 data-slot="title" id="drawer-top-title">Notifications</h2>
<p data-slot="description" id="drawer-top-description">Anchored to the block start edge, with the handle at the bottom.</p>
</header>
<section>
<p>Use a top drawer for a short announcement or a wide filter bar.</p>
</section>
<footer>
<button type="button" class="btn" data-variant="outline">Close</button>
</footer>
<span data-slot="handle" aria-hidden="true"></span>
</div>
</dialog>Scrollable content
<button type="button" class="btn" data-variant="outline">
Open scrollable drawer
</button>
<dialog class="drawer" id="demo-drawer-scrollable" data-side="block-end" aria-labelledby="drawer-scrollable-title" aria-describedby="drawer-scrollable-description">
<div>
<span data-slot="handle" aria-hidden="true"></span>
<header>
<h2 data-slot="title" id="drawer-scrollable-title">Scrollable content</h2>
<p data-slot="description" id="drawer-scrollable-description">The header and footer stay in place while the section scrolls.</p>
</header>
<section role="region" aria-label="Scrollable drawer content" tabindex="0">
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
</section>
<footer>
<button type="button" class="btn" data-variant="outline">Close</button>
</footer>
</div>
</dialog>Nested
<button type="button" class="btn" data-variant="outline">
Open drawer
</button>
<dialog class="drawer" id="demo-drawer-nested" data-side="block-end" aria-labelledby="drawer-nested-title" aria-describedby="drawer-nested-description">
<div>
<span data-slot="handle" aria-hidden="true"></span>
<header>
<h2 data-slot="title" id="drawer-nested-title">Drawer</h2>
<p data-slot="description" id="drawer-nested-description">Open another drawer from inside this one.</p>
</header>
<section>
<p>The parent drawer stays mounted behind the nested drawer.</p>
</section>
<footer>
<button type="button" class="btn" data-variant="outline">Open nested drawer</button>
<button type="button" class="btn">Close</button>
</footer>
<dialog class="drawer" id="demo-drawer-nested-child" data-side="block-end" aria-labelledby="drawer-nested-child-title" aria-describedby="drawer-nested-child-description">
<div>
<span data-slot="handle" aria-hidden="true"></span>
<header>
<h2 data-slot="title" id="drawer-nested-child-title">Nested drawer</h2>
<p data-slot="description" id="drawer-nested-child-description">This drawer stacks above the parent.</p>
</header>
<section>
<p>Close this drawer to return to the parent.</p>
</section>
<footer>
<button type="button" class="btn">Close</button>
</footer>
</div>
</dialog>
</div>
</dialog>Without handle
No handle
The handle is optional. Leave it out when drag gestures are not part of the flow.
Use the footer actions or Escape to dismiss the drawer.
<button type="button" class="btn" data-variant="outline">
Open drawer without handle
</button>
<dialog class="drawer" id="demo-drawer-no-handle" data-side="block-end" aria-labelledby="drawer-no-handle-title" aria-describedby="drawer-no-handle-description">
<div>
<header>
<h2 data-slot="title" id="drawer-no-handle-title">No handle</h2>
<p data-slot="description" id="drawer-no-handle-description">The handle is optional. Leave it out when drag gestures are not part of the flow.</p>
</header>
<section>
<p>Use the footer actions or Escape to dismiss the drawer.</p>
</section>
<footer>
<button type="button" class="btn">Close</button>
</footer>
</div>
</dialog>Right-to-left
تعديل الملف الشخصي
أجرِ تغييرات على ملفك الشخصي هنا.
<div dir="rtl" lang="ar">
<button type="button" class="btn" data-variant="outline">
فتح الدرج
</button>
<dialog class="drawer" id="demo-drawer-rtl" data-side="block-end" aria-labelledby="drawer-rtl-title" aria-describedby="drawer-rtl-description">
<div>
<span data-slot="handle" aria-hidden="true"></span>
<header>
<h2 data-slot="title" id="drawer-rtl-title">تعديل الملف الشخصي</h2>
<p data-slot="description" id="drawer-rtl-description">أجرِ تغييرات على ملفك الشخصي هنا.</p>
</header>
<section>
<div class="field">
<label class="label" for="drawer-rtl-name">الاسم</label>
<input class="input" id="drawer-rtl-name" value="ليلى حسن">
</div>
</section>
<footer>
<button type="button" class="btn" data-variant="outline">إلغاء</button>
<button type="button" class="btn">حفظ التغييرات</button>
</footer>
</div>
</dialog>
</div>Accessibility and behavior
- Native <dialog> with data-side="block-end" or "block-start". CSS only handles presentation; call showModal() and close(). The handle is optional [data-slot="handle"]; drag gestures are consumer JavaScript. data-size="sm" and "lg" set a 50vh or 90vh height; the default sizes to content up to 80vh. A section scrolls between the header and footer; a scrolling section without focusable content needs role="region", an accessible name and tabindex="0".
Files
components/drawer.cssbasestyles/nova/drawer.cssstyleInstall contract
The CLI writes the base file under components/, the visual file for the selected style under styles/<name>/, and any primitive dependency underprimitives/. The generated index.css imports them in the right layer order.