quasar
Version:
Build high-performance VueJS user interfaces (SPA, PWA, SSR, Mobile and Desktop) in record time
259 lines • 7.24 kB
JSON
{
"type": "component",
"meta": {
"docsUrl": "https://v2.quasar.dev/vue-components/dialog"
},
"props": {
"transition-show": {
"type": "String",
"desc": "One of Quasar's embedded transitions",
"examples": [
"fade",
"slide-down"
],
"category": "transition",
"default": "fade",
"required": false
},
"transition-hide": {
"type": "String",
"desc": "One of Quasar's embedded transitions",
"examples": [
"fade",
"slide-down"
],
"category": "transition",
"default": "fade",
"required": false
},
"transition-duration": {
"type": [
"String",
"Number"
],
"desc": "Transition duration (in milliseconds, without unit)",
"default": 300,
"category": "transition",
"required": false
},
"model-value": {
"type": "Boolean",
"desc": "Model of the component defining shown/hidden state; Either use this property (along with a listener for 'update:model-value' event) OR use v-model directive",
"category": "model"
},
"persistent": {
"type": "Boolean",
"desc": "User cannot dismiss Dialog if clicking outside of it or hitting ESC key; Also, an app route change won't dismiss it",
"category": "behavior"
},
"no-esc-dismiss": {
"type": "Boolean",
"desc": "User cannot dismiss Dialog by hitting ESC key; No need to set it if 'persistent' prop is also set",
"category": "behavior"
},
"no-backdrop-dismiss": {
"type": "Boolean",
"desc": "User cannot dismiss Dialog by clicking outside of it; No need to set it if 'persistent' prop is also set",
"category": "behavior"
},
"no-route-dismiss": {
"type": "Boolean",
"desc": "Changing route app won't dismiss Dialog; No need to set it if 'persistent' prop is also set",
"category": "behavior"
},
"auto-close": {
"type": "Boolean",
"desc": "Any click/tap inside of the dialog will close it",
"category": "behavior"
},
"seamless": {
"type": "Boolean",
"desc": "Put Dialog into seamless mode; Does not use a backdrop so user is able to interact with the rest of the page too",
"category": "content"
},
"maximized": {
"type": "Boolean",
"desc": "Put Dialog into maximized mode",
"category": "content"
},
"full-width": {
"type": "Boolean",
"desc": "Dialog will try to render with same width as the window",
"category": "content"
},
"full-height": {
"type": "Boolean",
"desc": "Dialog will try to render with same height as the window",
"category": "content"
},
"position": {
"type": "String",
"desc": "Stick dialog to one of the sides (top, right, bottom or left)",
"default": "standard",
"values": [
"standard",
"top",
"right",
"bottom",
"left"
],
"category": "content",
"required": false
},
"square": {
"type": "Boolean",
"desc": "Forces content to have squared borders",
"category": "style"
},
"no-refocus": {
"type": "Boolean",
"desc": "(Accessibility) When Dialog gets hidden, do not refocus on the DOM element that previously had focus",
"category": "behavior"
},
"no-focus": {
"type": "Boolean",
"desc": "(Accessibility) When Dialog gets shown, do not switch focus on it",
"category": "behavior"
},
"no-shake": {
"type": "Boolean",
"desc": "Do not shake up the Dialog to catch user's attention",
"category": "behavior",
"addedIn": "v2.1.1"
},
"allow-focus-outside": {
"type": "Boolean",
"desc": "Allow elements outside of the Dialog to be focusable; By default, for accessibility reasons, QDialog does not allow outer focus",
"category": "behavior",
"addedIn": "v2.7.2"
}
},
"slots": {
"default": {
"desc": "Default slot in the devland unslotted content of the component"
}
},
"events": {
"update:model-value": {
"desc": "Emitted when showing/hidden state changes; Is also used by v-model",
"params": {
"value": {
"type": "Boolean",
"desc": "New state (showing/hidden)"
}
}
},
"show": {
"desc": "Emitted after component has triggered show()",
"params": {
"evt": {
"type": "Event",
"desc": "JS event object",
"required": true
}
}
},
"before-show": {
"desc": "Emitted when component triggers show() but before it finishes doing it",
"params": {
"evt": {
"type": "Event",
"desc": "JS event object",
"required": true
}
}
},
"hide": {
"desc": "Emitted after component has triggered hide()",
"params": {
"evt": {
"type": "Event",
"desc": "JS event object",
"required": true
}
}
},
"before-hide": {
"desc": "Emitted when component triggers hide() but before it finishes doing it",
"params": {
"evt": {
"type": "Event",
"desc": "JS event object",
"required": true
}
}
},
"shake": {
"desc": "Emitted when the Dialog shakes in order to catch user's attention, unless the 'no-shake' property is set"
},
"escape-key": {
"desc": "Emitted when ESC key is pressed; Does not get emitted if Dialog is 'persistent' or it has 'no-esc-key' set"
}
},
"methods": {
"show": {
"desc": "Triggers component to show",
"params": {
"evt": {
"type": "Event",
"desc": "JS event object",
"required": false
}
}
},
"hide": {
"desc": "Triggers component to hide",
"params": {
"evt": {
"type": "Event",
"desc": "JS event object",
"required": false
}
}
},
"toggle": {
"params": {
"evt": {
"type": "Event",
"desc": "JS event object",
"required": false
}
},
"desc": "Triggers component to toggle between show/hide"
},
"focus": {
"desc": "Focus dialog; if you have content with autofocus attribute, it will directly focus it",
"params": {
"selector": {
"type": "String",
"required": false,
"desc": "Optional CSS selector to override default focusable element",
"examples": [
"[tabindex]:not([tabindex=\"-1\"])"
],
"addedIn": "v2.6.5"
}
}
},
"shake": {
"desc": "Shakes dialog",
"params": {
"focusTarget": {
"type": "Element",
"desc": "Optional DOM Element to be focused after shake",
"examples": [
"document.getElementById('example')"
],
"addedIn": "v2.10.1"
}
}
}
},
"computedProps": {
"contentEl": {
"type": "Element",
"desc": "The DOM Element of the rendered content",
"addedIn": "v2.10.1"
}
}
}