@@ -0,0 +1,26 | |||||
|
1 | import { Scope } from "./Scope"; | |||
|
2 | import { destroy, Rendition } from "./traits"; | |||
|
3 | ||||
|
4 | let _scope = Scope.dummy; | |||
|
5 | ||||
|
6 | const beginRender = async () => { | |||
|
7 | } | |||
|
8 | ||||
|
9 | const endRender = () => { | |||
|
10 | } | |||
|
11 | ||||
|
12 | export const getScope = () => _scope; | |||
|
13 | ||||
|
14 | export const render = async (rendition: () => Rendition, scope = Scope.dummy) => { | |||
|
15 | await beginRender(); | |||
|
16 | const prev = _scope; | |||
|
17 | _scope = scope; | |||
|
18 | try { | |||
|
19 | const node = rendition().getDomNode(); | |||
|
20 | scope.own(() => destroy(node)); | |||
|
21 | return node; | |||
|
22 | } finally { | |||
|
23 | _scope = prev; | |||
|
24 | endRender(); | |||
|
25 | } | |||
|
26 | } |
@@ -0,0 +1,40 | |||||
|
1 | import { IDestroyable, IRemovable } from "@implab/core-amd/interfaces"; | |||
|
2 | import { isDestroyable, isRemovable } from "@implab/core-amd/safe"; | |||
|
3 | ||||
|
4 | export interface IScope { | |||
|
5 | own(target: (() => void) | IDestroyable | IRemovable): void; | |||
|
6 | } | |||
|
7 | ||||
|
8 | export class Scope implements IDestroyable, IScope { | |||
|
9 | private readonly _cleanup: (() => void)[] = []; | |||
|
10 | ||||
|
11 | static readonly dummy: IScope = { own() { } }; | |||
|
12 | ||||
|
13 | own(target: (() => void) | IDestroyable | IRemovable) { | |||
|
14 | if (target instanceof Function) { | |||
|
15 | this._cleanup.push(target); | |||
|
16 | } else if (isDestroyable(target)) { | |||
|
17 | this._cleanup.push(() => target.destroy()); | |||
|
18 | } else if (isRemovable(target)) { | |||
|
19 | this._cleanup.push(() => target.remove()); | |||
|
20 | } | |||
|
21 | } | |||
|
22 | ||||
|
23 | clean() { | |||
|
24 | const guard = (cb: () => void) => { | |||
|
25 | try { | |||
|
26 | cb(); | |||
|
27 | } catch { | |||
|
28 | // guard | |||
|
29 | } | |||
|
30 | } | |||
|
31 | ||||
|
32 | this._cleanup.forEach(guard); | |||
|
33 | this._cleanup.length = 0; | |||
|
34 | } | |||
|
35 | ||||
|
36 | destroy() { | |||
|
37 | this.clean(); | |||
|
38 | } | |||
|
39 | ||||
|
40 | } No newline at end of file |
@@ -0,0 +1,58 | |||||
|
1 | import { id as mid } from "module"; | |||
|
2 | import { TraceSource } from "@implab/core-amd/log/TraceSource"; | |||
|
3 | import { argumentNotNull } from "@implab/core-amd/safe"; | |||
|
4 | import { place } from "dojo/dom-construct"; | |||
|
5 | import { getScope, render } from "./Renderer"; | |||
|
6 | import { RenditionBase } from "./RenditionBase"; | |||
|
7 | import { Scope } from "./Scope"; | |||
|
8 | import { locateNode } from "./traits"; | |||
|
9 | ||||
|
10 | const trace = TraceSource.get(mid); | |||
|
11 | ||||
|
12 | export class WatchRendition<T> extends RenditionBase<Node> { | |||
|
13 | private readonly _factory: (arg: T) => any; | |||
|
14 | ||||
|
15 | private _node: Node; | |||
|
16 | ||||
|
17 | private readonly _scope = new Scope(); | |||
|
18 | ||||
|
19 | constructor(component: (arg: T) => any, subject: any) { | |||
|
20 | super(); | |||
|
21 | argumentNotNull(component, "component"); | |||
|
22 | ||||
|
23 | this._factory = component; | |||
|
24 | ||||
|
25 | this._node = document.createComment("WatchRendition placeholder"); | |||
|
26 | } | |||
|
27 | ||||
|
28 | protected _create(attrs: object, children: any[]) { | |||
|
29 | const _attrs: any = attrs || {}; | |||
|
30 | const _children = children.map(x => this.getItemDom(x)); | |||
|
31 | this._node = this.getItemDom( | |||
|
32 | this._factory.call(null, { ..._attrs, children: _children }) | |||
|
33 | ); | |||
|
34 | ||||
|
35 | const scope = getScope(); | |||
|
36 | scope.own(this._scope); | |||
|
37 | ||||
|
38 | // Π΅ΡΠ»ΠΈ ΠΎΡΡΠ΅Π½Π΄Π΅ΡΠΈΠ»ΠΈ ΡΠ΅ΠΊΡΡ? ΠΈΠ»ΠΈ DocumentFragment | |||
|
39 | } | |||
|
40 | ||||
|
41 | private async _render(value: T) { | |||
|
42 | const [refNode, position] = locateNode(this._node); | |||
|
43 | this._scope.clean(); | |||
|
44 | ||||
|
45 | this._node = await render(() => this._factory(value), this._scope); | |||
|
46 | ||||
|
47 | if (refNode) | |||
|
48 | place(this._node, refNode, position); | |||
|
49 | } | |||
|
50 | ||||
|
51 | protected _getDomNode() { | |||
|
52 | if (!this._node) | |||
|
53 | throw new Error("The instance of the widget isn't created"); | |||
|
54 | return this._node; | |||
|
55 | } | |||
|
56 | ||||
|
57 | ||||
|
58 | } |
@@ -1,152 +1,161 | |||||
1 | import { IDestroyable } from "@implab/core-amd/interfaces"; |
|
1 | import { IDestroyable } from "@implab/core-amd/interfaces"; | |
2 | import { isDestroyable } from "@implab/core-amd/safe"; |
|
2 | import { isDestroyable } from "@implab/core-amd/safe"; | |
3 | import _WidgetBase = require("dijit/_WidgetBase"); |
|
3 | import _WidgetBase = require("dijit/_WidgetBase"); | |
4 | import registry = require("dijit/registry"); |
|
4 | import registry = require("dijit/registry"); | |
5 | import dom = require("dojo/dom-construct"); |
|
5 | import dom = require("dojo/dom-construct"); | |
6 |
|
6 | |||
7 | type _WidgetBaseConstructor = typeof _WidgetBase; |
|
7 | type _WidgetBaseConstructor = typeof _WidgetBase; | |
8 |
|
8 | |||
9 | export type DojoNodePosition = "first" | "after" | "before" | "last" | "replace" | "only" | number; |
|
9 | export type DojoNodePosition = "first" | "after" | "before" | "last" | "replace" | "only" | number; | |
10 |
|
10 | |||
|
11 | export type DojoNodeLocation = [Node | null, DojoNodePosition]; | |||
|
12 | ||||
11 | export interface Rendition<TNode extends Node = Node> { |
|
13 | export interface Rendition<TNode extends Node = Node> { | |
12 | getDomNode(): TNode; |
|
14 | getDomNode(): TNode; | |
13 |
|
15 | |||
14 | placeAt(refNode: string | Node, position?: DojoNodePosition): void; |
|
16 | placeAt(refNode: string | Node, position?: DojoNodePosition): void; | |
15 | } |
|
17 | } | |
16 |
|
18 | |||
17 | /** |
|
19 | /** | |
18 | * @deprecated use Rendition |
|
20 | * @deprecated use Rendition | |
19 | */ |
|
21 | */ | |
20 | export type BuildContext<TNode extends Node = Node> = Rendition<TNode>; |
|
22 | export type BuildContext<TNode extends Node = Node> = Rendition<TNode>; | |
21 |
|
23 | |||
22 | export interface IRecursivelyDestroyable { |
|
24 | export interface IRecursivelyDestroyable { | |
23 | destroyRecursive(): void; |
|
25 | destroyRecursive(): void; | |
24 | } |
|
26 | } | |
25 |
|
27 | |||
26 | export function isNode(el: any): el is Node { |
|
28 | export function isNode(el: any): el is Node { | |
27 | return el && el.nodeName && el.nodeType; |
|
29 | return el && el.nodeName && el.nodeType; | |
28 | } |
|
30 | } | |
29 |
|
31 | |||
30 | export function isElementNode(el: any): el is Element { |
|
32 | export function isElementNode(el: any): el is Element { | |
31 | return isNode(el) && el.nodeType === 1; |
|
33 | return isNode(el) && el.nodeType === 1; | |
32 | } |
|
34 | } | |
33 |
|
35 | |||
34 | export function isTextNode(el: any): el is Text { |
|
36 | export function isTextNode(el: any): el is Text { | |
35 | return isNode(el) && el.nodeType === 3; |
|
37 | return isNode(el) && el.nodeType === 3; | |
36 | } |
|
38 | } | |
37 |
|
39 | |||
38 | export function isProcessingInstructionNode(el: any): el is ProcessingInstruction { |
|
40 | export function isProcessingInstructionNode(el: any): el is ProcessingInstruction { | |
39 | return isNode(el) && el.nodeType === 7; |
|
41 | return isNode(el) && el.nodeType === 7; | |
40 | } |
|
42 | } | |
41 |
|
43 | |||
42 | export function isCommentNode(el: any): el is Comment { |
|
44 | export function isCommentNode(el: any): el is Comment { | |
43 | return isNode(el) && el.nodeType === 8; |
|
45 | return isNode(el) && el.nodeType === 8; | |
44 | } |
|
46 | } | |
45 |
|
47 | |||
46 | export function isDocumentNode(el: any): el is Document { |
|
48 | export function isDocumentNode(el: any): el is Document { | |
47 | return isNode(el) && el.nodeType === 9; |
|
49 | return isNode(el) && el.nodeType === 9; | |
48 | } |
|
50 | } | |
49 |
|
51 | |||
50 | export function isDocumentTypeNode(el: any): el is DocumentType { |
|
52 | export function isDocumentTypeNode(el: any): el is DocumentType { | |
51 | return isNode(el) && el.nodeType === 10; |
|
53 | return isNode(el) && el.nodeType === 10; | |
52 | } |
|
54 | } | |
53 |
|
55 | |||
54 | export function isDocumentFragmentNode(el: any): el is DocumentFragment { |
|
56 | export function isDocumentFragmentNode(el: any): el is DocumentFragment { | |
55 | return isNode(el) && el.nodeType === 11; |
|
57 | return isNode(el) && el.nodeType === 11; | |
56 | } |
|
58 | } | |
57 |
|
59 | |||
58 | export function isWidget(v: any): v is _WidgetBase { |
|
60 | export function isWidget(v: any): v is _WidgetBase { | |
59 | return v && "domNode" in v; |
|
61 | return v && "domNode" in v; | |
60 | } |
|
62 | } | |
61 |
|
63 | |||
62 | export function isRendition(v: any): v is Rendition { |
|
64 | export function isRendition(v: any): v is Rendition { | |
63 | return v && typeof v.getDomElement === "function"; |
|
65 | return v && typeof v.getDomElement === "function"; | |
64 | } |
|
66 | } | |
65 |
|
67 | |||
66 | /** |
|
68 | /** | |
67 | * @deprecated use isRendition |
|
69 | * @deprecated use isRendition | |
68 | */ |
|
70 | */ | |
69 | export const isBuildContext = isRendition; |
|
71 | export const isBuildContext = isRendition; | |
70 |
|
72 | |||
71 | export function isPlainObject(v: object) { |
|
73 | export function isPlainObject(v: object) { | |
72 | if (typeof v !== "object") |
|
74 | if (typeof v !== "object") | |
73 | return false; |
|
75 | return false; | |
74 |
|
76 | |||
75 | const vp = Object.getPrototypeOf(v); |
|
77 | const vp = Object.getPrototypeOf(v); | |
76 | return !vp || vp === Object.prototype; |
|
78 | return !vp || vp === Object.prototype; | |
77 | } |
|
79 | } | |
78 |
|
80 | |||
79 | export function isWidgetConstructor(v: any): v is _WidgetBaseConstructor { |
|
81 | export function isWidgetConstructor(v: any): v is _WidgetBaseConstructor { | |
80 | return typeof v === "function" && v.prototype && ( |
|
82 | return typeof v === "function" && v.prototype && ( | |
81 | "domNode" in v.prototype || |
|
83 | "domNode" in v.prototype || | |
82 | "buildRendering" in v.prototype |
|
84 | "buildRendering" in v.prototype | |
83 | ); |
|
85 | ); | |
84 | } |
|
86 | } | |
85 |
|
87 | |||
86 | /** Tests whether the specified node is placed in visible dom. |
|
88 | /** Tests whether the specified node is placed in visible dom. | |
87 | * @param {Node} node The node to test |
|
89 | * @param {Node} node The node to test | |
88 | */ |
|
90 | */ | |
89 | export function isInPage(node: Node) { |
|
91 | export function isInPage(node: Node) { | |
90 | return (node === document.body) ? false : document.body.contains(node); |
|
92 | return (node === document.body) ? false : document.body.contains(node); | |
91 | } |
|
93 | } | |
92 |
|
94 | |||
93 | export function isRecursivelyDestroyable(target: any): target is IRecursivelyDestroyable { |
|
95 | export function isRecursivelyDestroyable(target: any): target is IRecursivelyDestroyable { | |
94 | return target && typeof target.destroyRecursive === "function"; |
|
96 | return target && typeof target.destroyRecursive === "function"; | |
95 | } |
|
97 | } | |
96 |
|
98 | |||
97 |
|
99 | |||
98 | /** Destroys DOM Node with all contained widgets. |
|
100 | /** Destroys DOM Node with all contained widgets. | |
99 | * If the specified node is the root node of a widget, then the |
|
101 | * If the specified node is the root node of a widget, then the | |
100 | * widget will be destroyed. |
|
102 | * widget will be destroyed. | |
101 | * |
|
103 | * | |
102 | * @param target DOM Node or widget to destroy |
|
104 | * @param target DOM Node or widget to destroy | |
103 | */ |
|
105 | */ | |
104 | export function destroy(target: Node | IDestroyable | IRecursivelyDestroyable) { |
|
106 | export function destroy(target: Node | IDestroyable | IRecursivelyDestroyable) { | |
105 | if (isRecursivelyDestroyable(target)) { |
|
107 | if (isRecursivelyDestroyable(target)) { | |
106 | target.destroyRecursive(); |
|
108 | target.destroyRecursive(); | |
107 | } else if (isDestroyable(target)) { |
|
109 | } else if (isDestroyable(target)) { | |
108 | target.destroy(); |
|
110 | target.destroy(); | |
109 | } else if (isNode(target)) { |
|
111 | } else if (isNode(target)) { | |
110 | if (isElementNode(target)) { |
|
112 | if (isElementNode(target)) { | |
111 | const w = registry.byNode(target); |
|
113 | const w = registry.byNode(target); | |
112 | if (w) { |
|
114 | if (w) { | |
113 | w.destroyRecursive(); |
|
115 | w.destroyRecursive(); | |
114 | } else { |
|
116 | } else { | |
115 | registry.findWidgets(target).forEach(destroy); |
|
117 | registry.findWidgets(target).forEach(destroy); | |
116 | dom.destroy(target); |
|
118 | dom.destroy(target); | |
117 | } |
|
119 | } | |
118 | } |
|
120 | } | |
119 | } |
|
121 | } | |
120 | } |
|
122 | } | |
121 |
|
123 | |||
122 | /** Empties a content of the specified node and destroys all contained widgets. |
|
124 | /** Empties a content of the specified node and destroys all contained widgets. | |
123 | * |
|
125 | * | |
124 | * @param target DOM node to . |
|
126 | * @param target DOM node to . | |
125 | */ |
|
127 | */ | |
126 | export function emptyNode(target: Node) { |
|
128 | export function emptyNode(target: Node) { | |
127 | registry.findWidgets(target).forEach(destroy); |
|
129 | registry.findWidgets(target).forEach(destroy); | |
128 | dom.empty(target); |
|
130 | dom.empty(target); | |
129 | } |
|
131 | } | |
130 |
|
132 | |||
131 | /** This function starts all widgets inside the DOM node if the target is a node |
|
133 | /** This function starts all widgets inside the DOM node if the target is a node | |
132 | * or starts widget itself if the target is the widget. If the specified node |
|
134 | * or starts widget itself if the target is the widget. If the specified node | |
133 | * associated with the widget that widget will be started. |
|
135 | * associated with the widget that widget will be started. | |
134 | * |
|
136 | * | |
135 | * @param target DOM node to find and start widgets or the widget itself. |
|
137 | * @param target DOM node to find and start widgets or the widget itself. | |
136 | */ |
|
138 | */ | |
137 | export function startupWidgets(target: Node | _WidgetBase, skipNode?: Node) { |
|
139 | export function startupWidgets(target: Node | _WidgetBase, skipNode?: Node) { | |
138 | if (isNode(target)) { |
|
140 | if (isNode(target)) { | |
139 | if (isElementNode(target)) { |
|
141 | if (isElementNode(target)) { | |
140 | const w = registry.byNode(target); |
|
142 | const w = registry.byNode(target); | |
141 | if (w) { |
|
143 | if (w) { | |
142 | if (w.startup) |
|
144 | if (w.startup) | |
143 | w.startup(); |
|
145 | w.startup(); | |
144 | } else { |
|
146 | } else { | |
145 | registry.findWidgets(target, skipNode).forEach(x => x.startup()); |
|
147 | registry.findWidgets(target, skipNode).forEach(x => x.startup()); | |
146 | } |
|
148 | } | |
147 | } |
|
149 | } | |
148 | } else { |
|
150 | } else { | |
149 | if (target.startup) |
|
151 | if (target.startup) | |
150 | target.startup(); |
|
152 | target.startup(); | |
151 | } |
|
153 | } | |
152 | } |
|
154 | } | |
|
155 | ||||
|
156 | export function locateNode(node: Node): DojoNodeLocation { | |||
|
157 | const next = node.nextSibling; | |||
|
158 | return next ? | |||
|
159 | [next, "before"] : | |||
|
160 | [node.parentNode, "last"]; | |||
|
161 | } No newline at end of file |
General Comments 0
You need to be logged in to leave comments.
Login now