Account picker
Offer a touch-friendly choice panel from the bottom edge.
Components / Overlays
A bottom sheet for focused choices, with a drag handle and directional swipe to dismiss.
Last changed in version 0.13.0: Add avatar groups and chips, expand the block gallery, and improve component colors, spacing, and motion.
bunx --bun @getweini/cli@latest add drawerImport the files copied by the install command, then place the component in your Vue template. The text and values in the example belong to your app; change them to fit your task.
<script setup lang="ts">
import Drawer from './components/ui/drawer/Drawer.vue'
import DrawerBody from './components/ui/drawer/DrawerBody.vue'
import DrawerClose from './components/ui/drawer/DrawerClose.vue'
import DrawerContent from './components/ui/drawer/DrawerContent.vue'
import DrawerHandle from './components/ui/drawer/DrawerHandle.vue'
import DrawerHeader from './components/ui/drawer/DrawerHeader.vue'
import DrawerTitle from './components/ui/drawer/DrawerTitle.vue'
import DrawerTrigger from './components/ui/drawer/DrawerTrigger.vue'
</script>
<template>
<Drawer>
<DrawerTrigger>Open details</DrawerTrigger>
<DrawerContent>
<DrawerHandle />
<DrawerHeader><DrawerTitle>Details</DrawerTitle></DrawerHeader>
<DrawerBody><p>Put your details here.</p></DrawerBody>
<DrawerClose>Close</DrawerClose>
</DrawerContent>
</Drawer>
</template>Drag the handle toward the attached edge to dismiss. The distance threshold defaults to 25% of the drawer (at least 96px), or a faster swipe can close it sooner. You can also dismiss with Escape or an explicit close button.
Offer a touch-friendly choice panel from the bottom edge.
Use a handle for an explicitly selected swipe-to-dismiss surface.
The handle is a separate drag target above the header.
<script setup lang="ts">
import Button from './components/ui/button/Button.vue'
import Drawer from './components/ui/drawer/Drawer.vue'
import DrawerBody from './components/ui/drawer/DrawerBody.vue'
import DrawerClose from './components/ui/drawer/DrawerClose.vue'
import DrawerContent from './components/ui/drawer/DrawerContent.vue'
import DrawerHandle from './components/ui/drawer/DrawerHandle.vue'
import DrawerHeader from './components/ui/drawer/DrawerHeader.vue'
import DrawerTitle from './components/ui/drawer/DrawerTitle.vue'
import DrawerTrigger from './components/ui/drawer/DrawerTrigger.vue'
</script>
<template>
<Drawer>
<DrawerTrigger>Choose account</DrawerTrigger>
<DrawerContent>
<DrawerHandle />
<DrawerHeader><DrawerTitle>Accounts</DrawerTitle></DrawerHeader>
<DrawerBody>
<Button variant="outline" @click="$emit('choose', 'personal')">Personal</Button>
</DrawerBody>
<DrawerClose>Cancel</DrawerClose>
</DrawerContent>
</Drawer>
</template>Raise the threshold for a drawer with long scrolling content.
<script setup lang="ts">
import Drawer from './components/ui/drawer/Drawer.vue'
import DrawerBody from './components/ui/drawer/DrawerBody.vue'
import DrawerClose from './components/ui/drawer/DrawerClose.vue'
import DrawerContent from './components/ui/drawer/DrawerContent.vue'
import DrawerFooter from './components/ui/drawer/DrawerFooter.vue'
import DrawerHandle from './components/ui/drawer/DrawerHandle.vue'
import DrawerHeader from './components/ui/drawer/DrawerHeader.vue'
import DrawerTitle from './components/ui/drawer/DrawerTitle.vue'
import DrawerTrigger from './components/ui/drawer/DrawerTrigger.vue'
</script>
<template>
<Drawer>
<DrawerTrigger>Review order</DrawerTrigger>
<DrawerContent :dismiss-threshold="0.4">
<DrawerHandle />
<DrawerHeader><DrawerTitle>Review order</DrawerTitle></DrawerHeader>
<DrawerBody><p>Order summary and delivery details.</p></DrawerBody>
<DrawerFooter><DrawerClose>Close review</DrawerClose></DrawerFooter>
</DrawerContent>
</Drawer>
</template>Every public prop, model, event, slot, and exposed member of the installed Vue parts is listed below. “Not set” means you can leave that value out; “Required” means you must provide it. Native HTML attributes also work where the component uses a native element.
| Name | Type or signature | Default | What it does |
|---|---|---|---|
openmodel | boolean | undefined | Not set | Current open state. Use v-model:open to keep it in sync with your page. |
defaultOpenprop | boolean | undefined | false | Starting open state when the parent does not control open. |
disabledprop | boolean | undefined | false | Prevent interaction and show the disabled state. |
update:openevent | [open: boolean] | — | Requests a new open value from the parent. |
openChangeevent | [open: boolean] | — | Emitted after this value or state changes. |
defaultslot | () => unknown | Required | Content shown inside Drawer. |
openexposed | () => void | undefined | — | Open this component from application code. |
closeexposed | () => void | undefined | — | Close this component from application code. |
| Name | Type or signature | Default | What it does |
|---|---|---|---|
defaultslot | {} | Optional | Content shown inside DrawerBody. |
| Name | Type or signature | Default | What it does |
|---|---|---|---|
asChildprop | boolean | undefined | Not set | Use one child element as the control instead of adding another wrapper. |
defaultslot | {} | Optional | Content shown inside DrawerClose. |
| Name | Type or signature | Default | What it does |
|---|---|---|---|
dismissThresholdprop | number | undefined | 0.25 | Distance a gesture must move before it dismisses this surface. |
velocityThresholdprop | number | undefined | 0.5 | Minimum gesture speed needed to dismiss this surface. |
sideprop | SheetSide | undefined | "bottom" | Choose the side on which this content appears. |
dismissOnBackdropprop | boolean | undefined | true | Allow a click outside the dialog content to close it. |
defaultslot | (props: { close: () => void; }) => unknown | Required | Content shown inside DrawerContent. |
| Name | Type or signature | Default | What it does |
|---|---|---|---|
defaultslot | {} | Optional | Content shown inside DrawerDescription. |
| Name | Type or signature | Default | What it does |
|---|---|---|---|
defaultslot | {} | Optional | Content shown inside DrawerFooter. |
| Name | Type or signature | Default | What it does |
|---|
| Name | Type or signature | Default | What it does |
|---|---|---|---|
defaultslot | {} | Optional | Content shown inside DrawerHeader. |
| Name | Type or signature | Default | What it does |
|---|---|---|---|
defaultslot | {} | Optional | Content shown inside DrawerTitle. |
| Name | Type or signature | Default | What it does |
|---|---|---|---|
disabledprop | boolean | undefined | false | Prevent interaction and show the disabled state. |
asChildprop | boolean | undefined | Not set | Use one child element as the control instead of adding another wrapper. |
defaultslot | {} | Optional | Content shown inside DrawerTrigger. |
// packages/frameworks/vue/components/drawer/types.ts
import type { SheetContentProps, SheetProps, SheetTriggerProps } from '../sheet/types'
// ------- TYPES -------
export interface DrawerProps extends SheetProps {}
export interface DrawerTriggerProps extends SheetTriggerProps {}
export interface DrawerContentProps extends SheetContentProps {
dismissThreshold?: number
velocityThreshold?: number
}
// packages/frameworks/vue/components/sheet/types.ts
import type { DialogProps, DialogTriggerProps } from '../dialog/types'
// ------- TYPES -------
export type SheetSide = 'top' | 'right' | 'bottom' | 'left'
export interface SheetProps extends DialogProps {}
export interface SheetTriggerProps extends DialogTriggerProps {}
export interface SheetContentProps {
side?: SheetSide
dismissOnBackdrop?: boolean
}
// packages/frameworks/vue/components/dialog/types.ts
// ------- TYPES -------
export type DialogSize = 'sm' | 'md' | 'lg' | 'xl'
export interface DialogProps {
open?: boolean
defaultOpen?: boolean
disabled?: boolean
}
export interface DialogContentProps {
fullscreen?: boolean
size?: DialogSize
dismissOnBackdrop?: boolean
persistent?: boolean
}
export interface DialogTriggerProps {
disabled?: boolean
asChild?: boolean
}
export interface DialogCloseProps {
asChild?: boolean
}