3 <html lang=
"en" class=
"no-js">
7 <meta name=
"viewport" content=
"width=device-width,initial-scale=1">
11 <link rel=
"canonical" href=
"https://docs.woltlab.com/6.0/javascript/new-api_dialogs/">
14 <link rel=
"prev" href=
"../new-api_ajax/">
17 <link rel=
"next" href=
"../new-api_browser/">
19 <link rel=
"icon" href=
"../../assets/default.favicon.ico">
20 <meta name=
"generator" content=
"mkdocs-1.4.2, mkdocs-material-9.0.13">
24 <title>Dialogs - WoltLab Suite Documentation
</title>
28 <link rel=
"stylesheet" href=
"../../assets/stylesheets/main.ffa9267a.min.css">
31 <link rel=
"stylesheet" href=
"../../assets/stylesheets/palette.a0c5b2b5.min.css">
41 <link rel=
"stylesheet" href=
"../../stylesheets/extra.css">
43 <script>__md_scope=new URL(
"../..",location),__md_hash=e=
>[...e].reduce((e,_)=
>(e<
<5)-e+_.charCodeAt(
0),
0),__md_get=(e,_=localStorage,t=__md_scope)=
>JSON.parse(_.getItem(t.pathname+
"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=
>{try{t.setItem(a.pathname+
"."+e,JSON.stringify(_))}catch(e){}}
</script>
58 <body dir=
"ltr" data-md-color-scheme=
"default" data-md-color-primary=
"teal" data-md-color-accent=
"">
62 <input class=
"md-toggle" data-md-toggle=
"drawer" type=
"checkbox" id=
"__drawer" autocomplete=
"off">
63 <input class=
"md-toggle" data-md-toggle=
"search" type=
"checkbox" id=
"__search" autocomplete=
"off">
64 <label class=
"md-overlay" for=
"__drawer"></label>
65 <div data-md-component=
"skip">
68 <a href=
"#dialogs-javascript-api" class=
"md-skip">
73 <div data-md-component=
"announce">
75 <aside class=
"md-banner">
76 <div class=
"md-banner__inner md-grid md-typeset">
79 <a href=
"https://www.woltlab.com">Back to
<strong>woltlab.com
</strong></a>
87 <div data-md-color-scheme=
"default" data-md-component=
"outdated" hidden
>
94 <header class=
"md-header" data-md-component=
"header">
95 <nav class=
"md-header__inner md-grid" aria-label=
"Header">
96 <a href=
"../.." title=
"WoltLab Suite Documentation" class=
"md-header__button md-logo" aria-label=
"WoltLab Suite Documentation" data-md-component=
"logo">
98 <img src=
"../../assets/logo.png" alt=
"logo">
101 <label class=
"md-header__button md-icon" for=
"__drawer">
102 <svg xmlns=
"http://www.w3.org/2000/svg" viewBox=
"0 0 24 24"><path d=
"M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
104 <div class=
"md-header__title" data-md-component=
"header-title">
105 <div class=
"md-header__ellipsis">
106 <div class=
"md-header__topic">
107 <span class=
"md-ellipsis">
108 WoltLab Suite Documentation
111 <div class=
"md-header__topic" data-md-component=
"header-topic">
112 <span class=
"md-ellipsis">
123 <label class=
"md-header__button md-icon" for=
"__search">
124 <svg xmlns=
"http://www.w3.org/2000/svg" viewBox=
"0 0 24 24"><path d=
"M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
126 <div class=
"md-search" data-md-component=
"search" role=
"dialog">
127 <label class=
"md-search__overlay" for=
"__search"></label>
128 <div class=
"md-search__inner" role=
"search">
129 <form class=
"md-search__form" name=
"search">
130 <input type=
"text" class=
"md-search__input" name=
"query" aria-label=
"Search" placeholder=
"Search" autocapitalize=
"off" autocorrect=
"off" autocomplete=
"off" spellcheck=
"false" data-md-component=
"search-query" required
>
131 <label class=
"md-search__icon md-icon" for=
"__search">
132 <svg xmlns=
"http://www.w3.org/2000/svg" viewBox=
"0 0 24 24"><path d=
"M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
133 <svg xmlns=
"http://www.w3.org/2000/svg" viewBox=
"0 0 24 24"><path d=
"M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
135 <nav class=
"md-search__options" aria-label=
"Search">
137 <button type=
"reset" class=
"md-search__icon md-icon" title=
"Clear" aria-label=
"Clear" tabindex=
"-1">
138 <svg xmlns=
"http://www.w3.org/2000/svg" viewBox=
"0 0 24 24"><path d=
"M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
143 <div class=
"md-search__output">
144 <div class=
"md-search__scrollwrap" data-md-scrollfix
>
145 <div class=
"md-search-result" data-md-component=
"search-result">
146 <div class=
"md-search-result__meta">
149 <ol class=
"md-search-result__list" role=
"presentation"></ol>
157 <div class=
"md-header__source">
158 <a href=
"https://github.com/WoltLab/docs.woltlab.com/" title=
"Go to repository" class=
"md-source" data-md-component=
"source">
159 <div class=
"md-source__icon md-icon">
161 <svg xmlns=
"http://www.w3.org/2000/svg" viewBox=
"0 0 448 512"><!--! Font Awesome Free 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d=
"M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
163 <div class=
"md-source__repository">
173 <div class=
"md-container" data-md-component=
"container">
180 <main class=
"md-main" data-md-component=
"main">
181 <div class=
"md-main__inner md-grid">
185 <div class=
"md-sidebar md-sidebar--primary" data-md-component=
"sidebar" data-md-type=
"navigation" >
186 <div class=
"md-sidebar__scrollwrap">
187 <div class=
"md-sidebar__inner">
191 <nav class=
"md-nav md-nav--primary" aria-label=
"Navigation" data-md-level=
"0">
192 <label class=
"md-nav__title" for=
"__drawer">
193 <a href=
"../.." title=
"WoltLab Suite Documentation" class=
"md-nav__button md-logo" aria-label=
"WoltLab Suite Documentation" data-md-component=
"logo">
195 <img src=
"../../assets/logo.png" alt=
"logo">
198 WoltLab Suite Documentation
201 <div class=
"md-nav__source">
202 <a href=
"https://github.com/WoltLab/docs.woltlab.com/" title=
"Go to repository" class=
"md-source" data-md-component=
"source">
203 <div class=
"md-source__icon md-icon">
205 <svg xmlns=
"http://www.w3.org/2000/svg" viewBox=
"0 0 448 512"><!--! Font Awesome Free 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d=
"M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
207 <div class=
"md-source__repository">
213 <ul class=
"md-nav__list" data-md-scrollfix
>
222 <li class=
"md-nav__item">
223 <a href=
"../../getting-started/" class=
"md-nav__link">
238 <li class=
"md-nav__item md-nav__item--nested">
243 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_2" >
247 <label class=
"md-nav__link" for=
"__nav_2" id=
"__nav_2_label" tabindex=
"0">
249 <span class=
"md-nav__icon md-icon"></span>
252 <nav class=
"md-nav" data-md-level=
"1" aria-labelledby=
"__nav_2_label" aria-expanded=
"false">
253 <label class=
"md-nav__title" for=
"__nav_2">
254 <span class=
"md-nav__icon md-icon"></span>
257 <ul class=
"md-nav__list" data-md-scrollfix
>
264 <li class=
"md-nav__item">
265 <a href=
"../../php/pages/" class=
"md-nav__link">
278 <li class=
"md-nav__item">
279 <a href=
"../../php/database-objects/" class=
"md-nav__link">
292 <li class=
"md-nav__item">
293 <a href=
"../../php/database-access/" class=
"md-nav__link">
306 <li class=
"md-nav__item">
307 <a href=
"../../php/exceptions/" class=
"md-nav__link">
321 <li class=
"md-nav__item md-nav__item--nested">
326 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_2_5" >
330 <label class=
"md-nav__link" for=
"__nav_2_5" id=
"__nav_2_5_label" tabindex=
"0">
332 <span class=
"md-nav__icon md-icon"></span>
335 <nav class=
"md-nav" data-md-level=
"2" aria-labelledby=
"__nav_2_5_label" aria-expanded=
"false">
336 <label class=
"md-nav__title" for=
"__nav_2_5">
337 <span class=
"md-nav__icon md-icon"></span>
340 <ul class=
"md-nav__list" data-md-scrollfix
>
348 <li class=
"md-nav__item md-nav__item--nested">
353 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_2_5_1" >
357 <label class=
"md-nav__link" for=
"__nav_2_5_1" id=
"__nav_2_5_1_label" tabindex=
"0">
359 <span class=
"md-nav__icon md-icon"></span>
362 <nav class=
"md-nav" data-md-level=
"3" aria-labelledby=
"__nav_2_5_1_label" aria-expanded=
"false">
363 <label class=
"md-nav__title" for=
"__nav_2_5_1">
364 <span class=
"md-nav__icon md-icon"></span>
367 <ul class=
"md-nav__list" data-md-scrollfix
>
374 <li class=
"md-nav__item">
375 <a href=
"../../php/api/caches/" class=
"md-nav__link">
388 <li class=
"md-nav__item">
389 <a href=
"../../php/api/caches_persistent-caches/" class=
"md-nav__link">
402 <li class=
"md-nav__item">
403 <a href=
"../../php/api/caches_runtime-caches/" class=
"md-nav__link">
423 <li class=
"md-nav__item">
424 <a href=
"../../php/api/comments/" class=
"md-nav__link">
437 <li class=
"md-nav__item">
438 <a href=
"../../php/api/cronjobs/" class=
"md-nav__link">
451 <li class=
"md-nav__item">
452 <a href=
"../../php/api/events/" class=
"md-nav__link">
466 <li class=
"md-nav__item md-nav__item--nested">
471 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_2_5_5" >
475 <label class=
"md-nav__link" for=
"__nav_2_5_5" id=
"__nav_2_5_5_label" tabindex=
"0">
477 <span class=
"md-nav__icon md-icon"></span>
480 <nav class=
"md-nav" data-md-level=
"3" aria-labelledby=
"__nav_2_5_5_label" aria-expanded=
"false">
481 <label class=
"md-nav__title" for=
"__nav_2_5_5">
482 <span class=
"md-nav__icon md-icon"></span>
485 <ul class=
"md-nav__list" data-md-scrollfix
>
492 <li class=
"md-nav__item">
493 <a href=
"../../php/api/form_builder/overview/" class=
"md-nav__link">
506 <li class=
"md-nav__item">
507 <a href=
"../../php/api/form_builder/structure/" class=
"md-nav__link">
520 <li class=
"md-nav__item">
521 <a href=
"../../php/api/form_builder/form_fields/" class=
"md-nav__link">
534 <li class=
"md-nav__item">
535 <a href=
"../../php/api/form_builder/validation_data/" class=
"md-nav__link">
548 <li class=
"md-nav__item">
549 <a href=
"../../php/api/form_builder/dependencies/" class=
"md-nav__link">
569 <li class=
"md-nav__item">
570 <a href=
"../../php/api/package_installation_plugins/" class=
"md-nav__link">
571 Package Installation Plugins
583 <li class=
"md-nav__item">
584 <a href=
"../../php/api/user_activity_points/" class=
"md-nav__link">
597 <li class=
"md-nav__item">
598 <a href=
"../../php/api/user_notifications/" class=
"md-nav__link">
611 <li class=
"md-nav__item">
612 <a href=
"../../php/api/sitemaps/" class=
"md-nav__link">
632 <li class=
"md-nav__item">
633 <a href=
"../../php/code-style/" class=
"md-nav__link">
646 <li class=
"md-nav__item">
647 <a href=
"../../php/apps/" class=
"md-nav__link">
660 <li class=
"md-nav__item">
661 <a href=
"../../php/gdpr/" class=
"md-nav__link">
683 <li class=
"md-nav__item md-nav__item--nested">
688 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_3" >
692 <label class=
"md-nav__link" for=
"__nav_3" id=
"__nav_3_label" tabindex=
"0">
693 Languages, Templates & CSS
694 <span class=
"md-nav__icon md-icon"></span>
697 <nav class=
"md-nav" data-md-level=
"1" aria-labelledby=
"__nav_3_label" aria-expanded=
"false">
698 <label class=
"md-nav__title" for=
"__nav_3">
699 <span class=
"md-nav__icon md-icon"></span>
700 Languages, Templates & CSS
702 <ul class=
"md-nav__list" data-md-scrollfix
>
709 <li class=
"md-nav__item">
710 <a href=
"../../view/languages/" class=
"md-nav__link">
723 <li class=
"md-nav__item">
724 <a href=
"../../view/templates/" class=
"md-nav__link">
737 <li class=
"md-nav__item">
738 <a href=
"../../view/template-plugins/" class=
"md-nav__link">
751 <li class=
"md-nav__item">
752 <a href=
"../../view/css/" class=
"md-nav__link">
776 <li class=
"md-nav__item md-nav__item--active md-nav__item--nested">
781 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_4" checked
>
785 <label class=
"md-nav__link" for=
"__nav_4" id=
"__nav_4_label" tabindex=
"0">
786 TypeScript and JavaScript API
787 <span class=
"md-nav__icon md-icon"></span>
790 <nav class=
"md-nav" data-md-level=
"1" aria-labelledby=
"__nav_4_label" aria-expanded=
"true">
791 <label class=
"md-nav__title" for=
"__nav_4">
792 <span class=
"md-nav__icon md-icon"></span>
793 TypeScript and JavaScript API
795 <ul class=
"md-nav__list" data-md-scrollfix
>
802 <li class=
"md-nav__item">
803 <a href=
"../general-usage/" class=
"md-nav__link">
816 <li class=
"md-nav__item">
817 <a href=
"../typescript/" class=
"md-nav__link">
831 <li class=
"md-nav__item md-nav__item--nested">
836 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_4_3" >
840 <label class=
"md-nav__link" for=
"__nav_4_3" id=
"__nav_4_3_label" tabindex=
"0">
842 <span class=
"md-nav__icon md-icon"></span>
845 <nav class=
"md-nav" data-md-level=
"2" aria-labelledby=
"__nav_4_3_label" aria-expanded=
"false">
846 <label class=
"md-nav__title" for=
"__nav_4_3">
847 <span class=
"md-nav__icon md-icon"></span>
850 <ul class=
"md-nav__list" data-md-scrollfix
>
857 <li class=
"md-nav__item">
858 <a href=
"../components_confirmation/" class=
"md-nav__link">
871 <li class=
"md-nav__item">
872 <a href=
"../components_dialog/" class=
"md-nav__link">
885 <li class=
"md-nav__item">
886 <a href=
"../components_google_maps/" class=
"md-nav__link">
899 <li class=
"md-nav__item">
900 <a href=
"../components_pagination/" class=
"md-nav__link">
923 <li class=
"md-nav__item md-nav__item--active md-nav__item--nested">
928 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_4_4" checked
>
932 <label class=
"md-nav__link" for=
"__nav_4_4" id=
"__nav_4_4_label" tabindex=
"0">
934 <span class=
"md-nav__icon md-icon"></span>
937 <nav class=
"md-nav" data-md-level=
"2" aria-labelledby=
"__nav_4_4_label" aria-expanded=
"true">
938 <label class=
"md-nav__title" for=
"__nav_4_4">
939 <span class=
"md-nav__icon md-icon"></span>
942 <ul class=
"md-nav__list" data-md-scrollfix
>
949 <li class=
"md-nav__item">
950 <a href=
"../new-api_writing-a-module/" class=
"md-nav__link">
963 <li class=
"md-nav__item">
964 <a href=
"../new-api_core/" class=
"md-nav__link">
977 <li class=
"md-nav__item">
978 <a href=
"../new-api_dom/" class=
"md-nav__link">
991 <li class=
"md-nav__item">
992 <a href=
"../new-api_events/" class=
"md-nav__link">
1005 <li class=
"md-nav__item">
1006 <a href=
"../new-api_ajax/" class=
"md-nav__link">
1021 <li class=
"md-nav__item md-nav__item--active">
1023 <input class=
"md-nav__toggle md-toggle" type=
"checkbox" id=
"__toc">
1029 <label class=
"md-nav__link md-nav__link--active" for=
"__toc">
1031 <span class=
"md-nav__icon md-icon"></span>
1034 <a href=
"./" class=
"md-nav__link md-nav__link--active">
1040 <nav class=
"md-nav md-nav--secondary" aria-label=
"Table of contents">
1047 <label class=
"md-nav__title" for=
"__toc">
1048 <span class=
"md-nav__icon md-icon"></span>
1051 <ul class=
"md-nav__list" data-md-component=
"toc" data-md-scrollfix
>
1053 <li class=
"md-nav__item">
1054 <a href=
"#introduction" class=
"md-nav__link">
1060 <li class=
"md-nav__item">
1061 <a href=
"#_dialogsetup" class=
"md-nav__link">
1065 <nav class=
"md-nav" aria-label=
"_dialogSetup()">
1066 <ul class=
"md-nav__list">
1068 <li class=
"md-nav__item">
1069 <a href=
"#id-string" class=
"md-nav__link">
1075 <li class=
"md-nav__item">
1076 <a href=
"#source-any" class=
"md-nav__link">
1082 <li class=
"md-nav__item">
1083 <a href=
"#options-object" class=
"md-nav__link">
1087 <nav class=
"md-nav" aria-label=
"options: Object">
1088 <ul class=
"md-nav__list">
1090 <li class=
"md-nav__item">
1091 <a href=
"#optionsbackdropcloseonclick-boolean" class=
"md-nav__link">
1092 options.backdropCloseOnClick: boolean
1097 <li class=
"md-nav__item">
1098 <a href=
"#optionsclosable-boolean" class=
"md-nav__link">
1099 options.closable: boolean
1104 <li class=
"md-nav__item">
1105 <a href=
"#optionsclosebuttonlabel-string" class=
"md-nav__link">
1106 options.closeButtonLabel: string
1111 <li class=
"md-nav__item">
1112 <a href=
"#optionscloseconfirmmessage-string" class=
"md-nav__link">
1113 options.closeConfirmMessage: string
1118 <li class=
"md-nav__item">
1119 <a href=
"#optionstitle-string" class=
"md-nav__link">
1120 options.title: string
1125 <li class=
"md-nav__item">
1126 <a href=
"#optionsonbeforeclose-id-string-void" class=
"md-nav__link">
1127 options.onBeforeClose: (id: string) =
> void
1132 <li class=
"md-nav__item">
1133 <a href=
"#optionsonclose-id-string-void" class=
"md-nav__link">
1134 options.onClose: (id: string) =
> void
1139 <li class=
"md-nav__item">
1140 <a href=
"#optionsonshow-content-element-void" class=
"md-nav__link">
1141 options.onShow: (content: Element) =
> void
1156 <li class=
"md-nav__item">
1157 <a href=
"#settitleid-string-object-title-string" class=
"md-nav__link">
1158 setTitle(id: string | Object, title: string)
1163 <li class=
"md-nav__item">
1164 <a href=
"#setcallbackid-string-object-key-string-value-data-any-void-null" class=
"md-nav__link">
1165 setCallback(id: string | Object, key: string, value: (data: any) =
> void | null)
1170 <li class=
"md-nav__item">
1171 <a href=
"#rebuildid-string-object" class=
"md-nav__link">
1172 rebuild(id: string | Object)
1177 <li class=
"md-nav__item">
1178 <a href=
"#closeid-string-object" class=
"md-nav__link">
1179 close(id: string | Object)
1184 <li class=
"md-nav__item">
1185 <a href=
"#getdialogid-string-object-object" class=
"md-nav__link">
1186 getDialog(id: string | Object): Object
1191 <li class=
"md-nav__item">
1192 <a href=
"#isopenid-string-object-boolean" class=
"md-nav__link">
1193 isOpen(id: string | Object): boolean
1212 <li class=
"md-nav__item">
1213 <a href=
"../new-api_browser/" class=
"md-nav__link">
1214 Browser and Screen Sizes
1226 <li class=
"md-nav__item">
1227 <a href=
"../new-api_ui/" class=
"md-nav__link">
1247 <li class=
"md-nav__item">
1248 <a href=
"../legacy-api/" class=
"md-nav__link">
1261 <li class=
"md-nav__item">
1262 <a href=
"../code-snippets/" class=
"md-nav__link">
1284 <li class=
"md-nav__item md-nav__item--nested">
1289 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_5" >
1293 <label class=
"md-nav__link" for=
"__nav_5" id=
"__nav_5_label" tabindex=
"0">
1295 <span class=
"md-nav__icon md-icon"></span>
1298 <nav class=
"md-nav" data-md-level=
"1" aria-labelledby=
"__nav_5_label" aria-expanded=
"false">
1299 <label class=
"md-nav__title" for=
"__nav_5">
1300 <span class=
"md-nav__icon md-icon"></span>
1303 <ul class=
"md-nav__list" data-md-scrollfix
>
1310 <li class=
"md-nav__item">
1311 <a href=
"../../package/package-xml/" class=
"md-nav__link">
1325 <li class=
"md-nav__item md-nav__item--nested">
1330 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_5_2" >
1334 <label class=
"md-nav__link" for=
"__nav_5_2" id=
"__nav_5_2_label" tabindex=
"0">
1336 <span class=
"md-nav__icon md-icon"></span>
1339 <nav class=
"md-nav" data-md-level=
"2" aria-labelledby=
"__nav_5_2_label" aria-expanded=
"false">
1340 <label class=
"md-nav__title" for=
"__nav_5_2">
1341 <span class=
"md-nav__icon md-icon"></span>
1344 <ul class=
"md-nav__list" data-md-scrollfix
>
1351 <li class=
"md-nav__item">
1352 <a href=
"../../package/pip/" class=
"md-nav__link">
1365 <li class=
"md-nav__item">
1366 <a href=
"../../package/pip/acl-option/" class=
"md-nav__link">
1379 <li class=
"md-nav__item">
1380 <a href=
"../../package/pip/acp-menu/" class=
"md-nav__link">
1393 <li class=
"md-nav__item">
1394 <a href=
"../../package/pip/acp-search-provider/" class=
"md-nav__link">
1407 <li class=
"md-nav__item">
1408 <a href=
"../../package/pip/acp-template/" class=
"md-nav__link">
1421 <li class=
"md-nav__item">
1422 <a href=
"../../package/pip/acp-template-delete/" class=
"md-nav__link">
1435 <li class=
"md-nav__item">
1436 <a href=
"../../package/pip/bbcode/" class=
"md-nav__link">
1449 <li class=
"md-nav__item">
1450 <a href=
"../../package/pip/box/" class=
"md-nav__link">
1463 <li class=
"md-nav__item">
1464 <a href=
"../../package/pip/clipboard-action/" class=
"md-nav__link">
1477 <li class=
"md-nav__item">
1478 <a href=
"../../package/pip/core-object/" class=
"md-nav__link">
1491 <li class=
"md-nav__item">
1492 <a href=
"../../package/pip/cronjob/" class=
"md-nav__link">
1505 <li class=
"md-nav__item">
1506 <a href=
"../../package/pip/database/" class=
"md-nav__link">
1519 <li class=
"md-nav__item">
1520 <a href=
"../../package/pip/event-listener/" class=
"md-nav__link">
1533 <li class=
"md-nav__item">
1534 <a href=
"../../package/pip/file/" class=
"md-nav__link">
1547 <li class=
"md-nav__item">
1548 <a href=
"../../package/pip/file-delete/" class=
"md-nav__link">
1561 <li class=
"md-nav__item">
1562 <a href=
"../../package/pip/language/" class=
"md-nav__link">
1575 <li class=
"md-nav__item">
1576 <a href=
"../../package/pip/media-provider/" class=
"md-nav__link">
1589 <li class=
"md-nav__item">
1590 <a href=
"../../package/pip/menu/" class=
"md-nav__link">
1603 <li class=
"md-nav__item">
1604 <a href=
"../../package/pip/menu-item/" class=
"md-nav__link">
1617 <li class=
"md-nav__item">
1618 <a href=
"../../package/pip/object-type/" class=
"md-nav__link">
1631 <li class=
"md-nav__item">
1632 <a href=
"../../package/pip/object-type-definition/" class=
"md-nav__link">
1633 objectTypeDefinition
1645 <li class=
"md-nav__item">
1646 <a href=
"../../package/pip/option/" class=
"md-nav__link">
1659 <li class=
"md-nav__item">
1660 <a href=
"../../package/pip/page/" class=
"md-nav__link">
1673 <li class=
"md-nav__item">
1674 <a href=
"../../package/pip/pip/" class=
"md-nav__link">
1687 <li class=
"md-nav__item">
1688 <a href=
"../../package/pip/script/" class=
"md-nav__link">
1701 <li class=
"md-nav__item">
1702 <a href=
"../../package/pip/smiley/" class=
"md-nav__link">
1715 <li class=
"md-nav__item">
1716 <a href=
"../../package/pip/sql/" class=
"md-nav__link">
1729 <li class=
"md-nav__item">
1730 <a href=
"../../package/pip/style/" class=
"md-nav__link">
1743 <li class=
"md-nav__item">
1744 <a href=
"../../package/pip/template/" class=
"md-nav__link">
1757 <li class=
"md-nav__item">
1758 <a href=
"../../package/pip/template-delete/" class=
"md-nav__link">
1771 <li class=
"md-nav__item">
1772 <a href=
"../../package/pip/template-listener/" class=
"md-nav__link">
1785 <li class=
"md-nav__item">
1786 <a href=
"../../package/pip/user-group-option/" class=
"md-nav__link">
1799 <li class=
"md-nav__item">
1800 <a href=
"../../package/pip/user-menu/" class=
"md-nav__link">
1813 <li class=
"md-nav__item">
1814 <a href=
"../../package/pip/user-notification-event/" class=
"md-nav__link">
1815 userNotificationEvent
1827 <li class=
"md-nav__item">
1828 <a href=
"../../package/pip/user-option/" class=
"md-nav__link">
1841 <li class=
"md-nav__item">
1842 <a href=
"../../package/pip/user-profile-menu/" class=
"md-nav__link">
1862 <li class=
"md-nav__item">
1863 <a href=
"../../package/database-php-api/" class=
"md-nav__link">
1885 <li class=
"md-nav__item md-nav__item--nested">
1890 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_6" >
1894 <label class=
"md-nav__link" for=
"__nav_6" id=
"__nav_6_label" tabindex=
"0">
1896 <span class=
"md-nav__icon md-icon"></span>
1899 <nav class=
"md-nav" data-md-level=
"1" aria-labelledby=
"__nav_6_label" aria-expanded=
"false">
1900 <label class=
"md-nav__title" for=
"__nav_6">
1901 <span class=
"md-nav__icon md-icon"></span>
1904 <ul class=
"md-nav__list" data-md-scrollfix
>
1912 <li class=
"md-nav__item md-nav__item--nested">
1917 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_6_1" >
1921 <label class=
"md-nav__link" for=
"__nav_6_1" id=
"__nav_6_1_label" tabindex=
"0">
1922 From WoltLab Suite
5.5
1923 <span class=
"md-nav__icon md-icon"></span>
1926 <nav class=
"md-nav" data-md-level=
"2" aria-labelledby=
"__nav_6_1_label" aria-expanded=
"false">
1927 <label class=
"md-nav__title" for=
"__nav_6_1">
1928 <span class=
"md-nav__icon md-icon"></span>
1929 From WoltLab Suite
5.5
1931 <ul class=
"md-nav__list" data-md-scrollfix
>
1938 <li class=
"md-nav__item">
1939 <a href=
"../../migration/wsc55/php/" class=
"md-nav__link">
1952 <li class=
"md-nav__item">
1953 <a href=
"../../migration/wsc55/javascript/" class=
"md-nav__link">
1954 TypeScript and JavaScript
1966 <li class=
"md-nav__item">
1967 <a href=
"../../migration/wsc55/templates/" class=
"md-nav__link">
1980 <li class=
"md-nav__item">
1981 <a href=
"../../migration/wsc55/icons/" class=
"md-nav__link">
1994 <li class=
"md-nav__item">
1995 <a href=
"../../migration/wsc55/dialogs/" class=
"md-nav__link">
2008 <li class=
"md-nav__item">
2009 <a href=
"../../migration/wsc55/libraries/" class=
"md-nav__link">
2010 Third Party Libraries
2022 <li class=
"md-nav__item">
2023 <a href=
"../../migration/wsc55/deprecations_removals/" class=
"md-nav__link">
2024 Deprecations and Removals
2044 <li class=
"md-nav__item md-nav__item--nested">
2049 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_6_2" >
2053 <label class=
"md-nav__link" for=
"__nav_6_2" id=
"__nav_6_2_label" tabindex=
"0">
2054 From WoltLab Suite
5.4
2055 <span class=
"md-nav__icon md-icon"></span>
2058 <nav class=
"md-nav" data-md-level=
"2" aria-labelledby=
"__nav_6_2_label" aria-expanded=
"false">
2059 <label class=
"md-nav__title" for=
"__nav_6_2">
2060 <span class=
"md-nav__icon md-icon"></span>
2061 From WoltLab Suite
5.4
2063 <ul class=
"md-nav__list" data-md-scrollfix
>
2070 <li class=
"md-nav__item">
2071 <a href=
"../../migration/wsc54/php/" class=
"md-nav__link">
2084 <li class=
"md-nav__item">
2085 <a href=
"../../migration/wsc54/javascript/" class=
"md-nav__link">
2086 TypeScript and JavaScript
2098 <li class=
"md-nav__item">
2099 <a href=
"../../migration/wsc54/templates/" class=
"md-nav__link">
2112 <li class=
"md-nav__item">
2113 <a href=
"../../migration/wsc54/libraries/" class=
"md-nav__link">
2114 Third Party Libraries
2126 <li class=
"md-nav__item">
2127 <a href=
"../../migration/wsc54/deprecations_removals/" class=
"md-nav__link">
2128 Deprecations and Removals
2148 <li class=
"md-nav__item md-nav__item--nested">
2153 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_6_3" >
2157 <label class=
"md-nav__link" for=
"__nav_6_3" id=
"__nav_6_3_label" tabindex=
"0">
2158 From WoltLab Suite
5.3
2159 <span class=
"md-nav__icon md-icon"></span>
2162 <nav class=
"md-nav" data-md-level=
"2" aria-labelledby=
"__nav_6_3_label" aria-expanded=
"false">
2163 <label class=
"md-nav__title" for=
"__nav_6_3">
2164 <span class=
"md-nav__icon md-icon"></span>
2165 From WoltLab Suite
5.3
2167 <ul class=
"md-nav__list" data-md-scrollfix
>
2174 <li class=
"md-nav__item">
2175 <a href=
"../../migration/wsc53/php/" class=
"md-nav__link">
2188 <li class=
"md-nav__item">
2189 <a href=
"../../migration/wsc53/session/" class=
"md-nav__link">
2190 Session Handling and Authentication
2202 <li class=
"md-nav__item">
2203 <a href=
"../../migration/wsc53/javascript/" class=
"md-nav__link">
2204 TypeScript and JavaScript
2216 <li class=
"md-nav__item">
2217 <a href=
"../../migration/wsc53/templates/" class=
"md-nav__link">
2230 <li class=
"md-nav__item">
2231 <a href=
"../../migration/wsc53/libraries/" class=
"md-nav__link">
2232 Third Party Libraries
2252 <li class=
"md-nav__item md-nav__item--nested">
2257 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_6_4" >
2261 <label class=
"md-nav__link" for=
"__nav_6_4" id=
"__nav_6_4_label" tabindex=
"0">
2262 From WoltLab Suite
5.2
2263 <span class=
"md-nav__icon md-icon"></span>
2266 <nav class=
"md-nav" data-md-level=
"2" aria-labelledby=
"__nav_6_4_label" aria-expanded=
"false">
2267 <label class=
"md-nav__title" for=
"__nav_6_4">
2268 <span class=
"md-nav__icon md-icon"></span>
2269 From WoltLab Suite
5.2
2271 <ul class=
"md-nav__list" data-md-scrollfix
>
2278 <li class=
"md-nav__item">
2279 <a href=
"../../migration/wsc52/php/" class=
"md-nav__link">
2292 <li class=
"md-nav__item">
2293 <a href=
"../../migration/wsc52/templates/" class=
"md-nav__link">
2294 Templates and Languages
2306 <li class=
"md-nav__item">
2307 <a href=
"../../migration/wsc52/libraries/" class=
"md-nav__link">
2308 Third Party Libraries
2328 <li class=
"md-nav__item md-nav__item--nested">
2333 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_6_5" >
2337 <label class=
"md-nav__link" for=
"__nav_6_5" id=
"__nav_6_5_label" tabindex=
"0">
2338 From WoltLab Suite
3.1
2339 <span class=
"md-nav__icon md-icon"></span>
2342 <nav class=
"md-nav" data-md-level=
"2" aria-labelledby=
"__nav_6_5_label" aria-expanded=
"false">
2343 <label class=
"md-nav__title" for=
"__nav_6_5">
2344 <span class=
"md-nav__icon md-icon"></span>
2345 From WoltLab Suite
3.1
2347 <ul class=
"md-nav__list" data-md-scrollfix
>
2354 <li class=
"md-nav__item">
2355 <a href=
"../../migration/wsc31/php/" class=
"md-nav__link">
2376 <li class=
"md-nav__item md-nav__item--nested">
2381 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_6_6" >
2385 <label class=
"md-nav__link" for=
"__nav_6_6" id=
"__nav_6_6_label" tabindex=
"0">
2386 From WoltLab Suite
3.0
2387 <span class=
"md-nav__icon md-icon"></span>
2390 <nav class=
"md-nav" data-md-level=
"2" aria-labelledby=
"__nav_6_6_label" aria-expanded=
"false">
2391 <label class=
"md-nav__title" for=
"__nav_6_6">
2392 <span class=
"md-nav__icon md-icon"></span>
2393 From WoltLab Suite
3.0
2395 <ul class=
"md-nav__list" data-md-scrollfix
>
2402 <li class=
"md-nav__item">
2403 <a href=
"../../migration/wsc30/php/" class=
"md-nav__link">
2416 <li class=
"md-nav__item">
2417 <a href=
"../../migration/wsc30/javascript/" class=
"md-nav__link">
2430 <li class=
"md-nav__item">
2431 <a href=
"../../migration/wsc30/templates/" class=
"md-nav__link">
2444 <li class=
"md-nav__item">
2445 <a href=
"../../migration/wsc30/css/" class=
"md-nav__link">
2458 <li class=
"md-nav__item">
2459 <a href=
"../../migration/wsc30/package/" class=
"md-nav__link">
2480 <li class=
"md-nav__item md-nav__item--nested">
2485 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_6_7" >
2489 <label class=
"md-nav__link" for=
"__nav_6_7" id=
"__nav_6_7_label" tabindex=
"0">
2491 <span class=
"md-nav__icon md-icon"></span>
2494 <nav class=
"md-nav" data-md-level=
"2" aria-labelledby=
"__nav_6_7_label" aria-expanded=
"false">
2495 <label class=
"md-nav__title" for=
"__nav_6_7">
2496 <span class=
"md-nav__icon md-icon"></span>
2499 <ul class=
"md-nav__list" data-md-scrollfix
>
2506 <li class=
"md-nav__item">
2507 <a href=
"../../migration/wcf21/php/" class=
"md-nav__link">
2520 <li class=
"md-nav__item">
2521 <a href=
"../../migration/wcf21/templates/" class=
"md-nav__link">
2534 <li class=
"md-nav__item">
2535 <a href=
"../../migration/wcf21/css/" class=
"md-nav__link">
2548 <li class=
"md-nav__item">
2549 <a href=
"../../migration/wcf21/package/" class=
"md-nav__link">
2578 <li class=
"md-nav__item md-nav__item--nested">
2583 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_7" >
2587 <label class=
"md-nav__link" for=
"__nav_7" id=
"__nav_7_label" tabindex=
"0">
2589 <span class=
"md-nav__icon md-icon"></span>
2592 <nav class=
"md-nav" data-md-level=
"1" aria-labelledby=
"__nav_7_label" aria-expanded=
"false">
2593 <label class=
"md-nav__title" for=
"__nav_7">
2594 <span class=
"md-nav__icon md-icon"></span>
2597 <ul class=
"md-nav__list" data-md-scrollfix
>
2605 <li class=
"md-nav__item md-nav__item--nested">
2610 <input class=
"md-nav__toggle md-toggle " type=
"checkbox" id=
"__nav_7_1" >
2614 <label class=
"md-nav__link" for=
"__nav_7_1" id=
"__nav_7_1_label" tabindex=
"0">
2616 <span class=
"md-nav__icon md-icon"></span>
2619 <nav class=
"md-nav" data-md-level=
"2" aria-labelledby=
"__nav_7_1_label" aria-expanded=
"false">
2620 <label class=
"md-nav__title" for=
"__nav_7_1">
2621 <span class=
"md-nav__icon md-icon"></span>
2624 <ul class=
"md-nav__list" data-md-scrollfix
>
2631 <li class=
"md-nav__item">
2632 <a href=
"../../tutorial/series/overview/" class=
"md-nav__link">
2645 <li class=
"md-nav__item">
2646 <a href=
"../../tutorial/series/part_1/" class=
"md-nav__link">
2659 <li class=
"md-nav__item">
2660 <a href=
"../../tutorial/series/part_2/" class=
"md-nav__link">
2673 <li class=
"md-nav__item">
2674 <a href=
"../../tutorial/series/part_3/" class=
"md-nav__link">
2687 <li class=
"md-nav__item">
2688 <a href=
"../../tutorial/series/part_4/" class=
"md-nav__link">
2701 <li class=
"md-nav__item">
2702 <a href=
"../../tutorial/series/part_5/" class=
"md-nav__link">
2715 <li class=
"md-nav__item">
2716 <a href=
"../../tutorial/series/part_6/" class=
"md-nav__link">
2745 <div class=
"md-sidebar md-sidebar--secondary" data-md-component=
"sidebar" data-md-type=
"toc" >
2746 <div class=
"md-sidebar__scrollwrap">
2747 <div class=
"md-sidebar__inner">
2750 <nav class=
"md-nav md-nav--secondary" aria-label=
"Table of contents">
2757 <label class=
"md-nav__title" for=
"__toc">
2758 <span class=
"md-nav__icon md-icon"></span>
2761 <ul class=
"md-nav__list" data-md-component=
"toc" data-md-scrollfix
>
2763 <li class=
"md-nav__item">
2764 <a href=
"#introduction" class=
"md-nav__link">
2770 <li class=
"md-nav__item">
2771 <a href=
"#_dialogsetup" class=
"md-nav__link">
2775 <nav class=
"md-nav" aria-label=
"_dialogSetup()">
2776 <ul class=
"md-nav__list">
2778 <li class=
"md-nav__item">
2779 <a href=
"#id-string" class=
"md-nav__link">
2785 <li class=
"md-nav__item">
2786 <a href=
"#source-any" class=
"md-nav__link">
2792 <li class=
"md-nav__item">
2793 <a href=
"#options-object" class=
"md-nav__link">
2797 <nav class=
"md-nav" aria-label=
"options: Object">
2798 <ul class=
"md-nav__list">
2800 <li class=
"md-nav__item">
2801 <a href=
"#optionsbackdropcloseonclick-boolean" class=
"md-nav__link">
2802 options.backdropCloseOnClick: boolean
2807 <li class=
"md-nav__item">
2808 <a href=
"#optionsclosable-boolean" class=
"md-nav__link">
2809 options.closable: boolean
2814 <li class=
"md-nav__item">
2815 <a href=
"#optionsclosebuttonlabel-string" class=
"md-nav__link">
2816 options.closeButtonLabel: string
2821 <li class=
"md-nav__item">
2822 <a href=
"#optionscloseconfirmmessage-string" class=
"md-nav__link">
2823 options.closeConfirmMessage: string
2828 <li class=
"md-nav__item">
2829 <a href=
"#optionstitle-string" class=
"md-nav__link">
2830 options.title: string
2835 <li class=
"md-nav__item">
2836 <a href=
"#optionsonbeforeclose-id-string-void" class=
"md-nav__link">
2837 options.onBeforeClose: (id: string) =
> void
2842 <li class=
"md-nav__item">
2843 <a href=
"#optionsonclose-id-string-void" class=
"md-nav__link">
2844 options.onClose: (id: string) =
> void
2849 <li class=
"md-nav__item">
2850 <a href=
"#optionsonshow-content-element-void" class=
"md-nav__link">
2851 options.onShow: (content: Element) =
> void
2866 <li class=
"md-nav__item">
2867 <a href=
"#settitleid-string-object-title-string" class=
"md-nav__link">
2868 setTitle(id: string | Object, title: string)
2873 <li class=
"md-nav__item">
2874 <a href=
"#setcallbackid-string-object-key-string-value-data-any-void-null" class=
"md-nav__link">
2875 setCallback(id: string | Object, key: string, value: (data: any) =
> void | null)
2880 <li class=
"md-nav__item">
2881 <a href=
"#rebuildid-string-object" class=
"md-nav__link">
2882 rebuild(id: string | Object)
2887 <li class=
"md-nav__item">
2888 <a href=
"#closeid-string-object" class=
"md-nav__link">
2889 close(id: string | Object)
2894 <li class=
"md-nav__item">
2895 <a href=
"#getdialogid-string-object-object" class=
"md-nav__link">
2896 getDialog(id: string | Object): Object
2901 <li class=
"md-nav__item">
2902 <a href=
"#isopenid-string-object-boolean" class=
"md-nav__link">
2903 isOpen(id: string | Object): boolean
2917 <div class=
"md-content" data-md-component=
"content">
2918 <article class=
"md-content__inner md-typeset">
2926 <h1 id=
"dialogs-javascript-api">Dialogs - JavaScript API
<a class=
"headerlink" href=
"#dialogs-javascript-api" title=
"Permanent link">#
</a></h1>
2927 <div class=
"admonition info">
2928 <p class=
"admonition-title">This API has been deprecated in WoltLab Suite
6.0, please refer to the new
<a href=
"../components_dialog/">dialog implementation
</a>.
</p>
2930 <h2 id=
"introduction">Introduction
<a class=
"headerlink" href=
"#introduction" title=
"Permanent link">#
</a></h2>
2931 <p>Dialogs are full screen overlays that cover the currently visible window area
2932 using a semi-opague backdrop and a prominently placed dialog window in the
2933 foreground. They shift the attention away from the original content towards the
2934 dialog and usually contain additional details and/or dedicated form inputs.
</p>
2935 <h2 id=
"_dialogsetup"><code>_dialogSetup()
</code><a class=
"headerlink" href=
"#_dialogsetup" title=
"Permanent link">#
</a></h2>
2936 <p>The lazy initialization is performed upon the first invocation from the callee,
2937 using the magic
<code>_dialogSetup()
</code> method to retrieve the basic configuration for
2938 the dialog construction and any event callbacks.
</p>
2939 <div class=
"highlight"><table class=
"highlighttable"><tr><td class=
"linenos"><div class=
"linenodiv"><pre><span></span><span class=
"normal"> 1</span>
2940 <span class=
"normal"> 2</span>
2941 <span class=
"normal"> 3</span>
2942 <span class=
"normal"> 4</span>
2943 <span class=
"normal"> 5</span>
2944 <span class=
"normal"> 6</span>
2945 <span class=
"normal"> 7</span>
2946 <span class=
"normal"> 8</span>
2947 <span class=
"normal"> 9</span>
2948 <span class=
"normal">10</span>
2949 <span class=
"normal">11</span>
2950 <span class=
"normal">12</span>
2951 <span class=
"normal">13</span>
2952 <span class=
"normal">14</span>
2953 <span class=
"normal">15</span>
2954 <span class=
"normal">16</span>
2955 <span class=
"normal">17</span>
2956 <span class=
"normal">18</span>
2957 <span class=
"normal">19</span>
2958 <span class=
"normal">20</span>
2959 <span class=
"normal">21</span>
2960 <span class=
"normal">22</span>
2961 <span class=
"normal">23</span>
2962 <span class=
"normal">24</span>
2963 <span class=
"normal">25</span>
2964 <span class=
"normal">26</span></pre></div></td><td class=
"code"><div><pre><span></span><code><span class=
"c1">// App/Foo.js
</span>
2965 <span class=
"nx">define
</span><span class=
"p">([
</span><span class=
"s2">"Ui/Dialog
"</span><span class=
"p">],
</span><span class=
"w"> </span><span class=
"kd">function
</span><span class=
"p">(
</span><span class=
"nx">UiDialog
</span><span class=
"p">)
</span><span class=
"w"> </span><span class=
"p">{
</span>
2966 <span class=
"w"> </span><span class=
"s2">"use strict
"</span><span class=
"p">;
</span>
2968 <span class=
"w"> </span><span class=
"kd">function
</span><span class=
"w"> </span><span class=
"nx">Foo
</span><span class=
"p">()
</span><span class=
"w"> </span><span class=
"p">{};
</span>
2969 <span class=
"w"> </span><span class=
"nx">Foo
</span><span class=
"p">.
</span><span class=
"nx">prototype
</span><span class=
"w"> </span><span class=
"o">=
</span><span class=
"w"> </span><span class=
"p">{
</span>
2970 <span class=
"w"> </span><span class=
"nx">bar
</span><span class=
"o">:
</span><span class=
"w"> </span><span class=
"kd">function
</span><span class=
"p">()
</span><span class=
"w"> </span><span class=
"p">{
</span>
2971 <span class=
"w"> </span><span class=
"c1">// this will open the dialog constructed by _dialogSetup
</span>
2972 <span class=
"w"> </span><span class=
"nx">UiDialog
</span><span class=
"p">.
</span><span class=
"nx">open
</span><span class=
"p">(
</span><span class=
"k">this
</span><span class=
"p">);
</span>
2973 <span class=
"w"> </span><span class=
"p">},
</span>
2975 <span class=
"w"> </span><span class=
"nx">_dialogSetup
</span><span class=
"o">:
</span><span class=
"w"> </span><span class=
"kd">function
</span><span class=
"p">()
</span><span class=
"w"> </span><span class=
"p">{
</span>
2976 <span class=
"w"> </span><span class=
"k">return
</span><span class=
"w"> </span><span class=
"p">{
</span>
2977 <span class=
"w"> </span><span class=
"nx">id
</span><span class=
"o">:
</span><span class=
"w"> </span><span class=
"s2">"myDialog
"</span><span class=
"p">,
</span>
2978 <span class=
"w"> </span><span class=
"nx">source
</span><span class=
"o">:
</span><span class=
"w"> </span><span class=
"s2">"<p
>Hello World!
</p
>"</span><span class=
"p">,
</span>
2979 <span class=
"w"> </span><span class=
"nx">options
</span><span class=
"o">:
</span><span class=
"w"> </span><span class=
"p">{
</span>
2980 <span class=
"w"> </span><span class=
"nx">onClose
</span><span class=
"o">:
</span><span class=
"w"> </span><span class=
"kd">function
</span><span class=
"p">()
</span><span class=
"w"> </span><span class=
"p">{
</span>
2981 <span class=
"w"> </span><span class=
"c1">// the fancy dialog was closed!
</span>
2982 <span class=
"w"> </span><span class=
"p">}
</span>
2983 <span class=
"w"> </span><span class=
"p">}
</span>
2984 <span class=
"w"> </span><span class=
"p">}
</span>
2985 <span class=
"w"> </span><span class=
"p">}
</span>
2986 <span class=
"w"> </span><span class=
"p">};
</span>
2988 <span class=
"w"> </span><span class=
"k">return
</span><span class=
"w"> </span><span class=
"nx">Foo
</span><span class=
"p">;
</span>
2989 <span class=
"p">});
</span>
2990 </code></pre></div></td></tr></table></div>
2991 <h3 id=
"id-string"><code>id: string
</code><a class=
"headerlink" href=
"#id-string" title=
"Permanent link">#
</a></h3>
2992 <p>The
<code>id
</code> is used to identify a dialog on runtime, but is also part of the first-
2993 time setup when the dialog has not been opened before. If
<code>source
</code> is
<code>undefined
</code>,
2994 the module attempts to construct the dialog using an element with the same id.
</p>
2995 <h3 id=
"source-any"><code>source: any
</code><a class=
"headerlink" href=
"#source-any" title=
"Permanent link">#
</a></h3>
2996 <p>There are six different types of value that
<code>source
</code> does allow and each of them
2997 changes how the initial dialog is constructed:
</p>
2999 <li><code>undefined
</code><br />
3000 The dialog exists already and the value of
<code>id
</code> should be used to identify the
3002 <li><code>null
</code><br />
3003 The HTML is provided using the second argument of
<code>.open()
</code>.
</li>
3004 <li><code>() =
> void
</code><br />
3005 If the
<code>source
</code> is a function, it is executed and is expected to start the
3006 dialog initialization itself.
</li>
3007 <li><code>Object
</code><br />
3008 Plain objects are interpreted as parameters for an Ajax request, in particular
3009 <code>source.data
</code> will be used to issue the request. It is possible to specify the
3010 key
<code>source.after
</code> as a callback
<code>(content: Element, responseData: Object) =
> void
</code>
3011 that is executed after the dialog was opened.
</li>
3012 <li><code>string
</code><br />
3013 The string is expected to be plain HTML that should be used to construct the
3015 <li><code>DocumentFragment
</code><br />
3016 A new container
<code><div
></code> with the provided
<code>id
</code> is created and the contents of
3017 the
<code>DocumentFragment
</code> is appended to it. This container is then used for the
3020 <h3 id=
"options-object"><code>options: Object
</code><a class=
"headerlink" href=
"#options-object" title=
"Permanent link">#
</a></h3>
3021 <p>All configuration options and callbacks are handled through this object.
</p>
3022 <h4 id=
"optionsbackdropcloseonclick-boolean"><code>options.backdropCloseOnClick: boolean
</code><a class=
"headerlink" href=
"#optionsbackdropcloseonclick-boolean" title=
"Permanent link">#
</a></h4>
3023 <p><em>Defaults to
<code>true
</code>.
</em></p>
3024 <p>Clicks on the dialog backdrop will close the top-most dialog. This option will
3025 be force-disabled if the option
<code>closeable
</code> is set to
<code>false
</code>.
</p>
3026 <h4 id=
"optionsclosable-boolean"><code>options.closable: boolean
</code><a class=
"headerlink" href=
"#optionsclosable-boolean" title=
"Permanent link">#
</a></h4>
3027 <p><em>Defaults to
<code>true
</code>.
</em></p>
3028 <p>Enables the close button in the dialog title, when disabled the dialog can be
3029 closed through the
<code>.close()
</code> API call only.
</p>
3030 <h4 id=
"optionsclosebuttonlabel-string"><code>options.closeButtonLabel: string
</code><a class=
"headerlink" href=
"#optionsclosebuttonlabel-string" title=
"Permanent link">#
</a></h4>
3031 <p><em>Defaults to
<code>Language.get(
"wcf.global.button.close")
</code>.
</em></p>
3032 <p>The phrase that is displayed in the tooltip for the close button.
</p>
3033 <h4 id=
"optionscloseconfirmmessage-string"><code>options.closeConfirmMessage: string
</code><a class=
"headerlink" href=
"#optionscloseconfirmmessage-string" title=
"Permanent link">#
</a></h4>
3034 <p><em>Defaults to
<code>""</code>.
</em></p>
3035 <p>Shows a
<a href=
"../new-api_ui/">confirmation dialog
</a> using the configured message
3036 before closing the dialog. The dialog will not be closed if the dialog is
3037 rejected by the user.
</p>
3038 <h4 id=
"optionstitle-string"><code>options.title: string
</code><a class=
"headerlink" href=
"#optionstitle-string" title=
"Permanent link">#
</a></h4>
3039 <p><em>Defaults to
<code>""</code>.
</em></p>
3040 <p>The phrase that is displayed in the dialog title.
</p>
3041 <h4 id=
"optionsonbeforeclose-id-string-void"><code>options.onBeforeClose: (id: string) =
> void
</code><a class=
"headerlink" href=
"#optionsonbeforeclose-id-string-void" title=
"Permanent link">#
</a></h4>
3042 <p><em>Defaults to
<code>null
</code>.
</em></p>
3043 <p>The callback is executed when the user clicks on the close button or, if enabled,
3044 on the backdrop. The callback is responsible to close the dialog by itself, the
3045 default close behavior is automatically prevented.
</p>
3046 <h4 id=
"optionsonclose-id-string-void"><code>options.onClose: (id: string) =
> void
</code><a class=
"headerlink" href=
"#optionsonclose-id-string-void" title=
"Permanent link">#
</a></h4>
3047 <p><em>Defaults to
<code>null
</code>.
</em></p>
3048 <p>The callback is notified once the dialog is about to be closed, but is still
3049 visible at this point. It is not possible to abort the close operation at this
3051 <h4 id=
"optionsonshow-content-element-void"><code>options.onShow: (content: Element) =
> void
</code><a class=
"headerlink" href=
"#optionsonshow-content-element-void" title=
"Permanent link">#
</a></h4>
3052 <p><em>Defaults to
<code>null
</code>.
</em></p>
3053 <p>Receives the dialog content element as its only argument, allowing the callback
3054 to modify the DOM or to register event listeners before the dialog is presented
3055 to the user. The dialog is already visible at call time, but the dialog has not
3056 been finalized yet.
</p>
3057 <h2 id=
"settitleid-string-object-title-string"><code>setTitle(id: string | Object, title: string)
</code><a class=
"headerlink" href=
"#settitleid-string-object-title-string" title=
"Permanent link">#
</a></h2>
3058 <p>Sets the title of a dialog.
</p>
3059 <h2 id=
"setcallbackid-string-object-key-string-value-data-any-void-null"><code>setCallback(id: string | Object, key: string, value: (data: any) =
> void | null)
</code><a class=
"headerlink" href=
"#setcallbackid-string-object-key-string-value-data-any-void-null" title=
"Permanent link">#
</a></h2>
3060 <p>Sets a callback function after the dialog initialization, the special value
3061 <code>null
</code> will remove a previously set callback. Valid values for
<code>key
</code> are
3062 <code>onBeforeClose
</code>,
<code>onClose
</code> and
<code>onShow
</code>.
</p>
3063 <h2 id=
"rebuildid-string-object"><code>rebuild(id: string | Object)
</code><a class=
"headerlink" href=
"#rebuildid-string-object" title=
"Permanent link">#
</a></h2>
3064 <p>Rebuilds a dialog by performing various calculations on the maximum dialog
3065 height in regards to the overflow handling and adjustments for embedded forms.
3066 This method is automatically invoked whenever a dialog is shown, after invoking
3067 the
<code>options.onShow
</code> callback.
</p>
3068 <h2 id=
"closeid-string-object"><code>close(id: string | Object)
</code><a class=
"headerlink" href=
"#closeid-string-object" title=
"Permanent link">#
</a></h2>
3069 <p>Closes an open dialog, this will neither trigger a confirmation dialog, nor does
3070 it invoke the
<code>options.onBeforeClose
</code> callback. The
<code>options.onClose
</code> callback
3071 will always be invoked, but it cannot abort the close operation.
</p>
3072 <h2 id=
"getdialogid-string-object-object"><code>getDialog(id: string | Object): Object
</code><a class=
"headerlink" href=
"#getdialogid-string-object-object" title=
"Permanent link">#
</a></h2>
3073 <div class=
"admonition warning">
3074 <p class=
"admonition-title">This method returns an internal data object by reference, any modifications made do have an effect on the dialogs behavior and in particular no validation is performed on the modification. It is strongly recommended to use the
<code>.set*()
</code> methods only.
</p>
3076 <p>Returns the internal dialog data that is attached to a dialog. The most important
3077 key is
<code>.content
</code> which holds a reference to the dialog's inner content element.
</p>
3078 <h2 id=
"isopenid-string-object-boolean"><code>isOpen(id: string | Object): boolean
</code><a class=
"headerlink" href=
"#isopenid-string-object-boolean" title=
"Permanent link">#
</a></h2>
3079 <p>Returns true if the dialog exists and is open.
</p>
3082 <div class=
"md-source-file">
3104 <footer class=
"md-footer">
3106 <div class=
"md-footer-meta md-typeset">
3107 <div class=
"md-footer-meta__inner md-grid">
3108 <div class=
"md-copyright">
3110 <div class=
"md-copyright__highlight">
3111 Copyright ©
2020 WoltLab GmbH
3116 <a href=
"https://squidfunk.github.io/mkdocs-material/" target=
"_blank" rel=
"noopener">
3122 <div class=
"md-copyright">
3123 <a href=
"https://www.woltlab.com/legal-notice/">Legal Notice
</a>
3124 <a href=
"https://www.woltlab.com/privacy-policy/">Privacy Policy
</a>
3132 <div class=
"md-dialog" data-md-component=
"dialog">
3133 <div class=
"md-dialog__inner md-typeset"></div>
3136 <script id=
"__config" type=
"application/json">{
"base":
"../..",
"features": [
"navigation.tracking"],
"search":
"../../assets/javascripts/workers/search.208ed371.min.js",
"translations": {
"clipboard.copied":
"Copied to clipboard",
"clipboard.copy":
"Copy to clipboard",
"search.result.more.one":
"1 more on this page",
"search.result.more.other":
"# more on this page",
"search.result.none":
"No matching documents",
"search.result.one":
"1 matching document",
"search.result.other":
"# matching documents",
"search.result.placeholder":
"Type to start searching",
"search.result.term.missing":
"Missing",
"select.version":
"Select version"},
"version": {
"provider":
"mike"}}
</script>
3139 <script src=
"../../assets/javascripts/bundle.2a6f1dda.min.js"></script>