|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> |
|
2 <html xmlns:yui="http://yuilibrary.com/rdf/1.0/yui.rdf#"> |
|
3 <head> |
|
4 <meta http-equiv="content-type" content="text/html; charset=UTF-8" /> |
|
5 <title>API: widget-stack WidgetStack (YUI Library)</title> |
|
6 |
|
7 <link rel="stylesheet" type="text/css" href="assets/reset-fonts-grids-min.css" /> |
|
8 <link rel="stylesheet" type="text/css" href="assets/api.css" /> |
|
9 |
|
10 <script type="text/javascript" src="assets/api-js"></script> |
|
11 <script type="text/javascript" src="assets/ac-js"></script> |
|
12 </head> |
|
13 |
|
14 <body id="yahoo-com"> |
|
15 |
|
16 <div id="doc3" class="yui-t2"> |
|
17 <div id="hd"> |
|
18 <h1><a href="http://developer.yahoo.com/yui/" title="Yahoo! UI Library">Yahoo! UI Library</a></h1> |
|
19 <h3>widget-stack <span class="subtitle">3.0.0</span></h3> |
|
20 <a href="./index.html" title="Yahoo! UI Library">Yahoo! UI Library</a> |
|
21 > <a href="./module_widget-stack.html" title="widget-stack">widget-stack</a> |
|
22 > WidgetStack |
|
23 |
|
24 <form onsubmit="return false"> |
|
25 <div id="propertysearch"> |
|
26 Search: <input autocomplete="off" id="searchinput" /> |
|
27 <div id="searchresults"> |
|
28 |
|
29 </div> |
|
30 </div> |
|
31 </form> |
|
32 </div> |
|
33 |
|
34 <div id="bd"> |
|
35 <div id="yui-main"> |
|
36 <div class="yui-b"> |
|
37 <form action="#" name="yui-classopts-form" method="get" id="yui-classopts-form"> |
|
38 <fieldset> |
|
39 <legend>Filters</legend> |
|
40 <span class="classopts"><input type="checkbox" name="show_private" id="show_private" /> <label for="show_private">Show Private</label></span> |
|
41 <span class="classopts"><input type="checkbox" name="show_protected" id="show_protected" /> <label for="show_protected">Show Protected</label></span> |
|
42 <span class="classopts"><input type="checkbox" name="show_deprecated" id="show_deprecated" /> <label for="show_deprecated">Show Deprecated</label></span> |
|
43 </fieldset> |
|
44 </form> |
|
45 |
|
46 <h2> |
|
47 |
|
48 |
|
49 |
|
50 |
|
51 Class <b property="yui:name">WidgetStack</b> |
|
52 <span class="extends"> |
|
53 </span> |
|
54 |
|
55 </h2> |
|
56 <!-- class tree goes here --> |
|
57 |
|
58 |
|
59 |
|
60 |
|
61 <div class="summary description" property="yui:description"> |
|
62 Widget extension, which can be used to add stackable (z-index) support to the |
|
63 base Widget class along with a shimming solution, through the |
|
64 <a href="Base.html#method_build">Base.build</a> method. |
|
65 </div> |
|
66 |
|
67 |
|
68 <div rel="yui:properties" resource="#properties"> |
|
69 <div class="section field details"> |
|
70 <h3 id="properties">Properties</h3> |
|
71 <div class="content"> |
|
72 <div class="" rel="yui:property" resource="#property_WidgetStack.ATTRS"> |
|
73 <h4><a name="property_WidgetStack.ATTRS" property="yui:name">WidgetStack.ATTRS</a> |
|
74 - <code>static <span property="yui:type">Object</span></code> |
|
75 </h4> |
|
76 <div class="detail"> |
|
77 <div class="description" property="yui:description"> |
|
78 Static property used to define the default attribute |
|
79 configuration introduced by WidgetStack. |
|
80 </div> |
|
81 </div> |
|
82 |
|
83 |
|
84 |
|
85 |
|
86 <hr /> |
|
87 </div> |
|
88 <div class="" rel="yui:property" resource="#property_WidgetStack.HTML_PARSER"> |
|
89 <h4><a name="property_WidgetStack.HTML_PARSER" property="yui:name">WidgetStack.HTML_PARSER</a> |
|
90 - <code>static <span property="yui:type">Object</span></code> |
|
91 </h4> |
|
92 <div class="detail"> |
|
93 <div class="description" property="yui:description"> |
|
94 The HTML parsing rules for the WidgetStack class. |
|
95 </div> |
|
96 </div> |
|
97 |
|
98 |
|
99 |
|
100 |
|
101 <hr /> |
|
102 </div> |
|
103 <div class="" rel="yui:property" resource="#property_WidgetStack.SHIM_CLASS_NAME"> |
|
104 <h4><a name="property_WidgetStack.SHIM_CLASS_NAME" property="yui:name">WidgetStack.SHIM_CLASS_NAME</a> |
|
105 - <code>static <span property="yui:type">String</span></code> |
|
106 </h4> |
|
107 <div class="detail"> |
|
108 <div class="description" property="yui:description"> |
|
109 Default class used to mark the shim element |
|
110 </div> |
|
111 </div> |
|
112 |
|
113 |
|
114 <div class="default" property="yui:defaultValue"> |
|
115 Default Value: "yui-widget-shim" |
|
116 </div> |
|
117 |
|
118 |
|
119 <hr /> |
|
120 </div> |
|
121 <div class="" rel="yui:property" resource="#property_WidgetStack.SHIM_TEMPLATE"> |
|
122 <h4><a name="property_WidgetStack.SHIM_TEMPLATE" property="yui:name">WidgetStack.SHIM_TEMPLATE</a> |
|
123 - <code>static <span property="yui:type">String</span></code> |
|
124 </h4> |
|
125 <div class="detail"> |
|
126 <div class="description" property="yui:description"> |
|
127 Default markup template used to generate the shim element. |
|
128 </div> |
|
129 </div> |
|
130 |
|
131 |
|
132 |
|
133 |
|
134 <hr /> |
|
135 </div> |
|
136 <div class="" rel="yui:property" resource="#property_WidgetStack.STACKED_CLASS_NAME"> |
|
137 <h4><a name="property_WidgetStack.STACKED_CLASS_NAME" property="yui:name">WidgetStack.STACKED_CLASS_NAME</a> |
|
138 - <code>static <span property="yui:type">String</span></code> |
|
139 </h4> |
|
140 <div class="detail"> |
|
141 <div class="description" property="yui:description"> |
|
142 Default class used to mark the boundingBox of a stacked widget. |
|
143 </div> |
|
144 </div> |
|
145 |
|
146 |
|
147 <div class="default" property="yui:defaultValue"> |
|
148 Default Value: "yui-widget-stacked" |
|
149 </div> |
|
150 |
|
151 |
|
152 <hr /> |
|
153 </div> |
|
154 </div> |
|
155 </div> |
|
156 |
|
157 </div> |
|
158 |
|
159 <div rel="yui:methods" resource="#methods"> |
|
160 <div class="section method details"> |
|
161 <h3 id="methods">Methods</h3> |
|
162 <div class="content"> |
|
163 <div class="private" rel="yui:method" resource="#method__addShimResizeHandlers"> |
|
164 <h4> |
|
165 <a name="method__addShimResizeHandlers">_addShimResizeHandlers</a></h4> |
|
166 <div class="detail" > |
|
167 <code> |
|
168 private |
|
169 |
|
170 |
|
171 void |
|
172 <strong property="yui:name">_addShimResizeHandlers</strong> |
|
173 ( |
|
174 ) |
|
175 </code> |
|
176 |
|
177 <div class="description" property="yui:description"> |
|
178 Sets up event listeners to resize the shim when the size of the Widget changes. |
|
179 <p> |
|
180 NOTE: This method is only used for IE6 currently, since IE6 doesn't support a way to |
|
181 resize the shim purely through CSS, when the Widget does not have an explicit width/height |
|
182 set. |
|
183 </p> |
|
184 </div> |
|
185 |
|
186 <div class="description"> |
|
187 |
|
188 |
|
189 |
|
190 |
|
191 |
|
192 |
|
193 </div> |
|
194 |
|
195 </div> |
|
196 <hr /> |
|
197 </div> |
|
198 <div class="protected" rel="yui:method" resource="#method__afterShimChange"> |
|
199 <h4> |
|
200 <a name="method__afterShimChange">_afterShimChange</a></h4> |
|
201 <div class="detail" > |
|
202 <code> |
|
203 protected |
|
204 |
|
205 |
|
206 void |
|
207 <strong property="yui:name">_afterShimChange</strong> |
|
208 ( |
|
209 |
|
210 |
|
211 e |
|
212 |
|
213 |
|
214 ) |
|
215 </code> |
|
216 |
|
217 <div class="description" property="yui:description"> |
|
218 Default attribute change listener for the shim attribute, responsible |
|
219 for updating the UI, in response to attribute changes. |
|
220 </div> |
|
221 |
|
222 <div class="description"> |
|
223 |
|
224 <dl rel="yui:parameters"> |
|
225 <dt>Parameters:</dt> |
|
226 <dd rel="yui:parameter"> |
|
227 <code><span property="yui:name">e</span> |
|
228 <<span property="yui:type">EventFacade</span>> |
|
229 </code> |
|
230 <span property="yui:description"> The event facade for the attribute change</span> |
|
231 </dd> |
|
232 </dl> |
|
233 |
|
234 |
|
235 |
|
236 |
|
237 |
|
238 </div> |
|
239 |
|
240 </div> |
|
241 <hr /> |
|
242 </div> |
|
243 <div class="protected" rel="yui:method" resource="#method__afterZIndexChange"> |
|
244 <h4> |
|
245 <a name="method__afterZIndexChange">_afterZIndexChange</a></h4> |
|
246 <div class="detail" > |
|
247 <code> |
|
248 protected |
|
249 |
|
250 |
|
251 void |
|
252 <strong property="yui:name">_afterZIndexChange</strong> |
|
253 ( |
|
254 |
|
255 |
|
256 e |
|
257 |
|
258 |
|
259 ) |
|
260 </code> |
|
261 |
|
262 <div class="description" property="yui:description"> |
|
263 Default attribute change listener for the zIndex attribute, responsible |
|
264 for updating the UI, in response to attribute changes. |
|
265 </div> |
|
266 |
|
267 <div class="description"> |
|
268 |
|
269 <dl rel="yui:parameters"> |
|
270 <dt>Parameters:</dt> |
|
271 <dd rel="yui:parameter"> |
|
272 <code><span property="yui:name">e</span> |
|
273 <<span property="yui:type">EventFacade</span>> |
|
274 </code> |
|
275 <span property="yui:description"> The event facade for the attribute change</span> |
|
276 </dd> |
|
277 </dl> |
|
278 |
|
279 |
|
280 |
|
281 |
|
282 |
|
283 </div> |
|
284 |
|
285 </div> |
|
286 <hr /> |
|
287 </div> |
|
288 <div class="protected" rel="yui:method" resource="#method__bindUIStack"> |
|
289 <h4> |
|
290 <a name="method__bindUIStack">_bindUIStack</a></h4> |
|
291 <div class="detail" > |
|
292 <code> |
|
293 protected |
|
294 |
|
295 |
|
296 void |
|
297 <strong property="yui:name">_bindUIStack</strong> |
|
298 ( |
|
299 ) |
|
300 </code> |
|
301 |
|
302 <div class="description" property="yui:description"> |
|
303 Binds event listeners responsible for updating the UI state in response to |
|
304 Widget stack related state changes. |
|
305 <p> |
|
306 This method is invoked after bindUI is invoked for the Widget class |
|
307 using YUI's aop infrastructure. |
|
308 </p> |
|
309 </div> |
|
310 |
|
311 <div class="description"> |
|
312 |
|
313 |
|
314 |
|
315 |
|
316 |
|
317 |
|
318 </div> |
|
319 |
|
320 </div> |
|
321 <hr /> |
|
322 </div> |
|
323 <div class="private" rel="yui:method" resource="#method__destroyShim"> |
|
324 <h4> |
|
325 <a name="method__destroyShim">_destroyShim</a></h4> |
|
326 <div class="detail" > |
|
327 <code> |
|
328 private |
|
329 |
|
330 |
|
331 void |
|
332 <strong property="yui:name">_destroyShim</strong> |
|
333 ( |
|
334 ) |
|
335 </code> |
|
336 |
|
337 <div class="description" property="yui:description"> |
|
338 Removes the shim from the DOM, and detaches any related event |
|
339 listeners. |
|
340 </div> |
|
341 |
|
342 <div class="description"> |
|
343 |
|
344 |
|
345 |
|
346 |
|
347 |
|
348 |
|
349 </div> |
|
350 |
|
351 </div> |
|
352 <hr /> |
|
353 </div> |
|
354 <div class="private" rel="yui:method" resource="#method__detachStackHandles"> |
|
355 <h4> |
|
356 <a name="method__detachStackHandles">_detachStackHandles</a></h4> |
|
357 <div class="detail" > |
|
358 <code> |
|
359 private |
|
360 |
|
361 |
|
362 void |
|
363 <strong property="yui:name">_detachStackHandles</strong> |
|
364 ( |
|
365 |
|
366 |
|
367 String |
|
368 |
|
369 |
|
370 ) |
|
371 </code> |
|
372 |
|
373 <div class="description" property="yui:description"> |
|
374 Detaches any handles stored for the provided key |
|
375 </div> |
|
376 |
|
377 <div class="description"> |
|
378 |
|
379 <dl rel="yui:parameters"> |
|
380 <dt>Parameters:</dt> |
|
381 <dd rel="yui:parameter"> |
|
382 <code><span property="yui:name">String</span> |
|
383 <<span property="yui:type">object</span>> |
|
384 </code> |
|
385 <span property="yui:description"> handleKey The key defining the group of handles which should be detached</span> |
|
386 </dd> |
|
387 </dl> |
|
388 |
|
389 |
|
390 |
|
391 |
|
392 |
|
393 </div> |
|
394 |
|
395 </div> |
|
396 <hr /> |
|
397 </div> |
|
398 <div class="private" rel="yui:method" resource="#method__getShimTemplate"> |
|
399 <h4> |
|
400 <a name="method__getShimTemplate">_getShimTemplate</a></h4> |
|
401 <div class="detail" > |
|
402 <code> |
|
403 private |
|
404 |
|
405 |
|
406 Node |
|
407 <strong property="yui:name">_getShimTemplate</strong> |
|
408 ( |
|
409 ) |
|
410 </code> |
|
411 |
|
412 <div class="description" property="yui:description"> |
|
413 Creates a cloned shim node, using the SHIM_TEMPLATE html template, for use on a new instance. |
|
414 </div> |
|
415 |
|
416 <div class="description"> |
|
417 |
|
418 |
|
419 <dl> |
|
420 <dt>Returns: |
|
421 <code property="yui:return"> |
|
422 Node |
|
423 </code></dt> |
|
424 <dd property="yui:returnInfo">node A new shim Node instance.</dd> |
|
425 </dl> |
|
426 |
|
427 |
|
428 |
|
429 |
|
430 </div> |
|
431 |
|
432 </div> |
|
433 <hr /> |
|
434 </div> |
|
435 <div class="private" rel="yui:method" resource="#method__renderShim"> |
|
436 <h4> |
|
437 <a name="method__renderShim">_renderShim</a></h4> |
|
438 <div class="detail" > |
|
439 <code> |
|
440 private |
|
441 |
|
442 |
|
443 void |
|
444 <strong property="yui:name">_renderShim</strong> |
|
445 ( |
|
446 ) |
|
447 </code> |
|
448 |
|
449 <div class="description" property="yui:description"> |
|
450 Creates the shim element and adds it to the DOM |
|
451 </div> |
|
452 |
|
453 <div class="description"> |
|
454 |
|
455 |
|
456 |
|
457 |
|
458 |
|
459 |
|
460 </div> |
|
461 |
|
462 </div> |
|
463 <hr /> |
|
464 </div> |
|
465 <div class="private" rel="yui:method" resource="#method__renderShimDeferred"> |
|
466 <h4> |
|
467 <a name="method__renderShimDeferred">_renderShimDeferred</a></h4> |
|
468 <div class="detail" > |
|
469 <code> |
|
470 private |
|
471 |
|
472 |
|
473 void |
|
474 <strong property="yui:name">_renderShimDeferred</strong> |
|
475 ( |
|
476 ) |
|
477 </code> |
|
478 |
|
479 <div class="description" property="yui:description"> |
|
480 Sets up change handlers for the visible attribute, to defer shim creation/rendering |
|
481 until the Widget is made visible. |
|
482 </div> |
|
483 |
|
484 <div class="description"> |
|
485 |
|
486 |
|
487 |
|
488 |
|
489 |
|
490 |
|
491 </div> |
|
492 |
|
493 </div> |
|
494 <hr /> |
|
495 </div> |
|
496 <div class="protected" rel="yui:method" resource="#method__renderUIStack"> |
|
497 <h4> |
|
498 <a name="method__renderUIStack">_renderUIStack</a></h4> |
|
499 <div class="detail" > |
|
500 <code> |
|
501 protected |
|
502 |
|
503 |
|
504 void |
|
505 <strong property="yui:name">_renderUIStack</strong> |
|
506 ( |
|
507 ) |
|
508 </code> |
|
509 |
|
510 <div class="description" property="yui:description"> |
|
511 Creates/Initializes the DOM to support stackability. |
|
512 <p> |
|
513 This method in invoked after renderUI is invoked for the Widget class |
|
514 using YUI's aop infrastructure. |
|
515 </p> |
|
516 </div> |
|
517 |
|
518 <div class="description"> |
|
519 |
|
520 |
|
521 |
|
522 |
|
523 |
|
524 |
|
525 </div> |
|
526 |
|
527 </div> |
|
528 <hr /> |
|
529 </div> |
|
530 <div class="protected" rel="yui:method" resource="#method__setZIndex"> |
|
531 <h4> |
|
532 <a name="method__setZIndex">_setZIndex</a></h4> |
|
533 <div class="detail" > |
|
534 <code> |
|
535 protected |
|
536 |
|
537 |
|
538 Number |
|
539 <strong property="yui:name">_setZIndex</strong> |
|
540 ( |
|
541 |
|
542 |
|
543 zIndex |
|
544 |
|
545 |
|
546 ) |
|
547 </code> |
|
548 |
|
549 <div class="description" property="yui:description"> |
|
550 Default setter for zIndex attribute changes. Normalizes zIndex values to |
|
551 numbers, converting non-numerical values to 0. |
|
552 </div> |
|
553 |
|
554 <div class="description"> |
|
555 |
|
556 <dl rel="yui:parameters"> |
|
557 <dt>Parameters:</dt> |
|
558 <dd rel="yui:parameter"> |
|
559 <code><span property="yui:name">zIndex</span> |
|
560 <<span property="yui:type">String | Number</span>> |
|
561 </code> |
|
562 <span property="yui:description"></span> |
|
563 </dd> |
|
564 </dl> |
|
565 |
|
566 <dl> |
|
567 <dt>Returns: |
|
568 <code property="yui:return"> |
|
569 Number |
|
570 </code></dt> |
|
571 <dd property="yui:returnInfo">Normalized zIndex</dd> |
|
572 </dl> |
|
573 |
|
574 |
|
575 |
|
576 |
|
577 </div> |
|
578 |
|
579 </div> |
|
580 <hr /> |
|
581 </div> |
|
582 <div class="protected" rel="yui:method" resource="#method__syncUIStack"> |
|
583 <h4> |
|
584 <a name="method__syncUIStack">_syncUIStack</a></h4> |
|
585 <div class="detail" > |
|
586 <code> |
|
587 protected |
|
588 |
|
589 |
|
590 void |
|
591 <strong property="yui:name">_syncUIStack</strong> |
|
592 ( |
|
593 ) |
|
594 </code> |
|
595 |
|
596 <div class="description" property="yui:description"> |
|
597 Synchronizes the UI to match the Widgets stack state. This method in |
|
598 invoked after syncUI is invoked for the Widget class using YUI's aop infrastructure. |
|
599 </div> |
|
600 |
|
601 <div class="description"> |
|
602 |
|
603 |
|
604 |
|
605 |
|
606 |
|
607 |
|
608 </div> |
|
609 |
|
610 </div> |
|
611 <hr /> |
|
612 </div> |
|
613 <div class="protected" rel="yui:method" resource="#method__uiSetShim"> |
|
614 <h4> |
|
615 <a name="method__uiSetShim">_uiSetShim</a></h4> |
|
616 <div class="detail" > |
|
617 <code> |
|
618 protected |
|
619 |
|
620 |
|
621 void |
|
622 <strong property="yui:name">_uiSetShim</strong> |
|
623 ( |
|
624 |
|
625 |
|
626 enable |
|
627 |
|
628 |
|
629 ) |
|
630 </code> |
|
631 |
|
632 <div class="description" property="yui:description"> |
|
633 Updates the UI to enable/disable the shim. If the widget is not currently visible, |
|
634 creation of the shim is deferred until it is made visible, for performance reasons. |
|
635 </div> |
|
636 |
|
637 <div class="description"> |
|
638 |
|
639 <dl rel="yui:parameters"> |
|
640 <dt>Parameters:</dt> |
|
641 <dd rel="yui:parameter"> |
|
642 <code><span property="yui:name">enable</span> |
|
643 <<span property="yui:type">boolean</span>> |
|
644 </code> |
|
645 <span property="yui:description"> If true, creates/renders the shim, if false, removes it.</span> |
|
646 </dd> |
|
647 </dl> |
|
648 |
|
649 |
|
650 |
|
651 |
|
652 |
|
653 </div> |
|
654 |
|
655 </div> |
|
656 <hr /> |
|
657 </div> |
|
658 <div class="protected" rel="yui:method" resource="#method__uiSetZIndex"> |
|
659 <h4> |
|
660 <a name="method__uiSetZIndex">_uiSetZIndex</a></h4> |
|
661 <div class="detail" > |
|
662 <code> |
|
663 protected |
|
664 |
|
665 |
|
666 void |
|
667 <strong property="yui:name">_uiSetZIndex</strong> |
|
668 ( |
|
669 |
|
670 |
|
671 zIndex |
|
672 |
|
673 |
|
674 ) |
|
675 </code> |
|
676 |
|
677 <div class="description" property="yui:description"> |
|
678 Updates the UI to reflect the zIndex value passed in. |
|
679 </div> |
|
680 |
|
681 <div class="description"> |
|
682 |
|
683 <dl rel="yui:parameters"> |
|
684 <dt>Parameters:</dt> |
|
685 <dd rel="yui:parameter"> |
|
686 <code><span property="yui:name">zIndex</span> |
|
687 <<span property="yui:type">number</span>> |
|
688 </code> |
|
689 <span property="yui:description"> The zindex to be reflected in the UI</span> |
|
690 </dd> |
|
691 </dl> |
|
692 |
|
693 |
|
694 |
|
695 |
|
696 |
|
697 </div> |
|
698 |
|
699 </div> |
|
700 <hr /> |
|
701 </div> |
|
702 <div class="" rel="yui:method" resource="#method_sizeShim"> |
|
703 <h4> |
|
704 <a name="method_sizeShim">sizeShim</a></h4> |
|
705 <div class="detail" > |
|
706 <code> |
|
707 |
|
708 |
|
709 |
|
710 void |
|
711 <strong property="yui:name">sizeShim</strong> |
|
712 ( |
|
713 ) |
|
714 </code> |
|
715 |
|
716 <div class="description" property="yui:description"> |
|
717 For IE6, synchronizes the size and position of iframe shim to that of |
|
718 Widget bounding box which it is protecting. For all other browsers, |
|
719 this method does not do anything. |
|
720 </div> |
|
721 |
|
722 <div class="description"> |
|
723 |
|
724 |
|
725 |
|
726 |
|
727 |
|
728 |
|
729 </div> |
|
730 |
|
731 </div> |
|
732 <hr /> |
|
733 </div> |
|
734 </div> |
|
735 </div> |
|
736 |
|
737 </div> |
|
738 |
|
739 <div rel="yui:events" resource="#events"> |
|
740 <div class="section method details"> |
|
741 <h3 id="events">Events</h3> |
|
742 <div class="content"> |
|
743 <div class="" rel="yui:event" resource="#event_shimChange"> |
|
744 <h4> |
|
745 <a name="event_shimChange">shimChange</a></h4> |
|
746 <div class="detail"> |
|
747 <code> |
|
748 |
|
749 |
|
750 |
|
751 <strong property="yui:name">shimChange</strong> |
|
752 |
|
753 ( |
|
754 |
|
755 |
|
756 event |
|
757 |
|
758 |
|
759 ) |
|
760 |
|
761 </code> |
|
762 |
|
763 <div class="description" property="yui:description"> |
|
764 Fires when the value for the configuration attribute 'shim' is changed. You can listen for the event using the <a href="Attribute.html#method_on">on</a> method if you wish to be notified before the attribute's value has changed, or using the <a href="Event.Target.html#method_after">after</a> method if you wish to be notified after the attribute's value has changed. |
|
765 </div> |
|
766 |
|
767 <div class="description"> |
|
768 |
|
769 |
|
770 <dl rel="yui:parameters"> |
|
771 <dt>Parameters:</dt> |
|
772 <dd rel="yui:parameter"> |
|
773 <code><span property="yui:name">event</span> |
|
774 <<span property="yui:type">Event.Facade</span>> |
|
775 </code> |
|
776 <span property="yui:description">An Event Facade object with the following attribute specific properties added: <dl> <dt>prevVal</dt> <dd>The value of the attribute, prior to it being set</dd> <dt>newVal</dt> <dd>The value the attribute is to be set to</dd> <dt>attrName</dt> <dd>The name of the attribute being set</dd> <dt>subAttrName</dt> <dd>If setting a property within the attribute's value, the name of the sub-attribute property being set</dd> </dl></span> |
|
777 </dd> |
|
778 |
|
779 </dl> |
|
780 |
|
781 |
|
782 </div> |
|
783 |
|
784 </div> |
|
785 <hr /> |
|
786 </div> |
|
787 <div class="" rel="yui:event" resource="#event_zIndexChange"> |
|
788 <h4> |
|
789 <a name="event_zIndexChange">zIndexChange</a></h4> |
|
790 <div class="detail"> |
|
791 <code> |
|
792 |
|
793 |
|
794 |
|
795 <strong property="yui:name">zIndexChange</strong> |
|
796 |
|
797 ( |
|
798 |
|
799 |
|
800 event |
|
801 |
|
802 |
|
803 ) |
|
804 |
|
805 </code> |
|
806 |
|
807 <div class="description" property="yui:description"> |
|
808 Fires when the value for the configuration attribute 'zIndex' is changed. You can listen for the event using the <a href="Attribute.html#method_on">on</a> method if you wish to be notified before the attribute's value has changed, or using the <a href="Event.Target.html#method_after">after</a> method if you wish to be notified after the attribute's value has changed. |
|
809 </div> |
|
810 |
|
811 <div class="description"> |
|
812 |
|
813 |
|
814 <dl rel="yui:parameters"> |
|
815 <dt>Parameters:</dt> |
|
816 <dd rel="yui:parameter"> |
|
817 <code><span property="yui:name">event</span> |
|
818 <<span property="yui:type">Event.Facade</span>> |
|
819 </code> |
|
820 <span property="yui:description">An Event Facade object with the following attribute specific properties added: <dl> <dt>prevVal</dt> <dd>The value of the attribute, prior to it being set</dd> <dt>newVal</dt> <dd>The value the attribute is to be set to</dd> <dt>attrName</dt> <dd>The name of the attribute being set</dd> <dt>subAttrName</dt> <dd>If setting a property within the attribute's value, the name of the sub-attribute property being set</dd> </dl></span> |
|
821 </dd> |
|
822 |
|
823 </dl> |
|
824 |
|
825 |
|
826 </div> |
|
827 |
|
828 </div> |
|
829 <hr /> |
|
830 </div> |
|
831 </div> |
|
832 </div> |
|
833 |
|
834 |
|
835 </div> |
|
836 |
|
837 <div rel="yui:attributes" resource="#configattributes"> |
|
838 <div class="section field details"> |
|
839 <h3 id="configattributes">Configuration Attributes</h3> |
|
840 <div class="content"> |
|
841 <div class="" rel="yui:attribute" resource="#config_shim"> |
|
842 <h4><a name="config_shim">shim</a> |
|
843 <code>- <span property="yui:type">boolean</span></code> |
|
844 </h4> |
|
845 <div class="detail"> |
|
846 <div class="description" property="yui:description"> |
|
847 Boolean flag to indicate whether or not a shim should be added to the Widgets |
|
848 boundingBox, to protect it from select box bleedthrough. |
|
849 </div> |
|
850 </div> |
|
851 |
|
852 |
|
853 <div class="default"> |
|
854 Default Value: false, for all browsers other than IE6, for which a shim is enabled by default. |
|
855 </div> |
|
856 |
|
857 <hr /> |
|
858 </div> |
|
859 <div class="" rel="yui:attribute" resource="#config_zIndex"> |
|
860 <h4><a name="config_zIndex">zIndex</a> |
|
861 <code>- <span property="yui:type">number</span></code> |
|
862 </h4> |
|
863 <div class="detail"> |
|
864 <div class="description" property="yui:description"> |
|
865 The z-index to apply to the Widgets boundingBox. Non-numerical values for |
|
866 zIndex will be converted to 0 |
|
867 </div> |
|
868 </div> |
|
869 |
|
870 |
|
871 <div class="default"> |
|
872 Default Value: 0 |
|
873 </div> |
|
874 |
|
875 <hr /> |
|
876 </div> |
|
877 |
|
878 </div> |
|
879 </div> |
|
880 |
|
881 </div> |
|
882 |
|
883 </div> |
|
884 </div> |
|
885 <div class="yui-b"> |
|
886 <div class="nav"> |
|
887 |
|
888 <div id="moduleList" class="module"> |
|
889 <h4>Modules</h4> |
|
890 <ul class="content"> |
|
891 <li class=""><a href="module_anim.html" title="anim">anim</a></li> |
|
892 <li class=""><a href="module_async-queue.html" title="async-queue">async-queue</a></li> |
|
893 <li class=""><a href="module_attribute.html" title="attribute">attribute</a></li> |
|
894 <li class=""><a href="module_base.html" title="base">base</a></li> |
|
895 <li class=""><a href="module_cache.html" title="cache">cache</a></li> |
|
896 <li class=""><a href="module_classnamemanager.html" title="classnamemanager">classnamemanager</a></li> |
|
897 <li class=""><a href="module_collection.html" title="collection">collection</a></li> |
|
898 <li class=""><a href="module_console.html" title="console">console</a></li> |
|
899 <li class=""><a href="module_console-filters.html" title="console-filters">console-filters</a></li> |
|
900 <li class=""><a href="module_cookie.html" title="cookie">cookie</a></li> |
|
901 <li class=""><a href="module_dataschema.html" title="dataschema">dataschema</a></li> |
|
902 <li class=""><a href="module_datasource.html" title="datasource">datasource</a></li> |
|
903 <li class=""><a href="module_datatype.html" title="datatype">datatype</a></li> |
|
904 <li class=""><a href="module_dd.html" title="dd">dd</a></li> |
|
905 <li class=""><a href="module_dom.html" title="dom">dom</a></li> |
|
906 <li class=""><a href="module_dump.html" title="dump">dump</a></li> |
|
907 <li class=""><a href="module_event.html" title="event">event</a></li> |
|
908 <li class=""><a href="module_event-custom.html" title="event-custom">event-custom</a></li> |
|
909 <li class=""><a href="module_event-simulate.html" title="event-simulate">event-simulate</a></li> |
|
910 <li class=""><a href="module_history.html" title="history">history</a></li> |
|
911 <li class=""><a href="module_imageloader.html" title="imageloader">imageloader</a></li> |
|
912 <li class=""><a href="module_io.html" title="io">io</a></li> |
|
913 <li class=""><a href="module_json.html" title="json">json</a></li> |
|
914 <li class=""><a href="module_node.html" title="node">node</a></li> |
|
915 <li class=""><a href="module_node-focusmanager.html" title="node-focusmanager">node-focusmanager</a></li> |
|
916 <li class=""><a href="module_node-menunav.html" title="node-menunav">node-menunav</a></li> |
|
917 <li class=""><a href="module_oop.html" title="oop">oop</a></li> |
|
918 <li class=""><a href="module_overlay.html" title="overlay">overlay</a></li> |
|
919 <li class=""><a href="module_plugin.html" title="plugin">plugin</a></li> |
|
920 <li class=""><a href="module_profiler.html" title="profiler">profiler</a></li> |
|
921 <li class=""><a href="module_queue-promote.html" title="queue-promote">queue-promote</a></li> |
|
922 <li class=""><a href="module_slider.html" title="slider">slider</a></li> |
|
923 <li class=""><a href="module_stylesheet.html" title="stylesheet">stylesheet</a></li> |
|
924 <li class=""><a href="module_substitute.html" title="substitute">substitute</a></li> |
|
925 <li class=""><a href="module_test.html" title="test">test</a></li> |
|
926 <li class=""><a href="module_widget.html" title="widget">widget</a></li> |
|
927 <li class=""><a href="module_widget-position.html" title="widget-position">widget-position</a></li> |
|
928 <li class=""><a href="module_widget-position-ext.html" title="widget-position-ext">widget-position-ext</a></li> |
|
929 <li class="selected"><a href="module_widget-stack.html" title="widget-stack">widget-stack</a></li> |
|
930 <li class=""><a href="module_widget-stdmod.html" title="widget-stdmod">widget-stdmod</a></li> |
|
931 <li class=""><a href="module_yui.html" title="yui">yui</a></li> |
|
932 </ul> |
|
933 </div> |
|
934 |
|
935 <div id="classList" class="module"> |
|
936 <h4>Classes</h4> |
|
937 <ul class="content"> |
|
938 <li class="selected"><a href="WidgetStack.html" title="WidgetStack">WidgetStack</a></li> |
|
939 </ul> |
|
940 </div> |
|
941 |
|
942 <div id="fileList" class="module"> |
|
943 <h4>Files</h4> |
|
944 <ul class="content"> |
|
945 <li class=""><a href="Widget-Stack.js.html" title="Widget-Stack.js">Widget-Stack.js</a></li> |
|
946 </ul> |
|
947 </div> |
|
948 |
|
949 <div id="propertyList" class="module"> |
|
950 <h4>Properties</h4> |
|
951 <ul class="content"> |
|
952 <li class=""><a href="#property_WidgetStack.ATTRS" title="WidgetStack.ATTRS">WidgetStack.ATTRS</a></li> |
|
953 <li class=""><a href="#property_WidgetStack.HTML_PARSER" title="WidgetStack.HTML_PARSER">WidgetStack.HTML_PARSER</a></li> |
|
954 <li class=""><a href="#property_WidgetStack.SHIM_CLASS_NAME" title="WidgetStack.SHIM_CLASS_NAME">WidgetStack.SHIM_CLASS_NAME</a></li> |
|
955 <li class=""><a href="#property_WidgetStack.SHIM_TEMPLATE" title="WidgetStack.SHIM_TEMPLATE">WidgetStack.SHIM_TEMPLATE</a></li> |
|
956 <li class=""><a href="#property_WidgetStack.STACKED_CLASS_NAME" title="WidgetStack.STACKED_CLASS_NAME">WidgetStack.STACKED_CLASS_NAME</a></li> |
|
957 </ul> |
|
958 </div> |
|
959 |
|
960 <div id="methodsList" class="module"> |
|
961 <h4>Methods</h4> |
|
962 <ul class="content"> |
|
963 <li class="private"><a href="#method__addShimResizeHandlers" title="_addShimResizeHandlers">_addShimResizeHandlers</a></li> |
|
964 <li class="protected"><a href="#method__afterShimChange" title="_afterShimChange">_afterShimChange</a></li> |
|
965 <li class="protected"><a href="#method__afterZIndexChange" title="_afterZIndexChange">_afterZIndexChange</a></li> |
|
966 <li class="protected"><a href="#method__bindUIStack" title="_bindUIStack">_bindUIStack</a></li> |
|
967 <li class="private"><a href="#method__destroyShim" title="_destroyShim">_destroyShim</a></li> |
|
968 <li class="private"><a href="#method__detachStackHandles" title="_detachStackHandles">_detachStackHandles</a></li> |
|
969 <li class="private"><a href="#method__getShimTemplate" title="_getShimTemplate">_getShimTemplate</a></li> |
|
970 <li class="private"><a href="#method__renderShim" title="_renderShim">_renderShim</a></li> |
|
971 <li class="private"><a href="#method__renderShimDeferred" title="_renderShimDeferred">_renderShimDeferred</a></li> |
|
972 <li class="protected"><a href="#method__renderUIStack" title="_renderUIStack">_renderUIStack</a></li> |
|
973 <li class="protected"><a href="#method__setZIndex" title="_setZIndex">_setZIndex</a></li> |
|
974 <li class="protected"><a href="#method__syncUIStack" title="_syncUIStack">_syncUIStack</a></li> |
|
975 <li class="protected"><a href="#method__uiSetShim" title="_uiSetShim">_uiSetShim</a></li> |
|
976 <li class="protected"><a href="#method__uiSetZIndex" title="_uiSetZIndex">_uiSetZIndex</a></li> |
|
977 <li class=""><a href="#method_sizeShim" title="sizeShim">sizeShim</a></li> |
|
978 </ul> |
|
979 </div> |
|
980 |
|
981 <div id="eventsList" class="module"> |
|
982 <h4>Events</h4> |
|
983 <ul class="content"> |
|
984 <li class=""><a href="#event_shimChange" title="shimChange">shimChange</a></li> |
|
985 <li class=""><a href="#event_zIndexChange" title="zIndexChange">zIndexChange</a></li> |
|
986 </ul> |
|
987 </div> |
|
988 |
|
989 <div id="configList" class="module"> |
|
990 <h4>Configuration Attributes</h4> |
|
991 <ul class="content"> |
|
992 <li class=""><a href="#config_shim" title="shim">shim</a></li> |
|
993 <li class=""><a href="#config_zIndex" title="zIndex">zIndex</a></li> |
|
994 </ul> |
|
995 </div> |
|
996 |
|
997 </div> |
|
998 </div> |
|
999 </div> |
|
1000 <div id="ft"> |
|
1001 <hr /> |
|
1002 Copyright © 2009 Yahoo! Inc. All rights reserved. |
|
1003 </div> |
|
1004 </div> |
|
1005 <script type="text/javascript"> |
|
1006 ALL_YUI_PROPS = [{"access": "private", "host": "WidgetStack", "name": "_addShimResizeHandlers", "url": "WidgetStack.html#method__addShimResizeHandlers", "type": "method"}, {"access": "protected", "host": "WidgetStack", "name": "_afterShimChange", "url": "WidgetStack.html#method__afterShimChange", "type": "method"}, {"access": "protected", "host": "WidgetStack", "name": "_afterZIndexChange", "url": "WidgetStack.html#method__afterZIndexChange", "type": "method"}, {"access": "protected", "host": "WidgetStack", "name": "_bindUIStack", "url": "WidgetStack.html#method__bindUIStack", "type": "method"}, {"access": "private", "host": "WidgetStack", "name": "_destroyShim", "url": "WidgetStack.html#method__destroyShim", "type": "method"}, {"access": "private", "host": "WidgetStack", "name": "_detachStackHandles", "url": "WidgetStack.html#method__detachStackHandles", "type": "method"}, {"access": "private", "host": "WidgetStack", "name": "_getShimTemplate", "url": "WidgetStack.html#method__getShimTemplate", "type": "method"}, {"access": "private", "host": "WidgetStack", "name": "_renderShim", "url": "WidgetStack.html#method__renderShim", "type": "method"}, {"access": "private", "host": "WidgetStack", "name": "_renderShimDeferred", "url": "WidgetStack.html#method__renderShimDeferred", "type": "method"}, {"access": "protected", "host": "WidgetStack", "name": "_renderUIStack", "url": "WidgetStack.html#method__renderUIStack", "type": "method"}, {"access": "protected", "host": "WidgetStack", "name": "_setZIndex", "url": "WidgetStack.html#method__setZIndex", "type": "method"}, {"access": "", "host": "WidgetStack", "name": "shim", "url": "WidgetStack.html#config_shim", "type": "config"}, {"access": "", "host": "WidgetStack", "name": "shimChange", "url": "WidgetStack.html#event_shimChange", "type": "event"}, {"access": "", "host": "WidgetStack", "name": "sizeShim", "url": "WidgetStack.html#method_sizeShim", "type": "method"}, {"access": "protected", "host": "WidgetStack", "name": "_syncUIStack", "url": "WidgetStack.html#method__syncUIStack", "type": "method"}, {"access": "protected", "host": "WidgetStack", "name": "_uiSetShim", "url": "WidgetStack.html#method__uiSetShim", "type": "method"}, {"access": "protected", "host": "WidgetStack", "name": "_uiSetZIndex", "url": "WidgetStack.html#method__uiSetZIndex", "type": "method"}, {"access": "", "host": "WidgetStack", "name": "WidgetStack.ATTRS", "url": "WidgetStack.html#property_WidgetStack.ATTRS", "type": "property"}, {"access": "", "host": "WidgetStack", "name": "WidgetStack.HTML_PARSER", "url": "WidgetStack.html#property_WidgetStack.HTML_PARSER", "type": "property"}, {"access": "", "host": "WidgetStack", "name": "WidgetStack.SHIM_CLASS_NAME", "url": "WidgetStack.html#property_WidgetStack.SHIM_CLASS_NAME", "type": "property"}, {"access": "", "host": "WidgetStack", "name": "WidgetStack.SHIM_TEMPLATE", "url": "WidgetStack.html#property_WidgetStack.SHIM_TEMPLATE", "type": "property"}, {"access": "", "host": "WidgetStack", "name": "WidgetStack.STACKED_CLASS_NAME", "url": "WidgetStack.html#property_WidgetStack.STACKED_CLASS_NAME", "type": "property"}, {"access": "", "host": "WidgetStack", "name": "zIndex", "url": "WidgetStack.html#config_zIndex", "type": "config"}, {"access": "", "host": "WidgetStack", "name": "zIndexChange", "url": "WidgetStack.html#event_zIndexChange", "type": "event"}]; |
|
1007 </script> |
|
1008 </body> |
|
1009 </html> |