/[suikacvs]/messaging/manakai/lib/Message/DOM/DOMMutationEvents.dis
Suika

Contents of /messaging/manakai/lib/Message/DOM/DOMMutationEvents.dis

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.1 - (show annotations) (download)
Mon Oct 11 10:37:13 2004 UTC (20 years, 1 month ago) by wakaba
Branch: MAIN
CVS Tags: before-dis2-200411, manakai-release-0-3-2, manakai-release-0-3-1, manakai-release-0-4-0, manakai-200612, HEAD
New module added

1 Namespace:
2 @DOMCore:
3 http://suika.fam.cx/~wakaba/archive/2004/8/18/dom-core#
4 @ev:
5 http://www.w3.org/2001/xml-events
6 @lang:
7 http://suika.fam.cx/~wakaba/archive/2004/8/18/lang#
8 @license:
9 http://suika.fam.cx/~wakaba/archive/2004/8/18/license#
10 @ManakaiDOMEvents:
11 http://suika.fam.cx/~wakaba/archive/2004/mdom-ev#
12 @TreeCore:\
13 Module:
14 @Name: DOMMutationEvents
15 @Namespace:
16 http://suika.fam.cx/~wakaba/archive/2004/dom/events#
17 @BindingName:
18 @@@: events
19 @@Type:
20 lang:IDL-DOM
21 @@prefix: dom.w3c.org
22 @FullName:
23 @@lang:en
24 @@@: DOM Mutation Events Module
25 @Description:
26 @@lang:en
27 @@@:
28 Notify any changes to the structure of a document,
29 including attribute or character data modifications.
30 \
31 {NOTE:: Many single modifications can cause
32 multiple mutation events to be dispatched.
33 The ordering of mutation events is implementation
34 dependent.
35 \
36 }
37
38 @Author:
39 @@FullName: Wakaba
40 @@Mail: w@suika.fam.cx
41 @License:
42 license:Perl+MPL
43 @Date.RCS:
44 $Date: 2004/10/10 00:01:08 $
45
46 @ConditionDef:
47 @@Name:DOM2
48 @ConditionDef:
49 @@Name:DOM3
50 @@ISA:DOM2
51 @NormalCondition:DOM3
52
53 @Feature:
54 @@Name:MutationEvents
55 @@Version:2.0
56 @@FullName: DOM Level 2 Mutation Events
57 @@ImplNote:
58 @@@lang:en
59 @@@@:
60 The support for <Feature:Events>/<FeatureVer:2.0> is required.
61 @@Condition[list]:
62 DOM2
63 DOM3
64 @@Contrib:
65 DOMCore:DOMImplementation::
66 @Feature:
67 @@Name:MutationEvents
68 @@Version:3.0
69 @@FullName: DOM Level 3 Mutation Events
70 @@ImplNote:
71 @@@lang:en
72 @@@@:
73 The support for <Feature:Events>/<FeatureVer:3.0> is required.
74 @@Condition[list]:
75 DOM3
76 @@Contrib:
77 DOMCore:DOMImplementation::
78
79
80 @Require:
81 @@Module:
82 @@@Name: DOMEvents
83 @@@FileName:
84 @@@@@: events.idl
85 @@@@For:
86 lang:IDL-DOM
87 @@@Namespace:
88 http://suika.fam.cx/~wakaba/archive/2004/dom/events#
89
90 EventSet:
91 @Event:
92 @@Name:DOMSubtreeModified
93 @@QName:
94 ev:DOMSubtreeModified
95 @@Description:
96 @@@lang:en
97 @@@@:
98 A general event for notification of all changes to the document.
99 \
100 This type of event may be dispatched after a single modification
101 to the document or, at the discretion of the DOM implementation,
102 after multiple changes have occurred.
103 \
104 {NOTE:: The late use should generally be used to accommodate multiple
105 changes that occur either simultaneously or in rapid
106 succession.
107 \
108 }
109 \
110 This event is dispatched after any other events caused
111 by the mutation(s) that have occurred.
112 \
113 {NOTE:: This event can be used instead of the more specific
114 events such as:
115 \
116 - <EV:ev:DOMNodeInserted>
117 \
118 - <EV:ev:DOMNodeRemoved>
119 \
120 - <EV:ev:DOMNodeRemovedFromDocument>
121 \
122 - <EV:ev:DOMNodeInsertedIntoDocument>
123 \
124 - <EV:ev:DOMAttrModified>
125 \
126 - <EV:ev:DOMCharacterDataModified>
127 \
128 - <EV:ev:DOMElementNameChanged>
129 \
130 - <EV:ev:DOMAttributeNameChanged>
131 \
132 }
133 @@Type:MutationEvent
134 @@IsBubbling:1
135 @@IsCancalable:0
136 @@EventTarget:
137 @@@Type:
138 DOMCore:Node
139 @@@Description:
140 @@@@lang:en
141 @@@@@:
142 <IF:Document>, <IF:DocumentFragment>, <IF:Element>
143 or <IF:Attr> node.
144 The lowest common parent of the changes.
145 @@MutationEvent.relatedNode:
146 @@@Type:
147 DOMCore:Node
148 @@@Description:
149 @@@@lang:en
150 @@@@@:
151 If an event is instead dispatched to a subtree
152 indicating a subnode was changed, the changed node.
153 @@SpecLevel:2
154 @Event:
155 @@Name:DOMNodeInserted
156 @@QName:
157 ev:DOMNodeInserted
158 @@Description:
159 @@@lang:en
160 @@@@:
161 A node has been added as a child of another node.
162 @@DefaultActionBefore:
163 @@@lang:en
164 @@@@:
165 The insertion has take place.
166 @@Type:MutationEvent
167 @@IsBubbling:1
168 @@IsCancalable:0
169 @@EventTarget:
170 @@@Type:
171 DOMCore:Node
172 @@@Description:
173 @@@@lang:en
174 @@@@@:
175 <IF:Element>, <IF:Attr>, <IF:Text>, <IF:Comment>,
176 <IF:CDATASection>, <IF:DocumentType>, <IF:EntityReference>
177 or <IF:ProcessingInstruction> node.
178 The node being inserted.
179 @@MutationEvent.relatedNode:
180 @@@Type:
181 DOMCore:Node
182 @@@Description:
183 @@@@lang:en
184 @@@@@:
185 The parent node of the node being inserted.
186 @@SpecLevel:2
187 @Event:
188 @@Name:DOMNodeRemoved
189 @@QName:
190 ev:DOMNodeRemoved
191 @@Description:
192 @@@lang:en
193 @@@@:
194 A node is being removed from its parent node.
195 @@DefaultAction:
196 @@@lang:en
197 @@@@:
198 The node is removed from the tree.
199 @@Type:MutationEvent
200 @@IsBubbling:1
201 @@IsCancalable:0
202 @@EventTarget:
203 @@@Type:
204 DOMCore:Node
205 @@@Description:
206 @@@@lang:en
207 @@@@@:
208 <IF:Element>, <IF:Attr>, <IF:Text>, <IF:Comment>,
209 <IF:CDATASection>, <IF:DocumentType>, <IF:EntityReference>
210 or <IF:ProcessingInstruction> node.
211 The node being removed.
212 @@MutationEvent.relatedNode:
213 @@@Type:
214 DOMCore:Node
215 @@@Description:
216 @@@@lang:en
217 @@@@@:
218 The parent node of the node being removed.
219 @@SpecLevel:2
220 @Event:
221 @@QName:
222 ev:DOMNodeRemovedFromDocument
223 @@Name:DOMNodeRemovedFromDocument
224 @@Description:
225 @@@lang:en
226 @@@@:
227 A node is being removed from a document, either through
228 direct removal of the node or removal of a subtree
229 in which it is contained.
230 @@ActionBefore:
231 @@@Description:
232 @@@@lang:en
233 @@@@@:
234 If the node is being directly removed, the event
235 <EV:ev:DOMNodeRemoved> will fire before this event.
236 @@ActionAfter:
237 @@@Description:
238 @@@@lang:en
239 @@@@@:
240 The removal takes place.
241 @@Type:MutationEvent
242 @@IsBubbling:0
243 @@IsCancalable:0
244 @@EventTarget:
245 @@@Type:
246 DOMCore:Node
247 @@@Description:
248 @@@@lang:en
249 @@@@@:
250 <IF:Element>, <IF:Attr>, <IF:Text>, <IF:Comment>,
251 <IF:CDATASection>, <IF:DocumentType>, <IF:EntityReference>
252 or <IF:ProcessingInstruction> node.
253 The node being removed.
254 @@SpecLevel:2
255 @Event:
256 @@Name:DOMNodeInsertedIntoDocument
257 @@QName:
258 ev:DOMNodeInsertedIntoDocument
259 @@Description:
260 @@@lang:en
261 @@@@:
262 A node is being inserted into a document, either through
263 direct insertion of the node or insertion of a subtree
264 in which it is contained.
265 \
266 If the node is being directly inserted, the event
267 <EV:ev:DOMNodeInserted> will fire before this event.
268 @@ActionBefore:
269 @@@Description:
270 @@@@lang:en
271 @@@@@:
272 The insertion has taken place.
273 @@Type:MutationEvent
274 @@IsBubbling:0
275 @@IsCancalable:0
276 @@EventTarget:
277 @@@Type:
278 DOMCore:Node
279 @@@Description:
280 @@@@lang:en
281 @@@@@:
282 <IF:Element>, <IF:Attr>, <IF:Text>, <IF:Comment>,
283 <IF:CDATASection>, <IF:DocumentType>, <IF:EntityReference>
284 or <IF:ProcessingInstruction> node.
285 The node being inserted.
286 @@SpecLevel:2
287 @Event:
288 @@Name:DOMAttrModified
289 @@QName:
290 ev:DOMAttrModified
291 @@Description:
292 @@@lang:en
293 @@@@:
294 An <IF:Attr> has been modified on a node.
295 \
296 String based replacement of an <IF:Attr> value will be
297 viewed as a modification since its identity does not change;
298 replacement of the <IF:Attr> node with a
299 different <IF:Attr> node is viewed as the
300 pair of the removal and the addition.
301 @@ActionBefore:
302 @@@Description:
303 @@@@lang:en
304 @@@@@:
305 The <IF:Attr> has been modified.
306 @@Type:MutationEvent
307 @@IsBubbling:1
308 @@IsCancalable:0
309 @@EventTarget:
310 @@@Type:
311 DOMCore:Element
312 @@@Description:
313 @@@@lang:en
314 @@@@@:
315 The owner <IF:Element>.
316 @@MutationEvent.attrName:
317 @@@Type:
318 DOMMain:DOMString
319 @@@Description:
320 @@@@lang:en
321 @@@@@:
322 The name of the changed <IF:Attr> node.
323 @@MutationEvent.relatedNode:
324 @@@Type:
325 DOMCore:Attr
326 @@@Description:
327 @@@@lang:en
328 @@@@@:
329 The <IF:Attr> node.
330 @@MutationEvent.attrChange:
331 @@@Type:attrChangeType
332 @@@Description:
333 @@@@lang:en
334 @@@@@:
335 The type of modification occurred.
336 @@MutationEvent.newValue:
337 @@@Type:
338 DOMMain:DOMString
339 @@@Description:
340 @@@@lang:en
341 @@@@@:
342 The new value of the <IF:Attr>. This attribute is
343 in use when the node is either added or modified.
344 @@MutationEvent.prevValue:
345 @@@Type:
346 DOMMain:DOMString
347 @@@Description:
348 @@@@lang:en
349 @@@@@:
350 The previous value of the <IF:Attr>. This attribute is
351 in use when the node is either added or modified.
352 @@SpecLevel:2
353 @Event:
354 @@Name:DOMCharacterDataModified
355 @@QName:
356 ev:DOMCharacterDataModified
357 @@Description:
358 @@@lang:en
359 @@@@:
360 Either <A:CharacterData.data> or <A:ProcessingInstruction.data>
361 have been modified (but the node itself has not been inserted
362 or deleted).
363 @@ActionBefore:
364 @@@Description:
365 @@@@lang:en
366 @@@@@:
367 The <A:data> have been modified.
368 @@Type:MutationEvent
369 @@IsBubbling:1
370 @@IsCancalable:0
371 @@EventTarget:
372 @@@Type:
373 DOMCore:Node
374 @@@Description:
375 @@@@lang:en
376 @@@@@:
377 <IF:Text>, <IF:Comment>, <IF:CDATASection> or
378 <IF:ProcessingInstruction> node that has been modified.
379 @@MutationEvent.newValue:
380 @@@Type:
381 DOMMain:DOMString
382 @@@Description:
383 @@@@lang:en
384 @@@@@:
385 The new value of the node. This attribute is
386 in use when the node is either added or modified.
387 @@MutationEvent.prevValue:
388 @@@Type:
389 DOMMain:DOMString
390 @@@Description:
391 @@@@lang:en
392 @@@@@:
393 The new value of the node. This attribute is
394 in use when the node is either added or modified.
395 @@SpecLevel:2
396 @@ImplNote:
397 @@@lang:en
398 @@@@:
399 In the DOM Level 2 Events Specification, some instances
400 of <ERR:DOMCharDataModified> appear in the descriotions.
401 It is error <SRC:DOM Level 2 Errata events-2>.
402 ##ErrorSet
403
404 IF:
405 @Name: MutationEvent
406 @Description:
407 @@lang:en
408 @@@:
409 Provide specific contextual information associated with
410 mutation events.
411 @Example:
412 @@For:
413 lang:Perl
414 @@FullName:
415 @@@lang:en
416 @@@@:
417 Create an instance of the <IF:MutationEvent>
418 @@Code:
419 @@@Type:
420 lang:Perl
421 @@@@:
422 my $mev = $DocumentEvent->createEvent ('MutationEvent');
423
424 @ISA:
425 DOMEvents:Event
426 @Role:
427 @@@:
428 DOMEvents:Event
429 @@compat:
430 ManakaiDOMEvents:Events
431
432 @Level[list]: 2
433 @SpecLevel[list]: 2
434
435 @ConstGroup:
436 @@Name: attrChangeType
437 @@Type:
438 DOMMain:unsigned-short
439 @@Description:
440 @@@lang:en
441 @@@@:
442 The way in which the <IF:Attr> node was changed.
443 @@Const:
444 @@@Name: MODIFICATION
445 @@@Type:
446 DOMMain:unsigned-short
447 @@@Value: 1
448 @@@Description:
449 @@@@lang:en
450 @@@@@:
451 The <IF:Attr> modified in place.
452 @@Const:
453 @@@Name: ADDITION
454 @@@Type:
455 DOMMain:unsigned-short
456 @@@Value: 2
457 @@@Description:
458 @@@@lang:en
459 @@@@@:
460 The <IF:Attr> was just added.
461 @@Const:
462 @@@Name: REMOVAL
463 @@@Type:
464 DOMMain:unsigned-short
465 @@@Value: 3
466 @@@Description:
467 @@@@lang:en
468 @@@@@:
469 The <IF:Attr> was just removed.
470
471 @Attr:
472 @@Name: relatedNode
473 @@Description:
474 @@@lang:en
475 @@@@:
476 A secondary node related to a mutation event.
477 \
478 {eg::
479 \
480 - The parent of a node has changed::
481 The <A:relatedNode> is the changed parent.
482 \
483 }
484 @@Get:
485 @@@Type:
486 DOMCore:Node
487 @@@Def:
488 @@@@Type:
489 lang:dis
490 @@@@GetProp:
491 DOMMutationEvents:relatedNode
492 @Attr:
493 @@Name: prevValue
494 @@Description:
495 @@@lang:en
496 @@@@:
497 The previous value of the node.
498 @@Get:
499 @@@Type:
500 DOMMain:DOMString
501 @@@Def:
502 @@@@Type:
503 lang:dis
504 @@@@GetProp:
505 DOMMutationEvents:prevValue
506 @Attr:
507 @@Name: newValue
508 @@Description:
509 @@@lang:en
510 @@@@:
511 The new value of the node.
512 @@Get:
513 @@@Type:
514 DOMMain:DOMString
515 @@@Def:
516 @@@@Type:
517 lang:dis
518 @@@@GetProp:
519 DOMMutationEvents:newValue
520 @Attr:
521 @@Name: attrName
522 @@Description:
523 @@@lang:en
524 @@@@:
525 The name of the changed <IF:Attr> node.
526 @@Get:
527 @@@Type:
528 DOMMain:DOMString
529 @@@Def:
530 @@@@Type:
531 lang:dis
532 @@@@GetProp:
533 DOMMutationEvents:attrName
534 @Attr:
535 @@Name: attrChange
536 @@Description:
537 @@@lang:en
538 @@@@:
539 The type of change to the <IF:Attr> node.
540 @@Get:
541 @@@Type: attrChangeType
542 @@@Def:
543 @@@@Type:
544 lang:dis
545 @@@@GetProp:
546 DOMMutationEvents:attrChange
547 @Method:
548 @@Name: initMutationEvent
549 @@Description:
550 @@@lang:en
551 @@@@:
552 Initialize the value of a <IF:MutationEvent> object. It has
553 the same behavior as <M:Event.initEvent>.
554 @@NSVersion:initMutationEventNS
555 @@Param:
556 @@@Name: typeArg
557 @@@Type:
558 DOMMain:DOMString
559 @@Param:
560 @@@Name: canBubbleArg
561 @@@Type:
562 DOMMain:boolean
563 @@@InCase:
564 @@@@Value: true
565 @@@InCase:
566 @@@@Value: false
567 @@Param:
568 @@@Name: cancelableArg
569 @@@Type:
570 DOMMain:boolean
571 @@@InCase:
572 @@@@Value: true
573 @@@InCase:
574 @@@@Value: false
575 @@Param:
576 @@@Name: relatedNodeArg
577 @@@Type:
578 DOMCore:Node
579 @@Param:
580 @@@Name: prevValueArg
581 @@@Type:
582 DOMMain:DOMString
583 @@Param:
584 @@@Name: newValueArg
585 @@@Type:
586 DOMMain:DOMString
587 @@Param:
588 @@@Name: attrNameArg
589 @@@Type:
590 DOMMain:DOMString
591 @@Param:
592 @@@Name: attrChangeArg
593 @@@Type: attrChangeType
594 @@Return:
595 @@@Def:
596 @@@@Type:
597 lang:Perl
598 @@@@@:
599 ## Conditional
600 $self->__SUPER{Event}__::initEvent
601 ($typeArg, $canBubbleArg, $cancelableArg);
602 for ($self->{<Q:TreeCore:node>}) {
603 $_->{<Q:DOMMutationEvents:relatedNode>} = $relatedNodeArg;
604 $_->{<Q:DOMMutationEvents:prevValue>} = $prevValueArg;
605 $_->{<Q:DOMMutationEvents:newValue>} = $newValueArg;
606 $_->{<Q:DOMMutationEvents:attrName>} = $attrNameArg;
607 $_->{<Q:DOMMutationEvents:attrChange>} = $attrChangeArg;
608 }
609 @@SpecLevel:2
610 @@Level[list]:
611 2
612 3
613 @Method:
614 @@Name: initMutationEventNS
615 @@Description:
616 @@@lang:en
617 @@@@:
618 Initialize the value of a <IF:MutationEvent> object. It has
619 the same behavior as <M:Event.initEventNS>.
620 @@NoNSVersion:initMutationEventNS
621 @@Param:
622 @@@Name: namespaceURI
623 @@@Type:
624 ManakaiDOM:ManakaiDOMNamespaceURI
625 @@Param:
626 @@@Name: typeArg
627 @@@Type:
628 DOMMain:DOMString
629 @@Param:
630 @@@Name: canBubbleArg
631 @@@Type:
632 DOMMain:boolean
633 @@@InCase:
634 @@@@Value: true
635 @@@InCase:
636 @@@@Value: false
637 @@Param:
638 @@@Name: cancelableArg
639 @@@Type:
640 DOMMain:boolean
641 @@@InCase:
642 @@@@Value: true
643 @@@InCase:
644 @@@@Value: false
645 @@Param:
646 @@@Name: relatedNodeArg
647 @@@Type:
648 DOMCore:Node
649 @@Param:
650 @@@Name: prevValueArg
651 @@@Type:
652 DOMMain:DOMString
653 @@Param:
654 @@@Name: newValueArg
655 @@@Type:
656 DOMMain:DOMString
657 @@Param:
658 @@@Name: attrNameArg
659 @@@Type:
660 DOMMain:DOMString
661 @@Param:
662 @@@Name: attrChangeArg
663 @@@Type: attrChangeType
664 @@Return:
665 @@@Def:
666 @@@@Type:
667 lang:Perl
668 @@@@@:
669 ## Conditional
670 $self->__SUPER{Event}__::initEventNS
671 ($namespaceURI, $typeArg, $canBubbleArg, $cancelableArg);
672 for ($self->{<Q:TreeCore:node>}) {
673 $_->{<Q:DOMMutationEvents:relatedNode>} = $relatedNodeArg;
674 $_->{<Q:DOMMutationEvents:prevValue>} = $prevValueArg;
675 $_->{<Q:DOMMutationEvents:newValue>} = $newValueArg;
676 $_->{<Q:DOMMutationEvents:attrName>} = $attrNameArg;
677 $_->{<Q:DOMMutationEvents:attrChange>} = $attrChangeArg;
678 }
679 @@Level[list]: 3
680 @@SpecLevel[list]: 3
681 ##IF:MutationEvent
682
683 ## DOMMutationEvents.dis ends here

admin@suikawiki.org
ViewVC Help
Powered by ViewVC 1.1.24