Deployed e3be2c0 to 5.4 with MkDocs 1.1.2 and mike 0.5.5
[GitHub/WoltLab/woltlab.github.io.git] / latest / javascript / new-api_events / index.html
CommitLineData
0c5338dd
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">
0c5338dd
TD
14
15
16
17 <title>Event Handling - WoltLab Suite Documentation</title>
18
19
20
fb962f09 21 <link rel="stylesheet" href="../../assets/stylesheets/main.33e2939f.min.css">
0c5338dd
TD
22
23
fb962f09 24 <link rel="stylesheet" href="../../assets/stylesheets/palette.ef6f36e2.min.css">
0c5338dd
TD
25
26
27
28 <meta name="theme-color" content="#009485">
29
30
31
32
33
fd8430cb
WG
34
35
0c5338dd
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="">
0c5338dd
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
0c5338dd
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="#event-handling-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">
0c5338dd 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">
0c5338dd
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 Event Handling
101
102 </span>
103 </div>
104 </div>
0c5338dd
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
0c5338dd 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
0c5338dd
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
0c5338dd
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">
0c5338dd
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
0c5338dd
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
309 <li class="md-nav__item">
310 <a href="../../php/api/caches/" class="md-nav__link">
311 Caches
312 </a>
313 </li>
314
315
316
317
318
319
320
321 <li class="md-nav__item">
322 <a href="../../php/api/comments/" class="md-nav__link">
323 Comments
324 </a>
325 </li>
326
327
328
329
330
331
332
333 <li class="md-nav__item">
334 <a href="../../php/api/cronjobs/" class="md-nav__link">
335 Cronjobs
336 </a>
337 </li>
338
339
340
341
342
343
344
345 <li class="md-nav__item">
346 <a href="../../php/api/events/" class="md-nav__link">
347 Events
348 </a>
349 </li>
350
351
352
353
354
355
356
357
358 <li class="md-nav__item md-nav__item--nested">
359
360
361 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_5_5" type="checkbox" id="__nav_2_5_5" >
362
363 <label class="md-nav__link" for="__nav_2_5_5">
364 Form Builder
365 <span class="md-nav__icon md-icon"></span>
366 </label>
367 <nav class="md-nav" aria-label="Form Builder" data-md-level="3">
368 <label class="md-nav__title" for="__nav_2_5_5">
369 <span class="md-nav__icon md-icon"></span>
370 Form Builder
371 </label>
372 <ul class="md-nav__list" data-md-scrollfix>
373
374
375
376
377
378 <li class="md-nav__item">
379 <a href="../../php/api/form_builder/overview/" class="md-nav__link">
380 Overview
381 </a>
382 </li>
383
384
385
386
387
388
389
390 <li class="md-nav__item">
391 <a href="../../php/api/form_builder/structure/" class="md-nav__link">
392 Structure
393 </a>
394 </li>
395
396
397
398
399
400
401
402 <li class="md-nav__item">
403 <a href="../../php/api/form_builder/form_fields/" class="md-nav__link">
404 Fields
405 </a>
406 </li>
407
408
409
410
411
412
413
414 <li class="md-nav__item">
415 <a href="../../php/api/form_builder/validation_data/" class="md-nav__link">
416 Validation and Data
417 </a>
418 </li>
419
420
421
422
423
424
425
426 <li class="md-nav__item">
427 <a href="../../php/api/form_builder/dependencies/" class="md-nav__link">
428 Dependencies
429 </a>
430 </li>
431
432
433
434 </ul>
435 </nav>
436 </li>
437
438
439
440
441
442
443
444 <li class="md-nav__item">
445 <a href="../../php/api/package_installation_plugins/" class="md-nav__link">
446 Package Installation Plugins
447 </a>
448 </li>
449
450
451
452
453
454
455
456 <li class="md-nav__item">
457 <a href="../../php/api/user_activity_points/" class="md-nav__link">
458 User Activity Points
459 </a>
460 </li>
461
462
463
464
465
466
467
468 <li class="md-nav__item">
469 <a href="../../php/api/user_notifications/" class="md-nav__link">
470 User Notifications
471 </a>
472 </li>
473
474
475
476
477
478
479
480 <li class="md-nav__item">
481 <a href="../../php/api/sitemaps/" class="md-nav__link">
482 Sitemaps
483 </a>
484 </li>
485
486
487
488 </ul>
489 </nav>
490 </li>
491
492
493
494
495
496
497
498 <li class="md-nav__item">
499 <a href="../../php/code-style/" class="md-nav__link">
500 Code Style
501 </a>
502 </li>
503
504
505
506
507
508
509
510 <li class="md-nav__item">
511 <a href="../../php/apps/" class="md-nav__link">
512 Apps
513 </a>
514 </li>
515
516
517
518
519
520
521
522 <li class="md-nav__item">
523 <a href="../../php/gdpr/" class="md-nav__link">
524 GDPR
525 </a>
526 </li>
527
528
529
530 </ul>
531 </nav>
532 </li>
533
534
535
536
537
538
539
540
541
542
543
544 <li class="md-nav__item md-nav__item--nested">
545
546
547 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_3" type="checkbox" id="__nav_3" >
548
549 <label class="md-nav__link" for="__nav_3">
550 Languages, Templates & CSS
551 <span class="md-nav__icon md-icon"></span>
552 </label>
553 <nav class="md-nav" aria-label="Languages, Templates & CSS" data-md-level="1">
554 <label class="md-nav__title" for="__nav_3">
555 <span class="md-nav__icon md-icon"></span>
556 Languages, Templates & CSS
557 </label>
558 <ul class="md-nav__list" data-md-scrollfix>
559
560
561
562
563
564 <li class="md-nav__item">
565 <a href="../../view/languages/" class="md-nav__link">
566 Languages
567 </a>
568 </li>
569
570
571
572
573
574
575
576 <li class="md-nav__item">
577 <a href="../../view/templates/" class="md-nav__link">
578 Templates
579 </a>
580 </li>
581
582
583
584
585
586
587
588 <li class="md-nav__item">
589 <a href="../../view/css/" class="md-nav__link">
590 CSS
591 </a>
592 </li>
593
594
595
596 </ul>
597 </nav>
598 </li>
599
600
601
602
603
604
605
606
607
608
609
610
611
612 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
613
614
615 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" checked>
616
617 <label class="md-nav__link" for="__nav_4">
618 JavaScript API
619 <span class="md-nav__icon md-icon"></span>
620 </label>
621 <nav class="md-nav" aria-label="JavaScript API" data-md-level="1">
622 <label class="md-nav__title" for="__nav_4">
623 <span class="md-nav__icon md-icon"></span>
624 JavaScript API
625 </label>
626 <ul class="md-nav__list" data-md-scrollfix>
627
628
629
630
631
632 <li class="md-nav__item">
633 <a href="../general-usage/" class="md-nav__link">
634 General Usage
635 </a>
636 </li>
637
638
639
640
641
642
643
644
645
646
647 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
648
649
650 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4_2" type="checkbox" id="__nav_4_2" checked>
651
652 <label class="md-nav__link" for="__nav_4_2">
653 New API
654 <span class="md-nav__icon md-icon"></span>
655 </label>
656 <nav class="md-nav" aria-label="New API" data-md-level="2">
657 <label class="md-nav__title" for="__nav_4_2">
658 <span class="md-nav__icon md-icon"></span>
659 New API
660 </label>
661 <ul class="md-nav__list" data-md-scrollfix>
662
663
664
665
666
667 <li class="md-nav__item">
668 <a href="../new-api_writing-a-module/" class="md-nav__link">
669 Writing a module
670 </a>
671 </li>
672
673
674
675
676
677
678
679 <li class="md-nav__item">
680 <a href="../new-api_data-structures/" class="md-nav__link">
681 Data Structures
682 </a>
683 </li>
684
685
686
687
688
689
690
691 <li class="md-nav__item">
692 <a href="../new-api_core/" class="md-nav__link">
693 Core Functions
694 </a>
695 </li>
696
697
698
699
700
701
702
703 <li class="md-nav__item">
704 <a href="../new-api_dom/" class="md-nav__link">
705 DOM
706 </a>
707 </li>
708
709
710
711
712
713
714
715
716
717 <li class="md-nav__item md-nav__item--active">
718
719 <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
720
721
722
723
724 <label class="md-nav__link md-nav__link--active" for="__toc">
725 Event Handling
726 <span class="md-nav__icon md-icon"></span>
727 </label>
728
729 <a href="./" class="md-nav__link md-nav__link--active">
730 Event Handling
731 </a>
732
733
734<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
735
736
737
738
739
740 <label class="md-nav__title" for="__toc">
741 <span class="md-nav__icon md-icon"></span>
742 Table of contents
743 </label>
744 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
745
746 <li class="md-nav__item">
747 <a href="#eventkey" class="md-nav__link">
748 EventKey
749 </a>
750
751 <nav class="md-nav" aria-label="EventKey">
752 <ul class="md-nav__list">
753
754 <li class="md-nav__item">
755 <a href="#arrowdownevent-keyboardevent-boolean" class="md-nav__link">
756 ArrowDown(event: KeyboardEvent): boolean
757 </a>
758
759</li>
760
761 <li class="md-nav__item">
762 <a href="#arrowleftevent-keyboardevent-boolean" class="md-nav__link">
763 ArrowLeft(event: KeyboardEvent): boolean
764 </a>
765
766</li>
767
768 <li class="md-nav__item">
769 <a href="#arrowrightevent-keyboardevent-boolean" class="md-nav__link">
770 ArrowRight(event: KeyboardEvent): boolean
771 </a>
772
773</li>
774
775 <li class="md-nav__item">
776 <a href="#arrowupevent-keyboardevent-boolean" class="md-nav__link">
777 ArrowUp(event: KeyboardEvent): boolean
778 </a>
779
780</li>
781
782 <li class="md-nav__item">
783 <a href="#commaevent-keyboardevent-boolean" class="md-nav__link">
784 Comma(event: KeyboardEvent): boolean
785 </a>
786
787</li>
788
789 <li class="md-nav__item">
790 <a href="#enterevent-keyboardevent-boolean" class="md-nav__link">
791 Enter(event: KeyboardEvent): boolean
792 </a>
793
794</li>
795
796 <li class="md-nav__item">
797 <a href="#escapeevent-keyboardevent-boolean" class="md-nav__link">
798 Escape(event: KeyboardEvent): boolean
799 </a>
800
801</li>
802
803 <li class="md-nav__item">
804 <a href="#tabevent-keyboardevent-boolean" class="md-nav__link">
805 Tab(event: KeyboardEvent): boolean
806 </a>
807
808</li>
809
810 </ul>
811 </nav>
812
813</li>
814
815 <li class="md-nav__item">
816 <a href="#eventhandler" class="md-nav__link">
817 EventHandler
818 </a>
819
820 <nav class="md-nav" aria-label="EventHandler">
821 <ul class="md-nav__list">
822
823 <li class="md-nav__item">
824 <a href="#identifiying-events-with-the-developer-tools" class="md-nav__link">
825 Identifiying Events with the Developer Tools
826 </a>
827
828</li>
829
830 <li class="md-nav__item">
831 <a href="#addidentifier-string-action-string-callback-data-object-void-string" class="md-nav__link">
832 add(identifier: string, action: string, callback: (data: Object) =&gt; void): string
833 </a>
834
835</li>
836
837 <li class="md-nav__item">
838 <a href="#fireidentifier-string-action-string-data-object" class="md-nav__link">
839 fire(identifier: string, action: string, data?: Object)
840 </a>
841
842</li>
843
844 <li class="md-nav__item">
845 <a href="#removeidentifier-string-action-string-uuid-string" class="md-nav__link">
846 remove(identifier: string, action: string, uuid: string)
847 </a>
848
849</li>
850
851 <li class="md-nav__item">
852 <a href="#removeallidentifier-string-action-string" class="md-nav__link">
853 removeAll(identifier: string, action: string)
854 </a>
855
856</li>
857
858 <li class="md-nav__item">
859 <a href="#removeallbysuffixidentifier-string-suffix-string" class="md-nav__link">
860 removeAllBySuffix(identifier: string, suffix: string)
861 </a>
862
863</li>
864
865 </ul>
866 </nav>
867
868</li>
869
870 </ul>
871
872</nav>
873
874 </li>
875
876
877
878
879
880
881
882 <li class="md-nav__item">
883 <a href="../new-api_ajax/" class="md-nav__link">
884 Ajax
885 </a>
886 </li>
887
888
889
890
891
892
893
894 <li class="md-nav__item">
895 <a href="../new-api_dialogs/" class="md-nav__link">
896 Dialogs
897 </a>
898 </li>
899
900
901
902
903
904
905
906 <li class="md-nav__item">
907 <a href="../new-api_browser/" class="md-nav__link">
908 Browser and Screen Sizes
909 </a>
910 </li>
911
912
913
914
915
916
917
918 <li class="md-nav__item">
919 <a href="../new-api_ui/" class="md-nav__link">
920 User Interface
921 </a>
922 </li>
923
924
925
926 </ul>
927 </nav>
928 </li>
929
930
931
932
933
934
935
936 <li class="md-nav__item">
937 <a href="../legacy-api/" class="md-nav__link">
938 Legacy API
939 </a>
940 </li>
941
942
943
944
945
946
947
948 <li class="md-nav__item">
949 <a href="../helper-functions/" class="md-nav__link">
950 Helper Functions
951 </a>
952 </li>
953
954
955
956
957
958
959
960 <li class="md-nav__item">
961 <a href="../code-snippets/" class="md-nav__link">
962 Code Snippets
963 </a>
964 </li>
965
966
967
968 </ul>
969 </nav>
970 </li>
971
972
973
974
975
976
977
978
979
980
981
982 <li class="md-nav__item md-nav__item--nested">
983
984
985 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" >
986
987 <label class="md-nav__link" for="__nav_5">
988 Package Components
989 <span class="md-nav__icon md-icon"></span>
990 </label>
991 <nav class="md-nav" aria-label="Package Components" data-md-level="1">
992 <label class="md-nav__title" for="__nav_5">
993 <span class="md-nav__icon md-icon"></span>
994 Package Components
995 </label>
996 <ul class="md-nav__list" data-md-scrollfix>
997
998
999
1000
1001
1002 <li class="md-nav__item">
1003 <a href="../../package/package-xml/" class="md-nav__link">
1004 package.xml
1005 </a>
1006 </li>
1007
1008
1009
1010
1011
1012
1013
1014
1015 <li class="md-nav__item md-nav__item--nested">
1016
1017
1018 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5_2" type="checkbox" id="__nav_5_2" >
1019
1020 <label class="md-nav__link" for="__nav_5_2">
1021 PIPs
1022 <span class="md-nav__icon md-icon"></span>
1023 </label>
1024 <nav class="md-nav" aria-label="PIPs" data-md-level="2">
1025 <label class="md-nav__title" for="__nav_5_2">
1026 <span class="md-nav__icon md-icon"></span>
1027 PIPs
1028 </label>
1029 <ul class="md-nav__list" data-md-scrollfix>
1030
1031
1032
1033
1034
1035 <li class="md-nav__item">
1036 <a href="../../package/pip/" class="md-nav__link">
1037 Overview
1038 </a>
1039 </li>
1040
1041
1042
1043
1044
1045
1046
1047 <li class="md-nav__item">
1048 <a href="../../package/pip/acl-option/" class="md-nav__link">
1049 aclOption
1050 </a>
1051 </li>
1052
1053
1054
1055
1056
1057
1058
1059 <li class="md-nav__item">
1060 <a href="../../package/pip/acp-menu/" class="md-nav__link">
1061 acpMenu
1062 </a>
1063 </li>
1064
1065
1066
1067
1068
1069
1070
1071 <li class="md-nav__item">
1072 <a href="../../package/pip/acp-search-provider/" class="md-nav__link">
1073 acpSearchProvider
1074 </a>
1075 </li>
1076
1077
1078
1079
1080
1081
1082
1083 <li class="md-nav__item">
1084 <a href="../../package/pip/acp-template/" class="md-nav__link">
1085 acpTemplate
1086 </a>
1087 </li>
1088
1089
1090
1091
1092
1093
1094
1095 <li class="md-nav__item">
1096 <a href="../../package/pip/bbcode/" class="md-nav__link">
1097 bbcode
1098 </a>
1099 </li>
1100
1101
1102
1103
1104
1105
1106
1107 <li class="md-nav__item">
1108 <a href="../../package/pip/box/" class="md-nav__link">
1109 box
1110 </a>
1111 </li>
1112
1113
1114
1115
1116
1117
1118
1119 <li class="md-nav__item">
1120 <a href="../../package/pip/clipboard-action/" class="md-nav__link">
1121 clipboardAction
1122 </a>
1123 </li>
1124
1125
1126
1127
1128
1129
1130
1131 <li class="md-nav__item">
1132 <a href="../../package/pip/core-object/" class="md-nav__link">
1133 coreObject
1134 </a>
1135 </li>
1136
1137
1138
1139
1140
1141
1142
1143 <li class="md-nav__item">
1144 <a href="../../package/pip/cronjob/" class="md-nav__link">
1145 cronjob
1146 </a>
1147 </li>
1148
1149
1150
1151
1152
1153
1154
1155 <li class="md-nav__item">
1156 <a href="../../package/pip/event-listener/" class="md-nav__link">
1157 eventListener
1158 </a>
1159 </li>
1160
1161
1162
1163
1164
1165
1166
1167 <li class="md-nav__item">
1168 <a href="../../package/pip/file/" class="md-nav__link">
1169 file
1170 </a>
1171 </li>
1172
1173
1174
1175
1176
1177
1178
1179 <li class="md-nav__item">
1180 <a href="../../package/pip/language/" class="md-nav__link">
1181 language
1182 </a>
1183 </li>
1184
1185
1186
1187
1188
1189
1190
1191 <li class="md-nav__item">
1192 <a href="../../package/pip/media-provider/" class="md-nav__link">
1193 mediaProvider
1194 </a>
1195 </li>
1196
1197
1198
1199
1200
1201
1202
1203 <li class="md-nav__item">
1204 <a href="../../package/pip/menu/" class="md-nav__link">
1205 menu
1206 </a>
1207 </li>
1208
1209
1210
1211
1212
1213
1214
1215 <li class="md-nav__item">
1216 <a href="../../package/pip/menu-item/" class="md-nav__link">
1217 menuItem
1218 </a>
1219 </li>
1220
1221
1222
1223
1224
1225
1226
1227 <li class="md-nav__item">
1228 <a href="../../package/pip/object-type/" class="md-nav__link">
1229 objectType
1230 </a>
1231 </li>
1232
1233
1234
1235
1236
1237
1238
1239 <li class="md-nav__item">
1240 <a href="../../package/pip/object-type-definition/" class="md-nav__link">
1241 objectTypeDefinition
1242 </a>
1243 </li>
1244
1245
1246
1247
1248
1249
1250
1251 <li class="md-nav__item">
1252 <a href="../../package/pip/option/" class="md-nav__link">
1253 option
1254 </a>
1255 </li>
1256
1257
1258
1259
1260
1261
1262
1263 <li class="md-nav__item">
1264 <a href="../../package/pip/page/" class="md-nav__link">
1265 page
1266 </a>
1267 </li>
1268
1269
1270
1271
1272
1273
1274
1275 <li class="md-nav__item">
1276 <a href="../../package/pip/pip/" class="md-nav__link">
1277 pip
1278 </a>
1279 </li>
1280
1281
1282
1283
1284
1285
1286
1287 <li class="md-nav__item">
1288 <a href="../../package/pip/script/" class="md-nav__link">
1289 script
1290 </a>
1291 </li>
1292
1293
1294
1295
1296
1297
1298
1299 <li class="md-nav__item">
1300 <a href="../../package/pip/smiley/" class="md-nav__link">
1301 smiley
1302 </a>
1303 </li>
1304
1305
1306
1307
1308
1309
1310
1311 <li class="md-nav__item">
1312 <a href="../../package/pip/sql/" class="md-nav__link">
1313 sql
1314 </a>
1315 </li>
1316
1317
1318
1319
1320
1321
1322
1323 <li class="md-nav__item">
1324 <a href="../../package/pip/style/" class="md-nav__link">
1325 style
1326 </a>
1327 </li>
1328
1329
1330
1331
1332
1333
1334
1335 <li class="md-nav__item">
1336 <a href="../../package/pip/template/" class="md-nav__link">
1337 template
1338 </a>
1339 </li>
1340
1341
1342
1343
1344
1345
1346
1347 <li class="md-nav__item">
1348 <a href="../../package/pip/template-listener/" class="md-nav__link">
1349 templateListener
1350 </a>
1351 </li>
1352
1353
1354
1355
1356
1357
1358
1359 <li class="md-nav__item">
1360 <a href="../../package/pip/user-group-option/" class="md-nav__link">
1361 userGroupOption
1362 </a>
1363 </li>
1364
1365
1366
1367
1368
1369
1370
1371 <li class="md-nav__item">
1372 <a href="../../package/pip/user-menu/" class="md-nav__link">
1373 userMenu
1374 </a>
1375 </li>
1376
1377
1378
1379
1380
1381
1382
1383 <li class="md-nav__item">
1384 <a href="../../package/pip/user-notification-event/" class="md-nav__link">
1385 userNotificationEvent
1386 </a>
1387 </li>
1388
1389
1390
1391
1392
1393
1394
1395 <li class="md-nav__item">
1396 <a href="../../package/pip/user-option/" class="md-nav__link">
1397 userOption
1398 </a>
1399 </li>
1400
1401
1402
1403
1404
1405
1406
1407 <li class="md-nav__item">
1408 <a href="../../package/pip/user-profile-menu/" class="md-nav__link">
1409 userProfileMenu
1410 </a>
1411 </li>
1412
1413
1414
1415 </ul>
1416 </nav>
1417 </li>
1418
1419
1420
1421
1422
1423
1424
1425 <li class="md-nav__item">
1426 <a href="../../package/database-php-api/" class="md-nav__link">
1427 Database PHP API
1428 </a>
1429 </li>
1430
1431
1432
1433 </ul>
1434 </nav>
1435 </li>
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447 <li class="md-nav__item md-nav__item--nested">
1448
1449
1450 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" >
1451
1452 <label class="md-nav__link" for="__nav_6">
1453 Migration
1454 <span class="md-nav__icon md-icon"></span>
1455 </label>
1456 <nav class="md-nav" aria-label="Migration" data-md-level="1">
1457 <label class="md-nav__title" for="__nav_6">
1458 <span class="md-nav__icon md-icon"></span>
1459 Migration
1460 </label>
1461 <ul class="md-nav__list" data-md-scrollfix>
1462
1463
1464
1465
1466
1467
1468 <li class="md-nav__item md-nav__item--nested">
1469
1470
1471 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6_1" type="checkbox" id="__nav_6_1" >
1472
1473 <label class="md-nav__link" for="__nav_6_1">
1474 Migrating from WSC 5.3
1475 <span class="md-nav__icon md-icon"></span>
1476 </label>
1477 <nav class="md-nav" aria-label="Migrating from WSC 5.3" data-md-level="2">
1478 <label class="md-nav__title" for="__nav_6_1">
1479 <span class="md-nav__icon md-icon"></span>
1480 Migrating from WSC 5.3
1481 </label>
1482 <ul class="md-nav__list" data-md-scrollfix>
1483
1484
1485
1486
1487
1488 <li class="md-nav__item">
1489 <a href="../../migration/wsc53/php/" class="md-nav__link">
1490 PHP API
1491 </a>
1492 </li>
1493
1494
1495
1496
1497
1498
1499
1500 <li class="md-nav__item">
1501 <a href="../../migration/wsc53/session/" class="md-nav__link">
1502 Session Handling and Authentication
1503 </a>
1504 </li>
1505
1506
1507
1508
1509
1510
1511
1512 <li class="md-nav__item">
1513 <a href="../../migration/wsc53/javascript/" class="md-nav__link">
1514 JavaScript
1515 </a>
1516 </li>
1517
1518
1519
1520
1521
1522
1523
1524 <li class="md-nav__item">
1525 <a href="../../migration/wsc53/templates/" class="md-nav__link">
1526 Templates
1527 </a>
1528 </li>
1529
1530
1531
1532
1533
1534
1535
1536 <li class="md-nav__item">
1537 <a href="../../migration/wsc53/libraries/" class="md-nav__link">
1538 Third Party Libraries
1539 </a>
1540 </li>
1541
1542
1543
1544 </ul>
1545 </nav>
1546 </li>
1547
1548
1549
1550
1551
1552
1553
1554
1555 <li class="md-nav__item md-nav__item--nested">
1556
1557
1558 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6_2" type="checkbox" id="__nav_6_2" >
1559
1560 <label class="md-nav__link" for="__nav_6_2">
1561 Migrating from WSC 5.2
1562 <span class="md-nav__icon md-icon"></span>
1563 </label>
1564 <nav class="md-nav" aria-label="Migrating from WSC 5.2" data-md-level="2">
1565 <label class="md-nav__title" for="__nav_6_2">
1566 <span class="md-nav__icon md-icon"></span>
1567 Migrating from WSC 5.2
1568 </label>
1569 <ul class="md-nav__list" data-md-scrollfix>
1570
1571
1572
1573
1574
1575 <li class="md-nav__item">
1576 <a href="../../migration/wsc52/php/" class="md-nav__link">
1577 PHP API
1578 </a>
1579 </li>
1580
1581
1582
1583
1584
1585
1586
1587 <li class="md-nav__item">
1588 <a href="../../migration/wsc52/templates/" class="md-nav__link">
1589 Templates and Languages
1590 </a>
1591 </li>
1592
1593
1594
1595
1596
1597
1598
1599 <li class="md-nav__item">
1600 <a href="../../migration/wsc52/libraries/" class="md-nav__link">
1601 Third Party Libraries
1602 </a>
1603 </li>
1604
1605
1606
1607 </ul>
1608 </nav>
1609 </li>
1610
1611
1612
1613
1614
1615
1616
1617
1618 <li class="md-nav__item md-nav__item--nested">
1619
1620
1621 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6_3" type="checkbox" id="__nav_6_3" >
1622
1623 <label class="md-nav__link" for="__nav_6_3">
1624 Migrating from WSC 3.1
1625 <span class="md-nav__icon md-icon"></span>
1626 </label>
1627 <nav class="md-nav" aria-label="Migrating from WSC 3.1" data-md-level="2">
1628 <label class="md-nav__title" for="__nav_6_3">
1629 <span class="md-nav__icon md-icon"></span>
1630 Migrating from WSC 3.1
1631 </label>
1632 <ul class="md-nav__list" data-md-scrollfix>
1633
1634
1635
1636
1637
1638 <li class="md-nav__item">
1639 <a href="../../migration/wsc31/php/" class="md-nav__link">
1640 PHP API
1641 </a>
1642 </li>
1643
1644
1645
1646 </ul>
1647 </nav>
1648 </li>
1649
1650
1651
1652
1653
1654
1655
1656
1657 <li class="md-nav__item md-nav__item--nested">
1658
1659
1660 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6_4" type="checkbox" id="__nav_6_4" >
1661
1662 <label class="md-nav__link" for="__nav_6_4">
1663 Migrating from WSC 3.0
1664 <span class="md-nav__icon md-icon"></span>
1665 </label>
1666 <nav class="md-nav" aria-label="Migrating from WSC 3.0" data-md-level="2">
1667 <label class="md-nav__title" for="__nav_6_4">
1668 <span class="md-nav__icon md-icon"></span>
1669 Migrating from WSC 3.0
1670 </label>
1671 <ul class="md-nav__list" data-md-scrollfix>
1672
1673
1674
1675
1676
1677 <li class="md-nav__item">
1678 <a href="../../migration/wsc30/php/" class="md-nav__link">
1679 PHP API
1680 </a>
1681 </li>
1682
1683
1684
1685
1686
1687
1688
1689 <li class="md-nav__item">
1690 <a href="../../migration/wsc30/javascript/" class="md-nav__link">
1691 JavaScript API
1692 </a>
1693 </li>
1694
1695
1696
1697
1698
1699
1700
1701 <li class="md-nav__item">
1702 <a href="../../migration/wsc30/templates/" class="md-nav__link">
1703 Templates
1704 </a>
1705 </li>
1706
1707
1708
1709
1710
1711
1712
1713 <li class="md-nav__item">
1714 <a href="../../migration/wsc30/css/" class="md-nav__link">
1715 CSS
1716 </a>
1717 </li>
1718
1719
1720
1721
1722
1723
1724
1725 <li class="md-nav__item">
1726 <a href="../../migration/wsc30/package/" class="md-nav__link">
1727 Package Components
1728 </a>
1729 </li>
1730
1731
1732
1733 </ul>
1734 </nav>
1735 </li>
1736
1737
1738
1739
1740
1741
1742
1743
1744 <li class="md-nav__item md-nav__item--nested">
1745
1746
1747 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6_5" type="checkbox" id="__nav_6_5" >
1748
1749 <label class="md-nav__link" for="__nav_6_5">
1750 Migrating from WCF 2.1
1751 <span class="md-nav__icon md-icon"></span>
1752 </label>
1753 <nav class="md-nav" aria-label="Migrating from WCF 2.1" data-md-level="2">
1754 <label class="md-nav__title" for="__nav_6_5">
1755 <span class="md-nav__icon md-icon"></span>
1756 Migrating from WCF 2.1
1757 </label>
1758 <ul class="md-nav__list" data-md-scrollfix>
1759
1760
1761
1762
1763
1764 <li class="md-nav__item">
1765 <a href="../../migration/wcf21/php/" class="md-nav__link">
1766 PHP API
1767 </a>
1768 </li>
1769
1770
1771
1772
1773
1774
1775
1776 <li class="md-nav__item">
1777 <a href="../../migration/wcf21/templates/" class="md-nav__link">
1778 Templates
1779 </a>
1780 </li>
1781
1782
1783
1784
1785
1786
1787
1788 <li class="md-nav__item">
1789 <a href="../../migration/wcf21/css/" class="md-nav__link">
1790 CSS
1791 </a>
1792 </li>
1793
1794
1795
1796
1797
1798
1799
1800 <li class="md-nav__item">
1801 <a href="../../migration/wcf21/package/" class="md-nav__link">
1802 Package Components
1803 </a>
1804 </li>
1805
1806
1807
1808 </ul>
1809 </nav>
1810 </li>
1811
1812
1813
1814 </ul>
1815 </nav>
1816 </li>
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828 <li class="md-nav__item md-nav__item--nested">
1829
1830
1831 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" >
1832
1833 <label class="md-nav__link" for="__nav_7">
1834 Tutorials
1835 <span class="md-nav__icon md-icon"></span>
1836 </label>
1837 <nav class="md-nav" aria-label="Tutorials" data-md-level="1">
1838 <label class="md-nav__title" for="__nav_7">
1839 <span class="md-nav__icon md-icon"></span>
1840 Tutorials
1841 </label>
1842 <ul class="md-nav__list" data-md-scrollfix>
1843
1844
1845
1846
1847
1848
1849 <li class="md-nav__item md-nav__item--nested">
1850
1851
1852 <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7_1" type="checkbox" id="__nav_7_1" >
1853
1854 <label class="md-nav__link" for="__nav_7_1">
1855 Tutorial Series
1856 <span class="md-nav__icon md-icon"></span>
1857 </label>
1858 <nav class="md-nav" aria-label="Tutorial Series" data-md-level="2">
1859 <label class="md-nav__title" for="__nav_7_1">
1860 <span class="md-nav__icon md-icon"></span>
1861 Tutorial Series
1862 </label>
1863 <ul class="md-nav__list" data-md-scrollfix>
1864
1865
1866
1867
1868
1869 <li class="md-nav__item">
1870 <a href="../../tutorial/series/overview/" class="md-nav__link">
1871 Overview
1872 </a>
1873 </li>
1874
1875
1876
1877
1878
1879
1880
1881 <li class="md-nav__item">
1882 <a href="../../tutorial/series/part_1/" class="md-nav__link">
1883 Part 1
1884 </a>
1885 </li>
1886
1887
1888
1889
1890
1891
1892
1893 <li class="md-nav__item">
1894 <a href="../../tutorial/series/part_2/" class="md-nav__link">
1895 Part 2
1896 </a>
1897 </li>
1898
1899
1900
1901
1902
1903
1904
1905 <li class="md-nav__item">
1906 <a href="../../tutorial/series/part_3/" class="md-nav__link">
1907 Part 3
1908 </a>
1909 </li>
1910
1911
1912
1913 </ul>
1914 </nav>
1915 </li>
1916
1917
1918
1919 </ul>
1920 </nav>
1921 </li>
1922
1923
1924
1925 </ul>
1926</nav>
1927 </div>
1928 </div>
1929 </div>
1930
1931
1932
1933 <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
1934 <div class="md-sidebar__scrollwrap">
1935 <div class="md-sidebar__inner">
1936
1937<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
1938
1939
1940
1941
1942
1943 <label class="md-nav__title" for="__toc">
1944 <span class="md-nav__icon md-icon"></span>
1945 Table of contents
1946 </label>
1947 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
1948
1949 <li class="md-nav__item">
1950 <a href="#eventkey" class="md-nav__link">
1951 EventKey
1952 </a>
1953
1954 <nav class="md-nav" aria-label="EventKey">
1955 <ul class="md-nav__list">
1956
1957 <li class="md-nav__item">
1958 <a href="#arrowdownevent-keyboardevent-boolean" class="md-nav__link">
1959 ArrowDown(event: KeyboardEvent): boolean
1960 </a>
1961
1962</li>
1963
1964 <li class="md-nav__item">
1965 <a href="#arrowleftevent-keyboardevent-boolean" class="md-nav__link">
1966 ArrowLeft(event: KeyboardEvent): boolean
1967 </a>
1968
1969</li>
1970
1971 <li class="md-nav__item">
1972 <a href="#arrowrightevent-keyboardevent-boolean" class="md-nav__link">
1973 ArrowRight(event: KeyboardEvent): boolean
1974 </a>
1975
1976</li>
1977
1978 <li class="md-nav__item">
1979 <a href="#arrowupevent-keyboardevent-boolean" class="md-nav__link">
1980 ArrowUp(event: KeyboardEvent): boolean
1981 </a>
1982
1983</li>
1984
1985 <li class="md-nav__item">
1986 <a href="#commaevent-keyboardevent-boolean" class="md-nav__link">
1987 Comma(event: KeyboardEvent): boolean
1988 </a>
1989
1990</li>
1991
1992 <li class="md-nav__item">
1993 <a href="#enterevent-keyboardevent-boolean" class="md-nav__link">
1994 Enter(event: KeyboardEvent): boolean
1995 </a>
1996
1997</li>
1998
1999 <li class="md-nav__item">
2000 <a href="#escapeevent-keyboardevent-boolean" class="md-nav__link">
2001 Escape(event: KeyboardEvent): boolean
2002 </a>
2003
2004</li>
2005
2006 <li class="md-nav__item">
2007 <a href="#tabevent-keyboardevent-boolean" class="md-nav__link">
2008 Tab(event: KeyboardEvent): boolean
2009 </a>
2010
2011</li>
2012
2013 </ul>
2014 </nav>
2015
2016</li>
2017
2018 <li class="md-nav__item">
2019 <a href="#eventhandler" class="md-nav__link">
2020 EventHandler
2021 </a>
2022
2023 <nav class="md-nav" aria-label="EventHandler">
2024 <ul class="md-nav__list">
2025
2026 <li class="md-nav__item">
2027 <a href="#identifiying-events-with-the-developer-tools" class="md-nav__link">
2028 Identifiying Events with the Developer Tools
2029 </a>
2030
2031</li>
2032
2033 <li class="md-nav__item">
2034 <a href="#addidentifier-string-action-string-callback-data-object-void-string" class="md-nav__link">
2035 add(identifier: string, action: string, callback: (data: Object) =&gt; void): string
2036 </a>
2037
2038</li>
2039
2040 <li class="md-nav__item">
2041 <a href="#fireidentifier-string-action-string-data-object" class="md-nav__link">
2042 fire(identifier: string, action: string, data?: Object)
2043 </a>
2044
2045</li>
2046
2047 <li class="md-nav__item">
2048 <a href="#removeidentifier-string-action-string-uuid-string" class="md-nav__link">
2049 remove(identifier: string, action: string, uuid: string)
2050 </a>
2051
2052</li>
2053
2054 <li class="md-nav__item">
2055 <a href="#removeallidentifier-string-action-string" class="md-nav__link">
2056 removeAll(identifier: string, action: string)
2057 </a>
2058
2059</li>
2060
2061 <li class="md-nav__item">
2062 <a href="#removeallbysuffixidentifier-string-suffix-string" class="md-nav__link">
2063 removeAllBySuffix(identifier: string, suffix: string)
2064 </a>
2065
2066</li>
2067
2068 </ul>
2069 </nav>
2070
2071</li>
2072
2073 </ul>
2074
2075</nav>
2076 </div>
2077 </div>
2078 </div>
2079
2080
2081 <div class="md-content" data-md-component="content">
2082 <article class="md-content__inner md-typeset">
2083
2084
9b8bddda 2085 <a href="https://github.com/WoltLab/docs.woltlab.com/edit/5.4/docs/javascript/new-api_events.md" title="Edit this page" class="md-content__button md-icon">
7124f4cb
WG
2086 <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>
2087 </a>
2088
0c5338dd
TD
2089
2090 <h1 id="event-handling-javascript-api">Event Handling - JavaScript API<a class="headerlink" href="#event-handling-javascript-api" title="Permanent link">#</a></h1>
2091<h2 id="eventkey"><code>EventKey</code><a class="headerlink" href="#eventkey" title="Permanent link">#</a></h2>
2092<p>This class offers a set of static methods that can be used to determine if some
2093common keys are being pressed. Internally it compares either the <code>.key</code> property
2094if it is supported or the value of <code>.which</code>.</p>
2095<div class="highlight"><pre><span></span><code><span class="nx">require</span><span class="p">([</span><span class="s2">&quot;EventKey&quot;</span><span class="p">],</span> <span class="kd">function</span><span class="p">(</span><span class="nx">EventKey</span><span class="p">)</span> <span class="p">{</span>
2096 <span class="nx">elBySel</span><span class="p">(</span><span class="s2">&quot;.some-input&quot;</span><span class="p">).</span><span class="nx">addEventListener</span><span class="p">(</span><span class="s2">&quot;keydown&quot;</span><span class="p">,</span> <span class="kd">function</span><span class="p">(</span><span class="nx">event</span><span class="p">)</span> <span class="p">{</span>
2097 <span class="k">if</span> <span class="p">(</span><span class="nx">EventKey</span><span class="p">.</span><span class="nx">Enter</span><span class="p">(</span><span class="nx">event</span><span class="p">))</span> <span class="p">{</span>
2098 <span class="c1">// the `Enter` key was pressed</span>
2099 <span class="p">}</span>
2100 <span class="p">});</span>
2101<span class="p">});</span>
2102</code></pre></div>
0c5338dd
TD
2103<h3 id="arrowdownevent-keyboardevent-boolean"><code>ArrowDown(event: KeyboardEvent): boolean</code><a class="headerlink" href="#arrowdownevent-keyboardevent-boolean" title="Permanent link">#</a></h3>
2104<p>Returns true if the user has pressed the <code>↓</code> key.</p>
2105<h3 id="arrowleftevent-keyboardevent-boolean"><code>ArrowLeft(event: KeyboardEvent): boolean</code><a class="headerlink" href="#arrowleftevent-keyboardevent-boolean" title="Permanent link">#</a></h3>
2106<p>Returns true if the user has pressed the <code>←</code> key.</p>
2107<h3 id="arrowrightevent-keyboardevent-boolean"><code>ArrowRight(event: KeyboardEvent): boolean</code><a class="headerlink" href="#arrowrightevent-keyboardevent-boolean" title="Permanent link">#</a></h3>
2108<p>Returns true if the user has pressed the <code>→</code> key.</p>
2109<h3 id="arrowupevent-keyboardevent-boolean"><code>ArrowUp(event: KeyboardEvent): boolean</code><a class="headerlink" href="#arrowupevent-keyboardevent-boolean" title="Permanent link">#</a></h3>
2110<p>Returns true if the user has pressed the <code>↑</code> key.</p>
2111<h3 id="commaevent-keyboardevent-boolean"><code>Comma(event: KeyboardEvent): boolean</code><a class="headerlink" href="#commaevent-keyboardevent-boolean" title="Permanent link">#</a></h3>
2112<p>Returns true if the user has pressed the <code>,</code> key.</p>
2113<h3 id="enterevent-keyboardevent-boolean"><code>Enter(event: KeyboardEvent): boolean</code><a class="headerlink" href="#enterevent-keyboardevent-boolean" title="Permanent link">#</a></h3>
2114<p>Returns true if the user has pressed the <code>↲</code> key.</p>
2115<h3 id="escapeevent-keyboardevent-boolean"><code>Escape(event: KeyboardEvent): boolean</code><a class="headerlink" href="#escapeevent-keyboardevent-boolean" title="Permanent link">#</a></h3>
2116<p>Returns true if the user has pressed the <code>Esc</code> key.</p>
2117<h3 id="tabevent-keyboardevent-boolean"><code>Tab(event: KeyboardEvent): boolean</code><a class="headerlink" href="#tabevent-keyboardevent-boolean" title="Permanent link">#</a></h3>
2118<p>Returns true if the user has pressed the <code>↹</code> key.</p>
2119<h2 id="eventhandler"><code>EventHandler</code><a class="headerlink" href="#eventhandler" title="Permanent link">#</a></h2>
2120<p>A synchronous event system based on string identifiers rather than DOM elements,
2121similar to the PHP event system in WoltLab Suite. Any components can listen to
2122events or trigger events itself at any time.</p>
2123<h3 id="identifiying-events-with-the-developer-tools">Identifiying Events with the Developer Tools<a class="headerlink" href="#identifiying-events-with-the-developer-tools" title="Permanent link">#</a></h3>
2124<p>The Developer Tools in WoltLab Suite 3.1 offer an easy option to identify existing
2125events that are fired while code is being executed. You can enable this watch
2126mode through your browser's console using <code>Devtools.toggleEventLogging()</code>:</p>
2127<div class="highlight"><pre><span></span><code>&gt; Devtools.toggleEventLogging();
2128&lt; Event logging enabled
2129&lt; [Devtools.EventLogging] Firing event: bar @ com.example.app.foo
2130&lt; [Devtools.EventLogging] Firing event: baz @ com.example.app.foo
2131</code></pre></div>
0c5338dd
TD
2132<h3 id="addidentifier-string-action-string-callback-data-object-void-string"><code>add(identifier: string, action: string, callback: (data: Object) =&gt; void): string</code><a class="headerlink" href="#addidentifier-string-action-string-callback-data-object-void-string" title="Permanent link">#</a></h3>
2133<p>Adding an event listeners returns a randomly generated UUIDv4 that is used to
2134identify the listener. This UUID is required to remove a specific listener through
2135the <code>remove()</code> method.</p>
2136<h3 id="fireidentifier-string-action-string-data-object"><code>fire(identifier: string, action: string, data?: Object)</code><a class="headerlink" href="#fireidentifier-string-action-string-data-object" title="Permanent link">#</a></h3>
2137<p>Triggers an event using an optional <code>data</code> object that is passed to each listener
2138by reference.</p>
2139<h3 id="removeidentifier-string-action-string-uuid-string"><code>remove(identifier: string, action: string, uuid: string)</code><a class="headerlink" href="#removeidentifier-string-action-string-uuid-string" title="Permanent link">#</a></h3>
2140<p>Removes a previously registered event listener using the UUID returned by <code>add()</code>.</p>
2141<h3 id="removeallidentifier-string-action-string"><code>removeAll(identifier: string, action: string)</code><a class="headerlink" href="#removeallidentifier-string-action-string" title="Permanent link">#</a></h3>
2142<p>Removes all event listeners registered for the provided <code>identifier</code> and <code>action</code>.</p>
2143<h3 id="removeallbysuffixidentifier-string-suffix-string"><code>removeAllBySuffix(identifier: string, suffix: string)</code><a class="headerlink" href="#removeallbysuffixidentifier-string-suffix-string" title="Permanent link">#</a></h3>
2144<p>Removes all event listeners for an <code>identifier</code> whose action ends with the value
2145of <code>suffix</code>.</p>
2146
4a5c32e1
WG
2147
2148
2149
2150<hr>
2151<div class="md-source-date">
2152 <small>
2153
2154 Last update: 2021-01-08
2155
2156 </small>
2157</div>
2158
2159
0c5338dd
TD
2160
2161
2162
2163
2164
2165
2166 </article>
2167 </div>
2168 </div>
fb962f09 2169
0c5338dd
TD
2170 </main>
2171
2172
2173<footer class="md-footer">
2174
2175 <nav class="md-footer__inner md-grid" aria-label="Footer">
2176
2177 <a href="../new-api_dom/" class="md-footer__link md-footer__link--prev" rel="prev">
2178 <div class="md-footer__button md-icon">
2179 <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>
2180 </div>
2181 <div class="md-footer__title">
2182 <div class="md-ellipsis">
2183 <span class="md-footer__direction">
2184 Previous
2185 </span>
2186 DOM
2187 </div>
2188 </div>
2189 </a>
2190
2191
2192 <a href="../new-api_ajax/" class="md-footer__link md-footer__link--next" rel="next">
2193 <div class="md-footer__title">
2194 <div class="md-ellipsis">
2195 <span class="md-footer__direction">
2196 Next
2197 </span>
2198 Ajax
2199 </div>
2200 </div>
2201 <div class="md-footer__button md-icon">
2202 <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>
2203 </div>
2204 </a>
2205
2206 </nav>
2207
2208 <div class="md-footer-meta md-typeset">
2209 <div class="md-footer-meta__inner md-grid">
2210 <div class="md-footer-copyright">
2211
2212 <div class="md-footer-copyright__highlight">
2213 Copyright © 2020 WoltLab GmbH
2214 </div>
2215
2216 Made with
2217 <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
2218 Material for MkDocs
2219 </a>
fb88dc6e 2220
0c5338dd
TD
2221 </div>
2222 <div class="md-footer-copyright">
2223 <a href="https://www.woltlab.com/legal-notice/">Legal Notice</a>
2224 <a href="https://www.woltlab.com/privacy-policy/">Privacy Policy</a>
2225</div>
2226 </div>
2227 </div>
2228</footer>
2229
2230 </div>
2231 <div class="md-dialog" data-md-component="dialog">
2232 <div class="md-dialog__inner md-typeset"></div>
2233 </div>
fb962f09 2234 <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>
0c5338dd
TD
2235
2236
fb962f09 2237 <script src="../../assets/javascripts/bundle.d892486b.min.js"></script>
0c5338dd
TD
2238
2239
2240 </body>
2241</html>