Deployed 59ff7f1 to 5.4 with MkDocs 1.1.2 and mike 0.5.5
[GitHub/WoltLab/woltlab.github.io.git] / 5.4 / javascript / new-api_writing-a-module / index.html
CommitLineData
45ca63d0
TD
1
2<!doctype html>
3<html lang="en" class="no-js">
4 <head>
5
6 <meta charset="utf-8">
7 <meta name="viewport" content="width=device-width,initial-scale=1">
8
9
10
11
fb962f09
WG
12 <link rel="icon" href="../../assets/default.favicon.ico">
13 <meta name="generator" content="mkdocs-1.1.2, mkdocs-material-7.1.0">
45ca63d0
TD
14
15
16
17 <title>Writing a module - WoltLab Suite Documentation</title>
18
19
20
fb962f09 21 <link rel="stylesheet" href="../../assets/stylesheets/main.33e2939f.min.css">
45ca63d0
TD
22
23
fb962f09 24 <link rel="stylesheet" href="../../assets/stylesheets/palette.ef6f36e2.min.css">
45ca63d0
TD
25
26
27
28 <meta name="theme-color" content="#009485">
29
30
31
32
33
fd8430cb
WG
34
35
45ca63d0
TD
36
37
38 <link rel="stylesheet" href="../../stylesheets/extra.css">
39
40
41
42
43
44 </head>
45
46
47
48
49
50
51
52 <body dir="ltr" data-md-color-scheme="" data-md-color-primary="teal" data-md-color-accent="">
45ca63d0
TD
53
54
fb962f09
WG
55 <script>function __prefix(e){return new URL("../..",location).pathname+"."+e}function __get(e,t=localStorage){return JSON.parse(t.getItem(__prefix(e)))}</script>
56
45ca63d0
TD
57 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
58 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
59 <label class="md-overlay" for="__drawer"></label>
60 <div data-md-component="skip">
61
62
63 <a href="#writing-a-module-javascript-api" class="md-skip">
64 Skip to content
65 </a>
66
67 </div>
68 <div data-md-component="announce">
69
70 <aside class="md-announce">
71 <div class="md-announce__inner md-grid md-typeset">
72
73 <a href="https://www.woltlab.com">Back to <strong>woltlab.com</strong></a>
74
75 </div>
76 </aside>
77
78 </div>
79
fb962f09 80 <header class="md-header" data-md-component="header">
45ca63d0 81 <nav class="md-header__inner md-grid" aria-label="Header">
fb962f09 82 <a href="../.." title="WoltLab Suite Documentation" class="md-header__button md-logo" aria-label="WoltLab Suite Documentation" data-md-component="logo">
45ca63d0
TD
83
84 <img src="../../assets/logo.png" alt="logo">
85
86 </a>
87 <label class="md-header__button md-icon" for="__drawer">
88 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
89 </label>
90 <div class="md-header__title" data-md-component="header-title">
91 <div class="md-header__ellipsis">
92 <div class="md-header__topic">
93 <span class="md-ellipsis">
94 WoltLab Suite Documentation
95 </span>
96 </div>
97 <div class="md-header__topic" data-md-component="header-topic">
98 <span class="md-ellipsis">
99
100 Writing a module
101
102 </span>
103 </div>
104 </div>
45ca63d0
TD
105 </div>
106
fb962f09
WG
107
108
a3639e76
WG
109 <label class="md-header__button md-icon" for="__search">
110 <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>
111 </label>
112
113<div class="md-search" data-md-component="search" role="dialog">
114 <label class="md-search__overlay" for="__search"></label>
115 <div class="md-search__inner" role="search">
116 <form class="md-search__form" name="search">
117 <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" data-md-state="active" required>
118 <label class="md-search__icon md-icon" for="__search">
119 <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>
120 <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>
121 </label>
122 <button type="reset" class="md-search__icon md-icon" aria-label="Clear" tabindex="-1">
fb962f09 123 <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>
a3639e76
WG
124 </button>
125 </form>
126 <div class="md-search__output">
127 <div class="md-search__scrollwrap" data-md-scrollfix>
128 <div class="md-search-result" data-md-component="search-result">
129 <div class="md-search-result__meta">
130 Initializing search
131 </div>
132 <ol class="md-search-result__list"></ol>
133 </div>
134 </div>
135 </div>
136 </div>
137</div>
138
45ca63d0 139
7124f4cb
WG
140 <div class="md-header__source">
141
142<a href="https://github.com/WoltLab/docs.woltlab.com/" title="Go to repository" class="md-source" data-md-component="source">
143 <div class="md-source__icon md-icon">
144
fb962f09 145 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><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>
7124f4cb
WG
146 </div>
147 <div class="md-source__repository">
148 GitHub
149 </div>
150</a>
151 </div>
152
45ca63d0
TD
153 </nav>
154</header>
155
156 <div class="md-container" data-md-component="container">
157
158
159
160
161 <main class="md-main" data-md-component="main">
162 <div class="md-main__inner md-grid">
163
164
165
166 <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
167 <div class="md-sidebar__scrollwrap">
168 <div class="md-sidebar__inner">
169
170
171
45ca63d0
TD
172<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
173 <label class="md-nav__title" for="__drawer">
fb962f09 174 <a href="../.." title="WoltLab Suite Documentation" class="md-nav__button md-logo" aria-label="WoltLab Suite Documentation" data-md-component="logo">
45ca63d0
TD
175
176 <img src="../../assets/logo.png" alt="logo">
177
178 </a>
179 WoltLab Suite Documentation
180 </label>
181
7124f4cb
WG
182 <div class="md-nav__source">
183
184<a href="https://github.com/WoltLab/docs.woltlab.com/" title="Go to repository" class="md-source" data-md-component="source">
185 <div class="md-source__icon md-icon">
186
fb962f09 187 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><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>
7124f4cb
WG
188 </div>
189 <div class="md-source__repository">
190 GitHub
191 </div>
192</a>
193 </div>
194
45ca63d0
TD
195 <ul class="md-nav__list" data-md-scrollfix>
196
197
198
199
200
201
202
203
204 <li class="md-nav__item">
205 <a href="../../getting-started/" class="md-nav__link">
206 Getting Started
207 </a>
208 </li>
209
210
211
212
213
214
215
216
217
218
219
220 <li class="md-nav__item md-nav__item--nested">
221
222
223 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2" type="checkbox" id="__nav_2" >
224
225 <label class="md-nav__link" for="__nav_2">
226 PHP API
227 <span class="md-nav__icon md-icon"></span>
228 </label>
229 <nav class="md-nav" aria-label="PHP API" data-md-level="1">
230 <label class="md-nav__title" for="__nav_2">
231 <span class="md-nav__icon md-icon"></span>
232 PHP API
233 </label>
234 <ul class="md-nav__list" data-md-scrollfix>
235
236
237
238
239
240 <li class="md-nav__item">
241 <a href="../../php/pages/" class="md-nav__link">
242 Pages
243 </a>
244 </li>
245
246
247
248
249
250
251
252 <li class="md-nav__item">
253 <a href="../../php/database-objects/" class="md-nav__link">
254 Database Objects
255 </a>
256 </li>
257
258
259
260
261
262
263
264 <li class="md-nav__item">
265 <a href="../../php/database-access/" class="md-nav__link">
266 Database Access
267 </a>
268 </li>
269
270
271
272
273
274
275
276 <li class="md-nav__item">
277 <a href="../../php/exceptions/" class="md-nav__link">
278 Exceptions
279 </a>
280 </li>
281
282
283
284
285
286
287
288
289 <li class="md-nav__item md-nav__item--nested">
290
291
292 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_5" type="checkbox" id="__nav_2_5" >
293
294 <label class="md-nav__link" for="__nav_2_5">
295 API
296 <span class="md-nav__icon md-icon"></span>
297 </label>
298 <nav class="md-nav" aria-label="API" data-md-level="2">
299 <label class="md-nav__title" for="__nav_2_5">
300 <span class="md-nav__icon md-icon"></span>
301 API
302 </label>
303 <ul class="md-nav__list" data-md-scrollfix>
304
305
306
307
308
6923e968
WG
309
310 <li class="md-nav__item md-nav__item--nested">
311
312
313 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_5_1" type="checkbox" id="__nav_2_5_1" >
314
315 <label class="md-nav__link" for="__nav_2_5_1">
316 Caches
317 <span class="md-nav__icon md-icon"></span>
318 </label>
319 <nav class="md-nav" aria-label="Caches" data-md-level="3">
320 <label class="md-nav__title" for="__nav_2_5_1">
321 <span class="md-nav__icon md-icon"></span>
322 Caches
323 </label>
324 <ul class="md-nav__list" data-md-scrollfix>
325
326
327
328
329
45ca63d0
TD
330 <li class="md-nav__item">
331 <a href="../../php/api/caches/" class="md-nav__link">
6923e968
WG
332 Overview
333 </a>
334 </li>
335
336
337
338
339
340
341
342 <li class="md-nav__item">
343 <a href="../../php/api/caches_persistent-caches/" class="md-nav__link">
344 Persistent Caches
345 </a>
346 </li>
347
348
349
350
351
352
353
354 <li class="md-nav__item">
355 <a href="../../php/api/caches_runtime-caches/" class="md-nav__link">
356 Runtime Caches
45ca63d0
TD
357 </a>
358 </li>
359
360
361
6923e968
WG
362 </ul>
363 </nav>
364 </li>
365
366
367
45ca63d0
TD
368
369
370
371
372 <li class="md-nav__item">
373 <a href="../../php/api/comments/" class="md-nav__link">
374 Comments
375 </a>
376 </li>
377
378
379
380
381
382
383
384 <li class="md-nav__item">
385 <a href="../../php/api/cronjobs/" class="md-nav__link">
386 Cronjobs
387 </a>
388 </li>
389
390
391
392
393
394
395
396 <li class="md-nav__item">
397 <a href="../../php/api/events/" class="md-nav__link">
398 Events
399 </a>
400 </li>
401
402
403
404
405
406
407
408
409 <li class="md-nav__item md-nav__item--nested">
410
411
412 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_5_5" type="checkbox" id="__nav_2_5_5" >
413
414 <label class="md-nav__link" for="__nav_2_5_5">
415 Form Builder
416 <span class="md-nav__icon md-icon"></span>
417 </label>
418 <nav class="md-nav" aria-label="Form Builder" data-md-level="3">
419 <label class="md-nav__title" for="__nav_2_5_5">
420 <span class="md-nav__icon md-icon"></span>
421 Form Builder
422 </label>
423 <ul class="md-nav__list" data-md-scrollfix>
424
425
426
427
428
429 <li class="md-nav__item">
430 <a href="../../php/api/form_builder/overview/" class="md-nav__link">
431 Overview
432 </a>
433 </li>
434
435
436
437
438
439
440
441 <li class="md-nav__item">
442 <a href="../../php/api/form_builder/structure/" class="md-nav__link">
443 Structure
444 </a>
445 </li>
446
447
448
449
450
451
452
453 <li class="md-nav__item">
454 <a href="../../php/api/form_builder/form_fields/" class="md-nav__link">
455 Fields
456 </a>
457 </li>
458
459
460
461
462
463
464
465 <li class="md-nav__item">
466 <a href="../../php/api/form_builder/validation_data/" class="md-nav__link">
467 Validation and Data
468 </a>
469 </li>
470
471
472
473
474
475
476
477 <li class="md-nav__item">
478 <a href="../../php/api/form_builder/dependencies/" class="md-nav__link">
479 Dependencies
480 </a>
481 </li>
482
483
484
485 </ul>
486 </nav>
487 </li>
488
489
490
491
492
493
494
495 <li class="md-nav__item">
496 <a href="../../php/api/package_installation_plugins/" class="md-nav__link">
497 Package Installation Plugins
498 </a>
499 </li>
500
501
502
503
504
505
506
507 <li class="md-nav__item">
508 <a href="../../php/api/user_activity_points/" class="md-nav__link">
509 User Activity Points
510 </a>
511 </li>
512
513
514
515
516
517
518
519 <li class="md-nav__item">
520 <a href="../../php/api/user_notifications/" class="md-nav__link">
521 User Notifications
522 </a>
523 </li>
524
525
526
527
528
529
530
531 <li class="md-nav__item">
532 <a href="../../php/api/sitemaps/" class="md-nav__link">
533 Sitemaps
534 </a>
535 </li>
536
537
538
539 </ul>
540 </nav>
541 </li>
542
543
544
545
546
547
548
549 <li class="md-nav__item">
550 <a href="../../php/code-style/" class="md-nav__link">
551 Code Style
552 </a>
553 </li>
554
555
556
557
558
559
560
561 <li class="md-nav__item">
562 <a href="../../php/apps/" class="md-nav__link">
563 Apps
564 </a>
565 </li>
566
567
568
569
570
571
572
573 <li class="md-nav__item">
574 <a href="../../php/gdpr/" class="md-nav__link">
575 GDPR
576 </a>
577 </li>
578
579
580
581 </ul>
582 </nav>
583 </li>
584
585
586
587
588
589
590
591
592
593
594
595 <li class="md-nav__item md-nav__item--nested">
596
597
598 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_3" type="checkbox" id="__nav_3" >
599
600 <label class="md-nav__link" for="__nav_3">
601 Languages, Templates & CSS
602 <span class="md-nav__icon md-icon"></span>
603 </label>
604 <nav class="md-nav" aria-label="Languages, Templates & CSS" data-md-level="1">
605 <label class="md-nav__title" for="__nav_3">
606 <span class="md-nav__icon md-icon"></span>
607 Languages, Templates & CSS
608 </label>
609 <ul class="md-nav__list" data-md-scrollfix>
610
611
612
613
614
615 <li class="md-nav__item">
616 <a href="../../view/languages/" class="md-nav__link">
617 Languages
618 </a>
619 </li>
620
621
622
623
624
625
626
627 <li class="md-nav__item">
628 <a href="../../view/templates/" class="md-nav__link">
629 Templates
630 </a>
631 </li>
632
633
634
635
636
637
638
6923e968
WG
639 <li class="md-nav__item">
640 <a href="../../view/template-plugins/" class="md-nav__link">
641 Template Plugins
642 </a>
643 </li>
644
645
646
647
648
649
650
45ca63d0
TD
651 <li class="md-nav__item">
652 <a href="../../view/css/" class="md-nav__link">
653 CSS
654 </a>
655 </li>
656
657
658
659 </ul>
660 </nav>
661 </li>
662
663
664
665
666
667
668
669
670
671
672
673
674
675 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
676
677
678 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" checked>
679
680 <label class="md-nav__link" for="__nav_4">
77efcd46 681 TypeScript and JavaScript API
45ca63d0
TD
682 <span class="md-nav__icon md-icon"></span>
683 </label>
77efcd46 684 <nav class="md-nav" aria-label="TypeScript and JavaScript API" data-md-level="1">
45ca63d0
TD
685 <label class="md-nav__title" for="__nav_4">
686 <span class="md-nav__icon md-icon"></span>
77efcd46 687 TypeScript and JavaScript API
45ca63d0
TD
688 </label>
689 <ul class="md-nav__list" data-md-scrollfix>
690
691
692
693
694
695 <li class="md-nav__item">
696 <a href="../general-usage/" class="md-nav__link">
697 General Usage
698 </a>
699 </li>
700
701
702
703
704
705
77efcd46
WG
706
707 <li class="md-nav__item">
708 <a href="../typescript/" class="md-nav__link">
709 TypeScript
710 </a>
711 </li>
712
713
714
715
716
717
45ca63d0
TD
718
719
720
721
722 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
723
724
77efcd46 725 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4_3" type="checkbox" id="__nav_4_3" checked>
45ca63d0 726
77efcd46 727 <label class="md-nav__link" for="__nav_4_3">
45ca63d0
TD
728 New API
729 <span class="md-nav__icon md-icon"></span>
730 </label>
731 <nav class="md-nav" aria-label="New API" data-md-level="2">
77efcd46 732 <label class="md-nav__title" for="__nav_4_3">
45ca63d0
TD
733 <span class="md-nav__icon md-icon"></span>
734 New API
735 </label>
736 <ul class="md-nav__list" data-md-scrollfix>
737
738
739
740
741
742
743
744 <li class="md-nav__item md-nav__item--active">
745
746 <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
747
748
749
750
751 <label class="md-nav__link md-nav__link--active" for="__toc">
752 Writing a module
753 <span class="md-nav__icon md-icon"></span>
754 </label>
755
756 <a href="./" class="md-nav__link md-nav__link--active">
757 Writing a module
758 </a>
759
760
761<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
762
763
764
765
766
767 <label class="md-nav__title" for="__toc">
768 <span class="md-nav__icon md-icon"></span>
769 Table of contents
770 </label>
771 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
772
773 <li class="md-nav__item">
774 <a href="#introduction" class="md-nav__link">
775 Introduction
776 </a>
777
778</li>
779
780 <li class="md-nav__item">
781 <a href="#defining-a-module" class="md-nav__link">
782 Defining a Module
783 </a>
784
785</li>
786
787 <li class="md-nav__item">
788 <a href="#loading-a-module" class="md-nav__link">
789 Loading a Module
790 </a>
791
792 <nav class="md-nav" aria-label="Loading a Module">
793 <ul class="md-nav__list">
794
795 <li class="md-nav__item">
796 <a href="#module-aliases" class="md-nav__link">
797 Module Aliases
798 </a>
799
800</li>
801
802 </ul>
803 </nav>
804
805</li>
806
807 </ul>
808
809</nav>
810
811 </li>
812
813
814
815
816
817
818
819 <li class="md-nav__item">
820 <a href="../new-api_data-structures/" class="md-nav__link">
821 Data Structures
822 </a>
823 </li>
824
825
826
827
828
829
830
831 <li class="md-nav__item">
832 <a href="../new-api_core/" class="md-nav__link">
833 Core Functions
834 </a>
835 </li>
836
837
838
839
840
841
842
843 <li class="md-nav__item">
844 <a href="../new-api_dom/" class="md-nav__link">
845 DOM
846 </a>
847 </li>
848
849
850
851
852
853
854
855 <li class="md-nav__item">
856 <a href="../new-api_events/" class="md-nav__link">
857 Event Handling
858 </a>
859 </li>
860
861
862
863
864
865
866
867 <li class="md-nav__item">
868 <a href="../new-api_ajax/" class="md-nav__link">
869 Ajax
870 </a>
871 </li>
872
873
874
875
876
877
878
879 <li class="md-nav__item">
880 <a href="../new-api_dialogs/" class="md-nav__link">
881 Dialogs
882 </a>
883 </li>
884
885
886
887
888
889
890
891 <li class="md-nav__item">
892 <a href="../new-api_browser/" class="md-nav__link">
893 Browser and Screen Sizes
894 </a>
895 </li>
896
897
898
899
900
901
902
903 <li class="md-nav__item">
904 <a href="../new-api_ui/" class="md-nav__link">
905 User Interface
906 </a>
907 </li>
908
909
910
911 </ul>
912 </nav>
913 </li>
914
915
916
917
918
919
920
921 <li class="md-nav__item">
922 <a href="../legacy-api/" class="md-nav__link">
923 Legacy API
924 </a>
925 </li>
926
927
928
929
930
931
932
933 <li class="md-nav__item">
934 <a href="../helper-functions/" class="md-nav__link">
935 Helper Functions
936 </a>
937 </li>
938
939
940
941
942
943
944
945 <li class="md-nav__item">
946 <a href="../code-snippets/" class="md-nav__link">
947 Code Snippets
948 </a>
949 </li>
950
951
952
953 </ul>
954 </nav>
955 </li>
956
957
958
959
960
961
962
963
964
965
966
967 <li class="md-nav__item md-nav__item--nested">
968
969
970 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" >
971
972 <label class="md-nav__link" for="__nav_5">
973 Package Components
974 <span class="md-nav__icon md-icon"></span>
975 </label>
976 <nav class="md-nav" aria-label="Package Components" data-md-level="1">
977 <label class="md-nav__title" for="__nav_5">
978 <span class="md-nav__icon md-icon"></span>
979 Package Components
980 </label>
981 <ul class="md-nav__list" data-md-scrollfix>
982
983
984
985
986
987 <li class="md-nav__item">
988 <a href="../../package/package-xml/" class="md-nav__link">
989 package.xml
990 </a>
991 </li>
992
993
994
995
996
997
998
999
1000 <li class="md-nav__item md-nav__item--nested">
1001
1002
1003 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_2" type="checkbox" id="__nav_5_2" >
1004
1005 <label class="md-nav__link" for="__nav_5_2">
1006 PIPs
1007 <span class="md-nav__icon md-icon"></span>
1008 </label>
1009 <nav class="md-nav" aria-label="PIPs" data-md-level="2">
1010 <label class="md-nav__title" for="__nav_5_2">
1011 <span class="md-nav__icon md-icon"></span>
1012 PIPs
1013 </label>
1014 <ul class="md-nav__list" data-md-scrollfix>
1015
1016
1017
1018
1019
1020 <li class="md-nav__item">
1021 <a href="../../package/pip/" class="md-nav__link">
1022 Overview
1023 </a>
1024 </li>
1025
1026
1027
1028
1029
1030
1031
1032 <li class="md-nav__item">
1033 <a href="../../package/pip/acl-option/" class="md-nav__link">
1034 aclOption
1035 </a>
1036 </li>
1037
1038
1039
1040
1041
1042
1043
1044 <li class="md-nav__item">
1045 <a href="../../package/pip/acp-menu/" class="md-nav__link">
1046 acpMenu
1047 </a>
1048 </li>
1049
1050
1051
1052
1053
1054
1055
1056 <li class="md-nav__item">
1057 <a href="../../package/pip/acp-search-provider/" class="md-nav__link">
1058 acpSearchProvider
1059 </a>
1060 </li>
1061
1062
1063
1064
1065
1066
1067
1068 <li class="md-nav__item">
1069 <a href="../../package/pip/acp-template/" class="md-nav__link">
1070 acpTemplate
1071 </a>
1072 </li>
1073
1074
1075
1076
1077
1078
1079
1080 <li class="md-nav__item">
1081 <a href="../../package/pip/bbcode/" class="md-nav__link">
1082 bbcode
1083 </a>
1084 </li>
1085
1086
1087
1088
1089
1090
1091
1092 <li class="md-nav__item">
1093 <a href="../../package/pip/box/" class="md-nav__link">
1094 box
1095 </a>
1096 </li>
1097
1098
1099
1100
1101
1102
1103
1104 <li class="md-nav__item">
1105 <a href="../../package/pip/clipboard-action/" class="md-nav__link">
1106 clipboardAction
1107 </a>
1108 </li>
1109
1110
1111
1112
1113
1114
1115
1116 <li class="md-nav__item">
1117 <a href="../../package/pip/core-object/" class="md-nav__link">
1118 coreObject
1119 </a>
1120 </li>
1121
1122
1123
1124
1125
1126
1127
1128 <li class="md-nav__item">
1129 <a href="../../package/pip/cronjob/" class="md-nav__link">
1130 cronjob
1131 </a>
1132 </li>
1133
1134
1135
1136
1137
1138
1139
6923e968
WG
1140 <li class="md-nav__item">
1141 <a href="../../package/pip/database/" class="md-nav__link">
1142 database
1143 </a>
1144 </li>
1145
1146
1147
1148
1149
1150
1151
45ca63d0
TD
1152 <li class="md-nav__item">
1153 <a href="../../package/pip/event-listener/" class="md-nav__link">
1154 eventListener
1155 </a>
1156 </li>
1157
1158
1159
1160
1161
1162
1163
1164 <li class="md-nav__item">
1165 <a href="../../package/pip/file/" class="md-nav__link">
1166 file
1167 </a>
1168 </li>
1169
1170
1171
1172
1173
1174
1175
1176 <li class="md-nav__item">
1177 <a href="../../package/pip/language/" class="md-nav__link">
1178 language
1179 </a>
1180 </li>
1181
1182
1183
1184
1185
1186
1187
1188 <li class="md-nav__item">
1189 <a href="../../package/pip/media-provider/" class="md-nav__link">
1190 mediaProvider
1191 </a>
1192 </li>
1193
1194
1195
1196
1197
1198
1199
1200 <li class="md-nav__item">
1201 <a href="../../package/pip/menu/" class="md-nav__link">
1202 menu
1203 </a>
1204 </li>
1205
1206
1207
1208
1209
1210
1211
1212 <li class="md-nav__item">
1213 <a href="../../package/pip/menu-item/" class="md-nav__link">
1214 menuItem
1215 </a>
1216 </li>
1217
1218
1219
1220
1221
1222
1223
1224 <li class="md-nav__item">
1225 <a href="../../package/pip/object-type/" class="md-nav__link">
1226 objectType
1227 </a>
1228 </li>
1229
1230
1231
1232
1233
1234
1235
1236 <li class="md-nav__item">
1237 <a href="../../package/pip/object-type-definition/" class="md-nav__link">
1238 objectTypeDefinition
1239 </a>
1240 </li>
1241
1242
1243
1244
1245
1246
1247
1248 <li class="md-nav__item">
1249 <a href="../../package/pip/option/" class="md-nav__link">
1250 option
1251 </a>
1252 </li>
1253
1254
1255
1256
1257
1258
1259
1260 <li class="md-nav__item">
1261 <a href="../../package/pip/page/" class="md-nav__link">
1262 page
1263 </a>
1264 </li>
1265
1266
1267
1268
1269
1270
1271
1272 <li class="md-nav__item">
1273 <a href="../../package/pip/pip/" class="md-nav__link">
1274 pip
1275 </a>
1276 </li>
1277
1278
1279
1280
1281
1282
1283
1284 <li class="md-nav__item">
1285 <a href="../../package/pip/script/" class="md-nav__link">
1286 script
1287 </a>
1288 </li>
1289
1290
1291
1292
1293
1294
1295
1296 <li class="md-nav__item">
1297 <a href="../../package/pip/smiley/" class="md-nav__link">
1298 smiley
1299 </a>
1300 </li>
1301
1302
1303
1304
1305
1306
1307
1308 <li class="md-nav__item">
1309 <a href="../../package/pip/sql/" class="md-nav__link">
1310 sql
1311 </a>
1312 </li>
1313
1314
1315
1316
1317
1318
1319
1320 <li class="md-nav__item">
1321 <a href="../../package/pip/style/" class="md-nav__link">
1322 style
1323 </a>
1324 </li>
1325
1326
1327
1328
1329
1330
1331
1332 <li class="md-nav__item">
1333 <a href="../../package/pip/template/" class="md-nav__link">
1334 template
1335 </a>
1336 </li>
1337
1338
1339
1340
1341
1342
1343
1344 <li class="md-nav__item">
1345 <a href="../../package/pip/template-listener/" class="md-nav__link">
1346 templateListener
1347 </a>
1348 </li>
1349
1350
1351
1352
1353
1354
1355
1356 <li class="md-nav__item">
1357 <a href="../../package/pip/user-group-option/" class="md-nav__link">
1358 userGroupOption
1359 </a>
1360 </li>
1361
1362
1363
1364
1365
1366
1367
1368 <li class="md-nav__item">
1369 <a href="../../package/pip/user-menu/" class="md-nav__link">
1370 userMenu
1371 </a>
1372 </li>
1373
1374
1375
1376
1377
1378
1379
1380 <li class="md-nav__item">
1381 <a href="../../package/pip/user-notification-event/" class="md-nav__link">
1382 userNotificationEvent
1383 </a>
1384 </li>
1385
1386
1387
1388
1389
1390
1391
1392 <li class="md-nav__item">
1393 <a href="../../package/pip/user-option/" class="md-nav__link">
1394 userOption
1395 </a>
1396 </li>
1397
1398
1399
1400
1401
1402
1403
1404 <li class="md-nav__item">
1405 <a href="../../package/pip/user-profile-menu/" class="md-nav__link">
1406 userProfileMenu
1407 </a>
1408 </li>
1409
1410
1411
1412 </ul>
1413 </nav>
1414 </li>
1415
1416
1417
1418
1419
1420
1421
1422 <li class="md-nav__item">
1423 <a href="../../package/database-php-api/" class="md-nav__link">
1424 Database PHP API
1425 </a>
1426 </li>
1427
1428
1429
1430 </ul>
1431 </nav>
1432 </li>
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444 <li class="md-nav__item md-nav__item--nested">
1445
1446
1447 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" >
1448
1449 <label class="md-nav__link" for="__nav_6">
1450 Migration
1451 <span class="md-nav__icon md-icon"></span>
1452 </label>
1453 <nav class="md-nav" aria-label="Migration" data-md-level="1">
1454 <label class="md-nav__title" for="__nav_6">
1455 <span class="md-nav__icon md-icon"></span>
1456 Migration
1457 </label>
1458 <ul class="md-nav__list" data-md-scrollfix>
1459
1460
1461
1462
1463
1464
1465 <li class="md-nav__item md-nav__item--nested">
1466
1467
1468 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6_1" type="checkbox" id="__nav_6_1" >
1469
1470 <label class="md-nav__link" for="__nav_6_1">
1471 Migrating from WSC 5.3
1472 <span class="md-nav__icon md-icon"></span>
1473 </label>
1474 <nav class="md-nav" aria-label="Migrating from WSC 5.3" data-md-level="2">
1475 <label class="md-nav__title" for="__nav_6_1">
1476 <span class="md-nav__icon md-icon"></span>
1477 Migrating from WSC 5.3
1478 </label>
1479 <ul class="md-nav__list" data-md-scrollfix>
1480
1481
1482
1483
1484
1485 <li class="md-nav__item">
1486 <a href="../../migration/wsc53/php/" class="md-nav__link">
1487 PHP API
1488 </a>
1489 </li>
1490
1491
1492
1493
1494
1495
1496
1497 <li class="md-nav__item">
1498 <a href="../../migration/wsc53/session/" class="md-nav__link">
1499 Session Handling and Authentication
1500 </a>
1501 </li>
1502
1503
1504
1505
1506
1507
1508
1509 <li class="md-nav__item">
1510 <a href="../../migration/wsc53/javascript/" class="md-nav__link">
77efcd46 1511 TypeScript and JavaScript
45ca63d0
TD
1512 </a>
1513 </li>
1514
1515
1516
1517
1518
1519
1520
1521 <li class="md-nav__item">
1522 <a href="../../migration/wsc53/templates/" class="md-nav__link">
1523 Templates
1524 </a>
1525 </li>
1526
1527
1528
1529
1530
1531
1532
1533 <li class="md-nav__item">
1534 <a href="../../migration/wsc53/libraries/" class="md-nav__link">
1535 Third Party Libraries
1536 </a>
1537 </li>
1538
1539
1540
1541 </ul>
1542 </nav>
1543 </li>
1544
1545
1546
1547
1548
1549
1550
1551
1552 <li class="md-nav__item md-nav__item--nested">
1553
1554
1555 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6_2" type="checkbox" id="__nav_6_2" >
1556
1557 <label class="md-nav__link" for="__nav_6_2">
1558 Migrating from WSC 5.2
1559 <span class="md-nav__icon md-icon"></span>
1560 </label>
1561 <nav class="md-nav" aria-label="Migrating from WSC 5.2" data-md-level="2">
1562 <label class="md-nav__title" for="__nav_6_2">
1563 <span class="md-nav__icon md-icon"></span>
1564 Migrating from WSC 5.2
1565 </label>
1566 <ul class="md-nav__list" data-md-scrollfix>
1567
1568
1569
1570
1571
1572 <li class="md-nav__item">
1573 <a href="../../migration/wsc52/php/" class="md-nav__link">
1574 PHP API
1575 </a>
1576 </li>
1577
1578
1579
1580
1581
1582
1583
1584 <li class="md-nav__item">
1585 <a href="../../migration/wsc52/templates/" class="md-nav__link">
1586 Templates and Languages
1587 </a>
1588 </li>
1589
1590
1591
1592
1593
1594
1595
1596 <li class="md-nav__item">
1597 <a href="../../migration/wsc52/libraries/" class="md-nav__link">
1598 Third Party Libraries
1599 </a>
1600 </li>
1601
1602
1603
1604 </ul>
1605 </nav>
1606 </li>
1607
1608
1609
1610
1611
1612
1613
1614
1615 <li class="md-nav__item md-nav__item--nested">
1616
1617
1618 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6_3" type="checkbox" id="__nav_6_3" >
1619
1620 <label class="md-nav__link" for="__nav_6_3">
1621 Migrating from WSC 3.1
1622 <span class="md-nav__icon md-icon"></span>
1623 </label>
1624 <nav class="md-nav" aria-label="Migrating from WSC 3.1" data-md-level="2">
1625 <label class="md-nav__title" for="__nav_6_3">
1626 <span class="md-nav__icon md-icon"></span>
1627 Migrating from WSC 3.1
1628 </label>
1629 <ul class="md-nav__list" data-md-scrollfix>
1630
1631
1632
1633
1634
1635 <li class="md-nav__item">
1636 <a href="../../migration/wsc31/php/" class="md-nav__link">
1637 PHP API
1638 </a>
1639 </li>
1640
1641
1642
1643 </ul>
1644 </nav>
1645 </li>
1646
1647
1648
1649
1650
1651
1652
1653
1654 <li class="md-nav__item md-nav__item--nested">
1655
1656
1657 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6_4" type="checkbox" id="__nav_6_4" >
1658
1659 <label class="md-nav__link" for="__nav_6_4">
1660 Migrating from WSC 3.0
1661 <span class="md-nav__icon md-icon"></span>
1662 </label>
1663 <nav class="md-nav" aria-label="Migrating from WSC 3.0" data-md-level="2">
1664 <label class="md-nav__title" for="__nav_6_4">
1665 <span class="md-nav__icon md-icon"></span>
1666 Migrating from WSC 3.0
1667 </label>
1668 <ul class="md-nav__list" data-md-scrollfix>
1669
1670
1671
1672
1673
1674 <li class="md-nav__item">
1675 <a href="../../migration/wsc30/php/" class="md-nav__link">
1676 PHP API
1677 </a>
1678 </li>
1679
1680
1681
1682
1683
1684
1685
1686 <li class="md-nav__item">
1687 <a href="../../migration/wsc30/javascript/" class="md-nav__link">
1688 JavaScript API
1689 </a>
1690 </li>
1691
1692
1693
1694
1695
1696
1697
1698 <li class="md-nav__item">
1699 <a href="../../migration/wsc30/templates/" class="md-nav__link">
1700 Templates
1701 </a>
1702 </li>
1703
1704
1705
1706
1707
1708
1709
1710 <li class="md-nav__item">
1711 <a href="../../migration/wsc30/css/" class="md-nav__link">
1712 CSS
1713 </a>
1714 </li>
1715
1716
1717
1718
1719
1720
1721
1722 <li class="md-nav__item">
1723 <a href="../../migration/wsc30/package/" class="md-nav__link">
1724 Package Components
1725 </a>
1726 </li>
1727
1728
1729
1730 </ul>
1731 </nav>
1732 </li>
1733
1734
1735
1736
1737
1738
1739
1740
1741 <li class="md-nav__item md-nav__item--nested">
1742
1743
1744 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6_5" type="checkbox" id="__nav_6_5" >
1745
1746 <label class="md-nav__link" for="__nav_6_5">
1747 Migrating from WCF 2.1
1748 <span class="md-nav__icon md-icon"></span>
1749 </label>
1750 <nav class="md-nav" aria-label="Migrating from WCF 2.1" data-md-level="2">
1751 <label class="md-nav__title" for="__nav_6_5">
1752 <span class="md-nav__icon md-icon"></span>
1753 Migrating from WCF 2.1
1754 </label>
1755 <ul class="md-nav__list" data-md-scrollfix>
1756
1757
1758
1759
1760
1761 <li class="md-nav__item">
1762 <a href="../../migration/wcf21/php/" class="md-nav__link">
1763 PHP API
1764 </a>
1765 </li>
1766
1767
1768
1769
1770
1771
1772
1773 <li class="md-nav__item">
1774 <a href="../../migration/wcf21/templates/" class="md-nav__link">
1775 Templates
1776 </a>
1777 </li>
1778
1779
1780
1781
1782
1783
1784
1785 <li class="md-nav__item">
1786 <a href="../../migration/wcf21/css/" class="md-nav__link">
1787 CSS
1788 </a>
1789 </li>
1790
1791
1792
1793
1794
1795
1796
1797 <li class="md-nav__item">
1798 <a href="../../migration/wcf21/package/" class="md-nav__link">
1799 Package Components
1800 </a>
1801 </li>
1802
1803
1804
1805 </ul>
1806 </nav>
1807 </li>
1808
1809
1810
1811 </ul>
1812 </nav>
1813 </li>
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825 <li class="md-nav__item md-nav__item--nested">
1826
1827
1828 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" >
1829
1830 <label class="md-nav__link" for="__nav_7">
1831 Tutorials
1832 <span class="md-nav__icon md-icon"></span>
1833 </label>
1834 <nav class="md-nav" aria-label="Tutorials" data-md-level="1">
1835 <label class="md-nav__title" for="__nav_7">
1836 <span class="md-nav__icon md-icon"></span>
1837 Tutorials
1838 </label>
1839 <ul class="md-nav__list" data-md-scrollfix>
1840
1841
1842
1843
1844
1845
1846 <li class="md-nav__item md-nav__item--nested">
1847
1848
1849 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7_1" type="checkbox" id="__nav_7_1" >
1850
1851 <label class="md-nav__link" for="__nav_7_1">
1852 Tutorial Series
1853 <span class="md-nav__icon md-icon"></span>
1854 </label>
1855 <nav class="md-nav" aria-label="Tutorial Series" data-md-level="2">
1856 <label class="md-nav__title" for="__nav_7_1">
1857 <span class="md-nav__icon md-icon"></span>
1858 Tutorial Series
1859 </label>
1860 <ul class="md-nav__list" data-md-scrollfix>
1861
1862
1863
1864
1865
1866 <li class="md-nav__item">
1867 <a href="../../tutorial/series/overview/" class="md-nav__link">
1868 Overview
1869 </a>
1870 </li>
1871
1872
1873
1874
1875
1876
1877
1878 <li class="md-nav__item">
1879 <a href="../../tutorial/series/part_1/" class="md-nav__link">
1880 Part 1
1881 </a>
1882 </li>
1883
1884
1885
1886
1887
1888
1889
1890 <li class="md-nav__item">
1891 <a href="../../tutorial/series/part_2/" class="md-nav__link">
1892 Part 2
1893 </a>
1894 </li>
1895
1896
1897
1898
1899
1900
1901
1902 <li class="md-nav__item">
1903 <a href="../../tutorial/series/part_3/" class="md-nav__link">
1904 Part 3
1905 </a>
1906 </li>
1907
1908
1909
1910 </ul>
1911 </nav>
1912 </li>
1913
1914
1915
1916 </ul>
1917 </nav>
1918 </li>
1919
1920
1921
1922 </ul>
1923</nav>
1924 </div>
1925 </div>
1926 </div>
1927
1928
1929
1930 <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
1931 <div class="md-sidebar__scrollwrap">
1932 <div class="md-sidebar__inner">
1933
1934<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
1935
1936
1937
1938
1939
1940 <label class="md-nav__title" for="__toc">
1941 <span class="md-nav__icon md-icon"></span>
1942 Table of contents
1943 </label>
1944 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
1945
1946 <li class="md-nav__item">
1947 <a href="#introduction" class="md-nav__link">
1948 Introduction
1949 </a>
1950
1951</li>
1952
1953 <li class="md-nav__item">
1954 <a href="#defining-a-module" class="md-nav__link">
1955 Defining a Module
1956 </a>
1957
1958</li>
1959
1960 <li class="md-nav__item">
1961 <a href="#loading-a-module" class="md-nav__link">
1962 Loading a Module
1963 </a>
1964
1965 <nav class="md-nav" aria-label="Loading a Module">
1966 <ul class="md-nav__list">
1967
1968 <li class="md-nav__item">
1969 <a href="#module-aliases" class="md-nav__link">
1970 Module Aliases
1971 </a>
1972
1973</li>
1974
1975 </ul>
1976 </nav>
1977
1978</li>
1979
1980 </ul>
1981
1982</nav>
1983 </div>
1984 </div>
1985 </div>
1986
1987
1988 <div class="md-content" data-md-component="content">
1989 <article class="md-content__inner md-typeset">
1990
1991
9b8bddda 1992 <a href="https://github.com/WoltLab/docs.woltlab.com/edit/5.4/docs/javascript/new-api_writing-a-module.md" title="Edit this page" class="md-content__button md-icon">
7124f4cb
WG
1993 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75L3 17.25z"/></svg>
1994 </a>
1995
45ca63d0
TD
1996
1997 <h1 id="writing-a-module-javascript-api">Writing a Module - JavaScript API<a class="headerlink" href="#writing-a-module-javascript-api" title="Permanent link">#</a></h1>
1998<h2 id="introduction">Introduction<a class="headerlink" href="#introduction" title="Permanent link">#</a></h2>
1999<p>The new JavaScript-API was introduced with WoltLab Suite 3.0 and was a major
2000change in all regards. The previously used API heavily relied on larger JavaScript
2001files that contained a lot of different components with hidden dependencies
2002and suffered from extensive jQuery usage for historic reasons.</p>
2003<p>Eventually a new API was designed that solves the issues with the legacy API
2004by following a few basic principles:
2005 1. Vanilla ES5-JavaScript.<br />
2006 It allows us to achieve the best performance across all platforms, there is
2007 simply no reason to use jQuery today and the performance penalty on mobile
2008 devices is a real issue.
2009 2. Strict usage of modules.<br />
2010 Each component is placed in an own file and all dependencies are explicitly
2011 declared and injected at the top.Eventually we settled with AMD-style modules
2012 using require.js which offers both lazy loading and "ahead of time"-compilatio
2013 with <code>r.js</code>.
2014 3. No jQuery-based components on page init.<br />
2015 Nothing is more annoying than loading a page and then wait for JavaScript to
2016 modify the page before it becomes usable, forcing the user to sit and wait.
2017 Heavily optimized vanilla JavaScript components offered the speed we wanted.
2018 4. Limited backwards-compatibility.<br />
2019 The new API should make it easy to update existing components by providing
2020 similar interfaces, while still allowing legacy code to run side-by-side for
2021 best compatibility and to avoid rewritting everything from the start.</p>
2022<h2 id="defining-a-module">Defining a Module<a class="headerlink" href="#defining-a-module" title="Permanent link">#</a></h2>
2023<p>The default location for modules is <code>js/</code> in the Core's app dir,
2024but every app and plugin can register their own lookup path by providing the path
2025using a <a href="../../package/pip/template-listener/">template-listener</a> on <code>requirePaths@headIncludeJavaScript</code>.</p>
2026<p>For this example we'll assume the file is placed at <code>js/WoltLabSuite/Core/Ui/Foo.js</code>,
2027the module name is therefore <code>WoltLabSuite/Core/Ui/Foo</code>, it is automatically
2028derived from the file path and name.</p>
2029<p>For further instructions on how to define and require modules head over to the <a href="http://requirejs.org/docs/api.html">RequireJS API</a>.</p>
2030<div class="highlight"><pre><span></span><code><span class="nx">define</span><span class="p">([</span><span class="s2">&quot;Ajax&quot;</span><span class="p">,</span> <span class="s2">&quot;WoltLabSuite/Core/Ui/Bar&quot;</span><span class="p">],</span> <span class="kd">function</span><span class="p">(</span><span class="nx">Ajax</span><span class="p">,</span> <span class="nx">UiBar</span><span class="p">)</span> <span class="p">{</span>
2031 <span class="s2">&quot;use strict&quot;</span><span class="p">;</span>
2032
2033 <span class="kd">function</span> <span class="nx">Foo</span><span class="p">()</span> <span class="p">{</span> <span class="k">this</span><span class="p">.</span><span class="nx">init</span><span class="p">();</span> <span class="p">}</span>
2034 <span class="nx">Foo</span><span class="p">.</span><span class="nx">prototype</span> <span class="o">=</span> <span class="p">{</span>
2035 <span class="nx">init</span><span class="o">:</span> <span class="kd">function</span><span class="p">()</span> <span class="p">{</span>
2036 <span class="nx">elBySel</span><span class="p">(</span><span class="s2">&quot;.myButton&quot;</span><span class="p">).</span><span class="nx">addEventListener</span><span class="p">(</span><span class="nx">WCF_CLICK_EVENT</span><span class="p">,</span> <span class="k">this</span><span class="p">.</span><span class="nx">_click</span><span class="p">.</span><span class="nx">bind</span><span class="p">(</span><span class="k">this</span><span class="p">));</span>
2037 <span class="p">},</span>
2038
2039 <span class="nx">_click</span><span class="o">:</span> <span class="kd">function</span><span class="p">(</span><span class="nx">event</span><span class="p">)</span> <span class="p">{</span>
2040 <span class="nx">event</span><span class="p">.</span><span class="nx">preventDefault</span><span class="p">();</span>
2041
2042 <span class="k">if</span> <span class="p">(</span><span class="nx">UiBar</span><span class="p">.</span><span class="nx">isSnafucated</span><span class="p">())</span> <span class="p">{</span>
2043 <span class="nx">Ajax</span><span class="p">.</span><span class="nx">api</span><span class="p">(</span><span class="k">this</span><span class="p">);</span>
2044 <span class="p">}</span>
2045 <span class="p">},</span>
2046
2047 <span class="nx">_ajaxSuccess</span><span class="o">:</span> <span class="kd">function</span><span class="p">(</span><span class="nx">data</span><span class="p">)</span> <span class="p">{</span>
2048 <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&quot;Received response&quot;</span><span class="p">,</span> <span class="nx">data</span><span class="p">);</span>
2049 <span class="p">},</span>
2050
2051 <span class="nx">_ajaxSetup</span><span class="o">:</span> <span class="kd">function</span><span class="p">()</span> <span class="p">{</span>
2052 <span class="k">return</span> <span class="p">{</span>
2053 <span class="nx">data</span><span class="o">:</span> <span class="p">{</span>
2054 <span class="nx">actionName</span><span class="o">:</span> <span class="s2">&quot;makeSnafucated&quot;</span><span class="p">,</span>
2055 <span class="nx">className</span><span class="o">:</span> <span class="s2">&quot;wcf\\data\\foo\\FooAction&quot;</span>
2056 <span class="p">}</span>
2057 <span class="p">};</span>
2058 <span class="p">}</span>
2059 <span class="p">}</span>
2060
2061 <span class="k">return</span> <span class="nx">Foo</span><span class="p">;</span>
2062<span class="p">});</span>
2063</code></pre></div>
45ca63d0
TD
2064<h2 id="loading-a-module">Loading a Module<a class="headerlink" href="#loading-a-module" title="Permanent link">#</a></h2>
2065<p>Modules can then be loaded through their derived name:</p>
2066<div class="highlight"><pre><span></span><code><span class="p">&lt;</span><span class="nt">script</span> <span class="na">data-relocate</span><span class="o">=</span><span class="s">&quot;true&quot;</span><span class="p">&gt;</span>
2067 <span class="nx">require</span><span class="p">([</span><span class="s2">&quot;WoltLabSuite/Core/Ui/Foo&quot;</span><span class="p">],</span> <span class="kd">function</span><span class="p">(</span><span class="nx">UiFoo</span><span class="p">)</span> <span class="p">{</span>
2068 <span class="k">new</span> <span class="nx">UiFoo</span><span class="p">();</span>
2069 <span class="p">});</span>
2070<span class="p">&lt;/</span><span class="nt">script</span><span class="p">&gt;</span>
2071</code></pre></div>
45ca63d0
TD
2072<h3 id="module-aliases">Module Aliases<a class="headerlink" href="#module-aliases" title="Permanent link">#</a></h3>
2073<p>Some common modules have short-hand aliases that can be used to include them
2074without writing out their full name. You can still use their original path, but
2075it is strongly recommended to use the aliases for consistency.</p>
2076<table>
2077<thead>
2078<tr>
2079<th>Alias</th>
2080<th>Full Path</th>
2081</tr>
2082</thead>
2083<tbody>
2084<tr>
2085<td><a href="../new-api_ajax/">Ajax</a></td>
2086<td>WoltLabSuite/Core/Ajax</td>
2087</tr>
2088<tr>
2089<td>AjaxJsonp</td>
2090<td>WoltLabSuite/Core/Ajax/Jsonp</td>
2091</tr>
2092<tr>
2093<td>AjaxRequest</td>
2094<td>WoltLabSuite/Core/Ajax/Request</td>
2095</tr>
2096<tr>
2097<td>CallbackList</td>
2098<td>WoltLabSuite/Core/CallbackList</td>
2099</tr>
2100<tr>
2101<td>ColorUtil</td>
2102<td>WoltLabSuite/Core/ColorUtil</td>
2103</tr>
2104<tr>
2105<td><a href="../new-api_core/">Core</a></td>
2106<td>WoltLabSuite/Core/Core</td>
2107</tr>
2108<tr>
2109<td>DateUtil</td>
2110<td>WoltLabSuite/Core/Date/Util</td>
2111</tr>
2112<tr>
2113<td>Devtools</td>
2114<td>WoltLabSuite/Core/Devtools</td>
2115</tr>
2116<tr>
2117<td><a href="../new-api_data-structures/">Dictionary</a></td>
2118<td>WoltLabSuite/Core/Dictionary</td>
2119</tr>
2120<tr>
2121<td><a href="../new-api_dom/">Dom/ChangeListener</a></td>
2122<td>WoltLabSuite/Core/Dom/Change/Listener</td>
2123</tr>
2124<tr>
2125<td>Dom/Traverse</td>
2126<td>WoltLabSuite/Core/Dom/Traverse</td>
2127</tr>
2128<tr>
2129<td><a href="../new-api_dom/">Dom/Util</a></td>
2130<td>WoltLabSuite/Core/Dom/Util</td>
2131</tr>
2132<tr>
2133<td><a href="../new-api_browser/">Environment</a></td>
2134<td>WoltLabSuite/Core/Environment</td>
2135</tr>
2136<tr>
2137<td><a href="../new-api_events/">EventHandler</a></td>
2138<td>WoltLabSuite/Core/Event/Handler</td>
2139</tr>
2140<tr>
2141<td><a href="../new-api_events/">EventKey</a></td>
2142<td>WoltLabSuite/Core/Event/Key</td>
2143</tr>
2144<tr>
2145<td><a href="../new-api_core/">Language</a></td>
2146<td>WoltLabSuite/Core/Language</td>
2147</tr>
2148<tr>
2149<td><a href="../new-api_data-structures/">List</a></td>
2150<td>WoltLabSuite/Core/List</td>
2151</tr>
2152<tr>
2153<td><a href="../new-api_data-structures/">ObjectMap</a></td>
2154<td>WoltLabSuite/Core/ObjectMap</td>
2155</tr>
2156<tr>
2157<td>Permission</td>
2158<td>WoltLabSuite/Core/Permission</td>
2159</tr>
2160<tr>
2161<td><a href="../new-api_core/">StringUtil</a></td>
2162<td>WoltLabSuite/Core/StringUtil</td>
2163</tr>
2164<tr>
2165<td><a href="../new-api_ui/">Ui/Alignment</a></td>
2166<td>WoltLabSuite/Core/Ui/Alignment</td>
2167</tr>
2168<tr>
2169<td><a href="../new-api_ui/">Ui/CloseOverlay</a></td>
2170<td>WoltLabSuite/Core/Ui/CloseOverlay</td>
2171</tr>
2172<tr>
2173<td><a href="../new-api_ui/">Ui/Confirmation</a></td>
2174<td>WoltLabSuite/Core/Ui/Confirmation</td>
2175</tr>
2176<tr>
2177<td><a href="../new-api_dialogs/">Ui/Dialog</a></td>
2178<td>WoltLabSuite/Core/Ui/Dialog</td>
2179</tr>
2180<tr>
2181<td><a href="../new-api_ui/">Ui/Notification</a></td>
2182<td>WoltLabSuite/Core/Ui/Notification</td>
2183</tr>
2184<tr>
2185<td>Ui/ReusableDropdown</td>
2186<td>WoltLabSuite/Core/Ui/Dropdown/Reusable</td>
2187</tr>
2188<tr>
2189<td><a href="../new-api_browser/">Ui/Screen</a></td>
2190<td>WoltLabSuite/Core/Ui/Screen</td>
2191</tr>
2192<tr>
2193<td>Ui/Scroll</td>
2194<td>WoltLabSuite/Core/Ui/Scroll</td>
2195</tr>
2196<tr>
2197<td>Ui/SimpleDropdown</td>
2198<td>WoltLabSuite/Core/Ui/Dropdown/Simple</td>
2199</tr>
2200<tr>
2201<td>Ui/TabMenu</td>
2202<td>WoltLabSuite/Core/Ui/TabMenu</td>
2203</tr>
2204<tr>
2205<td>Upload</td>
2206<td>WoltLabSuite/Core/Upload</td>
2207</tr>
2208<tr>
2209<td>User</td>
2210<td>WoltLabSuite/Core/User</td>
2211</tr>
2212</tbody>
2213</table>
2214
4a5c32e1
WG
2215
2216
2217
2218<hr>
2219<div class="md-source-date">
2220 <small>
2221
2222 Last update: 2021-01-08
2223
2224 </small>
2225</div>
2226
2227
45ca63d0
TD
2228
2229
2230
2231
2232
2233
2234 </article>
2235 </div>
2236 </div>
fb962f09 2237
45ca63d0
TD
2238 </main>
2239
2240
2241<footer class="md-footer">
2242
2243 <nav class="md-footer__inner md-grid" aria-label="Footer">
2244
77efcd46 2245 <a href="../typescript/" class="md-footer__link md-footer__link--prev" rel="prev">
45ca63d0
TD
2246 <div class="md-footer__button md-icon">
2247 <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>
2248 </div>
2249 <div class="md-footer__title">
2250 <div class="md-ellipsis">
2251 <span class="md-footer__direction">
2252 Previous
2253 </span>
77efcd46 2254 TypeScript
45ca63d0
TD
2255 </div>
2256 </div>
2257 </a>
2258
2259
2260 <a href="../new-api_data-structures/" class="md-footer__link md-footer__link--next" rel="next">
2261 <div class="md-footer__title">
2262 <div class="md-ellipsis">
2263 <span class="md-footer__direction">
2264 Next
2265 </span>
2266 Data Structures
2267 </div>
2268 </div>
2269 <div class="md-footer__button md-icon">
2270 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg>
2271 </div>
2272 </a>
2273
2274 </nav>
2275
2276 <div class="md-footer-meta md-typeset">
2277 <div class="md-footer-meta__inner md-grid">
2278 <div class="md-footer-copyright">
2279
2280 <div class="md-footer-copyright__highlight">
2281 Copyright © 2020 WoltLab GmbH
2282 </div>
2283
2284 Made with
2285 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
2286 Material for MkDocs
2287 </a>
fb88dc6e 2288
45ca63d0
TD
2289 </div>
2290 <div class="md-footer-copyright">
2291 <a href="https://www.woltlab.com/legal-notice/">Legal Notice</a>
2292 <a href="https://www.woltlab.com/privacy-policy/">Privacy Policy</a>
2293</div>
2294 </div>
2295 </div>
2296</footer>
2297
2298 </div>
2299 <div class="md-dialog" data-md-component="dialog">
2300 <div class="md-dialog__inner md-typeset"></div>
2301 </div>
fb962f09 2302 <script id="__config" type="application/json">{"base": "../..", "features": [], "translations": {"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing"}, "search": "../../assets/javascripts/workers/search.fe42c31b.min.js", "version": {"provider": "mike"}}</script>
45ca63d0
TD
2303
2304
fb962f09 2305 <script src="../../assets/javascripts/bundle.d892486b.min.js"></script>
45ca63d0
TD
2306
2307
2308 </body>
2309</html>