|
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 Widget.js (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 <span class="subtitle">3.0.0b1</span></h3> |
|
20 <a href="./index.html" title="Yahoo! UI Library">Yahoo! UI Library</a> |
|
21 > <a href="./module_widget.html" title="widget">widget</a> |
|
22 |
|
23 > Widget.js (source view) |
|
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 <div id="srcout"> |
|
47 <style> |
|
48 #doc3 .classopts { display:none; } |
|
49 </style> |
|
50 <div class="highlight" ><pre><span class="c">/**</span> |
|
51 <span class="c"> * Provides the base Widget class</span> |
|
52 <span class="c"> *</span> |
|
53 <span class="c"> * @module widget</span> |
|
54 <span class="c"> */</span> |
|
55 |
|
56 <span class="c">// Local Constants</span> |
|
57 <span class="c"></span><span class="k">var</span> <span class="nx">L</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Lang</span><span class="o">,</span> |
|
58 <span class="nx">O</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nb">Object</span><span class="o">,</span> |
|
59 <span class="nx">Node</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Node</span><span class="o">,</span> |
|
60 <span class="nx">ClassNameManager</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">ClassNameManager</span><span class="o">,</span> |
|
61 |
|
62 <span class="nx">WIDGET</span> <span class="o">=</span> <span class="s2">"widget"</span><span class="o">,</span> |
|
63 <span class="nx">CONTENT</span> <span class="o">=</span> <span class="s2">"content"</span><span class="o">,</span> |
|
64 <span class="nx">VISIBLE</span> <span class="o">=</span> <span class="s2">"visible"</span><span class="o">,</span> |
|
65 <span class="nx">HIDDEN</span> <span class="o">=</span> <span class="s2">"hidden"</span><span class="o">,</span> |
|
66 <span class="nx">DISABLED</span> <span class="o">=</span> <span class="s2">"disabled"</span><span class="o">,</span> |
|
67 <span class="nx">FOCUSED</span> <span class="o">=</span> <span class="s2">"focused"</span><span class="o">,</span> |
|
68 <span class="nx">WIDTH</span> <span class="o">=</span> <span class="s2">"width"</span><span class="o">,</span> |
|
69 <span class="nx">HEIGHT</span> <span class="o">=</span> <span class="s2">"height"</span><span class="o">,</span> |
|
70 <span class="nx">EMPTY</span> <span class="o">=</span> <span class="s2">""</span><span class="o">,</span> |
|
71 <span class="nx">HYPHEN</span> <span class="o">=</span> <span class="s2">"-"</span><span class="o">,</span> |
|
72 <span class="nx">BOUNDING_BOX</span> <span class="o">=</span> <span class="s2">"boundingBox"</span><span class="o">,</span> |
|
73 <span class="nx">CONTENT_BOX</span> <span class="o">=</span> <span class="s2">"contentBox"</span><span class="o">,</span> |
|
74 <span class="nx">PARENT_NODE</span> <span class="o">=</span> <span class="s2">"parentNode"</span><span class="o">,</span> |
|
75 <span class="nx">FIRST_CHILD</span> <span class="o">=</span> <span class="s2">"firstChild"</span><span class="o">,</span> |
|
76 <span class="nx">OWNER_DOCUMENT</span> <span class="o">=</span> <span class="s2">"ownerDocument"</span><span class="o">,</span> |
|
77 <span class="nx">BODY</span> <span class="o">=</span> <span class="s2">"body"</span><span class="o">,</span> |
|
78 <span class="nx">TAB_INDEX</span> <span class="o">=</span> <span class="s2">"tabIndex"</span><span class="o">,</span> |
|
79 <span class="nx">LOCALE</span> <span class="o">=</span> <span class="s2">"locale"</span><span class="o">,</span> |
|
80 <span class="nx">INIT_VALUE</span> <span class="o">=</span> <span class="s2">"initValue"</span><span class="o">,</span> |
|
81 <span class="nx">ID</span> <span class="o">=</span> <span class="s2">"id"</span><span class="o">,</span> |
|
82 <span class="nx">RENDER</span> <span class="o">=</span> <span class="s2">"render"</span><span class="o">,</span> |
|
83 <span class="nx">RENDERED</span> <span class="o">=</span> <span class="s2">"rendered"</span><span class="o">,</span> |
|
84 <span class="nx">DESTROYED</span> <span class="o">=</span> <span class="s2">"destroyed"</span><span class="o">,</span> |
|
85 |
|
86 <span class="nx">ContentUpdate</span> <span class="o">=</span> <span class="s2">"contentUpdate"</span><span class="o">,</span> |
|
87 |
|
88 <span class="c">// Widget nodeid-to-instance map for now, 1-to-1.</span> |
|
89 <span class="c"></span> <span class="nx">_instances</span> <span class="o">=</span> <span class="o">{};</span> |
|
90 |
|
91 <span class="c">/**</span> |
|
92 <span class="c"> * A base class for widgets, providing:</span> |
|
93 <span class="c"> * <ul></span> |
|
94 <span class="c"> * <li>The render lifecycle method, in addition to the init and destroy </span> |
|
95 <span class="c"> * lifecycle methods provide by Base</li></span> |
|
96 <span class="c"> * <li>Abstract methods to support consistent MVC structure across </span> |
|
97 <span class="c"> * widgets: renderer, renderUI, bindUI, syncUI</li></span> |
|
98 <span class="c"> * <li>Support for common widget attributes, such as boundingBox, contentBox, visible, </span> |
|
99 <span class="c"> * disabled, focused, strings</li></span> |
|
100 <span class="c"> * </ul></span> |
|
101 <span class="c"> *</span> |
|
102 <span class="c"> * @param config {Object} Object literal specifying widget configuration </span> |
|
103 <span class="c"> * properties.</span> |
|
104 <span class="c"> *</span> |
|
105 <span class="c"> * @class Widget</span> |
|
106 <span class="c"> * @constructor</span> |
|
107 <span class="c"> * @extends Base</span> |
|
108 <span class="c"> */</span> |
|
109 <span class="k">function</span> <span class="nx">Widget</span><span class="o">(</span><span class="nx">config</span><span class="o">)</span> <span class="o">{</span> |
|
110 <span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s1">'constructor called'</span><span class="o">,</span> <span class="s1">'life'</span><span class="o">,</span> <span class="s1">'widget'</span><span class="o">);</span> |
|
111 |
|
112 <span class="k">this</span><span class="o">.</span><span class="nx">_yuid</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">guid</span><span class="o">(</span><span class="nx">WIDGET</span><span class="o">);</span> |
|
113 <span class="k">this</span><span class="o">.</span><span class="nx">_strings</span> <span class="o">=</span> <span class="o">{};</span> |
|
114 |
|
115 <span class="nx">Widget</span><span class="o">.</span><span class="nx">superclass</span><span class="o">.</span><span class="nx">constructor</span><span class="o">.</span><span class="nx">apply</span><span class="o">(</span><span class="k">this</span><span class="o">,</span> <span class="nx">arguments</span><span class="o">);</span> |
|
116 <span class="o">}</span> |
|
117 |
|
118 <span class="c">/**</span> |
|
119 <span class="c"> * The build configuration for the Widget class.</span> |
|
120 <span class="c"> * <p></span> |
|
121 <span class="c"> * Defines the static fields which need to be aggregated,</span> |
|
122 <span class="c"> * when this class is used as the main class passed to </span> |
|
123 <span class="c"> * the <a href="Base.html#method_build">Base.build</a> method.</span> |
|
124 <span class="c"> * </p></span> |
|
125 <span class="c"> * @property _buildCfg</span> |
|
126 <span class="c"> * @type Object</span> |
|
127 <span class="c"> * @static</span> |
|
128 <span class="c"> * @final</span> |
|
129 <span class="c"> * @private</span> |
|
130 <span class="c"> */</span> |
|
131 <span class="nx">Widget</span><span class="o">.</span><span class="nx">_buildCfg</span> <span class="o">=</span> <span class="o">{</span> |
|
132 <span class="nx">aggregates</span> <span class="o">:</span> <span class="o">[</span><span class="s2">"HTML_PARSER"</span><span class="o">]</span> |
|
133 <span class="o">};</span> |
|
134 |
|
135 <span class="c">/**</span> |
|
136 <span class="c"> * Static property provides a string to identify the class.</span> |
|
137 <span class="c"> * <p></span> |
|
138 <span class="c"> * Currently used to apply class identifiers to the bounding box </span> |
|
139 <span class="c"> * and to classify events fired by the widget.</span> |
|
140 <span class="c"> * </p></span> |
|
141 <span class="c"> *</span> |
|
142 <span class="c"> * @property Widget.NAME</span> |
|
143 <span class="c"> * @type String</span> |
|
144 <span class="c"> * @static</span> |
|
145 <span class="c"> */</span> |
|
146 <span class="nx">Widget</span><span class="o">.</span><span class="nx">NAME</span> <span class="o">=</span> <span class="nx">WIDGET</span><span class="o">;</span> |
|
147 |
|
148 <span class="c">/**</span> |
|
149 <span class="c"> * Constant used to identify state changes originating from</span> |
|
150 <span class="c"> * the DOM (as opposed to the JavaScript model).</span> |
|
151 <span class="c"> *</span> |
|
152 <span class="c"> * @property Widget.UI_SRC</span> |
|
153 <span class="c"> * @type String</span> |
|
154 <span class="c"> * @static</span> |
|
155 <span class="c"> * @final</span> |
|
156 <span class="c"> */</span> |
|
157 <span class="nx">Widget</span><span class="o">.</span><span class="nx">UI_SRC</span> <span class="o">=</span> <span class="s2">"ui"</span><span class="o">;</span> |
|
158 |
|
159 <span class="k">var</span> <span class="nx">UI</span> <span class="o">=</span> <span class="nx">Widget</span><span class="o">.</span><span class="nx">UI_SRC</span><span class="o">;</span> |
|
160 |
|
161 <span class="c">/**</span> |
|
162 <span class="c"> * Static property used to define the default attribute </span> |
|
163 <span class="c"> * configuration for the Widget.</span> |
|
164 <span class="c"> * </span> |
|
165 <span class="c"> * @property Widget.ATTRS</span> |
|
166 <span class="c"> * @type Object</span> |
|
167 <span class="c"> * @static</span> |
|
168 <span class="c"> */</span> |
|
169 <span class="nx">Widget</span><span class="o">.</span><span class="nx">ATTRS</span> <span class="o">=</span> <span class="o">{</span> |
|
170 |
|
171 <span class="c">/**</span> |
|
172 <span class="c"> * Flag indicating whether or not this object</span> |
|
173 <span class="c"> * has been through the render lifecycle phase.</span> |
|
174 <span class="c"> *</span> |
|
175 <span class="c"> * @attribute rendered</span> |
|
176 <span class="c"> * @readOnly</span> |
|
177 <span class="c"> * @default false</span> |
|
178 <span class="c"> * @type boolean</span> |
|
179 <span class="c"> */</span> |
|
180 <span class="nx">rendered</span><span class="o">:</span> <span class="o">{</span> |
|
181 <span class="nx">value</span><span class="o">:</span><span class="kc">false</span><span class="o">,</span> |
|
182 <span class="nx">readOnly</span><span class="o">:</span><span class="kc">true</span> |
|
183 <span class="o">},</span> |
|
184 |
|
185 <span class="c">/**</span> |
|
186 <span class="c"> * @attribute boundingBox</span> |
|
187 <span class="c"> * @description The outermost DOM node for the Widget, used for sizing and positioning </span> |
|
188 <span class="c"> * of a Widget as well as a containing element for any decorator elements used </span> |
|
189 <span class="c"> * for skinning.</span> |
|
190 <span class="c"> * @type Node</span> |
|
191 <span class="c"> */</span> |
|
192 <span class="nx">boundingBox</span><span class="o">:</span> <span class="o">{</span> |
|
193 <span class="nx">value</span><span class="o">:</span><span class="kc">null</span><span class="o">,</span> |
|
194 <span class="nx">setter</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">node</span><span class="o">)</span> <span class="o">{</span> |
|
195 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_setBoundingBox</span><span class="o">(</span><span class="nx">node</span><span class="o">);</span> |
|
196 <span class="o">},</span> |
|
197 <span class="nx">writeOnce</span><span class="o">:</span> <span class="kc">true</span> |
|
198 <span class="o">},</span> |
|
199 |
|
200 <span class="c">/**</span> |
|
201 <span class="c"> * @attribute contentBox</span> |
|
202 <span class="c"> * @description A DOM node that is a direct descendent of a Widget's bounding box that </span> |
|
203 <span class="c"> * houses its content.</span> |
|
204 <span class="c"> * @type Node</span> |
|
205 <span class="c"> */</span> |
|
206 <span class="nx">contentBox</span><span class="o">:</span> <span class="o">{</span> |
|
207 <span class="nx">value</span><span class="o">:</span><span class="kc">null</span><span class="o">,</span> |
|
208 <span class="nx">setter</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">node</span><span class="o">)</span> <span class="o">{</span> |
|
209 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_setContentBox</span><span class="o">(</span><span class="nx">node</span><span class="o">);</span> |
|
210 <span class="o">},</span> |
|
211 <span class="nx">writeOnce</span><span class="o">:</span> <span class="kc">true</span> |
|
212 <span class="o">},</span> |
|
213 |
|
214 <span class="c">/**</span> |
|
215 <span class="c"> * @attribute tabIndex</span> |
|
216 <span class="c"> * @description Number (between -32767 to 32767) indicating the widget's </span> |
|
217 <span class="c"> * position in the default tab flow. The value is used to set the </span> |
|
218 <span class="c"> * "tabIndex" attribute on the widget's bounding box. Negative values allow</span> |
|
219 <span class="c"> * the widget to receive DOM focus programmatically (by calling the focus</span> |
|
220 <span class="c"> * method), while being removed from the default tab flow. A value of </span> |
|
221 <span class="c"> * null removes the "tabIndex" attribute from the widget's bounding box.</span> |
|
222 <span class="c"> * @type Number</span> |
|
223 <span class="c"> * @default null</span> |
|
224 <span class="c"> */</span> |
|
225 <span class="nx">tabIndex</span><span class="o">:</span> <span class="o">{</span> |
|
226 |
|
227 <span class="nx">value</span><span class="o">:</span> <span class="m">0</span><span class="o">,</span> |
|
228 <span class="nx">validator</span><span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">val</span><span class="o">)</span> <span class="o">{</span> |
|
229 <span class="k">return</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isNumber</span><span class="o">(</span><span class="nx">val</span><span class="o">)</span> <span class="o">||</span> <span class="nx">L</span><span class="o">.</span><span class="nx">isNull</span><span class="o">(</span><span class="nx">val</span><span class="o">));</span> |
|
230 <span class="o">}</span> |
|
231 |
|
232 <span class="o">},</span> |
|
233 |
|
234 <span class="c">/**</span> |
|
235 <span class="c"> * @attribute focused</span> |
|
236 <span class="c"> * @description Boolean indicating if the Widget, or one of its descendants, </span> |
|
237 <span class="c"> * has focus.</span> |
|
238 <span class="c"> * @readOnly</span> |
|
239 <span class="c"> * @default false</span> |
|
240 <span class="c"> * @type boolean</span> |
|
241 <span class="c"> */</span> |
|
242 <span class="nx">focused</span><span class="o">:</span> <span class="o">{</span> |
|
243 <span class="nx">value</span><span class="o">:</span> <span class="kc">false</span><span class="o">,</span> |
|
244 <span class="nx">readOnly</span><span class="o">:</span><span class="kc">true</span> |
|
245 <span class="o">},</span> |
|
246 |
|
247 <span class="c">/**</span> |
|
248 <span class="c"> * @attribute disabled</span> |
|
249 <span class="c"> * @description Boolean indicating if the Widget should be disabled. The disabled implementation</span> |
|
250 <span class="c"> * is left to the specific classes extending widget.</span> |
|
251 <span class="c"> * @default false</span> |
|
252 <span class="c"> * @type boolean</span> |
|
253 <span class="c"> */</span> |
|
254 <span class="nx">disabled</span><span class="o">:</span> <span class="o">{</span> |
|
255 <span class="nx">value</span><span class="o">:</span> <span class="kc">false</span> |
|
256 <span class="o">},</span> |
|
257 |
|
258 <span class="c">/**</span> |
|
259 <span class="c"> * @attribute visible</span> |
|
260 <span class="c"> * @description Boolean indicating weather or not the Widget is visible.</span> |
|
261 <span class="c"> * @default true</span> |
|
262 <span class="c"> * @type boolean</span> |
|
263 <span class="c"> */</span> |
|
264 <span class="nx">visible</span><span class="o">:</span> <span class="o">{</span> |
|
265 <span class="nx">value</span><span class="o">:</span> <span class="kc">true</span> |
|
266 <span class="o">},</span> |
|
267 |
|
268 <span class="c">/**</span> |
|
269 <span class="c"> * @attribute height</span> |
|
270 <span class="c"> * @description String with units, or number, representing the height of the Widget. If a number is provided,</span> |
|
271 <span class="c"> * the default unit, defined by the Widgets DEF_UNIT, property is used.</span> |
|
272 <span class="c"> * @default ""</span> |
|
273 <span class="c"> * @type {String | Number}</span> |
|
274 <span class="c"> */</span> |
|
275 <span class="nx">height</span><span class="o">:</span> <span class="o">{</span> |
|
276 <span class="nx">value</span><span class="o">:</span> <span class="nx">EMPTY</span> |
|
277 <span class="o">},</span> |
|
278 |
|
279 <span class="c">/**</span> |
|
280 <span class="c"> * @attribute width</span> |
|
281 <span class="c"> * @description String with units, or number, representing the width of the Widget. If a number is provided,</span> |
|
282 <span class="c"> * the default unit, defined by the Widgets DEF_UNIT, property is used.</span> |
|
283 <span class="c"> * @default ""</span> |
|
284 <span class="c"> * @type {String | Number}</span> |
|
285 <span class="c"> */</span> |
|
286 <span class="nx">width</span><span class="o">:</span> <span class="o">{</span> |
|
287 <span class="nx">value</span><span class="o">:</span> <span class="nx">EMPTY</span> |
|
288 <span class="o">},</span> |
|
289 |
|
290 <span class="c">/**</span> |
|
291 <span class="c"> * @attribute moveStyles</span> |
|
292 <span class="c"> * @description Flag defining whether or not style properties from the content box</span> |
|
293 <span class="c"> * should be moved to the bounding box when wrapped (as defined by the WRAP_STYLES property)</span> |
|
294 <span class="c"> * @default false</span> |
|
295 <span class="c"> * @type boolean</span> |
|
296 <span class="c"> */</span> |
|
297 <span class="nx">moveStyles</span><span class="o">:</span> <span class="o">{</span> |
|
298 <span class="nx">value</span><span class="o">:</span> <span class="kc">false</span> |
|
299 <span class="o">},</span> |
|
300 |
|
301 <span class="c">/**</span> |
|
302 <span class="c"> * @attribute locale</span> |
|
303 <span class="c"> * @description</span> |
|
304 <span class="c"> * The default locale for the widget. NOTE: Using get/set on the "strings" attribute will</span> |
|
305 <span class="c"> * return/set strings for this locale.</span> |
|
306 <span class="c"> * @default "en"</span> |
|
307 <span class="c"> * @type String</span> |
|
308 <span class="c"> */</span> |
|
309 <span class="nx">locale</span> <span class="o">:</span> <span class="o">{</span> |
|
310 <span class="nx">value</span><span class="o">:</span> <span class="s2">"en"</span> |
|
311 <span class="o">},</span> |
|
312 |
|
313 <span class="c">/**</span> |
|
314 <span class="c"> * @attribute strings</span> |
|
315 <span class="c"> * @description Collection of strings used to label elements of the Widget's UI.</span> |
|
316 <span class="c"> * @default null</span> |
|
317 <span class="c"> * @type Object</span> |
|
318 <span class="c"> */</span> |
|
319 <span class="nx">strings</span><span class="o">:</span> <span class="o">{</span> |
|
320 <span class="nx">setter</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">val</span><span class="o">)</span> <span class="o">{</span> |
|
321 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_setStrings</span><span class="o">(</span><span class="nx">val</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">LOCALE</span><span class="o">));</span> |
|
322 <span class="o">},</span> |
|
323 |
|
324 <span class="nx">getter</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
325 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">getStrings</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">LOCALE</span><span class="o">));</span> |
|
326 <span class="o">}</span> |
|
327 <span class="o">}</span> |
|
328 <span class="o">};</span> |
|
329 |
|
330 <span class="c">/**</span> |
|
331 <span class="c"> * Cached lowercase version of Widget.NAME</span> |
|
332 <span class="c"> *</span> |
|
333 <span class="c"> * @property Widget._NAME_LOWERCASE</span> |
|
334 <span class="c"> * @private</span> |
|
335 <span class="c"> * @static</span> |
|
336 <span class="c"> */</span> |
|
337 <span class="nx">Widget</span><span class="o">.</span><span class="nx">_NAME_LOWERCASE</span> <span class="o">=</span> <span class="nx">Widget</span><span class="o">.</span><span class="nx">NAME</span><span class="o">.</span><span class="nx">toLowerCase</span><span class="o">();</span> |
|
338 |
|
339 <span class="c">/**</span> |
|
340 <span class="c"> * Generate a standard prefixed classname for the Widget, prefixed by the default prefix defined</span> |
|
341 <span class="c"> * by the <code>Y.config.classNamePrefix</code> attribute used by <code>ClassNameManager</code> and </span> |
|
342 <span class="c"> * <code>Widget.NAME.toLowerCase()</code> (e.g. "yui-widget-xxxxx-yyyyy", based on default values for </span> |
|
343 <span class="c"> * the prefix and widget class name).</span> |
|
344 <span class="c"> * <p></span> |
|
345 <span class="c"> * The instance based version of this method can be used to generate standard prefixed classnames,</span> |
|
346 <span class="c"> * based on the instances NAME, as opposed to Widget.NAME. This method should be used when you</span> |
|
347 <span class="c"> * need to use a constant class name across different types instances.</span> |
|
348 <span class="c"> * </p></span> |
|
349 <span class="c"> * @method getClassName</span> |
|
350 <span class="c"> * @param {String*} args* 0..n strings which should be concatenated, using the default separator defined by ClassNameManager, to create the class name</span> |
|
351 <span class="c"> */</span> |
|
352 <span class="nx">Widget</span><span class="o">.</span><span class="nx">getClassName</span> <span class="o">=</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
353 <span class="k">var</span> <span class="nx">args</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nb">Array</span><span class="o">(</span><span class="nx">arguments</span><span class="o">,</span> <span class="m">0</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span> |
|
354 <span class="nx">args</span><span class="o">.</span><span class="nx">splice</span><span class="o">(</span><span class="m">0</span><span class="o">,</span> <span class="m">0</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">_NAME_LOWERCASE</span><span class="o">);</span> |
|
355 <span class="k">return</span> <span class="nx">ClassNameManager</span><span class="o">.</span><span class="nx">getClassName</span><span class="o">.</span><span class="nx">apply</span><span class="o">(</span><span class="nx">ClassNameManager</span><span class="o">,</span> <span class="nx">args</span><span class="o">);</span> |
|
356 <span class="o">};</span> |
|
357 |
|
358 <span class="c">/**</span> |
|
359 <span class="c"> * Returns the widget instance whose bounding box contains, or is, the given node. </span> |
|
360 <span class="c"> * <p></span> |
|
361 <span class="c"> * In the case of nested widgets, the nearest bounding box ancestor is used to</span> |
|
362 <span class="c"> * return the widget instance.</span> |
|
363 <span class="c"> * </p></span> |
|
364 <span class="c"> * @method Widget.getByNode</span> |
|
365 <span class="c"> * @static</span> |
|
366 <span class="c"> * @param node {Node | String} The node for which to return a Widget instance. If a selector</span> |
|
367 <span class="c"> * string is passed in, which selects more than one node, the first node found is used.</span> |
|
368 <span class="c"> * @return {Widget} Widget instance, or null if not found.</span> |
|
369 <span class="c"> */</span> |
|
370 <span class="nx">Widget</span><span class="o">.</span><span class="nx">getByNode</span> <span class="o">=</span> <span class="k">function</span><span class="o">(</span><span class="nx">node</span><span class="o">)</span> <span class="o">{</span> |
|
371 <span class="k">var</span> <span class="nx">widget</span><span class="o">,</span> |
|
372 <span class="nx">bbMarker</span> <span class="o">=</span> <span class="nx">Widget</span><span class="o">.</span><span class="nx">getClassName</span><span class="o">();</span> |
|
373 |
|
374 <span class="nx">node</span> <span class="o">=</span> <span class="nx">Node</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">node</span><span class="o">);</span> |
|
375 <span class="k">if</span> <span class="o">(</span><span class="nx">node</span><span class="o">)</span> <span class="o">{</span> |
|
376 <span class="nx">node</span> <span class="o">=</span> <span class="o">(</span><span class="nx">node</span><span class="o">.</span><span class="nx">hasClass</span><span class="o">(</span><span class="nx">bbMarker</span><span class="o">))</span> <span class="o">?</span> <span class="nx">node</span> <span class="o">:</span> <span class="nx">node</span><span class="o">.</span><span class="nx">ancestor</span><span class="o">(</span><span class="s2">"."</span> <span class="o">+</span> <span class="nx">bbMarker</span><span class="o">);</span> |
|
377 <span class="k">if</span> <span class="o">(</span><span class="nx">node</span><span class="o">)</span> <span class="o">{</span> |
|
378 <span class="nx">widget</span> <span class="o">=</span> <span class="nx">_instances</span><span class="o">[</span><span class="nx">node</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">ID</span><span class="o">)];</span> |
|
379 <span class="o">}</span> |
|
380 <span class="o">}</span> |
|
381 |
|
382 <span class="k">return</span> <span class="nx">widget</span> <span class="o">||</span> <span class="kc">null</span><span class="o">;</span> |
|
383 <span class="o">};</span> |
|
384 |
|
385 <span class="c">/**</span> |
|
386 <span class="c"> * Object hash, defining how attribute values are to be parsed from</span> |
|
387 <span class="c"> * markup contained in the widget's content box. e.g.:</span> |
|
388 <span class="c"> * <pre></span> |
|
389 <span class="c"> * {</span> |
|
390 <span class="c"> * // Set single Node references using selector syntax </span> |
|
391 <span class="c"> * // (selector is run through node.query)</span> |
|
392 <span class="c"> * titleNode: "span.yui-title",</span> |
|
393 <span class="c"> * // Set NodeList references using selector syntax </span> |
|
394 <span class="c"> * // (array indicates selector is to be run through node.queryAll)</span> |
|
395 <span class="c"> * listNodes: ["li.yui-item"],</span> |
|
396 <span class="c"> * // Set other attribute types, using a parse function. </span> |
|
397 <span class="c"> * // Context is set to the widget instance.</span> |
|
398 <span class="c"> * label: function(contentBox) {</span> |
|
399 <span class="c"> * return contentBox.query("span.title").get("innerHTML");</span> |
|
400 <span class="c"> * }</span> |
|
401 <span class="c"> * }</span> |
|
402 <span class="c"> * </pre></span> |
|
403 <span class="c"> * </span> |
|
404 <span class="c"> * @property Widget.HTML_PARSER</span> |
|
405 <span class="c"> * @type Object</span> |
|
406 <span class="c"> * @static</span> |
|
407 <span class="c"> */</span> |
|
408 <span class="nx">Widget</span><span class="o">.</span><span class="nx">HTML_PARSER</span> <span class="o">=</span> <span class="o">{};</span> |
|
409 |
|
410 <span class="nx">Y</span><span class="o">.</span><span class="nx">extend</span><span class="o">(</span><span class="nx">Widget</span><span class="o">,</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">Base</span><span class="o">,</span> <span class="o">{</span> |
|
411 |
|
412 <span class="c">/**</span> |
|
413 <span class="c"> * Returns a class name prefixed with the the value of the </span> |
|
414 <span class="c"> * <code>YUI.config.classNamePrefix</code> attribute + the instances <code>NAME</code> property.</span> |
|
415 <span class="c"> * Uses <code>YUI.config.classNameDelimiter</code> attribute to delimit the provided strings.</span> |
|
416 <span class="c"> * e.g. </span> |
|
417 <span class="c"> * <code></span> |
|
418 <span class="c"> * <pre></span> |
|
419 <span class="c"> * // returns "yui-slider-foo-bar", for a slider instance</span> |
|
420 <span class="c"> * var scn = slider.getClassName('foo','bar');</span> |
|
421 <span class="c"> *</span> |
|
422 <span class="c"> * // returns "yui-overlay-foo-bar", for an overlay instance</span> |
|
423 <span class="c"> * var ocn = slider.getClassName('foo','bar');</span> |
|
424 <span class="c"> * </pre></span> |
|
425 <span class="c"> * </code></span> |
|
426 <span class="c"> *</span> |
|
427 <span class="c"> * @method getClassName</span> |
|
428 <span class="c"> * @param {String}+ One or more classname bits to be joined and prefixed</span> |
|
429 <span class="c"> */</span> |
|
430 <span class="nx">getClassName</span><span class="o">:</span> <span class="k">function</span> <span class="o">()</span> <span class="o">{</span> |
|
431 <span class="k">var</span> <span class="nx">args</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nb">Array</span><span class="o">(</span><span class="nx">arguments</span><span class="o">,</span> <span class="m">0</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span> |
|
432 <span class="nx">args</span><span class="o">.</span><span class="nx">splice</span><span class="o">(</span><span class="m">0</span><span class="o">,</span> <span class="m">0</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">_name</span><span class="o">);</span> |
|
433 <span class="k">return</span> <span class="nx">ClassNameManager</span><span class="o">.</span><span class="nx">getClassName</span><span class="o">.</span><span class="nx">apply</span><span class="o">(</span><span class="nx">ClassNameManager</span><span class="o">,</span> <span class="nx">args</span><span class="o">);</span> |
|
434 <span class="o">},</span> |
|
435 |
|
436 <span class="c">/**</span> |
|
437 <span class="c"> * Initializer lifecycle implementation for the Widget class. Registers the </span> |
|
438 <span class="c"> * widget instance, and runs through the Widget's HTML_PARSER definition. </span> |
|
439 <span class="c"> *</span> |
|
440 <span class="c"> * @method initializer</span> |
|
441 <span class="c"> * @protected</span> |
|
442 <span class="c"> * @param config {Object} Configuration object literal for the widget</span> |
|
443 <span class="c"> */</span> |
|
444 <span class="nx">initializer</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">config</span><span class="o">)</span> <span class="o">{</span> |
|
445 <span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s1">'initializer called'</span><span class="o">,</span> <span class="s1">'life'</span><span class="o">,</span> <span class="s1">'widget'</span><span class="o">);</span> |
|
446 |
|
447 <span class="c">/**</span> |
|
448 <span class="c"> * Notification event, which widget implementations can fire, when</span> |
|
449 <span class="c"> * they change the content of the widget. This event has no default</span> |
|
450 <span class="c"> * behavior and cannot be prevented, so the "on" or "after"</span> |
|
451 <span class="c"> * moments are effectively equivalent (with on listeners being invoked before </span> |
|
452 <span class="c"> * after listeners).</span> |
|
453 <span class="c"> * </span> |
|
454 <span class="c"> * @event widget:contentUpdate</span> |
|
455 <span class="c"> * @preventable false</span> |
|
456 <span class="c"> * @param {EventFacade} e The Event Facade</span> |
|
457 <span class="c"> */</span> |
|
458 <span class="k">this</span><span class="o">.</span><span class="nx">publish</span><span class="o">(</span><span class="nx">ContentUpdate</span><span class="o">,</span> <span class="o">{</span> <span class="nx">preventable</span><span class="o">:</span><span class="kc">false</span> <span class="o">});</span> |
|
459 |
|
460 <span class="k">this</span><span class="o">.</span><span class="nx">_name</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">constructor</span><span class="o">.</span><span class="nx">NAME</span><span class="o">.</span><span class="nx">toLowerCase</span><span class="o">();</span> |
|
461 |
|
462 <span class="k">var</span> <span class="nx">nodeId</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BOUNDING_BOX</span><span class="o">).</span><span class="nx">get</span><span class="o">(</span><span class="nx">ID</span><span class="o">);</span> |
|
463 <span class="k">if</span> <span class="o">(</span><span class="nx">nodeId</span><span class="o">)</span> <span class="o">{</span> |
|
464 <span class="nx">_instances</span><span class="o">[</span><span class="nx">nodeId</span><span class="o">]</span> <span class="o">=</span> <span class="k">this</span><span class="o">;</span> |
|
465 <span class="o">}</span> |
|
466 |
|
467 <span class="k">var</span> <span class="nx">htmlConfig</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_parseHTML</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">CONTENT_BOX</span><span class="o">));</span> |
|
468 <span class="k">if</span> <span class="o">(</span><span class="nx">htmlConfig</span><span class="o">)</span> <span class="o">{</span> |
|
469 <span class="nx">Y</span><span class="o">.</span><span class="nx">aggregate</span><span class="o">(</span><span class="nx">config</span><span class="o">,</span> <span class="nx">htmlConfig</span><span class="o">,</span> <span class="kc">false</span><span class="o">);</span> |
|
470 <span class="o">}</span> |
|
471 <span class="o">},</span> |
|
472 |
|
473 <span class="c">/**</span> |
|
474 <span class="c"> * Descructor lifecycle implementation for the Widget class. Purges events attached</span> |
|
475 <span class="c"> * to the bounding box (and all child nodes) and removes the Widget from the </span> |
|
476 <span class="c"> * list of registered widgets.</span> |
|
477 <span class="c"> *</span> |
|
478 <span class="c"> * @method destructor</span> |
|
479 <span class="c"> * @protected</span> |
|
480 <span class="c"> */</span> |
|
481 <span class="nx">destructor</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
482 <span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s1">'destructor called'</span><span class="o">,</span> <span class="s1">'life'</span><span class="o">,</span> <span class="s1">'widget'</span><span class="o">);</span> |
|
483 |
|
484 <span class="k">var</span> <span class="nx">boundingBox</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BOUNDING_BOX</span><span class="o">);</span> |
|
485 |
|
486 <span class="nx">Y</span><span class="o">.</span><span class="nx">Event</span><span class="o">.</span><span class="nx">purgeElement</span><span class="o">(</span><span class="nx">boundingBox</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span> |
|
487 |
|
488 <span class="k">var</span> <span class="nx">nodeId</span> <span class="o">=</span> <span class="nx">boundingBox</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">ID</span><span class="o">);</span> |
|
489 <span class="k">if</span> <span class="o">(</span><span class="nx">nodeId</span> <span class="o">&&</span> <span class="nx">nodeId</span> <span class="k">in</span> <span class="nx">_instances</span><span class="o">)</span> <span class="o">{</span> |
|
490 <span class="nx">delete</span> <span class="nx">_instances</span><span class="o">[</span><span class="nx">nodeId</span><span class="o">];</span> |
|
491 <span class="o">}</span> |
|
492 <span class="o">},</span> |
|
493 |
|
494 <span class="c">/**</span> |
|
495 <span class="c"> * Establishes the initial DOM for the widget. Invoking this</span> |
|
496 <span class="c"> * method will lead to the creating of all DOM elements for</span> |
|
497 <span class="c"> * the widget (or the manipulation of existing DOM elements </span> |
|
498 <span class="c"> * for the progressive enhancement use case).</span> |
|
499 <span class="c"> * <p></span> |
|
500 <span class="c"> * This method should only be invoked once for an initialized</span> |
|
501 <span class="c"> * widget.</span> |
|
502 <span class="c"> * </p></span> |
|
503 <span class="c"> * <p></span> |
|
504 <span class="c"> * It delegates to the widget specific renderer method to do</span> |
|
505 <span class="c"> * the actual work.</span> |
|
506 <span class="c"> * </p></span> |
|
507 <span class="c"> *</span> |
|
508 <span class="c"> * @method render</span> |
|
509 <span class="c"> * @chainable</span> |
|
510 <span class="c"> * @final </span> |
|
511 <span class="c"> * @param parentNode {Object | String} Optional. The Node under which the </span> |
|
512 <span class="c"> * Widget is to be rendered. This can be a Node instance or a CSS selector string. </span> |
|
513 <span class="c"> * <p></span> |
|
514 <span class="c"> * If the selector string returns more than one Node, the first node will be used </span> |
|
515 <span class="c"> * as the parentNode. NOTE: This argument is required if both the boundingBox and contentBox</span> |
|
516 <span class="c"> * are not currently in the document. If it's not provided, the Widget will be rendered</span> |
|
517 <span class="c"> * to the body of the current document in this case.</span> |
|
518 <span class="c"> * </p></span> |
|
519 <span class="c"> */</span> |
|
520 <span class="nx">render</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">parentNode</span><span class="o">)</span> <span class="o">{</span> |
|
521 |
|
522 <span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">DESTROYED</span><span class="o">))</span> <span class="o">{</span> |
|
523 <span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s2">"Render failed; widget has been destroyed"</span><span class="o">,</span> <span class="s2">"error"</span><span class="o">,</span> <span class="s2">"widget"</span><span class="o">);</span> |
|
524 <span class="k">return</span><span class="o">;</span> |
|
525 <span class="o">}</span> |
|
526 |
|
527 <span class="k">if</span> <span class="o">(!</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">RENDERED</span><span class="o">))</span> <span class="o">{</span> |
|
528 <span class="c">/**</span> |
|
529 <span class="c"> * Lifcyle event for the render phase, fired prior to rendering the UI </span> |
|
530 <span class="c"> * for the widget (prior to invoking the widgets renderer method).</span> |
|
531 <span class="c"> * <p></span> |
|
532 <span class="c"> * Subscribers to the "on" moment of this event, will be notified </span> |
|
533 <span class="c"> * before the widget is rendered.</span> |
|
534 <span class="c"> * </p></span> |
|
535 <span class="c"> * <p></span> |
|
536 <span class="c"> * Subscribers to the "after" momemt of this event, will be notified</span> |
|
537 <span class="c"> * after rendering is complete.</span> |
|
538 <span class="c"> * </p></span> |
|
539 <span class="c"> *</span> |
|
540 <span class="c"> * @event widget:render</span> |
|
541 <span class="c"> * @preventable _defRenderFn</span> |
|
542 <span class="c"> * @param {EventFacade} e The Event Facade</span> |
|
543 <span class="c"> */</span> |
|
544 <span class="k">this</span><span class="o">.</span><span class="nx">publish</span><span class="o">(</span><span class="nx">RENDER</span><span class="o">,</span> <span class="o">{</span><span class="nx">queuable</span><span class="o">:</span><span class="kc">false</span><span class="o">,</span> <span class="nx">defaultFn</span><span class="o">:</span> <span class="k">this</span><span class="o">.</span><span class="nx">_defRenderFn</span><span class="o">});</span> |
|
545 |
|
546 <span class="nx">parentNode</span> <span class="o">=</span> <span class="o">(</span><span class="nx">parentNode</span><span class="o">)</span> <span class="o">?</span> <span class="nx">Node</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">parentNode</span><span class="o">)</span> <span class="o">:</span> <span class="kc">null</span><span class="o">;</span> |
|
547 <span class="k">if</span> <span class="o">(</span><span class="nx">parentNode</span> <span class="o">&&</span> <span class="o">!</span><span class="nx">parentNode</span><span class="o">.</span><span class="nx">inDoc</span><span class="o">())</span> <span class="o">{</span> |
|
548 <span class="nx">parentNode</span> <span class="o">=</span> <span class="kc">null</span><span class="o">;</span> |
|
549 <span class="o">}</span> |
|
550 |
|
551 <span class="k">this</span><span class="o">.</span><span class="nx">fire</span><span class="o">(</span><span class="nx">RENDER</span><span class="o">,</span> <span class="o">{</span><span class="nx">parentNode</span><span class="o">:</span> <span class="nx">parentNode</span><span class="o">});</span> |
|
552 <span class="o">}</span> |
|
553 |
|
554 <span class="k">return</span> <span class="k">this</span><span class="o">;</span> |
|
555 <span class="o">},</span> |
|
556 |
|
557 <span class="c">/**</span> |
|
558 <span class="c"> * Default render handler</span> |
|
559 <span class="c"> *</span> |
|
560 <span class="c"> * @method _defRenderFn</span> |
|
561 <span class="c"> * @protected</span> |
|
562 <span class="c"> * @param {EventFacade} e The Event object</span> |
|
563 <span class="c"> * @param {Node} parentNode The parent node to render to, if passed in to the <code>render</code> method</span> |
|
564 <span class="c"> */</span> |
|
565 <span class="nx">_defRenderFn</span> <span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">e</span><span class="o">)</span> <span class="o">{</span> |
|
566 |
|
567 <span class="k">this</span><span class="o">.</span><span class="nx">_renderUI</span><span class="o">(</span><span class="nx">e</span><span class="o">.</span><span class="nx">parentNode</span><span class="o">);</span> |
|
568 <span class="k">this</span><span class="o">.</span><span class="nx">_bindUI</span><span class="o">();</span> |
|
569 <span class="k">this</span><span class="o">.</span><span class="nx">_syncUI</span><span class="o">();</span> |
|
570 |
|
571 <span class="k">this</span><span class="o">.</span><span class="nx">renderer</span><span class="o">();</span> |
|
572 |
|
573 <span class="k">this</span><span class="o">.</span><span class="nx">_set</span><span class="o">(</span><span class="nx">RENDERED</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span> |
|
574 <span class="o">},</span> |
|
575 |
|
576 <span class="c">/** </span> |
|
577 <span class="c"> * Creates DOM (or manipulates DOM for progressive enhancement)</span> |
|
578 <span class="c"> * This method is invoked by render() and is not chained </span> |
|
579 <span class="c"> * automatically for the class hierarchy (like initializer, destructor) </span> |
|
580 <span class="c"> * so it should be chained manually for subclasses if required.</span> |
|
581 <span class="c"> * </span> |
|
582 <span class="c"> * @method renderer</span> |
|
583 <span class="c"> * @protected</span> |
|
584 <span class="c"> */</span> |
|
585 <span class="nx">renderer</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
586 <span class="k">this</span><span class="o">.</span><span class="nx">renderUI</span><span class="o">();</span> |
|
587 <span class="k">this</span><span class="o">.</span><span class="nx">bindUI</span><span class="o">();</span> |
|
588 <span class="k">this</span><span class="o">.</span><span class="nx">syncUI</span><span class="o">();</span> |
|
589 <span class="o">},</span> |
|
590 |
|
591 <span class="c">/**</span> |
|
592 <span class="c"> * Configures/Sets up listeners to bind Widget State to UI/DOM</span> |
|
593 <span class="c"> * </span> |
|
594 <span class="c"> * This method is not called by framework and is not chained </span> |
|
595 <span class="c"> * automatically for the class hierarchy.</span> |
|
596 <span class="c"> * </span> |
|
597 <span class="c"> * @method bindUI</span> |
|
598 <span class="c"> * @protected</span> |
|
599 <span class="c"> */</span> |
|
600 <span class="nx">bindUI</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{},</span> |
|
601 |
|
602 <span class="c">/**</span> |
|
603 <span class="c"> * Adds nodes to the DOM </span> |
|
604 <span class="c"> * </span> |
|
605 <span class="c"> * This method is not called by framework and is not chained </span> |
|
606 <span class="c"> * automatically for the class hierarchy.</span> |
|
607 <span class="c"> * </span> |
|
608 <span class="c"> * @method renderUI</span> |
|
609 <span class="c"> * @protected</span> |
|
610 <span class="c"> */</span> |
|
611 <span class="nx">renderUI</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{},</span> |
|
612 |
|
613 <span class="c">/**</span> |
|
614 <span class="c"> * Refreshes the rendered UI, based on Widget State</span> |
|
615 <span class="c"> * </span> |
|
616 <span class="c"> * This method is not called by framework and is not chained</span> |
|
617 <span class="c"> * automatically for the class hierarchy.</span> |
|
618 <span class="c"> *</span> |
|
619 <span class="c"> * @method syncUI</span> |
|
620 <span class="c"> * </span> |
|
621 <span class="c"> */</span> |
|
622 <span class="nx">syncUI</span><span class="o">:</span> <span class="k">function</span><span class="o">(){},</span> |
|
623 |
|
624 <span class="c">/**</span> |
|
625 <span class="c"> * @method hide</span> |
|
626 <span class="c"> * @description Shows the Module element by setting the "visible" attribute to "false".</span> |
|
627 <span class="c"> */</span> |
|
628 <span class="nx">hide</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
629 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">set</span><span class="o">(</span><span class="nx">VISIBLE</span><span class="o">,</span> <span class="kc">false</span><span class="o">);</span> |
|
630 <span class="o">},</span> |
|
631 |
|
632 <span class="c">/**</span> |
|
633 <span class="c"> * @method show</span> |
|
634 <span class="c"> * @description Shows the Module element by setting the "visible" attribute to "true".</span> |
|
635 <span class="c"> */</span> |
|
636 <span class="nx">show</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
637 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">set</span><span class="o">(</span><span class="nx">VISIBLE</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span> |
|
638 <span class="o">},</span> |
|
639 |
|
640 <span class="c">/**</span> |
|
641 <span class="c"> * @method focus</span> |
|
642 <span class="c"> * @description Causes the Widget to receive the focus by setting the "focused" </span> |
|
643 <span class="c"> * attribute to "true".</span> |
|
644 <span class="c"> */</span> |
|
645 <span class="nx">focus</span><span class="o">:</span> <span class="k">function</span> <span class="o">()</span> <span class="o">{</span> |
|
646 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_set</span><span class="o">(</span><span class="nx">FOCUSED</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span> |
|
647 <span class="o">},</span> |
|
648 |
|
649 <span class="c">/**</span> |
|
650 <span class="c"> * @method blur</span> |
|
651 <span class="c"> * @description Causes the Widget to lose focus by setting the "focused" attribute </span> |
|
652 <span class="c"> * to "false"</span> |
|
653 <span class="c"> */</span> |
|
654 <span class="nx">blur</span><span class="o">:</span> <span class="k">function</span> <span class="o">()</span> <span class="o">{</span> |
|
655 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_set</span><span class="o">(</span><span class="nx">FOCUSED</span><span class="o">,</span> <span class="kc">false</span><span class="o">);</span> |
|
656 <span class="o">},</span> |
|
657 |
|
658 <span class="c">/**</span> |
|
659 <span class="c"> * @method enable</span> |
|
660 <span class="c"> * @description Set the Widget's "disabled" attribute to "false".</span> |
|
661 <span class="c"> */</span> |
|
662 <span class="nx">enable</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
663 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">set</span><span class="o">(</span><span class="nx">DISABLED</span><span class="o">,</span> <span class="kc">false</span><span class="o">);</span> |
|
664 <span class="o">},</span> |
|
665 |
|
666 <span class="c">/**</span> |
|
667 <span class="c"> * @method disabled</span> |
|
668 <span class="c"> * @description Set the Widget's "disabled" attribute to "true".</span> |
|
669 <span class="c"> */</span> |
|
670 <span class="nx">disable</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
671 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">set</span><span class="o">(</span><span class="nx">DISABLED</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span> |
|
672 <span class="o">},</span> |
|
673 |
|
674 <span class="c">/**</span> |
|
675 <span class="c"> * Utilitity method used to apply the <code>HTML_PARSER</code> configuration for the </span> |
|
676 <span class="c"> * instance, to retrieve config data values.</span> |
|
677 <span class="c"> * </span> |
|
678 <span class="c"> * @method _parseHTML</span> |
|
679 <span class="c"> * @private </span> |
|
680 <span class="c"> * @param node {Node} Root node to use to parse markup for configuration data</span> |
|
681 <span class="c"> * @return config {Object} configuration object, with values found in the HTML, populated</span> |
|
682 <span class="c"> */</span> |
|
683 <span class="nx">_parseHTML</span> <span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">node</span><span class="o">)</span> <span class="o">{</span> |
|
684 |
|
685 <span class="k">var</span> <span class="nx">schema</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_getHtmlParser</span><span class="o">(),</span> |
|
686 <span class="nx">data</span><span class="o">,</span> |
|
687 <span class="nx">val</span><span class="o">;</span> |
|
688 |
|
689 <span class="k">if</span> <span class="o">(</span><span class="nx">schema</span> <span class="o">&&</span> <span class="nx">node</span> <span class="o">&&</span> <span class="nx">node</span><span class="o">.</span><span class="nx">hasChildNodes</span><span class="o">())</span> <span class="o">{</span> |
|
690 |
|
691 <span class="nx">O</span><span class="o">.</span><span class="nx">each</span><span class="o">(</span><span class="nx">schema</span><span class="o">,</span> <span class="k">function</span><span class="o">(</span><span class="nx">v</span><span class="o">,</span> <span class="nx">k</span><span class="o">,</span> <span class="nx">o</span><span class="o">)</span> <span class="o">{</span> |
|
692 <span class="nx">val</span> <span class="o">=</span> <span class="kc">null</span><span class="o">;</span> |
|
693 |
|
694 <span class="k">if</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isFunction</span><span class="o">(</span><span class="nx">v</span><span class="o">))</span> <span class="o">{</span> |
|
695 <span class="nx">val</span> <span class="o">=</span> <span class="nx">v</span><span class="o">.</span><span class="nx">call</span><span class="o">(</span><span class="k">this</span><span class="o">,</span> <span class="nx">node</span><span class="o">);</span> |
|
696 <span class="o">}</span> <span class="k">else</span> <span class="o">{</span> |
|
697 <span class="k">if</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isArray</span><span class="o">(</span><span class="nx">v</span><span class="o">))</span> <span class="o">{</span> |
|
698 <span class="nx">val</span> <span class="o">=</span> <span class="nx">node</span><span class="o">.</span><span class="nx">queryAll</span><span class="o">(</span><span class="nx">v</span><span class="o">[</span><span class="m">0</span><span class="o">]);</span> |
|
699 <span class="o">}</span> <span class="k">else</span> <span class="o">{</span> |
|
700 <span class="nx">val</span> <span class="o">=</span> <span class="nx">node</span><span class="o">.</span><span class="nx">query</span><span class="o">(</span><span class="nx">v</span><span class="o">);</span> |
|
701 <span class="o">}</span> |
|
702 <span class="o">}</span> |
|
703 |
|
704 <span class="k">if</span> <span class="o">(</span><span class="nx">val</span> <span class="o">!==</span> <span class="kc">null</span> <span class="o">&&</span> <span class="nx">val</span> <span class="o">!==</span> <span class="kc">undefined</span><span class="o">)</span> <span class="o">{</span> |
|
705 <span class="nx">data</span> <span class="o">=</span> <span class="nx">data</span> <span class="o">||</span> <span class="o">{};</span> |
|
706 <span class="nx">data</span><span class="o">[</span><span class="nx">k</span><span class="o">]</span> <span class="o">=</span> <span class="nx">val</span><span class="o">;</span> |
|
707 <span class="o">}</span> |
|
708 |
|
709 <span class="o">},</span> <span class="k">this</span><span class="o">);</span> |
|
710 <span class="o">}</span> |
|
711 |
|
712 <span class="k">return</span> <span class="nx">data</span><span class="o">;</span> |
|
713 <span class="o">},</span> |
|
714 |
|
715 <span class="c">/**</span> |
|
716 <span class="c"> * Moves a pre-defined set of style rules (WRAP_STYLES) from one node to another.</span> |
|
717 <span class="c"> *</span> |
|
718 <span class="c"> * @method _moveStyles</span> |
|
719 <span class="c"> * @private</span> |
|
720 <span class="c"> * @param {Node} nodeFrom The node to gather the styles from</span> |
|
721 <span class="c"> * @param {Node} nodeTo The node to apply the styles to</span> |
|
722 <span class="c"> */</span> |
|
723 <span class="nx">_moveStyles</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">nodeFrom</span><span class="o">,</span> <span class="nx">nodeTo</span><span class="o">)</span> <span class="o">{</span> |
|
724 |
|
725 <span class="k">var</span> <span class="nx">styles</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">WRAP_STYLES</span><span class="o">,</span> |
|
726 <span class="nx">pos</span> <span class="o">=</span> <span class="nx">nodeFrom</span><span class="o">.</span><span class="nx">getStyle</span><span class="o">(</span><span class="s1">'position'</span><span class="o">),</span> |
|
727 <span class="nx">contentBox</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">CONTENT_BOX</span><span class="o">),</span> |
|
728 <span class="nx">xy</span> <span class="o">=</span> <span class="o">[</span><span class="m">0</span><span class="o">,</span><span class="m">0</span><span class="o">],</span> |
|
729 <span class="nx">h</span><span class="o">,</span> <span class="nx">w</span><span class="o">;</span> |
|
730 |
|
731 <span class="k">if</span> <span class="o">(!</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s1">'height'</span><span class="o">))</span> <span class="o">{</span> |
|
732 <span class="nx">h</span> <span class="o">=</span> <span class="nx">contentBox</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s1">'offsetHeight'</span><span class="o">);</span> |
|
733 <span class="o">}</span> |
|
734 |
|
735 <span class="k">if</span> <span class="o">(!</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s1">'width'</span><span class="o">))</span> <span class="o">{</span> |
|
736 <span class="nx">w</span> <span class="o">=</span> <span class="nx">contentBox</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s1">'offsetWidth'</span><span class="o">);</span> |
|
737 <span class="o">}</span> |
|
738 |
|
739 <span class="k">if</span> <span class="o">(</span><span class="nx">pos</span> <span class="o">===</span> <span class="s1">'absolute'</span><span class="o">)</span> <span class="o">{</span> |
|
740 <span class="nx">xy</span> <span class="o">=</span> <span class="nx">nodeFrom</span><span class="o">.</span><span class="nx">getXY</span><span class="o">();</span> |
|
741 <span class="nx">nodeTo</span><span class="o">.</span><span class="nx">setStyles</span><span class="o">({</span> |
|
742 <span class="nx">right</span><span class="o">:</span> <span class="s1">'auto'</span><span class="o">,</span> |
|
743 <span class="nx">bottom</span><span class="o">:</span> <span class="s1">'auto'</span> |
|
744 <span class="o">});</span> |
|
745 |
|
746 <span class="nx">nodeFrom</span><span class="o">.</span><span class="nx">setStyles</span><span class="o">({</span> |
|
747 <span class="nx">right</span><span class="o">:</span> <span class="s1">'auto'</span><span class="o">,</span> |
|
748 <span class="nx">bottom</span><span class="o">:</span> <span class="s1">'auto'</span> |
|
749 <span class="o">});</span> |
|
750 <span class="o">}</span> |
|
751 |
|
752 <span class="nx">Y</span><span class="o">.</span><span class="nx">each</span><span class="o">(</span><span class="nx">styles</span><span class="o">,</span> <span class="k">function</span><span class="o">(</span><span class="nx">v</span><span class="o">,</span> <span class="nx">k</span><span class="o">)</span> <span class="o">{</span> |
|
753 <span class="k">var</span> <span class="nx">s</span> <span class="o">=</span> <span class="nx">nodeFrom</span><span class="o">.</span><span class="nx">getStyle</span><span class="o">(</span><span class="nx">k</span><span class="o">);</span> |
|
754 <span class="nx">nodeTo</span><span class="o">.</span><span class="nx">setStyle</span><span class="o">(</span><span class="nx">k</span><span class="o">,</span> <span class="nx">s</span><span class="o">);</span> |
|
755 <span class="k">if</span> <span class="o">(</span><span class="nx">v</span> <span class="o">===</span> <span class="kc">false</span><span class="o">)</span> <span class="o">{</span> |
|
756 <span class="nx">nodeFrom</span><span class="o">.</span><span class="nx">setStyle</span><span class="o">(</span><span class="nx">k</span><span class="o">,</span> <span class="s1">''</span><span class="o">);</span> |
|
757 <span class="o">}</span> <span class="k">else</span> <span class="o">{</span> |
|
758 <span class="nx">nodeFrom</span><span class="o">.</span><span class="nx">setStyle</span><span class="o">(</span><span class="nx">k</span><span class="o">,</span> <span class="nx">v</span><span class="o">);</span> |
|
759 <span class="o">}</span> |
|
760 <span class="o">});</span> |
|
761 |
|
762 <span class="k">if</span> <span class="o">(</span><span class="nx">pos</span> <span class="o">===</span> <span class="s1">'absolute'</span><span class="o">)</span> <span class="o">{</span> |
|
763 <span class="nx">nodeTo</span><span class="o">.</span><span class="nx">setXY</span><span class="o">(</span><span class="nx">xy</span><span class="o">);</span> |
|
764 <span class="o">}</span> |
|
765 |
|
766 <span class="k">if</span> <span class="o">(</span><span class="nx">h</span><span class="o">)</span> <span class="o">{</span> |
|
767 <span class="k">this</span><span class="o">.</span><span class="nx">set</span><span class="o">(</span><span class="s1">'height'</span><span class="o">,</span> <span class="nx">h</span><span class="o">);</span> |
|
768 <span class="o">}</span> |
|
769 |
|
770 <span class="k">if</span> <span class="o">(</span><span class="nx">w</span><span class="o">)</span> <span class="o">{</span> |
|
771 <span class="k">this</span><span class="o">.</span><span class="nx">set</span><span class="o">(</span><span class="s1">'width'</span><span class="o">,</span> <span class="nx">w</span><span class="o">);</span> |
|
772 <span class="o">}</span> |
|
773 <span class="o">},</span> |
|
774 |
|
775 <span class="c">/**</span> |
|
776 <span class="c"> * Helper method to collect the boundingBox and contentBox, set styles and append to the provided parentNode, if not</span> |
|
777 <span class="c"> * already a child. The owner document of the boundingBox, or the owner document of the contentBox will be used </span> |
|
778 <span class="c"> * as the document into which the Widget is rendered if a parentNode is node is not provided. If both the boundingBox and</span> |
|
779 <span class="c"> * the contentBox are not currently in the document, and no parentNode is provided, the widget will be rendered </span> |
|
780 <span class="c"> * to the current document's body.</span> |
|
781 <span class="c"> *</span> |
|
782 <span class="c"> * @method _renderBox</span> |
|
783 <span class="c"> * @private</span> |
|
784 <span class="c"> * @param {Node} parentNode The parentNode to render the widget to. If not provided, and both the boundingBox and</span> |
|
785 <span class="c"> * the contentBox are not currently in the document, the widget will be rendered to the current document's body.</span> |
|
786 <span class="c"> */</span> |
|
787 <span class="nx">_renderBox</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">parentNode</span><span class="o">)</span> <span class="o">{</span> |
|
788 |
|
789 <span class="k">var</span> <span class="nx">contentBox</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">CONTENT_BOX</span><span class="o">),</span> |
|
790 <span class="nx">boundingBox</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BOUNDING_BOX</span><span class="o">),</span> |
|
791 <span class="nx">doc</span> <span class="o">=</span> <span class="nx">boundingBox</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">OWNER_DOCUMENT</span><span class="o">)</span> <span class="o">||</span> <span class="nx">contentBox</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">OWNER_DOCUMENT</span><span class="o">),</span> |
|
792 <span class="nx">body</span><span class="o">;</span> |
|
793 |
|
794 <span class="k">if</span> <span class="o">(!</span><span class="nx">boundingBox</span><span class="o">.</span><span class="nx">compareTo</span><span class="o">(</span><span class="nx">contentBox</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">PARENT_NODE</span><span class="o">)))</span> <span class="o">{</span> |
|
795 <span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="s1">'moveStyles'</span><span class="o">))</span> <span class="o">{</span> |
|
796 <span class="k">this</span><span class="o">.</span><span class="nx">_moveStyles</span><span class="o">(</span><span class="nx">contentBox</span><span class="o">,</span> <span class="nx">boundingBox</span><span class="o">);</span> |
|
797 <span class="o">}</span> |
|
798 <span class="c">// If contentBox box is already in the document, have boundingBox box take it's place</span> |
|
799 <span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">contentBox</span><span class="o">.</span><span class="nx">inDoc</span><span class="o">(</span><span class="nx">doc</span><span class="o">))</span> <span class="o">{</span> |
|
800 <span class="nx">contentBox</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">PARENT_NODE</span><span class="o">).</span><span class="nx">replaceChild</span><span class="o">(</span><span class="nx">boundingBox</span><span class="o">,</span> <span class="nx">contentBox</span><span class="o">);</span> |
|
801 <span class="o">}</span> |
|
802 <span class="nx">boundingBox</span><span class="o">.</span><span class="nx">appendChild</span><span class="o">(</span><span class="nx">contentBox</span><span class="o">);</span> |
|
803 <span class="o">}</span> |
|
804 |
|
805 <span class="k">if</span> <span class="o">(!</span><span class="nx">boundingBox</span><span class="o">.</span><span class="nx">inDoc</span><span class="o">(</span><span class="nx">doc</span><span class="o">)</span> <span class="o">&&</span> <span class="o">!</span><span class="nx">parentNode</span><span class="o">)</span> <span class="o">{</span> |
|
806 <span class="nx">body</span> <span class="o">=</span> <span class="nx">Node</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BODY</span><span class="o">);</span> |
|
807 <span class="k">if</span> <span class="o">(</span><span class="nx">body</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">FIRST_CHILD</span><span class="o">))</span> <span class="o">{</span> |
|
808 <span class="c">// Special case when handling body as default (no parentNode), always try to insert.</span> |
|
809 <span class="c"></span> <span class="nx">body</span><span class="o">.</span><span class="nx">insertBefore</span><span class="o">(</span><span class="nx">boundingBox</span><span class="o">,</span> <span class="nx">body</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">FIRST_CHILD</span><span class="o">));</span> |
|
810 <span class="o">}</span> <span class="k">else</span> <span class="o">{</span> |
|
811 <span class="nx">body</span><span class="o">.</span><span class="nx">appendChild</span><span class="o">(</span><span class="nx">boundingBox</span><span class="o">);</span> |
|
812 <span class="o">}</span> |
|
813 <span class="o">}</span> <span class="k">else</span> <span class="o">{</span> |
|
814 <span class="k">if</span> <span class="o">(</span><span class="nx">parentNode</span> <span class="o">&&</span> <span class="o">!</span><span class="nx">parentNode</span><span class="o">.</span><span class="nx">compareTo</span><span class="o">(</span><span class="nx">boundingBox</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">PARENT_NODE</span><span class="o">)))</span> <span class="o">{</span> |
|
815 <span class="nx">parentNode</span><span class="o">.</span><span class="nx">appendChild</span><span class="o">(</span><span class="nx">boundingBox</span><span class="o">);</span> |
|
816 <span class="o">}</span> |
|
817 <span class="o">}</span> |
|
818 <span class="o">},</span> |
|
819 |
|
820 <span class="c">/**</span> |
|
821 <span class="c"> * Setter for the boundingBox attribute</span> |
|
822 <span class="c"> *</span> |
|
823 <span class="c"> * @method _setBoundingBox</span> |
|
824 <span class="c"> * @private</span> |
|
825 <span class="c"> * @param Node/String</span> |
|
826 <span class="c"> * @return Node</span> |
|
827 <span class="c"> */</span> |
|
828 <span class="nx">_setBoundingBox</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">node</span><span class="o">)</span> <span class="o">{</span> |
|
829 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_setBox</span><span class="o">(</span><span class="nx">node</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">BOUNDING_TEMPLATE</span><span class="o">);</span> |
|
830 <span class="o">},</span> |
|
831 |
|
832 <span class="c">/**</span> |
|
833 <span class="c"> * Setter for the contentBox attribute</span> |
|
834 <span class="c"> *</span> |
|
835 <span class="c"> * @method _setContentBox</span> |
|
836 <span class="c"> * @private</span> |
|
837 <span class="c"> * @param {Node|String} node</span> |
|
838 <span class="c"> * @return Node</span> |
|
839 <span class="c"> */</span> |
|
840 <span class="nx">_setContentBox</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">node</span><span class="o">)</span> <span class="o">{</span> |
|
841 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_setBox</span><span class="o">(</span><span class="nx">node</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">CONTENT_TEMPLATE</span><span class="o">);</span> |
|
842 <span class="o">},</span> |
|
843 |
|
844 <span class="c">/**</span> |
|
845 <span class="c"> * Helper method to set the bounding/content box, or create it from</span> |
|
846 <span class="c"> * the provided template if not found.</span> |
|
847 <span class="c"> *</span> |
|
848 <span class="c"> * @method _setBox</span> |
|
849 <span class="c"> * @private</span> |
|
850 <span class="c"> *</span> |
|
851 <span class="c"> * @param {Node|String} node The node reference</span> |
|
852 <span class="c"> * @param {String} template HTML string template for the node</span> |
|
853 <span class="c"> * @return {Node} The node</span> |
|
854 <span class="c"> */</span> |
|
855 <span class="nx">_setBox</span> <span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">node</span><span class="o">,</span> <span class="nx">template</span><span class="o">)</span> <span class="o">{</span> |
|
856 <span class="nx">node</span> <span class="o">=</span> <span class="nx">Node</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">node</span><span class="o">)</span> <span class="o">||</span> <span class="nx">Node</span><span class="o">.</span><span class="nx">create</span><span class="o">(</span><span class="nx">template</span><span class="o">);</span> |
|
857 |
|
858 <span class="k">var</span> <span class="nx">sid</span> <span class="o">=</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">stamp</span><span class="o">(</span><span class="nx">node</span><span class="o">);</span> |
|
859 <span class="k">if</span> <span class="o">(!</span><span class="nx">node</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">ID</span><span class="o">))</span> <span class="o">{</span> |
|
860 <span class="nx">node</span><span class="o">.</span><span class="nx">set</span><span class="o">(</span><span class="nx">ID</span><span class="o">,</span> <span class="nx">sid</span><span class="o">);</span> |
|
861 <span class="o">}</span> |
|
862 <span class="k">return</span> <span class="nx">node</span><span class="o">;</span> |
|
863 <span class="o">},</span> |
|
864 |
|
865 <span class="c">/**</span> |
|
866 <span class="c"> * Initializes the UI state for the Widget's bounding/content boxes.</span> |
|
867 <span class="c"> *</span> |
|
868 <span class="c"> * @method _renderUI</span> |
|
869 <span class="c"> * @protected</span> |
|
870 <span class="c"> * @param {Node} The parent node to rendering the widget into</span> |
|
871 <span class="c"> */</span> |
|
872 <span class="nx">_renderUI</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">parentNode</span><span class="o">)</span> <span class="o">{</span> |
|
873 <span class="k">this</span><span class="o">.</span><span class="nx">_renderBoxClassNames</span><span class="o">();</span> |
|
874 <span class="k">this</span><span class="o">.</span><span class="nx">_renderBox</span><span class="o">(</span><span class="nx">parentNode</span><span class="o">);</span> |
|
875 <span class="o">},</span> |
|
876 |
|
877 <span class="c">/**</span> |
|
878 <span class="c"> * Applies standard class names to the boundingBox and contentBox</span> |
|
879 <span class="c"> * </span> |
|
880 <span class="c"> * @method _renderBoxClassNames</span> |
|
881 <span class="c"> * @protected</span> |
|
882 <span class="c"> */</span> |
|
883 <span class="nx">_renderBoxClassNames</span> <span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
884 <span class="k">var</span> <span class="nx">classes</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_getClasses</span><span class="o">(),</span> |
|
885 <span class="nx">boundingBox</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BOUNDING_BOX</span><span class="o">),</span> |
|
886 <span class="nx">contentBox</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">CONTENT_BOX</span><span class="o">),</span> |
|
887 <span class="nx">name</span><span class="o">,</span> <span class="nx">i</span><span class="o">;</span> |
|
888 |
|
889 <span class="nx">boundingBox</span><span class="o">.</span><span class="nx">addClass</span><span class="o">(</span><span class="nx">Widget</span><span class="o">.</span><span class="nx">getClassName</span><span class="o">());</span> |
|
890 |
|
891 <span class="c">// Start from Widget Sub Class</span> |
|
892 <span class="c"></span> <span class="k">for</span> <span class="o">(</span><span class="nx">i</span> <span class="o">=</span> <span class="nx">classes</span><span class="o">.</span><span class="nx">length</span><span class="o">-</span><span class="m">3</span><span class="o">;</span> <span class="nx">i</span> <span class="o">>=</span> <span class="m">0</span><span class="o">;</span> <span class="nx">i</span><span class="o">--)</span> <span class="o">{</span> |
|
893 <span class="nx">name</span> <span class="o">=</span> <span class="nx">classes</span><span class="o">[</span><span class="nx">i</span><span class="o">].</span><span class="nx">NAME</span><span class="o">;</span> |
|
894 <span class="k">if</span> <span class="o">(</span><span class="nx">name</span><span class="o">)</span> <span class="o">{</span> |
|
895 <span class="nx">boundingBox</span><span class="o">.</span><span class="nx">addClass</span><span class="o">(</span><span class="nx">ClassNameManager</span><span class="o">.</span><span class="nx">getClassName</span><span class="o">(</span><span class="nx">name</span><span class="o">.</span><span class="nx">toLowerCase</span><span class="o">()));</span> |
|
896 <span class="o">}</span> |
|
897 <span class="o">}</span> |
|
898 |
|
899 <span class="c">// Use instance based name for content box</span> |
|
900 <span class="c"></span> <span class="nx">contentBox</span><span class="o">.</span><span class="nx">addClass</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">getClassName</span><span class="o">(</span><span class="nx">CONTENT</span><span class="o">));</span> |
|
901 <span class="o">},</span> |
|
902 |
|
903 <span class="c">/**</span> |
|
904 <span class="c"> * Sets up DOM and CustomEvent listeners for the widget.</span> |
|
905 <span class="c"> *</span> |
|
906 <span class="c"> * @method _bindUI</span> |
|
907 <span class="c"> * @protected</span> |
|
908 <span class="c"> */</span> |
|
909 <span class="nx">_bindUI</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
910 <span class="k">this</span><span class="o">.</span><span class="nx">after</span><span class="o">(</span><span class="s1">'visibleChange'</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">_afterVisibleChange</span><span class="o">);</span> |
|
911 <span class="k">this</span><span class="o">.</span><span class="nx">after</span><span class="o">(</span><span class="s1">'disabledChange'</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">_afterDisabledChange</span><span class="o">);</span> |
|
912 <span class="k">this</span><span class="o">.</span><span class="nx">after</span><span class="o">(</span><span class="s1">'heightChange'</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">_afterHeightChange</span><span class="o">);</span> |
|
913 <span class="k">this</span><span class="o">.</span><span class="nx">after</span><span class="o">(</span><span class="s1">'widthChange'</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">_afterWidthChange</span><span class="o">);</span> |
|
914 <span class="k">this</span><span class="o">.</span><span class="nx">after</span><span class="o">(</span><span class="s1">'focusedChange'</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">_afterFocusedChange</span><span class="o">);</span> |
|
915 |
|
916 <span class="k">this</span><span class="o">.</span><span class="nx">_bindDOMListeners</span><span class="o">();</span> |
|
917 <span class="o">},</span> |
|
918 |
|
919 <span class="c">/**</span> |
|
920 <span class="c"> * Sets up DOM listeners, on elements rendered by the widget.</span> |
|
921 <span class="c"> * </span> |
|
922 <span class="c"> * @method _bindDOMListeners</span> |
|
923 <span class="c"> * @protected</span> |
|
924 <span class="c"> */</span> |
|
925 <span class="nx">_bindDOMListeners</span> <span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
926 |
|
927 <span class="k">var</span> <span class="nx">oDocument</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BOUNDING_BOX</span><span class="o">).</span><span class="nx">get</span><span class="o">(</span><span class="s2">"ownerDocument"</span><span class="o">);</span> |
|
928 |
|
929 <span class="nx">oDocument</span><span class="o">.</span><span class="nx">on</span><span class="o">(</span><span class="s2">"focus"</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">_onFocus</span><span class="o">,</span> <span class="k">this</span><span class="o">);</span> |
|
930 |
|
931 <span class="c">// Fix for Webkit:</span> |
|
932 <span class="c"></span> <span class="c">// Document doesn't receive focus in Webkit when the user mouses </span> |
|
933 <span class="c"></span> <span class="c">// down on it, so the "focused" attribute won't get set to the </span> |
|
934 <span class="c"></span> <span class="c">// correct value.</span> |
|
935 <span class="c"></span> |
|
936 <span class="k">if</span> <span class="o">(</span><span class="nx">Y</span><span class="o">.</span><span class="nx">UA</span><span class="o">.</span><span class="nx">webkit</span><span class="o">)</span> <span class="o">{</span> |
|
937 <span class="nx">oDocument</span><span class="o">.</span><span class="nx">on</span><span class="o">(</span><span class="s2">"mousedown"</span><span class="o">,</span> <span class="k">this</span><span class="o">.</span><span class="nx">_onDocMouseDown</span><span class="o">,</span> <span class="k">this</span><span class="o">);</span> |
|
938 <span class="o">}</span> |
|
939 |
|
940 <span class="o">},</span> |
|
941 |
|
942 <span class="c">/**</span> |
|
943 <span class="c"> * Updates the widget UI to reflect the attribute state.</span> |
|
944 <span class="c"> *</span> |
|
945 <span class="c"> * @method _syncUI</span> |
|
946 <span class="c"> * @protected</span> |
|
947 <span class="c"> */</span> |
|
948 <span class="nx">_syncUI</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
949 <span class="k">this</span><span class="o">.</span><span class="nx">_uiSetVisible</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">VISIBLE</span><span class="o">));</span> |
|
950 <span class="k">this</span><span class="o">.</span><span class="nx">_uiSetDisabled</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">DISABLED</span><span class="o">));</span> |
|
951 <span class="k">this</span><span class="o">.</span><span class="nx">_uiSetHeight</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">HEIGHT</span><span class="o">));</span> |
|
952 <span class="k">this</span><span class="o">.</span><span class="nx">_uiSetWidth</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">WIDTH</span><span class="o">));</span> |
|
953 <span class="k">this</span><span class="o">.</span><span class="nx">_uiSetFocused</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">FOCUSED</span><span class="o">));</span> |
|
954 <span class="k">this</span><span class="o">.</span><span class="nx">_uiSetTabIndex</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">TAB_INDEX</span><span class="o">));</span> |
|
955 <span class="o">},</span> |
|
956 |
|
957 <span class="c">/**</span> |
|
958 <span class="c"> * Sets the height on the widget's bounding box element</span> |
|
959 <span class="c"> * </span> |
|
960 <span class="c"> * @method _uiSetHeight</span> |
|
961 <span class="c"> * @protected</span> |
|
962 <span class="c"> * @param {String | Number} val</span> |
|
963 <span class="c"> */</span> |
|
964 <span class="nx">_uiSetHeight</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">val</span><span class="o">)</span> <span class="o">{</span> |
|
965 <span class="k">if</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isNumber</span><span class="o">(</span><span class="nx">val</span><span class="o">))</span> <span class="o">{</span> |
|
966 <span class="nx">val</span> <span class="o">=</span> <span class="nx">val</span> <span class="o">+</span> <span class="k">this</span><span class="o">.</span><span class="nx">DEF_UNIT</span><span class="o">;</span> |
|
967 <span class="o">}</span> |
|
968 <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BOUNDING_BOX</span><span class="o">).</span><span class="nx">setStyle</span><span class="o">(</span><span class="nx">HEIGHT</span><span class="o">,</span> <span class="nx">val</span><span class="o">);</span> |
|
969 <span class="o">},</span> |
|
970 |
|
971 <span class="c">/**</span> |
|
972 <span class="c"> * Sets the width on the widget's bounding box element</span> |
|
973 <span class="c"> *</span> |
|
974 <span class="c"> * @method _uiSetWidth</span> |
|
975 <span class="c"> * @protected</span> |
|
976 <span class="c"> * @param {String | Number} val</span> |
|
977 <span class="c"> */</span> |
|
978 <span class="nx">_uiSetWidth</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">val</span><span class="o">)</span> <span class="o">{</span> |
|
979 <span class="k">if</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isNumber</span><span class="o">(</span><span class="nx">val</span><span class="o">))</span> <span class="o">{</span> |
|
980 <span class="nx">val</span> <span class="o">=</span> <span class="nx">val</span> <span class="o">+</span> <span class="k">this</span><span class="o">.</span><span class="nx">DEF_UNIT</span><span class="o">;</span> |
|
981 <span class="o">}</span> |
|
982 <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BOUNDING_BOX</span><span class="o">).</span><span class="nx">setStyle</span><span class="o">(</span><span class="nx">WIDTH</span><span class="o">,</span> <span class="nx">val</span><span class="o">);</span> |
|
983 <span class="o">},</span> |
|
984 |
|
985 <span class="c">/**</span> |
|
986 <span class="c"> * Sets the visible state for the UI</span> |
|
987 <span class="c"> * </span> |
|
988 <span class="c"> * @method _uiSetVisible</span> |
|
989 <span class="c"> * @protected</span> |
|
990 <span class="c"> * @param {boolean} val</span> |
|
991 <span class="c"> */</span> |
|
992 <span class="nx">_uiSetVisible</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">val</span><span class="o">)</span> <span class="o">{</span> |
|
993 |
|
994 <span class="k">var</span> <span class="nx">box</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BOUNDING_BOX</span><span class="o">),</span> |
|
995 <span class="nx">sClassName</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">getClassName</span><span class="o">(</span><span class="nx">HIDDEN</span><span class="o">);</span> |
|
996 |
|
997 <span class="k">if</span> <span class="o">(</span><span class="nx">val</span> <span class="o">===</span> <span class="kc">true</span><span class="o">)</span> <span class="o">{</span> |
|
998 <span class="nx">box</span><span class="o">.</span><span class="nx">removeClass</span><span class="o">(</span><span class="nx">sClassName</span><span class="o">);</span> |
|
999 <span class="o">}</span> <span class="k">else</span> <span class="o">{</span> |
|
1000 <span class="nx">box</span><span class="o">.</span><span class="nx">addClass</span><span class="o">(</span><span class="nx">sClassName</span><span class="o">);</span> |
|
1001 <span class="o">}</span> |
|
1002 <span class="o">},</span> |
|
1003 |
|
1004 <span class="c">/**</span> |
|
1005 <span class="c"> * Sets the disabled state for the UI</span> |
|
1006 <span class="c"> * </span> |
|
1007 <span class="c"> * @protected</span> |
|
1008 <span class="c"> * @param {boolean} val</span> |
|
1009 <span class="c"> */</span> |
|
1010 <span class="nx">_uiSetDisabled</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">val</span><span class="o">)</span> <span class="o">{</span> |
|
1011 |
|
1012 <span class="k">var</span> <span class="nx">box</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BOUNDING_BOX</span><span class="o">),</span> |
|
1013 <span class="nx">sClassName</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">getClassName</span><span class="o">(</span><span class="nx">DISABLED</span><span class="o">);</span> |
|
1014 |
|
1015 <span class="k">if</span> <span class="o">(</span><span class="nx">val</span> <span class="o">===</span> <span class="kc">true</span><span class="o">)</span> <span class="o">{</span> |
|
1016 <span class="nx">box</span><span class="o">.</span><span class="nx">addClass</span><span class="o">(</span><span class="nx">sClassName</span><span class="o">);</span> |
|
1017 <span class="o">}</span> <span class="k">else</span> <span class="o">{</span> |
|
1018 <span class="nx">box</span><span class="o">.</span><span class="nx">removeClass</span><span class="o">(</span><span class="nx">sClassName</span><span class="o">);</span> |
|
1019 <span class="o">}</span> |
|
1020 <span class="o">},</span> |
|
1021 |
|
1022 |
|
1023 <span class="c">/**</span> |
|
1024 <span class="c"> * Set the tabIndex on the widget's rendered UI</span> |
|
1025 <span class="c"> *</span> |
|
1026 <span class="c"> * @method _uiSetTabIndex</span> |
|
1027 <span class="c"> * @protected</span> |
|
1028 <span class="c"> * @param Number</span> |
|
1029 <span class="c"> */</span> |
|
1030 <span class="nx">_uiSetTabIndex</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">index</span><span class="o">)</span> <span class="o">{</span> |
|
1031 |
|
1032 <span class="k">var</span> <span class="nx">boundingBox</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BOUNDING_BOX</span><span class="o">);</span> |
|
1033 |
|
1034 <span class="k">if</span> <span class="o">(</span><span class="nx">L</span><span class="o">.</span><span class="nx">isNumber</span><span class="o">(</span><span class="nx">index</span><span class="o">))</span> <span class="o">{</span> |
|
1035 <span class="nx">boundingBox</span><span class="o">.</span><span class="nx">set</span><span class="o">(</span><span class="nx">TAB_INDEX</span><span class="o">,</span> <span class="nx">index</span><span class="o">);</span> |
|
1036 <span class="o">}</span> |
|
1037 <span class="k">else</span> <span class="o">{</span> |
|
1038 <span class="nx">boundingBox</span><span class="o">.</span><span class="nx">removeAttribute</span><span class="o">(</span><span class="nx">TAB_INDEX</span><span class="o">);</span> |
|
1039 <span class="o">}</span> |
|
1040 |
|
1041 <span class="o">},</span> |
|
1042 |
|
1043 |
|
1044 <span class="c">/**</span> |
|
1045 <span class="c"> * Sets the focused state for the UI</span> |
|
1046 <span class="c"> *</span> |
|
1047 <span class="c"> * @protected</span> |
|
1048 <span class="c"> * @param {boolean} val</span> |
|
1049 <span class="c"> * @param {string} src String representing the source that triggered an update to </span> |
|
1050 <span class="c"> * the UI. </span> |
|
1051 <span class="c"> */</span> |
|
1052 <span class="nx">_uiSetFocused</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">val</span><span class="o">,</span> <span class="nx">src</span><span class="o">)</span> <span class="o">{</span> |
|
1053 |
|
1054 <span class="k">var</span> <span class="nx">box</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BOUNDING_BOX</span><span class="o">),</span> |
|
1055 <span class="nx">sClassName</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">getClassName</span><span class="o">(</span><span class="nx">FOCUSED</span><span class="o">);</span> |
|
1056 |
|
1057 <span class="k">if</span> <span class="o">(</span><span class="nx">val</span> <span class="o">===</span> <span class="kc">true</span><span class="o">)</span> <span class="o">{</span> |
|
1058 <span class="nx">box</span><span class="o">.</span><span class="nx">addClass</span><span class="o">(</span><span class="nx">sClassName</span><span class="o">);</span> |
|
1059 <span class="k">if</span> <span class="o">(</span><span class="nx">src</span> <span class="o">!==</span> <span class="nx">UI</span><span class="o">)</span> <span class="o">{</span> |
|
1060 <span class="nx">box</span><span class="o">.</span><span class="nx">focus</span><span class="o">();</span> |
|
1061 <span class="o">}</span> |
|
1062 <span class="o">}</span> <span class="k">else</span> <span class="o">{</span> |
|
1063 <span class="nx">box</span><span class="o">.</span><span class="nx">removeClass</span><span class="o">(</span><span class="nx">sClassName</span><span class="o">);</span> |
|
1064 <span class="k">if</span> <span class="o">(</span><span class="nx">src</span> <span class="o">!==</span> <span class="nx">UI</span><span class="o">)</span> <span class="o">{</span> |
|
1065 <span class="nx">box</span><span class="o">.</span><span class="nx">blur</span><span class="o">();</span> |
|
1066 <span class="o">}</span> |
|
1067 <span class="o">}</span> |
|
1068 <span class="o">},</span> |
|
1069 |
|
1070 |
|
1071 |
|
1072 <span class="c">/**</span> |
|
1073 <span class="c"> * Default visible attribute state change handler</span> |
|
1074 <span class="c"> *</span> |
|
1075 <span class="c"> * @method _afterVisibleChange</span> |
|
1076 <span class="c"> * @protected</span> |
|
1077 <span class="c"> * @param {EventFacade} evt The event facade for the attribute change</span> |
|
1078 <span class="c"> */</span> |
|
1079 <span class="nx">_afterVisibleChange</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">evt</span><span class="o">)</span> <span class="o">{</span> |
|
1080 <span class="k">this</span><span class="o">.</span><span class="nx">_uiSetVisible</span><span class="o">(</span><span class="nx">evt</span><span class="o">.</span><span class="nx">newVal</span><span class="o">);</span> |
|
1081 <span class="o">},</span> |
|
1082 |
|
1083 <span class="c">/**</span> |
|
1084 <span class="c"> * Default disabled attribute state change handler</span> |
|
1085 <span class="c"> * </span> |
|
1086 <span class="c"> * @method _afterDisabledChange</span> |
|
1087 <span class="c"> * @protected</span> |
|
1088 <span class="c"> * @param {EventFacade} evt The event facade for the attribute change</span> |
|
1089 <span class="c"> */</span> |
|
1090 <span class="nx">_afterDisabledChange</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">evt</span><span class="o">)</span> <span class="o">{</span> |
|
1091 <span class="k">this</span><span class="o">.</span><span class="nx">_uiSetDisabled</span><span class="o">(</span><span class="nx">evt</span><span class="o">.</span><span class="nx">newVal</span><span class="o">);</span> |
|
1092 <span class="o">},</span> |
|
1093 |
|
1094 <span class="c">/**</span> |
|
1095 <span class="c"> * Default height attribute state change handler</span> |
|
1096 <span class="c"> * </span> |
|
1097 <span class="c"> * @method _afterHeightChange</span> |
|
1098 <span class="c"> * @protected</span> |
|
1099 <span class="c"> * @param {EventFacade} evt The event facade for the attribute change</span> |
|
1100 <span class="c"> */</span> |
|
1101 <span class="nx">_afterHeightChange</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">evt</span><span class="o">)</span> <span class="o">{</span> |
|
1102 <span class="k">this</span><span class="o">.</span><span class="nx">_uiSetHeight</span><span class="o">(</span><span class="nx">evt</span><span class="o">.</span><span class="nx">newVal</span><span class="o">);</span> |
|
1103 <span class="o">},</span> |
|
1104 |
|
1105 <span class="c">/**</span> |
|
1106 <span class="c"> * Default widget attribute state change handler</span> |
|
1107 <span class="c"> * </span> |
|
1108 <span class="c"> * @method _afterWidthChange</span> |
|
1109 <span class="c"> * @protected</span> |
|
1110 <span class="c"> * @param {EventFacade} evt The event facade for the attribute change</span> |
|
1111 <span class="c"> */</span> |
|
1112 <span class="nx">_afterWidthChange</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">evt</span><span class="o">)</span> <span class="o">{</span> |
|
1113 <span class="k">this</span><span class="o">.</span><span class="nx">_uiSetWidth</span><span class="o">(</span><span class="nx">evt</span><span class="o">.</span><span class="nx">newVal</span><span class="o">);</span> |
|
1114 <span class="o">},</span> |
|
1115 |
|
1116 <span class="c">/**</span> |
|
1117 <span class="c"> * Default focused attribute state change handler</span> |
|
1118 <span class="c"> * </span> |
|
1119 <span class="c"> * @method _afterFocusedChange</span> |
|
1120 <span class="c"> * @protected</span> |
|
1121 <span class="c"> * @param {EventFacade} evt The event facade for the attribute change</span> |
|
1122 <span class="c"> */</span> |
|
1123 <span class="nx">_afterFocusedChange</span><span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">evt</span><span class="o">)</span> <span class="o">{</span> |
|
1124 <span class="k">this</span><span class="o">.</span><span class="nx">_uiSetFocused</span><span class="o">(</span><span class="nx">evt</span><span class="o">.</span><span class="nx">newVal</span><span class="o">,</span> <span class="nx">evt</span><span class="o">.</span><span class="nx">src</span><span class="o">);</span> |
|
1125 <span class="o">},</span> |
|
1126 |
|
1127 <span class="c">/**</span> |
|
1128 <span class="c"> * @method _onDocMouseDown</span> |
|
1129 <span class="c"> * @description "mousedown" event handler for the owner document of the </span> |
|
1130 <span class="c"> * widget's bounding box.</span> |
|
1131 <span class="c"> * @protected</span> |
|
1132 <span class="c"> * @param {EventFacade} evt The event facade for the DOM focus event</span> |
|
1133 <span class="c"> */</span> |
|
1134 <span class="nx">_onDocMouseDown</span><span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">evt</span><span class="o">)</span> <span class="o">{</span> |
|
1135 |
|
1136 <span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">_hasDOMFocus</span><span class="o">)</span> <span class="o">{</span> |
|
1137 <span class="k">this</span><span class="o">.</span><span class="nx">_onFocus</span><span class="o">(</span><span class="nx">evt</span><span class="o">);</span> |
|
1138 <span class="o">}</span> |
|
1139 |
|
1140 <span class="o">},</span> |
|
1141 |
|
1142 <span class="c">/**</span> |
|
1143 <span class="c"> * DOM focus event handler, used to sync the state of the Widget with the DOM</span> |
|
1144 <span class="c"> * </span> |
|
1145 <span class="c"> * @method _onFocus</span> |
|
1146 <span class="c"> * @protected</span> |
|
1147 <span class="c"> * @param {EventFacade} evt The event facade for the DOM focus event</span> |
|
1148 <span class="c"> */</span> |
|
1149 <span class="nx">_onFocus</span><span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">evt</span><span class="o">)</span> <span class="o">{</span> |
|
1150 |
|
1151 <span class="k">var</span> <span class="nx">target</span> <span class="o">=</span> <span class="nx">evt</span><span class="o">.</span><span class="nx">target</span><span class="o">,</span> |
|
1152 <span class="nx">boundingBox</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">BOUNDING_BOX</span><span class="o">),</span> |
|
1153 <span class="nx">bFocused</span> <span class="o">=</span> <span class="o">(</span><span class="nx">boundingBox</span><span class="o">.</span><span class="nx">compareTo</span><span class="o">(</span><span class="nx">target</span><span class="o">)</span> <span class="o">||</span> <span class="nx">boundingBox</span><span class="o">.</span><span class="nx">contains</span><span class="o">(</span><span class="nx">target</span><span class="o">));</span> |
|
1154 |
|
1155 <span class="k">this</span><span class="o">.</span><span class="nx">_hasDOMFocus</span> <span class="o">=</span> <span class="nx">bFocused</span><span class="o">;</span> |
|
1156 <span class="k">this</span><span class="o">.</span><span class="nx">_set</span><span class="o">(</span><span class="nx">FOCUSED</span><span class="o">,</span> <span class="nx">bFocused</span><span class="o">,</span> <span class="o">{</span> <span class="nx">src</span><span class="o">:</span> <span class="nx">UI</span> <span class="o">});</span> |
|
1157 |
|
1158 <span class="o">},</span> |
|
1159 |
|
1160 <span class="c">/**</span> |
|
1161 <span class="c"> * Generic toString implementation for all widgets.</span> |
|
1162 <span class="c"> *</span> |
|
1163 <span class="c"> * @method toString</span> |
|
1164 <span class="c"> * @return {String} The default string value for the widget [ displays the NAME of the instance, and the unique id ]</span> |
|
1165 <span class="c"> */</span> |
|
1166 <span class="nx">toString</span><span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
1167 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">constructor</span><span class="o">.</span><span class="nx">NAME</span> <span class="o">+</span> <span class="s2">"["</span> <span class="o">+</span> <span class="k">this</span><span class="o">.</span><span class="nx">_yuid</span> <span class="o">+</span> <span class="s2">"]"</span><span class="o">;</span> |
|
1168 <span class="o">},</span> |
|
1169 |
|
1170 <span class="c">/**</span> |
|
1171 <span class="c"> * Default unit to use for dimension values</span> |
|
1172 <span class="c"> * </span> |
|
1173 <span class="c"> * @property DEF_UNIT</span> |
|
1174 <span class="c"> */</span> |
|
1175 <span class="nx">DEF_UNIT</span> <span class="o">:</span> <span class="s2">"px"</span><span class="o">,</span> |
|
1176 |
|
1177 <span class="c">/**</span> |
|
1178 <span class="c"> * Static property defining the markup template for content box.</span> |
|
1179 <span class="c"> *</span> |
|
1180 <span class="c"> * @property CONTENT_TEMPLATE</span> |
|
1181 <span class="c"> * @type String</span> |
|
1182 <span class="c"> */</span> |
|
1183 <span class="nx">CONTENT_TEMPLATE</span> <span class="o">:</span> <span class="s2">"<div></div>"</span><span class="o">,</span> |
|
1184 |
|
1185 <span class="c">/**</span> |
|
1186 <span class="c"> * Static property defining the markup template for bounding box.</span> |
|
1187 <span class="c"> *</span> |
|
1188 <span class="c"> * @property BOUNDING_TEMPLATE</span> |
|
1189 <span class="c"> * @type String</span> |
|
1190 <span class="c"> */</span> |
|
1191 <span class="nx">BOUNDING_TEMPLATE</span> <span class="o">:</span> <span class="s2">"<div></div>"</span><span class="o">,</span> |
|
1192 |
|
1193 <span class="c">/**</span> |
|
1194 <span class="c"> * Static property listing the styles that are mimiced on the bounding box from the content box.</span> |
|
1195 <span class="c"> *</span> |
|
1196 <span class="c"> * @property WRAP_STYLES</span> |
|
1197 <span class="c"> * @type Object</span> |
|
1198 <span class="c"> */</span> |
|
1199 <span class="nx">WRAP_STYLES</span> <span class="o">:</span> <span class="o">{</span> |
|
1200 <span class="nx">height</span><span class="o">:</span> <span class="s1">'100%'</span><span class="o">,</span> |
|
1201 <span class="nx">width</span><span class="o">:</span> <span class="s1">'100%'</span><span class="o">,</span> |
|
1202 <span class="nx">zIndex</span><span class="o">:</span> <span class="kc">false</span><span class="o">,</span> |
|
1203 <span class="nx">position</span><span class="o">:</span> <span class="s1">'static'</span><span class="o">,</span> |
|
1204 <span class="nx">top</span><span class="o">:</span> <span class="s1">'0'</span><span class="o">,</span> |
|
1205 <span class="nx">left</span><span class="o">:</span> <span class="s1">'0'</span><span class="o">,</span> |
|
1206 <span class="nx">bottom</span><span class="o">:</span> <span class="s1">''</span><span class="o">,</span> |
|
1207 <span class="nx">right</span><span class="o">:</span> <span class="s1">''</span><span class="o">,</span> |
|
1208 <span class="nx">padding</span><span class="o">:</span> <span class="s1">''</span><span class="o">,</span> |
|
1209 <span class="nx">margin</span><span class="o">:</span> <span class="s1">''</span> |
|
1210 <span class="o">},</span> |
|
1211 |
|
1212 <span class="c">/**</span> |
|
1213 <span class="c"> * Sets strings for a particular locale, merging with any existing</span> |
|
1214 <span class="c"> * strings which may already be defined for the locale.</span> |
|
1215 <span class="c"> *</span> |
|
1216 <span class="c"> * @method _setStrings</span> |
|
1217 <span class="c"> * @protected</span> |
|
1218 <span class="c"> * @param {Object} strings The hash of string key/values to set</span> |
|
1219 <span class="c"> * @param {Object} locale The locale for the string values being set</span> |
|
1220 <span class="c"> */</span> |
|
1221 <span class="nx">_setStrings</span> <span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">strings</span><span class="o">,</span> <span class="nx">locale</span><span class="o">)</span> <span class="o">{</span> |
|
1222 <span class="k">var</span> <span class="nx">strs</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_strings</span><span class="o">;</span> |
|
1223 <span class="nx">locale</span> <span class="o">=</span> <span class="nx">locale</span><span class="o">.</span><span class="nx">toLowerCase</span><span class="o">();</span> |
|
1224 |
|
1225 <span class="k">if</span> <span class="o">(!</span><span class="nx">strs</span><span class="o">[</span><span class="nx">locale</span><span class="o">])</span> <span class="o">{</span> |
|
1226 <span class="nx">strs</span><span class="o">[</span><span class="nx">locale</span><span class="o">]</span> <span class="o">=</span> <span class="o">{};</span> |
|
1227 <span class="o">}</span> |
|
1228 |
|
1229 <span class="nx">Y</span><span class="o">.</span><span class="nx">aggregate</span><span class="o">(</span><span class="nx">strs</span><span class="o">[</span><span class="nx">locale</span><span class="o">],</span> <span class="nx">strings</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span> |
|
1230 <span class="k">return</span> <span class="nx">strs</span><span class="o">[</span><span class="nx">locale</span><span class="o">];</span> |
|
1231 <span class="o">},</span> |
|
1232 |
|
1233 <span class="c">/**</span> |
|
1234 <span class="c"> * Returns the strings key/value hash for a paricular locale, without locale lookup applied.</span> |
|
1235 <span class="c"> *</span> |
|
1236 <span class="c"> * @method _getStrings</span> |
|
1237 <span class="c"> * @protected</span> |
|
1238 <span class="c"> * @param {Object} locale</span> |
|
1239 <span class="c"> */</span> |
|
1240 <span class="nx">_getStrings</span> <span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">locale</span><span class="o">)</span> <span class="o">{</span> |
|
1241 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_strings</span><span class="o">[</span><span class="nx">locale</span><span class="o">.</span><span class="nx">toLowerCase</span><span class="o">()];</span> |
|
1242 <span class="o">},</span> |
|
1243 |
|
1244 <span class="c">/**</span> |
|
1245 <span class="c"> * Gets the entire strings hash for a particular locale, performing locale lookup.</span> |
|
1246 <span class="c"> * <p></span> |
|
1247 <span class="c"> * If no values of the key are defined for a particular locale the value for the </span> |
|
1248 <span class="c"> * default locale (in initial locale set for the class) is returned.</span> |
|
1249 <span class="c"> * </p></span> |
|
1250 <span class="c"> * @method getStrings</span> |
|
1251 <span class="c"> * @param {String} locale (optional) The locale for which the string value is required. Defaults to the current locale, if not provided.</span> |
|
1252 <span class="c"> */</span> |
|
1253 <span class="c">// TODO: Optimize/Cache. Clear cache on _setStrings call.</span> |
|
1254 <span class="c"></span> <span class="nx">getStrings</span> <span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">locale</span><span class="o">)</span> <span class="o">{</span> |
|
1255 |
|
1256 <span class="nx">locale</span> <span class="o">=</span> <span class="o">(</span><span class="nx">locale</span> <span class="o">||</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">LOCALE</span><span class="o">)).</span><span class="nx">toLowerCase</span><span class="o">();</span> |
|
1257 |
|
1258 <span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s2">"getStrings: For "</span> <span class="o">+</span> <span class="nx">locale</span><span class="o">,</span> <span class="s2">"info"</span><span class="o">,</span> <span class="s2">"widget"</span><span class="o">);</span> |
|
1259 |
|
1260 <span class="k">var</span> <span class="nx">defLocale</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">getDefaultLocale</span><span class="o">().</span><span class="nx">toLowerCase</span><span class="o">(),</span> |
|
1261 <span class="nx">defStrs</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_getStrings</span><span class="o">(</span><span class="nx">defLocale</span><span class="o">),</span> |
|
1262 <span class="nx">strs</span> <span class="o">=</span> <span class="o">(</span><span class="nx">defStrs</span><span class="o">)</span> <span class="o">?</span> <span class="nx">Y</span><span class="o">.</span><span class="nx">merge</span><span class="o">(</span><span class="nx">defStrs</span><span class="o">)</span> <span class="o">:</span> <span class="o">{},</span> |
|
1263 <span class="nx">localeSegments</span> <span class="o">=</span> <span class="nx">locale</span><span class="o">.</span><span class="nx">split</span><span class="o">(</span><span class="nx">HYPHEN</span><span class="o">);</span> |
|
1264 |
|
1265 <span class="c">// If locale is different than the default, or needs lookup support</span> |
|
1266 <span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">locale</span> <span class="o">!==</span> <span class="nx">defLocale</span> <span class="o">||</span> <span class="nx">localeSegments</span><span class="o">.</span><span class="nx">length</span> <span class="o">></span> <span class="m">1</span><span class="o">)</span> <span class="o">{</span> |
|
1267 <span class="k">var</span> <span class="nx">lookup</span> <span class="o">=</span> <span class="s2">""</span><span class="o">;</span> |
|
1268 <span class="k">for</span> <span class="o">(</span><span class="k">var</span> <span class="nx">i</span> <span class="o">=</span> <span class="m">0</span><span class="o">,</span> <span class="nx">l</span> <span class="o">=</span> <span class="nx">localeSegments</span><span class="o">.</span><span class="nx">length</span><span class="o">;</span> <span class="nx">i</span> <span class="o"><</span> <span class="nx">l</span><span class="o">;</span> <span class="o">++</span><span class="nx">i</span><span class="o">)</span> <span class="o">{</span> |
|
1269 <span class="nx">lookup</span> <span class="o">+=</span> <span class="nx">localeSegments</span><span class="o">[</span><span class="nx">i</span><span class="o">];</span> |
|
1270 |
|
1271 <span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s2">"getStrings: Merging in strings from: "</span> <span class="o">+</span> <span class="nx">lookup</span><span class="o">,</span> <span class="s2">"info"</span><span class="o">,</span> <span class="s2">"widget"</span><span class="o">);</span> |
|
1272 |
|
1273 <span class="k">var</span> <span class="nx">localeStrs</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_getStrings</span><span class="o">(</span><span class="nx">lookup</span><span class="o">);</span> |
|
1274 <span class="k">if</span> <span class="o">(</span><span class="nx">localeStrs</span><span class="o">)</span> <span class="o">{</span> |
|
1275 <span class="nx">Y</span><span class="o">.</span><span class="nx">aggregate</span><span class="o">(</span><span class="nx">strs</span><span class="o">,</span> <span class="nx">localeStrs</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span> |
|
1276 <span class="o">}</span> |
|
1277 <span class="nx">lookup</span> <span class="o">+=</span> <span class="nx">HYPHEN</span><span class="o">;</span> |
|
1278 <span class="o">}</span> |
|
1279 <span class="o">}</span> |
|
1280 |
|
1281 <span class="k">return</span> <span class="nx">strs</span><span class="o">;</span> |
|
1282 <span class="o">},</span> |
|
1283 |
|
1284 <span class="c">/**</span> |
|
1285 <span class="c"> * Gets the string for a particular key, for a particular locale, performing locale lookup.</span> |
|
1286 <span class="c"> * <p></span> |
|
1287 <span class="c"> * If no values if defined for the key, for the given locale, the value for the </span> |
|
1288 <span class="c"> * default locale (in initial locale set for the class) is returned.</span> |
|
1289 <span class="c"> * </p></span> |
|
1290 <span class="c"> * @method getString</span> |
|
1291 <span class="c"> * @param {String} key The key.</span> |
|
1292 <span class="c"> * @param {String} locale (optional) The locale for which the string value is required. Defaults to the current locale, if not provided.</span> |
|
1293 <span class="c"> */</span> |
|
1294 <span class="nx">getString</span> <span class="o">:</span> <span class="k">function</span><span class="o">(</span><span class="nx">key</span><span class="o">,</span> <span class="nx">locale</span><span class="o">)</span> <span class="o">{</span> |
|
1295 |
|
1296 <span class="nx">locale</span> <span class="o">=</span> <span class="o">(</span><span class="nx">locale</span> <span class="o">||</span> <span class="k">this</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">LOCALE</span><span class="o">)).</span><span class="nx">toLowerCase</span><span class="o">();</span> |
|
1297 |
|
1298 <span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s2">"getString: For "</span> <span class="o">+</span> <span class="nx">locale</span><span class="o">,</span> <span class="s2">"info"</span><span class="o">,</span> <span class="s2">"widget"</span><span class="o">);</span> |
|
1299 |
|
1300 <span class="k">var</span> <span class="nx">defLocale</span> <span class="o">=</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">getDefaultLocale</span><span class="o">()).</span><span class="nx">toLowerCase</span><span class="o">(),</span> |
|
1301 <span class="nx">strs</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_getStrings</span><span class="o">(</span><span class="nx">defLocale</span><span class="o">)</span> <span class="o">||</span> <span class="o">{},</span> |
|
1302 <span class="nx">str</span> <span class="o">=</span> <span class="nx">strs</span><span class="o">[</span><span class="nx">key</span><span class="o">],</span> |
|
1303 <span class="nx">idx</span> <span class="o">=</span> <span class="nx">locale</span><span class="o">.</span><span class="nx">lastIndexOf</span><span class="o">(</span><span class="nx">HYPHEN</span><span class="o">);</span> |
|
1304 |
|
1305 <span class="c">// If locale is different than the default, or needs lookup support</span> |
|
1306 <span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">locale</span> <span class="o">!==</span> <span class="nx">defLocale</span> <span class="o">||</span> <span class="nx">idx</span> <span class="o">!=</span> <span class="o">-</span><span class="m">1</span><span class="o">)</span> <span class="o">{</span> |
|
1307 <span class="k">do</span> <span class="o">{</span> |
|
1308 <span class="nx">Y</span><span class="o">.</span><span class="nx">log</span><span class="o">(</span><span class="s2">"getString: Performing lookup for: "</span> <span class="o">+</span> <span class="nx">locale</span><span class="o">,</span> <span class="s2">"info"</span><span class="o">,</span> <span class="s2">"widget"</span><span class="o">);</span> |
|
1309 |
|
1310 <span class="nx">strs</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_getStrings</span><span class="o">(</span><span class="nx">locale</span><span class="o">);</span> |
|
1311 <span class="k">if</span> <span class="o">(</span><span class="nx">strs</span> <span class="o">&&</span> <span class="nx">key</span> <span class="k">in</span> <span class="nx">strs</span><span class="o">)</span> <span class="o">{</span> |
|
1312 <span class="nx">str</span> <span class="o">=</span> <span class="nx">strs</span><span class="o">[</span><span class="nx">key</span><span class="o">];</span> |
|
1313 <span class="k">break</span><span class="o">;</span> |
|
1314 <span class="o">}</span> |
|
1315 <span class="nx">idx</span> <span class="o">=</span> <span class="nx">locale</span><span class="o">.</span><span class="nx">lastIndexOf</span><span class="o">(</span><span class="nx">HYPHEN</span><span class="o">);</span> |
|
1316 <span class="c">// Chop of last locale segment</span> |
|
1317 <span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">idx</span> <span class="o">!=</span> <span class="o">-</span><span class="m">1</span><span class="o">)</span> <span class="o">{</span> |
|
1318 <span class="nx">locale</span> <span class="o">=</span> <span class="nx">locale</span><span class="o">.</span><span class="nx">substring</span><span class="o">(</span><span class="m">0</span><span class="o">,</span> <span class="nx">idx</span><span class="o">);</span> |
|
1319 <span class="o">}</span> |
|
1320 |
|
1321 <span class="o">}</span> <span class="k">while</span> <span class="o">(</span><span class="nx">idx</span> <span class="o">!=</span> <span class="o">-</span><span class="m">1</span><span class="o">);</span> |
|
1322 <span class="o">}</span> |
|
1323 |
|
1324 <span class="k">return</span> <span class="nx">str</span><span class="o">;</span> |
|
1325 <span class="o">},</span> |
|
1326 |
|
1327 <span class="c">/**</span> |
|
1328 <span class="c"> * Returns the default locale for the widget (the locale value defined by the</span> |
|
1329 <span class="c"> * widget class, or provided by the user during construction).</span> |
|
1330 <span class="c"> *</span> |
|
1331 <span class="c"> * @method getDefaultLocale</span> |
|
1332 <span class="c"> * @return {String} The default locale for the widget</span> |
|
1333 <span class="c"> */</span> |
|
1334 <span class="nx">getDefaultLocale</span> <span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
1335 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_conf</span><span class="o">.</span><span class="nx">get</span><span class="o">(</span><span class="nx">LOCALE</span><span class="o">,</span> <span class="nx">INIT_VALUE</span><span class="o">);</span> |
|
1336 <span class="o">},</span> |
|
1337 |
|
1338 <span class="c">/**</span> |
|
1339 <span class="c"> * Private stings hash, used to store strings in locale specific buckets.</span> |
|
1340 <span class="c"> *</span> |
|
1341 <span class="c"> * @property _strings</span> |
|
1342 <span class="c"> * @private</span> |
|
1343 <span class="c"> * @type Object</span> |
|
1344 <span class="c"> */</span> |
|
1345 <span class="nx">_strings</span><span class="o">:</span> <span class="kc">null</span><span class="o">,</span> |
|
1346 |
|
1347 <span class="c">/**</span> |
|
1348 <span class="c"> * Gets the HTML_PARSER definition for this instance, by merging HTML_PARSER</span> |
|
1349 <span class="c"> * definitions across the class hierarchy.</span> |
|
1350 <span class="c"> *</span> |
|
1351 <span class="c"> * @method _getHtmlParser</span> |
|
1352 <span class="c"> * @return {Object} HTML_PARSER definition for this instance</span> |
|
1353 <span class="c"> */</span> |
|
1354 <span class="nx">_getHtmlParser</span> <span class="o">:</span> <span class="k">function</span><span class="o">()</span> <span class="o">{</span> |
|
1355 <span class="k">if</span> <span class="o">(!</span><span class="k">this</span><span class="o">.</span><span class="nx">_HTML_PARSER</span><span class="o">)</span> <span class="o">{</span> |
|
1356 <span class="k">var</span> <span class="nx">classes</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_getClasses</span><span class="o">(),</span> |
|
1357 <span class="nx">parser</span> <span class="o">=</span> <span class="o">{},</span> |
|
1358 <span class="nx">i</span><span class="o">,</span> <span class="nx">p</span><span class="o">;</span> |
|
1359 |
|
1360 <span class="k">for</span> <span class="o">(</span><span class="nx">i</span> <span class="o">=</span> <span class="nx">classes</span><span class="o">.</span><span class="nx">length</span> <span class="o">-</span> <span class="m">1</span><span class="o">;</span> <span class="nx">i</span> <span class="o">>=</span> <span class="m">0</span><span class="o">;</span> <span class="nx">i</span><span class="o">--)</span> <span class="o">{</span> |
|
1361 <span class="nx">p</span> <span class="o">=</span> <span class="nx">classes</span><span class="o">[</span><span class="nx">i</span><span class="o">].</span><span class="nx">HTML_PARSER</span><span class="o">;</span> |
|
1362 <span class="k">if</span> <span class="o">(</span><span class="nx">p</span><span class="o">)</span> <span class="o">{</span> |
|
1363 <span class="nx">Y</span><span class="o">.</span><span class="nx">mix</span><span class="o">(</span><span class="nx">parser</span><span class="o">,</span> <span class="nx">p</span><span class="o">,</span> <span class="kc">true</span><span class="o">);</span> |
|
1364 <span class="o">}</span> |
|
1365 <span class="o">}</span> |
|
1366 |
|
1367 <span class="k">this</span><span class="o">.</span><span class="nx">_HTML_PARSER</span> <span class="o">=</span> <span class="nx">parser</span><span class="o">;</span> |
|
1368 <span class="o">}</span> |
|
1369 |
|
1370 <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_HTML_PARSER</span><span class="o">;</span> |
|
1371 <span class="o">}</span> |
|
1372 <span class="o">});</span> |
|
1373 |
|
1374 <span class="nx">Y</span><span class="o">.</span><span class="nx">Widget</span> <span class="o">=</span> <span class="nx">Widget</span><span class="o">;</span> |
|
1375 </pre></div> |
|
1376 </div> |
|
1377 </div> |
|
1378 </div> |
|
1379 <div class="yui-b"> |
|
1380 <div class="nav"> |
|
1381 |
|
1382 <div id="moduleList" class="module"> |
|
1383 <h4>Modules</h4> |
|
1384 <ul class="content"> |
|
1385 <li class=""><a href="module_anim.html" title="anim">anim</a></li> |
|
1386 <li class=""><a href="module_attribute.html" title="attribute">attribute</a></li> |
|
1387 <li class=""><a href="module_base.html" title="base">base</a></li> |
|
1388 <li class=""><a href="module_cache.html" title="cache">cache</a></li> |
|
1389 <li class=""><a href="module_classnamemanager.html" title="classnamemanager">classnamemanager</a></li> |
|
1390 <li class=""><a href="module_collection.html" title="collection">collection</a></li> |
|
1391 <li class=""><a href="module_console.html" title="console">console</a></li> |
|
1392 <li class=""><a href="module_console-filters.html" title="console-filters">console-filters</a></li> |
|
1393 <li class=""><a href="module_cookie.html" title="cookie">cookie</a></li> |
|
1394 <li class=""><a href="module_dataschema.html" title="dataschema">dataschema</a></li> |
|
1395 <li class=""><a href="module_datasource.html" title="datasource">datasource</a></li> |
|
1396 <li class=""><a href="module_datatype.html" title="datatype">datatype</a></li> |
|
1397 <li class=""><a href="module_dd.html" title="dd">dd</a></li> |
|
1398 <li class=""><a href="module_dom.html" title="dom">dom</a></li> |
|
1399 <li class=""><a href="module_dump.html" title="dump">dump</a></li> |
|
1400 <li class=""><a href="module_event.html" title="event">event</a></li> |
|
1401 <li class=""><a href="module_event-custom.html" title="event-custom">event-custom</a></li> |
|
1402 <li class=""><a href="module_event-simulate.html" title="event-simulate">event-simulate</a></li> |
|
1403 <li class=""><a href="module_history.html" title="history">history</a></li> |
|
1404 <li class=""><a href="module_imageloader.html" title="imageloader">imageloader</a></li> |
|
1405 <li class=""><a href="module_io.html" title="io">io</a></li> |
|
1406 <li class=""><a href="module_json.html" title="json">json</a></li> |
|
1407 <li class=""><a href="module_node.html" title="node">node</a></li> |
|
1408 <li class=""><a href="module_node-focusmanager.html" title="node-focusmanager">node-focusmanager</a></li> |
|
1409 <li class=""><a href="module_node-menunav.html" title="node-menunav">node-menunav</a></li> |
|
1410 <li class=""><a href="module_oop.html" title="oop">oop</a></li> |
|
1411 <li class=""><a href="module_overlay.html" title="overlay">overlay</a></li> |
|
1412 <li class=""><a href="module_plugin.html" title="plugin">plugin</a></li> |
|
1413 <li class=""><a href="module_profiler.html" title="profiler">profiler</a></li> |
|
1414 <li class=""><a href="module_queue.html" title="queue">queue</a></li> |
|
1415 <li class=""><a href="module_slider.html" title="slider">slider</a></li> |
|
1416 <li class=""><a href="module_stylesheet.html" title="stylesheet">stylesheet</a></li> |
|
1417 <li class=""><a href="module_substitute.html" title="substitute">substitute</a></li> |
|
1418 <li class=""><a href="module_test.html" title="test">test</a></li> |
|
1419 <li class="selected"><a href="module_widget.html" title="widget">widget</a></li> |
|
1420 <li class=""><a href="module_widget-position.html" title="widget-position">widget-position</a></li> |
|
1421 <li class=""><a href="module_widget-position-ext.html" title="widget-position-ext">widget-position-ext</a></li> |
|
1422 <li class=""><a href="module_widget-stack.html" title="widget-stack">widget-stack</a></li> |
|
1423 <li class=""><a href="module_widget-stdmod.html" title="widget-stdmod">widget-stdmod</a></li> |
|
1424 <li class=""><a href="module_yui.html" title="yui">yui</a></li> |
|
1425 </ul> |
|
1426 </div> |
|
1427 |
|
1428 <div id="classList" class="module"> |
|
1429 <h4>Classes</h4> |
|
1430 <ul class="content"> |
|
1431 <li class=""><a href="Widget.html" title="Widget">Widget</a></li> |
|
1432 </ul> |
|
1433 </div> |
|
1434 |
|
1435 <div id="fileList" class="module"> |
|
1436 <h4>Files</h4> |
|
1437 <ul class="content"> |
|
1438 <li class="selected"><a href="Widget.js.html" title="Widget.js">Widget.js</a></li> |
|
1439 </ul> |
|
1440 </div> |
|
1441 |
|
1442 |
|
1443 |
|
1444 |
|
1445 |
|
1446 </div> |
|
1447 </div> |
|
1448 </div> |
|
1449 <div id="ft"> |
|
1450 <hr /> |
|
1451 Copyright © 2009 Yahoo! Inc. All rights reserved. |
|
1452 </div> |
|
1453 </div> |
|
1454 <script type="text/javascript"> |
|
1455 ALL_YUI_PROPS = [{"access": "protected", "host": "Widget", "name": "_afterDisabledChange", "url": "Widget.html#method__afterDisabledChange", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_afterFocusedChange", "url": "Widget.html#method__afterFocusedChange", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_afterHeightChange", "url": "Widget.html#method__afterHeightChange", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_afterVisibleChange", "url": "Widget.html#method__afterVisibleChange", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_afterWidthChange", "url": "Widget.html#method__afterWidthChange", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_bindDOMListeners", "url": "Widget.html#method__bindDOMListeners", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_bindUI", "url": "Widget.html#method__bindUI", "type": "method"}, {"access": "protected", "host": "Widget", "name": "bindUI", "url": "Widget.html#method_bindUI", "type": "method"}, {"access": "", "host": "Widget", "name": "blur", "url": "Widget.html#method_blur", "type": "method"}, {"access": "", "host": "Widget", "name": "boundingBox", "url": "Widget.html#config_boundingBox", "type": "config"}, {"access": "", "host": "Widget", "name": "boundingBoxChange", "url": "Widget.html#event_boundingBoxChange", "type": "event"}, {"access": "", "host": "Widget", "name": "BOUNDING_TEMPLATE", "url": "Widget.html#property_BOUNDING_TEMPLATE", "type": "property"}, {"access": "private", "host": "Widget", "name": "_buildCfg", "url": "Widget.html#property__buildCfg", "type": "property"}, {"access": "", "host": "Widget", "name": "contentBox", "url": "Widget.html#config_contentBox", "type": "config"}, {"access": "", "host": "Widget", "name": "contentBoxChange", "url": "Widget.html#event_contentBoxChange", "type": "event"}, {"access": "", "host": "Widget", "name": "CONTENT_TEMPLATE", "url": "Widget.html#property_CONTENT_TEMPLATE", "type": "property"}, {"access": "protected", "host": "Widget", "name": "_defRenderFn", "url": "Widget.html#method__defRenderFn", "type": "method"}, {"access": "", "host": "Widget", "name": "DEF_UNIT", "url": "Widget.html#property_DEF_UNIT", "type": "property"}, {"access": "protected", "host": "Widget", "name": "destructor", "url": "Widget.html#method_destructor", "type": "method"}, {"access": "", "host": "Widget", "name": "disabled", "url": "Widget.html#method_disabled", "type": "method"}, {"access": "", "host": "Widget", "name": "disabled", "url": "Widget.html#config_disabled", "type": "config"}, {"access": "", "host": "Widget", "name": "disabledChange", "url": "Widget.html#event_disabledChange", "type": "event"}, {"access": "", "host": "Widget", "name": "enable", "url": "Widget.html#method_enable", "type": "method"}, {"access": "", "host": "Widget", "name": "focus", "url": "Widget.html#method_focus", "type": "method"}, {"access": "", "host": "Widget", "name": "focused", "url": "Widget.html#config_focused", "type": "config"}, {"access": "", "host": "Widget", "name": "focusedChange", "url": "Widget.html#event_focusedChange", "type": "event"}, {"access": "", "host": "Widget", "name": "getClassName", "url": "Widget.html#method_getClassName", "type": "method"}, {"access": "", "host": "Widget", "name": "getDefaultLocale", "url": "Widget.html#method_getDefaultLocale", "type": "method"}, {"access": "", "host": "Widget", "name": "_getHtmlParser", "url": "Widget.html#method__getHtmlParser", "type": "method"}, {"access": "", "host": "Widget", "name": "getString", "url": "Widget.html#method_getString", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_getStrings", "url": "Widget.html#method__getStrings", "type": "method"}, {"access": "", "host": "Widget", "name": "getStrings", "url": "Widget.html#method_getStrings", "type": "method"}, {"access": "", "host": "Widget", "name": "height", "url": "Widget.html#config_height", "type": "config"}, {"access": "", "host": "Widget", "name": "heightChange", "url": "Widget.html#event_heightChange", "type": "event"}, {"access": "", "host": "Widget", "name": "hide", "url": "Widget.html#method_hide", "type": "method"}, {"access": "protected", "host": "Widget", "name": "initializer", "url": "Widget.html#method_initializer", "type": "method"}, {"access": "", "host": "Widget", "name": "locale", "url": "Widget.html#config_locale", "type": "config"}, {"access": "", "host": "Widget", "name": "localeChange", "url": "Widget.html#event_localeChange", "type": "event"}, {"access": "private", "host": "Widget", "name": "_moveStyles", "url": "Widget.html#method__moveStyles", "type": "method"}, {"access": "", "host": "Widget", "name": "moveStyles", "url": "Widget.html#config_moveStyles", "type": "config"}, {"access": "", "host": "Widget", "name": "moveStylesChange", "url": "Widget.html#event_moveStylesChange", "type": "event"}, {"access": "protected", "host": "Widget", "name": "_onDocMouseDown", "url": "Widget.html#method__onDocMouseDown", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_onFocus", "url": "Widget.html#method__onFocus", "type": "method"}, {"access": "private", "host": "Widget", "name": "_parseHTML", "url": "Widget.html#method__parseHTML", "type": "method"}, {"access": "", "host": "Widget", "name": "render", "url": "Widget.html#method_render", "type": "method"}, {"access": "private", "host": "Widget", "name": "_renderBox", "url": "Widget.html#method__renderBox", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_renderBoxClassNames", "url": "Widget.html#method__renderBoxClassNames", "type": "method"}, {"access": "", "host": "Widget", "name": "rendered", "url": "Widget.html#config_rendered", "type": "config"}, {"access": "", "host": "Widget", "name": "renderedChange", "url": "Widget.html#event_renderedChange", "type": "event"}, {"access": "protected", "host": "Widget", "name": "renderer", "url": "Widget.html#method_renderer", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_renderUI", "url": "Widget.html#method__renderUI", "type": "method"}, {"access": "protected", "host": "Widget", "name": "renderUI", "url": "Widget.html#method_renderUI", "type": "method"}, {"access": "private", "host": "Widget", "name": "_setBoundingBox", "url": "Widget.html#method__setBoundingBox", "type": "method"}, {"access": "private", "host": "Widget", "name": "_setBox", "url": "Widget.html#method__setBox", "type": "method"}, {"access": "private", "host": "Widget", "name": "_setContentBox", "url": "Widget.html#method__setContentBox", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_setStrings", "url": "Widget.html#method__setStrings", "type": "method"}, {"access": "", "host": "Widget", "name": "show", "url": "Widget.html#method_show", "type": "method"}, {"access": "private", "host": "Widget", "name": "_strings", "url": "Widget.html#property__strings", "type": "property"}, {"access": "", "host": "Widget", "name": "strings", "url": "Widget.html#config_strings", "type": "config"}, {"access": "", "host": "Widget", "name": "stringsChange", "url": "Widget.html#event_stringsChange", "type": "event"}, {"access": "protected", "host": "Widget", "name": "_syncUI", "url": "Widget.html#method__syncUI", "type": "method"}, {"access": "", "host": "Widget", "name": "syncUI", "url": "Widget.html#method_syncUI", "type": "method"}, {"access": "", "host": "Widget", "name": "tabIndex", "url": "Widget.html#config_tabIndex", "type": "config"}, {"access": "", "host": "Widget", "name": "tabIndexChange", "url": "Widget.html#event_tabIndexChange", "type": "event"}, {"access": "", "host": "Widget", "name": "toString", "url": "Widget.html#method_toString", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_uiSetDisabled", "url": "Widget.html#method__uiSetDisabled", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_uiSetFocused", "url": "Widget.html#method__uiSetFocused", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_uiSetHeight", "url": "Widget.html#method__uiSetHeight", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_uiSetTabIndex", "url": "Widget.html#method__uiSetTabIndex", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_uiSetVisible", "url": "Widget.html#method__uiSetVisible", "type": "method"}, {"access": "protected", "host": "Widget", "name": "_uiSetWidth", "url": "Widget.html#method__uiSetWidth", "type": "method"}, {"access": "", "host": "Widget", "name": "visible", "url": "Widget.html#config_visible", "type": "config"}, {"access": "", "host": "Widget", "name": "visibleChange", "url": "Widget.html#event_visibleChange", "type": "event"}, {"access": "", "host": "Widget", "name": "widget:contentUpdate", "url": "Widget.html#event_widget:contentUpdate", "type": "event"}, {"access": "", "host": "Widget", "name": "widget:render", "url": "Widget.html#event_widget:render", "type": "event"}, {"access": "", "host": "Widget", "name": "Widget.ATTRS", "url": "Widget.html#property_Widget.ATTRS", "type": "property"}, {"access": "", "host": "Widget", "name": "Widget.getByNode", "url": "Widget.html#method_Widget.getByNode", "type": "method"}, {"access": "", "host": "Widget", "name": "Widget.HTML_PARSER", "url": "Widget.html#property_Widget.HTML_PARSER", "type": "property"}, {"access": "", "host": "Widget", "name": "Widget.NAME", "url": "Widget.html#property_Widget.NAME", "type": "property"}, {"access": "private", "host": "Widget", "name": "Widget._NAME_LOWERCASE", "url": "Widget.html#property_Widget._NAME_LOWERCASE", "type": "property"}, {"access": "", "host": "Widget", "name": "Widget.UI_SRC", "url": "Widget.html#property_Widget.UI_SRC", "type": "property"}, {"access": "", "host": "Widget", "name": "width", "url": "Widget.html#config_width", "type": "config"}, {"access": "", "host": "Widget", "name": "widthChange", "url": "Widget.html#event_widthChange", "type": "event"}, {"access": "", "host": "Widget", "name": "WRAP_STYLES", "url": "Widget.html#property_WRAP_STYLES", "type": "property"}]; |
|
1456 </script> |
|
1457 </body> |
|
1458 </html> |