/
Matreshka#unbindNode.jsdoc.js
92 lines (79 loc) · 3.4 KB
/
Matreshka#unbindNode.jsdoc.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
/**
@method Seemple#unbindNode
@importance 2
@fires unbind
@fires unbind:KEY
@summary Розриває зв'язок між властивістю і HTML елементом
@desc Використовуючи цей метод, можна видалити доданий раніше, але вже не потрібний зв'язок між властивістю і елементом.
@param {string|null} key - Ключ або список ключів, розділених пробілами. Якщо замість ключа передати null, будуть видалені всі прив'язки для даного об'єкта.
@param {string|node|$nodes} [node] - HTML елемент, з яким властивість більше не хоче мати справи
@param {eventOptions} [eventOptions] - Об'єкт події, в який можна передати якісь дані для обробника або ключ ``"silent"``, який відключає генерацію подій ``"unbind"`` і ``"unbind:KEY"``
@returns {seemple} self
@example
this.bindNode('myKey', '.my-element');
// Змінює значення властивості і стан HTML елемента
this.myKey = true;
this.unbindNode('myKey', '.my-element');
// Тепер змінюється лише значення властивості
this.myKey = false;
*/
/**
@method Seemple#unbindNode
@importance 2
@variation 2
@summary Альтернативний синтаксис ``unbindNode``, що дозволяє передати об'єкт з байндінгамі. Див. {@link Seemple#bindNode(2)}
@param {object} bindings (див. приклад)
@param {eventOptions} [eventOptions] (див. вище)
@returns {seemple} self
@example
this.unbindNode({
foo: '.aaa'
bar: {
node: '.bbb'
},
baz: [{
node: '.ccc'
}, {
node: '.ddd'
}]
});
*/
/**
@method Seemple#unbindNode
@importance 2
@variation 3
@summary Альтернативний синтаксис, що дозволяє видалити необмежену кількість байндінгів одним викликом методу.
@desc Варіація методу дозволяє передати масссів об'єктів, що містять інформацію про байндінги. Елемент масиву повинен містити наступні властивості:
- ``key`` - ім'я властивості
- ``node`` - елемент, для якого був об'явлений байндінг з ``key`` (не обов'язково)
Ця варіація методу зручна тим, що її синтаксис збігається з однією з варіацій методу {@link Seemple#bindNode}, дозволяючи привласнити байндінгі змінної для швидкого видалення.
@param {array} batch - Массив байндингів
@param {eventOptions} [eventOptions] (див. вище)
@example
const temporaryBindings = [{
key: 'a',
node: '.my-node',
binder: {
setValue(v) {
doSomething(v);
}
}
}, {
key: 'b',
node: document.querySelectorAll('.bar')
event: {
foo: 'bar'
}
}, {
key: 'c.d.e',
node: jQuery('.baz'),
binder: Seemple.binders.html(),
event: {
silent: true,
exactKey: true
}
}]
this.bindNode(temporaryBindings);
// більше не потрібні ці прив'язки
this.unbindNode(temporaryBindings);
*/