SoybeanUI is now VeanUIMigration guidePackages moved to @vean/aria and @vean/ui, and the docs moved to veanui.com.This site redirects in Nov 2026; the @soybeanjs packages are deprecated in Apr 2027.
Components
Back to catalog
Component detail entry
Overlay
@soybeanjs/ui
SDialog

Dialog

Dialog belongs to the Overlay category. Start with demos and usage, then use the API tables to finish integration and styling decisions.

Use the quick jump panel to reach overview, usage, demos, and API first, then continue through the full page.

Quick jump

Related components

If you are composing interactions in the same family, these components usually pair well together.

Changelog

Version history is grouped by release so you can quickly see what changed for this component across published versions.

v0.40.0

2026-09-14

Compare release

Fix

label the icon-only close trigger via locale

Scope: dialogAuthors: soybeanfeView commitabe07

Fix

restore fullscreen toggle visible by default

Scope: dialogAuthors: soybeanfeView commit600a0

Fix

hide fullscreen toggle by default

Scope: dialogAuthors: soybeanfeView commit3ae1c

Refactor

remove redundant showFullscreen default

Scope: dialogAuthors: soybeanfeView commit956d7

Fix

label the icon-only close trigger via locale

Scope: dialogAuthors: soybeanfeView commitabe07

v0.30.0

2026-08-20

Compare release

Feature

add fullscreen and draggable features

Scope: dialogAuthors: soybeanjsView commitfac2c

Feature

add fullscreen and draggable features

Scope: dialogAuthors: soybeanjsView commitfac2c

v0.22.3

2026-05-17

Compare release

Fix

adjust popup max height for better responsiveness

Scope: dialogAuthors: soybeanfeView commit9e115

v0.17.0

2026-05-03

Compare release

Optimization

rename DialogRootProps to extend DialogBaseProps for consistency

Scope: dialogAuthors: soybeanjsView commit7b052

v0.15.0

2026-04-26

Compare release

Breaking

Implement DialogCompact and refactor `useDialog`

Scope: dialogAuthors: soybeanjsView commit39019

Feature

enable showConfirm prop in DialogCompact component

Scope: dialogAuthors: soybeanfeView commite8a13

Optimization

enhance slot props binding for DialogCompact component

Scope: dialogAuthors: soybeanfeView commita3c2d

Breaking

Implement DialogCompact and refactor `useDialog`

Scope: dialogAuthors: soybeanjsView commit39019

Feature

enable showConfirm prop in DialogCompact component

Scope: dialogAuthors: soybeanfeView commite8a13

Optimization

enhance slot props binding for DialogCompact component

Scope: dialogAuthors: soybeanfeView commita3c2d

v0.13.8

2026-03-24

Compare release

Fix

update content styles for responsive design

Scope: dialogAuthors: soybeanjsView commit77fa2

v0.12.1

2026-03-07

Compare release

Optimization

update dialog content styles to use w-max for better responsiveness

Scope: dialogAuthors: soybeanjsView commiteb13c

v0.11.4

2026-03-06

Compare release

Feature

add min-width constraints to dialog content sizes

Scope: dialogAuthors: soybeanjsView commit9a5e1

v0.11.3

2026-03-06

Compare release

Feature

update max-width for dialog size variants

Scope: dialogAuthors: soybeanjsView commit417a0

v0.11.2

2026-03-06

Compare release

Feature

add class prop to bind content class

Scope: dialogAuthors: soybeanjsView commit1e779

v0.10.3

2026-03-06

Compare release

Fix

remove unnecessary sm: prefix from rounded-lg class

Scope: dialogAuthors: soybeanjsView commit30fd6

v0.0.8

2026-01-01

Compare release

Refactor

replace DialogContent with DialogPopup, and update related types and context management for improved structure and functionality

Scope: dialogAuthors: soybeanjsView commit4d82e

Refactor

rename DialogPopup to DialogContent

Scope: dialogAuthors: soybeanjsView commite0796

v0.0.2

2025-11-18

Compare release

Feature

implement dialog component with context management and accessibility features

Scope: dialogAuthors: soybeanjsView commitadfcc

Feature

introduce DialogContentImpl component for improved focus management and dismissable layer functionality

Scope: dialogAuthors: soybeanjsView commit8861f

Feature

integrate useHideOthers composable for improved accessibility and focus management

Scope: dialogAuthors: soybeanjsView commit1139a

Feature

add dialog example component showcasing usage of DialogRoot, DialogTrigger, and related elements

Scope: dialogAuthors: soybeanjsView commite08d4

Feature

expose closeModal function in dialog slot for improved control

Scope: dialogAuthors: soybeanjsView commit2f005

Feature

introduce DialogThemeContext for theming support and add DialogHeader and DialogFooter components

Scope: dialogAuthors: soybeanjsView commitf2b65

Feature

add Dialog component and related context, close, and types for enhanced dialog functionality

Scope: dialogAuthors: soybeanjsView commit8378a

Feature

add multiple dialog examples with default, footer, state control, and prevent close functionality

Scope: dialogAuthors: soybeanjsView commit9bdd9

Feature

add SDialogPure component with customizable properties and variants

Scope: dialogAuthors: soybeanjsView commit5ff73

Feature

add beforeClose prop to DialogClose component to control closing behavior

Scope: dialogAuthors: soybeanjsView commit35bd1

Feature

update beforeClose prop to allow returning void in Dialog and AlertDialog components

Scope: dialogAuthors: soybeanjsView commitf295b

Feature

implement useDialog composable and integrate DialogProvider for enhanced dialog management

Scope: dialogAuthors: soybeanjsView commit2041c

Fix

adjust closeIcon positioning and add outline-none to dialog content for improved accessibility and visual consistency

Scope: dialogAuthors: soybeanjsView commit40fc9

Fix

remove unused theme context and update DialogClose class binding

Scope: dialogAuthors: soybeanjsView commitbe3ae

Optimization

update DialogClose component to use theme context and rename closeIcon to closable

Scope: dialogAuthors: soybeanjsView commit82210

Refactor

update dialog component to use v-bind for dismissable layer and focus scope props

Scope: dialogAuthors: soybeanjsView commitceba2

Refactor

replace closeModal with onOpenChange for improved dialog state management

Scope: dialogAuthors: soybeanjsView commit430be

Refactor

simplify dialog component structure by removing unused imports and enhancing focus management

Scope: dialogAuthors: soybeanjsView commit5072c

Refactor

streamline dialog component structure by updating prop bindings and consolidating context imports

Scope: dialogAuthors: soybeanjsView commita4447

Refactor

restructure dialog context and provider, removing legacy code and enhancing dialog management

Scope: dialogAuthors: soybeanjsView commitde4f2

Feature

add beforeClose prop to DialogClose component to control closing behavior

Scope: dialogAuthors: soybeanjsView commit35bd1

Feature

update beforeClose prop to allow returning void in Dialog and AlertDialog components

Scope: dialogAuthors: soybeanjsView commitf295b

Feature

implement useDialog composable and integrate DialogProvider for enhanced dialog management

Scope: dialogAuthors: soybeanjsView commit2041c

Refactor

restructure dialog context and provider, removing legacy code and enhancing dialog management

Scope: dialogAuthors: soybeanjsView commitde4f2

Feature

implement dialog component with context management and accessibility features

Scope: dialogAuthors: soybeanjsView commitadfcc

Feature

introduce DialogContentImpl component for improved focus management and dismissable layer functionality

Scope: dialogAuthors: soybeanjsView commit8861f

Feature

integrate useHideOthers composable for improved accessibility and focus management

Scope: dialogAuthors: soybeanjsView commit1139a

Feature

add dialog example component showcasing usage of DialogRoot, DialogTrigger, and related elements

Scope: dialogAuthors: soybeanjsView commite08d4

Feature

expose closeModal function in dialog slot for improved control

Scope: dialogAuthors: soybeanjsView commit2f005

Feature

introduce DialogThemeContext for theming support and add DialogHeader and DialogFooter components

Scope: dialogAuthors: soybeanjsView commitf2b65

Feature

add Dialog component and related context, close, and types for enhanced dialog functionality

Scope: dialogAuthors: soybeanjsView commit8378a

Feature

add multiple dialog examples with default, footer, state control, and prevent close functionality

Scope: dialogAuthors: soybeanjsView commit9bdd9

Feature

add SDialogPure component with customizable properties and variants

Scope: dialogAuthors: soybeanjsView commit5ff73

Fix

adjust closeIcon positioning and add outline-none to dialog content for improved accessibility and visual consistency

Scope: dialogAuthors: soybeanjsView commit40fc9

Fix

remove unused theme context and update DialogClose class binding

Scope: dialogAuthors: soybeanjsView commitbe3ae

Optimization

update DialogClose component to use theme context and rename closeIcon to closable

Scope: dialogAuthors: soybeanjsView commit82210

Refactor

update dialog component to use v-bind for dismissable layer and focus scope props

Scope: dialogAuthors: soybeanjsView commitceba2

Refactor

replace closeModal with onOpenChange for improved dialog state management

Scope: dialogAuthors: soybeanjsView commit430be

Refactor

simplify dialog component structure by removing unused imports and enhancing focus management

Scope: dialogAuthors: soybeanjsView commit5072c

Refactor

streamline dialog component structure by updating prop bindings and consolidating context imports

Scope: dialogAuthors: soybeanjsView commita4447