x4js 1.4.4 → 1.4.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/application.d.ts +96 -0
- package/lib/application.js +146 -0
- package/lib/base64.d.ts +31 -0
- package/lib/base64.js +139 -0
- package/lib/base_component.d.ts +64 -0
- package/lib/base_component.js +81 -0
- package/lib/button.d.ts +145 -0
- package/lib/button.js +241 -0
- package/lib/calendar.d.ts +77 -0
- package/lib/calendar.js +241 -0
- package/lib/canvas.d.ts +88 -0
- package/lib/canvas.js +358 -0
- package/lib/cardview.d.ts +83 -0
- package/lib/cardview.js +156 -0
- package/lib/checkbox.d.ts +72 -0
- package/lib/checkbox.js +130 -0
- package/lib/color.d.ts +144 -0
- package/lib/color.js +588 -0
- package/lib/colorpicker.js +86 -80
- package/lib/combobox.js +26 -22
- package/lib/component.d.ts +572 -0
- package/lib/component.js +1729 -0
- package/lib/datastore.js +29 -20
- package/lib/dialog.js +41 -36
- package/lib/dom_events.d.ts +284 -0
- package/lib/dom_events.js +14 -0
- package/lib/drag_manager.js +4 -1
- package/lib/drawtext.js +9 -5
- package/lib/fileupload.js +19 -12
- package/lib/form.js +29 -25
- package/lib/formatters.js +19 -10
- package/lib/gridview.js +40 -35
- package/lib/hosts/host.d.ts +44 -0
- package/lib/hosts/host.js +73 -0
- package/lib/i18n.d.ts +67 -0
- package/lib/i18n.js +175 -0
- package/lib/icon.d.ts +56 -0
- package/lib/icon.js +178 -0
- package/lib/image.js +7 -3
- package/lib/index.js +71 -55
- package/lib/input.d.ts +86 -0
- package/lib/input.js +176 -0
- package/lib/label.d.ts +54 -0
- package/lib/label.js +90 -0
- package/lib/layout.d.ts +77 -0
- package/lib/layout.js +271 -0
- package/lib/link.js +9 -5
- package/lib/listview.js +34 -27
- package/lib/md5.js +5 -1
- package/lib/menu.d.ts +122 -0
- package/lib/menu.js +284 -0
- package/lib/messagebox.js +22 -17
- package/lib/panel.js +13 -9
- package/lib/popup.d.ts +71 -0
- package/lib/popup.js +378 -0
- package/lib/property_editor.js +20 -16
- package/lib/radiobtn.js +13 -9
- package/lib/rating.js +13 -9
- package/lib/request.js +16 -9
- package/lib/router.js +5 -1
- package/lib/settings.d.ts +33 -0
- package/lib/settings.js +67 -0
- package/lib/sidebarview.js +12 -8
- package/lib/smartedit.js +16 -11
- package/lib/spreadsheet.js +35 -31
- package/lib/styles.d.ts +81 -0
- package/lib/styles.js +268 -0
- package/lib/svgcomponent.js +8 -3
- package/lib/tabbar.js +10 -6
- package/lib/tabview.js +10 -6
- package/lib/textarea.js +10 -6
- package/lib/textedit.js +39 -35
- package/lib/texthiliter.js +8 -4
- package/lib/toaster.js +8 -4
- package/lib/tools.d.ts +382 -0
- package/lib/tools.js +1142 -0
- package/lib/tooltips.js +14 -9
- package/lib/treeview.js +30 -26
- package/lib/x4_events.d.ts +253 -0
- package/lib/x4_events.js +375 -0
- package/package.json +1 -1
- package/src/application.ts +9 -4
- package/src/x4.less +143 -107
- package/tsconfig.json +1 -1
- package/x4.css +1541 -0
package/lib/tooltips.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
"use strict";
|
|
1
2
|
/**
|
|
2
3
|
* ___ ___ __
|
|
3
4
|
* \ \_/ / / _
|
|
@@ -22,16 +23,18 @@
|
|
|
22
23
|
*
|
|
23
24
|
* You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
24
25
|
**/
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
26
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
27
|
+
exports.initTooltips = exports.Tooltip = void 0;
|
|
28
|
+
const component_1 = require("./component");
|
|
29
|
+
const label_1 = require("./label");
|
|
30
|
+
const icon_1 = require("./icon");
|
|
31
|
+
const tools_1 = require("./tools");
|
|
29
32
|
let tipTmo;
|
|
30
33
|
let tooltip;
|
|
31
34
|
/**
|
|
32
35
|
*
|
|
33
36
|
*/
|
|
34
|
-
|
|
37
|
+
class Tooltip extends component_1.Component {
|
|
35
38
|
m_text;
|
|
36
39
|
set text(text) {
|
|
37
40
|
this.m_text.text = text;
|
|
@@ -40,8 +43,8 @@ export class Tooltip extends Component {
|
|
|
40
43
|
render() {
|
|
41
44
|
this.setClass('@non-maskable', true);
|
|
42
45
|
this.setContent([
|
|
43
|
-
new Icon({ icon: 'cls(far fa-circle-info)' }),
|
|
44
|
-
this.m_text = new Label({ text: 'help' })
|
|
46
|
+
new icon_1.Icon({ icon: 'cls(far fa-circle-info)' }),
|
|
47
|
+
this.m_text = new label_1.Label({ text: 'help' })
|
|
45
48
|
]);
|
|
46
49
|
}
|
|
47
50
|
/**
|
|
@@ -75,8 +78,9 @@ export class Tooltip extends Component {
|
|
|
75
78
|
this.setStyle({ left: x, top: y });
|
|
76
79
|
}
|
|
77
80
|
}
|
|
78
|
-
|
|
79
|
-
|
|
81
|
+
exports.Tooltip = Tooltip;
|
|
82
|
+
function initTooltips(cb) {
|
|
83
|
+
if ((0, tools_1.isTouchDevice)()) {
|
|
80
84
|
return;
|
|
81
85
|
}
|
|
82
86
|
let tipTarget = {
|
|
@@ -146,3 +150,4 @@ export function initTooltips(cb) {
|
|
|
146
150
|
document.body.addEventListener('mouseout', handle_mouse);
|
|
147
151
|
document.body.addEventListener('mousemove', handle_mpos);
|
|
148
152
|
}
|
|
153
|
+
exports.initTooltips = initTooltips;
|
package/lib/treeview.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
"use strict";
|
|
1
2
|
/**
|
|
2
3
|
* ___ ___ __
|
|
3
4
|
* \ \_/ / / _
|
|
@@ -22,18 +23,20 @@
|
|
|
22
23
|
*
|
|
23
24
|
* You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
24
25
|
**/
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
26
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
27
|
+
exports.TreeView = void 0;
|
|
28
|
+
const component_1 = require("./component");
|
|
29
|
+
const icon_1 = require("./icon");
|
|
30
|
+
const label_1 = require("./label");
|
|
31
|
+
const layout_1 = require("./layout");
|
|
32
|
+
const x4_events_1 = require("./x4_events");
|
|
30
33
|
function EvExpand(node) {
|
|
31
|
-
return BasicEvent({ node });
|
|
34
|
+
return (0, x4_events_1.BasicEvent)({ node });
|
|
32
35
|
}
|
|
33
36
|
/**
|
|
34
37
|
*
|
|
35
38
|
*/
|
|
36
|
-
|
|
39
|
+
class TreeView extends layout_1.VLayout {
|
|
37
40
|
m_view;
|
|
38
41
|
m_container;
|
|
39
42
|
m_selection;
|
|
@@ -44,15 +47,15 @@ export class TreeView extends VLayout {
|
|
|
44
47
|
props.gadgets = props.gadgets;
|
|
45
48
|
props.sort = props.sort ?? false;
|
|
46
49
|
this.m_selection = null;
|
|
47
|
-
this.m_container = new Container({ cls: '@scroll-container' });
|
|
48
|
-
this.m_view = new Container({
|
|
50
|
+
this.m_container = new component_1.Container({ cls: '@scroll-container' });
|
|
51
|
+
this.m_view = new component_1.Container({
|
|
49
52
|
cls: '@scroll-view',
|
|
50
53
|
flex: 1,
|
|
51
54
|
content: this.m_container
|
|
52
55
|
});
|
|
53
56
|
this.setContent([
|
|
54
57
|
this.m_view,
|
|
55
|
-
props.gadgets ? new HLayout({
|
|
58
|
+
props.gadgets ? new layout_1.HLayout({
|
|
56
59
|
cls: 'gadgets',
|
|
57
60
|
content: props.gadgets
|
|
58
61
|
}) : null,
|
|
@@ -62,7 +65,7 @@ export class TreeView extends VLayout {
|
|
|
62
65
|
this.setDomEvent('contextmenu', (e) => this._handleCtxMenu(e));
|
|
63
66
|
if (props.canDragItems) {
|
|
64
67
|
this.setDomEvent('dragstart', (ev) => {
|
|
65
|
-
let hit = Component.getElement(ev.target, Component);
|
|
68
|
+
let hit = component_1.Component.getElement(ev.target, component_1.Component);
|
|
66
69
|
let node = hit?.getData("node");
|
|
67
70
|
if (node) {
|
|
68
71
|
ev.dataTransfer.effectAllowed = 'move';
|
|
@@ -87,7 +90,7 @@ export class TreeView extends VLayout {
|
|
|
87
90
|
}
|
|
88
91
|
_dragEnter(ev) {
|
|
89
92
|
ev.preventDefault();
|
|
90
|
-
let hit = Component.getElement(ev.target, Component);
|
|
93
|
+
let hit = component_1.Component.getElement(ev.target, component_1.Component);
|
|
91
94
|
let node = hit?.getData("node");
|
|
92
95
|
if (node) {
|
|
93
96
|
hit.addClass('@drag-over');
|
|
@@ -95,14 +98,14 @@ export class TreeView extends VLayout {
|
|
|
95
98
|
}
|
|
96
99
|
}
|
|
97
100
|
_dragLeave(ev) {
|
|
98
|
-
let hit = Component.getElement(ev.target, Component);
|
|
101
|
+
let hit = component_1.Component.getElement(ev.target, component_1.Component);
|
|
99
102
|
let node = hit?.getData("node");
|
|
100
103
|
if (node) {
|
|
101
104
|
hit.removeClass('@drag-over');
|
|
102
105
|
}
|
|
103
106
|
}
|
|
104
107
|
_drop(ev) {
|
|
105
|
-
let hit = Component.getElement(ev.target, Component);
|
|
108
|
+
let hit = component_1.Component.getElement(ev.target, component_1.Component);
|
|
106
109
|
let node = hit?.getData("node");
|
|
107
110
|
if (!node) {
|
|
108
111
|
node = this.m_props.root;
|
|
@@ -120,7 +123,7 @@ export class TreeView extends VLayout {
|
|
|
120
123
|
for (let i = 0; i < ev.dataTransfer.items.length; i++) {
|
|
121
124
|
ev.dataTransfer.items[0].getAsString((value) => {
|
|
122
125
|
let data = JSON.parse(value);
|
|
123
|
-
this.emit('drag', EvDrag(node, data, parent));
|
|
126
|
+
this.emit('drag', (0, x4_events_1.EvDrag)(node, data, parent));
|
|
124
127
|
});
|
|
125
128
|
}
|
|
126
129
|
}
|
|
@@ -222,13 +225,13 @@ export class TreeView extends VLayout {
|
|
|
222
225
|
}
|
|
223
226
|
}
|
|
224
227
|
_renderDef(node) {
|
|
225
|
-
return new Label({ cls: 'tree-label', flex: 1, text: node.text });
|
|
228
|
+
return new label_1.Label({ cls: 'tree-label', flex: 1, text: node.text });
|
|
226
229
|
}
|
|
227
230
|
_makeNode(node, cls, icon, level) {
|
|
228
|
-
const item = new HLayout({
|
|
231
|
+
const item = new layout_1.HLayout({
|
|
229
232
|
cls,
|
|
230
233
|
content: [
|
|
231
|
-
new Icon({ cls: 'tree-icon', icon }),
|
|
234
|
+
new icon_1.Icon({ cls: 'tree-icon', icon }),
|
|
232
235
|
this.m_props.renderItem ? this.m_props.renderItem(node) : this._renderDef(node),
|
|
233
236
|
],
|
|
234
237
|
data: {
|
|
@@ -319,7 +322,7 @@ export class TreeView extends VLayout {
|
|
|
319
322
|
onsub = true;
|
|
320
323
|
}
|
|
321
324
|
while (dom != this.dom) {
|
|
322
|
-
let el = Component.getElement(dom);
|
|
325
|
+
let el = component_1.Component.getElement(dom);
|
|
323
326
|
let nd = el?.getData('node');
|
|
324
327
|
if (nd) {
|
|
325
328
|
if (nd.children && !onsub) {
|
|
@@ -339,14 +342,14 @@ export class TreeView extends VLayout {
|
|
|
339
342
|
this.selection = nd.id;
|
|
340
343
|
if (!onsub) {
|
|
341
344
|
if (ev.type == 'click') {
|
|
342
|
-
this.emit('click', EvClick(nd));
|
|
345
|
+
this.emit('click', (0, x4_events_1.EvClick)(nd));
|
|
343
346
|
}
|
|
344
347
|
else {
|
|
345
|
-
this.emit('dblclick', EvDblClick(nd));
|
|
348
|
+
this.emit('dblclick', (0, component_1.EvDblClick)(nd));
|
|
346
349
|
}
|
|
347
350
|
}
|
|
348
351
|
}
|
|
349
|
-
this.emit('selectionchange', EvSelectionChange(nd));
|
|
352
|
+
this.emit('selectionchange', (0, x4_events_1.EvSelectionChange)(nd));
|
|
350
353
|
return;
|
|
351
354
|
}
|
|
352
355
|
dom = dom.parentElement;
|
|
@@ -354,7 +357,7 @@ export class TreeView extends VLayout {
|
|
|
354
357
|
if (ev.type == 'click') {
|
|
355
358
|
this.m_selection = null;
|
|
356
359
|
this.update();
|
|
357
|
-
this.emit('selectionchange', EvSelectionChange(null));
|
|
360
|
+
this.emit('selectionchange', (0, x4_events_1.EvSelectionChange)(null));
|
|
358
361
|
}
|
|
359
362
|
}
|
|
360
363
|
_handleCtxMenu(ev) {
|
|
@@ -362,7 +365,7 @@ export class TreeView extends VLayout {
|
|
|
362
365
|
let dom = ev.target;
|
|
363
366
|
let idom = dom;
|
|
364
367
|
while (dom != this.dom) {
|
|
365
|
-
let el = Component.getElement(dom);
|
|
368
|
+
let el = component_1.Component.getElement(dom);
|
|
366
369
|
let nd = el?.getData('node');
|
|
367
370
|
if (nd) {
|
|
368
371
|
if (nd.children) {
|
|
@@ -373,14 +376,14 @@ export class TreeView extends VLayout {
|
|
|
373
376
|
}
|
|
374
377
|
this.m_selection = { id: nd.id, el: null };
|
|
375
378
|
this.update();
|
|
376
|
-
this.emit('contextMenu', EvContextMenu(ev, nd));
|
|
379
|
+
this.emit('contextMenu', (0, x4_events_1.EvContextMenu)(ev, nd));
|
|
377
380
|
return;
|
|
378
381
|
}
|
|
379
382
|
dom = dom.parentElement;
|
|
380
383
|
}
|
|
381
384
|
this.m_selection = null;
|
|
382
385
|
this.update();
|
|
383
|
-
this.emit('contextMenu', EvContextMenu(ev, null));
|
|
386
|
+
this.emit('contextMenu', (0, x4_events_1.EvContextMenu)(ev, null));
|
|
384
387
|
}
|
|
385
388
|
/**
|
|
386
389
|
* constructs a tree node from an array of strings
|
|
@@ -488,3 +491,4 @@ export class TreeView extends VLayout {
|
|
|
488
491
|
return root;
|
|
489
492
|
}
|
|
490
493
|
}
|
|
494
|
+
exports.TreeView = TreeView;
|
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ___ ___ __
|
|
3
|
+
* \ \_/ / / _
|
|
4
|
+
* \ / /_| |_
|
|
5
|
+
* / _ \____ _|
|
|
6
|
+
* /__/ \__\ |_|
|
|
7
|
+
*
|
|
8
|
+
* @file observable.ts
|
|
9
|
+
* @author Etienne Cochard
|
|
10
|
+
* @license
|
|
11
|
+
* Copyright (c) 2019-2021 R-libre ingenierie
|
|
12
|
+
*
|
|
13
|
+
* This program is free software; you can redistribute it and/or modify
|
|
14
|
+
* it under the terms of the GNU General Public License as published by
|
|
15
|
+
* the Free Software Foundation; either version 3 of the License, or
|
|
16
|
+
* (at your option) any later version.
|
|
17
|
+
*
|
|
18
|
+
* This program is distributed in the hope that it will be useful,
|
|
19
|
+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
20
|
+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
21
|
+
* GNU General Public License for more details.
|
|
22
|
+
*
|
|
23
|
+
* You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
24
|
+
**/
|
|
25
|
+
export declare type EventCallback<T extends BasicEvent = BasicEvent> = (event: T) => any;
|
|
26
|
+
export interface EventDisposer {
|
|
27
|
+
dispose(): void;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Basic event
|
|
31
|
+
* name like that to avoid conflict with Browsers Event class.
|
|
32
|
+
*/
|
|
33
|
+
export interface BasicEvent {
|
|
34
|
+
readonly type?: string;
|
|
35
|
+
readonly source?: unknown;
|
|
36
|
+
readonly context?: any;
|
|
37
|
+
propagationStopped?: boolean;
|
|
38
|
+
defaultPrevented?: boolean;
|
|
39
|
+
stopPropagation?(): void;
|
|
40
|
+
preventDefault?(): void;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* BasicEvent Builder
|
|
44
|
+
* this function is responsable of BasicEvent creation
|
|
45
|
+
* ie. is equivalent of new BasicEvent( xxx );
|
|
46
|
+
* @param params
|
|
47
|
+
* @returns BasicEvent
|
|
48
|
+
*/
|
|
49
|
+
export declare function BasicEvent<T extends BasicEvent = BasicEvent>(params: any): T;
|
|
50
|
+
/**
|
|
51
|
+
* Click Event
|
|
52
|
+
* click event do not have any additional parameters
|
|
53
|
+
*/
|
|
54
|
+
export interface EvClick extends BasicEvent {
|
|
55
|
+
}
|
|
56
|
+
export declare function EvClick(context?: any): EvClick;
|
|
57
|
+
/**
|
|
58
|
+
* Change Event
|
|
59
|
+
* value is the the element value
|
|
60
|
+
*/
|
|
61
|
+
export interface EvChange extends BasicEvent {
|
|
62
|
+
readonly value: any;
|
|
63
|
+
}
|
|
64
|
+
export declare function EvChange(value: unknown, context?: any): EvChange;
|
|
65
|
+
/**
|
|
66
|
+
* Selection Event
|
|
67
|
+
* value is the new selection or null
|
|
68
|
+
*/
|
|
69
|
+
export interface EvSelectionChange extends BasicEvent {
|
|
70
|
+
readonly selection: unknown;
|
|
71
|
+
}
|
|
72
|
+
export declare function EvSelectionChange(selection: unknown, context?: any): EvSelectionChange;
|
|
73
|
+
/**
|
|
74
|
+
* ContextMenu Event
|
|
75
|
+
*/
|
|
76
|
+
export interface EvContextMenu extends BasicEvent {
|
|
77
|
+
uievent: UIEvent;
|
|
78
|
+
}
|
|
79
|
+
export declare function EvContextMenu(uievent: UIEvent, context?: any): EvContextMenu;
|
|
80
|
+
/**
|
|
81
|
+
* Timer Event
|
|
82
|
+
* @see startTimer, stopTimer
|
|
83
|
+
*/
|
|
84
|
+
export interface EvTimer extends BasicEvent {
|
|
85
|
+
timer: string;
|
|
86
|
+
time: number;
|
|
87
|
+
}
|
|
88
|
+
export declare function EvTimer(timer: string, time?: number, context?: any): EvTimer;
|
|
89
|
+
/**
|
|
90
|
+
* Simple message
|
|
91
|
+
*/
|
|
92
|
+
export interface EvMessage extends BasicEvent {
|
|
93
|
+
readonly msg: string;
|
|
94
|
+
readonly params?: any;
|
|
95
|
+
}
|
|
96
|
+
export declare function EvMessage(msg: string, params?: unknown, source?: unknown): EvMessage;
|
|
97
|
+
/**
|
|
98
|
+
* Drag/Drop event
|
|
99
|
+
*/
|
|
100
|
+
export interface EvDrag extends BasicEvent {
|
|
101
|
+
element: unknown;
|
|
102
|
+
data: any;
|
|
103
|
+
}
|
|
104
|
+
export declare function EvDrag(element: unknown, data: any, ctx: any): EvDrag;
|
|
105
|
+
/**
|
|
106
|
+
* this Base interface is used to describe available events & their types
|
|
107
|
+
*
|
|
108
|
+
* you can implement your own event mapping:
|
|
109
|
+
* @example
|
|
110
|
+
* ```ts
|
|
111
|
+
* interface MyEventMap extends EventMap {
|
|
112
|
+
* click: EvClick,
|
|
113
|
+
* 'custom-message': Event,
|
|
114
|
+
* [key: string]: Event,
|
|
115
|
+
* }
|
|
116
|
+
* ```
|
|
117
|
+
*/
|
|
118
|
+
export interface EventMap {
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* basic event types, in general the type is builded from the eventMap
|
|
122
|
+
* this is very usefull for editor completion
|
|
123
|
+
* @example
|
|
124
|
+
* ```ts
|
|
125
|
+
* type MyEventType = MapEvents<MyEventMap>;
|
|
126
|
+
* ```
|
|
127
|
+
*/
|
|
128
|
+
export interface EventTypes {
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* convert an EventMap to a EventType
|
|
132
|
+
*/
|
|
133
|
+
export declare type MapEvents<Type> = {
|
|
134
|
+
[Property in keyof Type]?: (ev: Type[Property]) => any;
|
|
135
|
+
};
|
|
136
|
+
/**
|
|
137
|
+
* Event emitter class
|
|
138
|
+
* this class allow you to emit and handle events
|
|
139
|
+
*
|
|
140
|
+
* @example:
|
|
141
|
+
* ```ts
|
|
142
|
+
*
|
|
143
|
+
* interface EvDoIt extends BasicEvent {
|
|
144
|
+
* param: unknown;
|
|
145
|
+
* }
|
|
146
|
+
*
|
|
147
|
+
* function EvDoIt( e: EvDoIt ) : EvDoIt {
|
|
148
|
+
* return BasicEvent<EvDoIt>( e );
|
|
149
|
+
* }
|
|
150
|
+
*
|
|
151
|
+
* interface TestEventMap extends EventMap {
|
|
152
|
+
* doit: EvDoIt;
|
|
153
|
+
* }
|
|
154
|
+
*
|
|
155
|
+
* let ee = new EventSource<TestEventMap>(null);
|
|
156
|
+
* ee.listen({
|
|
157
|
+
* doit: (e) => {
|
|
158
|
+
* console.log(e);
|
|
159
|
+
* e.preventDefault();
|
|
160
|
+
* },
|
|
161
|
+
* });
|
|
162
|
+
*
|
|
163
|
+
* ee.defaults({
|
|
164
|
+
* doit: (e) => {
|
|
165
|
+
* console.log('default handler for ', e.type, e.selection);
|
|
166
|
+
* },
|
|
167
|
+
* })
|
|
168
|
+
*
|
|
169
|
+
* ee.on('doit', (e) => {
|
|
170
|
+
* debugger;
|
|
171
|
+
* })
|
|
172
|
+
*
|
|
173
|
+
* const ev = EvDoIt({ param: 10 });
|
|
174
|
+
* ee.emit('change', ev);
|
|
175
|
+
* if (ev.defaultPrevented) {
|
|
176
|
+
* console.log('prevented');
|
|
177
|
+
* }
|
|
178
|
+
* ```
|
|
179
|
+
*/
|
|
180
|
+
export declare class EventSource<Q extends EventMap, T extends EventTypes = MapEvents<Q>> {
|
|
181
|
+
private m_source;
|
|
182
|
+
private m_eventRegistry;
|
|
183
|
+
private m_defaultHandlers;
|
|
184
|
+
constructor(source?: unknown);
|
|
185
|
+
/**
|
|
186
|
+
* emit an event
|
|
187
|
+
* you can stop propagation of event or prevent default
|
|
188
|
+
* @param eventName - name of event to emit
|
|
189
|
+
* @param event - event data
|
|
190
|
+
*/
|
|
191
|
+
emit<K extends keyof Q>(type: K, event?: Q[K]): void;
|
|
192
|
+
_emit(eventName: string, e: BasicEvent): void;
|
|
193
|
+
/**
|
|
194
|
+
* signal en event
|
|
195
|
+
* signaled event are notification : no way to prevent default not stop propagation
|
|
196
|
+
* @param eventName name of event to signal
|
|
197
|
+
* @param event event data
|
|
198
|
+
*/
|
|
199
|
+
signal<K extends keyof Q>(type: K, event: Q[K], delay?: number): void;
|
|
200
|
+
_signal(eventName: string, e: BasicEvent, delay?: number): void;
|
|
201
|
+
/**
|
|
202
|
+
* handle an event one time
|
|
203
|
+
* @param eventName - event name to handle
|
|
204
|
+
* @param callback - callback to call when event is signaled
|
|
205
|
+
* @returns Promise if callback is null
|
|
206
|
+
*
|
|
207
|
+
* take care with that because if the event is never fired and you await it,
|
|
208
|
+
* the system may overflow
|
|
209
|
+
*/
|
|
210
|
+
once<K extends keyof Q>(type: K, callback: (ev: Q[K]) => any): void;
|
|
211
|
+
_once(eventName: string, callback: EventCallback): Promise<unknown>;
|
|
212
|
+
/**
|
|
213
|
+
* set the event default handler
|
|
214
|
+
* @param eventName - name of the event
|
|
215
|
+
* @param callback - callback to call when the event is not handled (and preventDeault has not been called)
|
|
216
|
+
*/
|
|
217
|
+
setDefaultHandler(eventName: string, callback: EventCallback): void;
|
|
218
|
+
/**
|
|
219
|
+
* remove the previous default handler installed for an event
|
|
220
|
+
* @param eventName - event name
|
|
221
|
+
* @param callback - callback handler to remove (must be the same as in setDefaultHandler)
|
|
222
|
+
*/
|
|
223
|
+
removeDefaultHandler(eventName: string, callback: EventCallback): void;
|
|
224
|
+
/**
|
|
225
|
+
* define a set of listeners in one call
|
|
226
|
+
* @param events
|
|
227
|
+
*/
|
|
228
|
+
listen(events: T): void;
|
|
229
|
+
/**
|
|
230
|
+
* define a set of default handlers in one call
|
|
231
|
+
* @param events
|
|
232
|
+
*/
|
|
233
|
+
defaults(events: T): void;
|
|
234
|
+
/**
|
|
235
|
+
* listen for an event
|
|
236
|
+
* @param eventName - event name to listen on
|
|
237
|
+
* @param callback - callback to call
|
|
238
|
+
* @param capturing - if true, capture event before other registred event handlers
|
|
239
|
+
*/
|
|
240
|
+
on<K extends keyof Q>(type: K, callback: (ev: Q[K]) => any): EventDisposer;
|
|
241
|
+
_on(eventName: string, callback: EventCallback, capturing?: boolean): EventDisposer;
|
|
242
|
+
/**
|
|
243
|
+
* stop listening to an event
|
|
244
|
+
* @param eventName - event name
|
|
245
|
+
* @param callback - callback to remove (must be the same as in on )
|
|
246
|
+
*/
|
|
247
|
+
off(eventName: string, callback: EventCallback): void;
|
|
248
|
+
/**
|
|
249
|
+
* remove all listeners for an event
|
|
250
|
+
* @param eventName - event name
|
|
251
|
+
*/
|
|
252
|
+
removeAllListeners(eventName: string | null): void;
|
|
253
|
+
}
|