##// END OF EJS Templates
Fixed typo in widget model code causing notebook to not load
Jonathan Frederic -
Show More
@@ -1,587 +1,587 b''
1 1 //----------------------------------------------------------------------------
2 2 // Copyright (C) 2013 The IPython Development Team
3 3 //
4 4 // Distributed under the terms of the BSD License. The full license is in
5 5 // the file COPYING, distributed as part of this software.
6 6 //----------------------------------------------------------------------------
7 7
8 8 //============================================================================
9 9 // WidgetModel, WidgetView, and WidgetManager
10 10 //============================================================================
11 11 /**
12 12 * Base Widget classes
13 13 * @module IPython
14 14 * @namespace IPython
15 15 * @submodule widget
16 16 */
17 17
18 18 "use strict";
19 19
20 20 // Use require.js 'define' method so that require.js is intelligent enough to
21 21 // syncronously load everything within this file when it is being 'required'
22 22 // elsewhere.
23 23 define(["components/underscore/underscore-min",
24 24 "components/backbone/backbone-min",
25 25 ], function(underscore, backbone){
26 26
27 27
28 28 //--------------------------------------------------------------------
29 29 // WidgetModel class
30 30 //--------------------------------------------------------------------
31 31 var WidgetModel = Backbone.Model.extend({
32 32 constructor: function(comm_manager, comm, widget_manager) {
33 33 this.comm_manager = comm_manager;
34 34 this.widget_manager = widget_manager;
35 35 this.pending_msgs = 0;
36 36 this.msg_throttle = 3;
37 37 this.msg_buffer = null;
38 38 this.views = {};
39 39
40 40 // Remember comm associated with the model.
41 41 this.comm = comm;
42 42 comm.model = this;
43 43
44 44 // Hook comm messages up to model.
45 45 comm.on_close($.proxy(this._handle_comm_closed, this));
46 46 comm.on_msg($.proxy(this._handle_comm_msg, this));
47 47
48 48 return Backbone.Model.apply(this);
49 49 },
50 50
51 51
52 52 update_other_views: function(caller) {
53 53 this.last_modified_view = caller;
54 54 this.save(this.changedAttributes(), {patch: true});
55 55
56 56 for (var cell in this.views) {
57 57 var views = this.views[cell];
58 58 for (var view_index in views) {
59 59 var view = views[view_index];
60 60 if (view !== caller) {
61 61 view.update();
62 62 }
63 63 }
64 64 }
65 65 },
66 66
67 send = function (content) {
67 send: function(content) {
68 68
69 69 // Used the last modified view as the sender of the message. This
70 70 // will insure that any python code triggered by the sent message
71 71 // can create and display widgets and output.
72 72 var cell = null;
73 73 if (this.last_modified_view != undefined &&
74 74 this.last_modified_view.cell != undefined) {
75 75 cell = this.last_modified_view.cell;
76 76 }
77 77 var callbacks = this._make_callbacks(cell);
78 78 var data = {custom_content: content};
79 79 this.comm.send(data, callbacks);
80 80 },
81 81
82 82
83 83 on_view_displayed: function (callback) {
84 84 this._view_displayed_callback = callback;
85 85 },
86 86
87 87
88 88 on_close: function (callback) {
89 89 this._close_callback = callback;
90 90 },
91 91
92 92
93 93 on_msg: function (callback) {
94 94 this._msg_callback = callback;
95 95 },
96 96
97 97
98 98 _handle_custom_msg: function (content) {
99 99 if (this._msg_callback) {
100 100 try {
101 101 this._msg_callback(content);
102 102 } catch (e) {
103 103 console.log("Exception in widget model msg callback", e, content);
104 104 }
105 105 }
106 106 },
107 107
108 108
109 109 // Handle when a widget is closed.
110 110 _handle_comm_closed: function (msg) {
111 111 for (var cell in this.views) {
112 112 var views = this.views[cell];
113 113 for (var view_index in views) {
114 114 var view = views[view_index];
115 115 view.remove();
116 116 }
117 117 }
118 118 delete this.comm.model; // Delete ref so GC will collect widget model.
119 119 },
120 120
121 121
122 122 // Handle incomming comm msg.
123 123 _handle_comm_msg: function (msg) {
124 124 var method = msg.content.data.method;
125 125 switch (method){
126 126 case 'display':
127 127
128 128 // Try to get the cell.
129 129 var cell = this._get_msg_cell(msg.parent_header.msg_id);
130 130 if (cell == null) {
131 131 console.log("Could not determine where the display" +
132 132 " message was from. Widget will not be displayed")
133 133 } else {
134 134 this._display_view(msg.content.data.view_name,
135 135 msg.content.data.parent,
136 136 cell);
137 137 }
138 138 break;
139 139 case 'update':
140 140 this._handle_update(msg.content.data.state);
141 141 break;
142 142 case 'custom':
143 143 this._handle_custom_msg(msg.content.data.custom_content);
144 144 break;
145 145 }
146 146 },
147 147
148 148
149 149 // Handle when a widget is updated via the python side.
150 150 _handle_update: function (state) {
151 151 this.updating = true;
152 152 try {
153 153 for (var key in state) {
154 154 if (state.hasOwnProperty(key)) {
155 155 if (key == "_css"){
156 156
157 157 // Set the css value of the model as an attribute
158 158 // instead of a backbone trait because we are only
159 159 // interested in backend css -> frontend css. In
160 160 // other words, if the css dict changes in the
161 161 // frontend, we don't need to push the changes to
162 162 // the backend.
163 163 this.css = state[key];
164 164 } else {
165 165 this.set(key, state[key]);
166 166 }
167 167 }
168 168 }
169 169 this.id = this.comm.comm_id;
170 170 this.save();
171 171 } finally {
172 172 this.updating = false;
173 173 }
174 174 },
175 175
176 176
177 177 _handle_status: function (cell, msg) {
178 178 //execution_state : ('busy', 'idle', 'starting')
179 179 if (msg.content.execution_state=='idle') {
180 180
181 181 // Send buffer if this message caused another message to be
182 182 // throttled.
183 183 if (this.msg_buffer != null &&
184 184 this.msg_throttle == this.pending_msgs) {
185 185
186 186 var cell = this._get_msg_cell(msg.parent_header.msg_id);
187 187 var callbacks = this._make_callbacks(cell);
188 188 var data = {sync_method: 'update', sync_data: this.msg_buffer};
189 189 this.comm.send(data, callbacks);
190 190 this.msg_buffer = null;
191 191 } else {
192 192
193 193 // Only decrease the pending message count if the buffer
194 194 // doesn't get flushed (sent).
195 195 --this.pending_msgs;
196 196 }
197 197 }
198 198 },
199 199
200 200
201 201 // Custom syncronization logic.
202 202 _handle_sync: function (method, options) {
203 203 var model_json = this.toJSON();
204 204
205 205 // Only send updated state if the state hasn't been changed
206 206 // during an update.
207 207 if (!this.updating) {
208 208 if (this.pending_msgs >= this.msg_throttle) {
209 209 // The throttle has been exceeded, buffer the current msg so
210 210 // it can be sent once the kernel has finished processing
211 211 // some of the existing messages.
212 212 if (method=='patch') {
213 213 if (this.msg_buffer == null) {
214 214 this.msg_buffer = $.extend({}, model_json); // Copy
215 215 }
216 216 for (var attr in options.attrs) {
217 217 this.msg_buffer[attr] = options.attrs[attr];
218 218 }
219 219 } else {
220 220 this.msg_buffer = $.extend({}, model_json); // Copy
221 221 }
222 222
223 223 } else {
224 224 // We haven't exceeded the throttle, send the message like
225 225 // normal. If this is a patch operation, just send the
226 226 // changes.
227 227 var send_json = model_json;
228 228 if (method=='patch') {
229 229 send_json = {};
230 230 for (var attr in options.attrs) {
231 231 send_json[attr] = options.attrs[attr];
232 232 }
233 233 }
234 234
235 235 var data = {sync_method: method, sync_data: send_json};
236 236
237 237 var cell = null;
238 238 if (this.last_modified_view != undefined && this.last_modified_view != null) {
239 239 cell = this.last_modified_view.cell;
240 240 }
241 241
242 242 var callbacks = this._make_callbacks(cell);
243 243 this.comm.send(data, callbacks);
244 244 this.pending_msgs++;
245 245 }
246 246 }
247 247
248 248 // Since the comm is a one-way communication, assume the message
249 249 // arrived.
250 250 return model_json;
251 251 },
252 252
253 253
254 254 _handle_view_displayed: function(view) {
255 255 if (this._view_displayed_callback) {
256 256 try {
257 257 this._view_displayed_callback(view)
258 258 } catch (e) {
259 259 console.log("Exception in widget model view displayed callback", e, view, this);
260 260 }
261 261 }
262 262 },
263 263
264 264
265 265 // Create view that represents the model.
266 266 _display_view: function (view_name, parent_comm_id, cell) {
267 267 var new_views = [];
268 268
269 269 // Try creating and adding the view to it's parent.
270 270 var displayed = false;
271 271 if (parent_comm_id != undefined) {
272 272 var parent_comm = this.comm_manager.comms[parent_comm_id];
273 273 var parent_model = parent_comm.model;
274 274 var parent_views = parent_model.views[cell];
275 275 for (var parent_view_index in parent_views) {
276 276 var parent_view = parent_views[parent_view_index];
277 277 if (parent_view.display_child != undefined) {
278 278 var view = this._create_view(view_name, cell);
279 279 if (view != null) {
280 280 new_views.push(view);
281 281 parent_view.display_child(view);
282 282 displayed = true;
283 283 this._handle_view_displayed(view);
284 284 }
285 285 }
286 286 }
287 287 }
288 288
289 289 // If no parent view is defined or exists. Add the view's
290 290 // element to cell's widget div.
291 291 if (!displayed) {
292 292 var view = this._create_view(view_name, cell);
293 293 if (view != null) {
294 294 new_views.push(view);
295 295
296 296 if (cell.widget_subarea != undefined && cell.widget_subarea != null) {
297 297 cell.widget_area.show();
298 298 cell.widget_subarea.append(view.$el);
299 299 this._handle_view_displayed(view);
300 300 }
301 301 }
302 302 }
303 303
304 304 // Force the new view(s) to update their selves
305 305 for (var view_index in new_views) {
306 306 var view = new_views[view_index];
307 307 view.update();
308 308 }
309 309 },
310 310
311 311
312 312 // Create a view
313 313 _create_view: function (view_name, cell) {
314 314 var view_type = this.widget_manager.widget_view_types[view_name];
315 315 if (view_type != undefined && view_type != null) {
316 316 var view = new view_type({model: this});
317 317 view.render();
318 318 if (this.views[cell]==undefined) {
319 319 this.views[cell] = []
320 320 }
321 321 this.views[cell].push(view);
322 322 view.cell = cell;
323 323
324 324 // Handle when the view element is remove from the page.
325 325 var that = this;
326 326 view.$el.on("remove", function(){
327 327 var index = that.views[cell].indexOf(view);
328 328 if (index > -1) {
329 329 that.views[cell].splice(index, 1);
330 330 }
331 331 view.remove(); // Clean-up view
332 332 if (that.views[cell].length()==0) {
333 333 delete that.views[cell];
334 334 }
335 335
336 336 // Close the comm if there are no views left.
337 337 if (that.views.length()==0) {
338 338 if (that._close_callback) {
339 339 try {
340 340 that._close_callback(that)
341 341 } catch (e) {
342 342 console.log("Exception in widget model close callback", e, that);
343 343 }
344 344 }
345 345 that.comm.close();
346 346 delete that.comm.model; // Delete ref so GC will collect widget model.
347 347 }
348 348 });
349 349 return view;
350 350 }
351 351 return null;
352 352 },
353 353
354 354
355 355 // Build a callback dict.
356 356 _make_callbacks: function (cell) {
357 357 var callbacks = {};
358 358 if (cell != null && cell.output_area != undefined && cell.output_area != null) {
359 359 var that = this;
360 360 callbacks = {
361 361 iopub : {
362 362 output : $.proxy(cell.output_area.handle_output, cell.output_area),
363 363 clear_output : $.proxy(cell.output_area.handle_clear_output, cell.output_area),
364 364 status : function(msg){
365 365 that._handle_status(cell, msg);
366 366 },
367 367
368 368 // Special function only registered by widget messages.
369 369 // Allows us to get the cell for a message so we know
370 370 // where to add widgets if the code requires it.
371 371 get_cell : function() {
372 372 if (that.last_modified_view != undefined &&
373 373 that.last_modified_view.cell != undefined) {
374 374 return that.last_modified_view.cell;
375 375 } else {
376 376 return null
377 377 }
378 378 },
379 379 },
380 380 };
381 381 }
382 382 return callbacks;
383 383 },
384 384
385 385
386 386 // Get the output area corresponding to the msg_id.
387 387 // cell is an instance of IPython.Cell
388 388 _get_msg_cell: function (msg_id) {
389 389
390 390 // First, check to see if the msg was triggered by cell execution.
391 391 var cell = this.widget_manager.get_msg_cell(msg_id);
392 392 if (cell != null) {
393 393 return cell;
394 394 }
395 395
396 396 // Second, check to see if a get_cell callback was defined
397 397 // for the message. get_cell callbacks are registered for
398 398 // widget messages, so this block is actually checking to see if the
399 399 // message was triggered by a widget.
400 400 var kernel = this.comm_manager.kernel;
401 401 var callbacks = kernel.get_callbacks_for_msg(msg_id);
402 402 if (callbacks != undefined &&
403 403 callbacks.iopub != undefined &&
404 404 callbacks.iopub.get_cell != undefined) {
405 405
406 406 return callbacks.iopub.get_cell();
407 407 }
408 408
409 409 // Not triggered by a cell or widget (no get_cell callback
410 410 // exists).
411 411 return null;
412 412 },
413 413
414 414 });
415 415
416 416
417 417 //--------------------------------------------------------------------
418 418 // WidgetView class
419 419 //--------------------------------------------------------------------
420 420 var WidgetView = Backbone.View.extend({
421 421
422 422 initialize: function() {
423 423 this.visible = true;
424 424 this.model.on('change',this.update,this);
425 425 this._add_class_calls = this.model.get('_add_class')[0];
426 426 this._remove_class_calls = this.model.get('_remove_class')[0];
427 427 },
428 428
429 429 update: function() {
430 430 if (this.model.get('visible') != undefined) {
431 431 if (this.visible != this.model.get('visible')) {
432 432 this.visible = this.model.get('visible');
433 433 if (this.visible) {
434 434 this.$el.show();
435 435 } else {
436 436 this.$el.hide();
437 437 }
438 438 }
439 439 }
440 440
441 441 if (this.model.css != undefined) {
442 442 for (var selector in this.model.css) {
443 443 if (this.model.css.hasOwnProperty(selector)) {
444 444
445 445 // Apply the css traits to all elements that match the selector.
446 446 var elements = this._get_selector_element(selector);
447 447 if (elements.length > 0) {
448 448 var css_traits = this.model.css[selector];
449 449 for (var css_key in css_traits) {
450 450 if (css_traits.hasOwnProperty(css_key)) {
451 451 elements.css(css_key, css_traits[css_key]);
452 452 }
453 453 }
454 454 }
455 455 }
456 456 }
457 457 }
458 458
459 459 var add_class = this.model.get('_add_class');
460 460 if (add_class != undefined){
461 461 var add_class_calls = add_class[0];
462 462 if (add_class_calls > this._add_class_calls) {
463 463 this._add_class_calls = add_class_calls;
464 464 var elements = this._get_selector_element(add_class[1]);
465 465 if (elements.length > 0) {
466 466 elements.addClass(add_class[2]);
467 467 }
468 468 }
469 469 }
470 470
471 471 var remove_class = this.model.get('_remove_class');
472 472 if (remove_class != undefined){
473 473 var remove_class_calls = remove_class[0];
474 474 if (remove_class_calls > this._remove_class_calls) {
475 475 this._remove_class_calls = remove_class_calls;
476 476 var elements = this._get_selector_element(remove_class[1]);
477 477 if (elements.length > 0) {
478 478 elements.removeClass(remove_class[2]);
479 479 }
480 480 }
481 481 }
482 482 },
483 483
484 484 _get_selector_element: function(selector) {
485 485 // Get the elements via the css selector. If the selector is
486 486 // blank, apply the style to the $el_to_style element. If
487 487 // the $el_to_style element is not defined, use apply the
488 488 // style to the view's element.
489 489 var elements = this.$el.find(selector);
490 490 if (selector=='') {
491 491 if (this.$el_to_style == undefined) {
492 492 elements = this.$el;
493 493 } else {
494 494 elements = this.$el_to_style;
495 495 }
496 496 }
497 497 return elements;
498 498 },
499 499 });
500 500
501 501
502 502 //--------------------------------------------------------------------
503 503 // WidgetManager class
504 504 //--------------------------------------------------------------------
505 505 var WidgetManager = function(){
506 506 this.comm_manager = null;
507 507 this.widget_model_types = {};
508 508 this.widget_view_types = {};
509 509
510 510 var that = this;
511 511 Backbone.sync = function(method, model, options, error) {
512 512 var result = model._handle_sync(method, options);
513 513 if (options.success) {
514 514 options.success(result);
515 515 }
516 516 };
517 517 }
518 518
519 519
520 520 WidgetManager.prototype.attach_comm_manager = function (comm_manager) {
521 521 this.comm_manager = comm_manager;
522 522
523 523 // Register already register widget model types with the comm manager.
524 524 for (var widget_model_name in this.widget_model_types) {
525 525 this.comm_manager.register_target(widget_model_name, $.proxy(this._handle_com_open, this));
526 526 }
527 527 }
528 528
529 529
530 530 WidgetManager.prototype.register_widget_model = function (widget_model_name, widget_model_type) {
531 531 // Register the widget with the comm manager. Make sure to pass this object's context
532 532 // in so `this` works in the call back.
533 533 if (this.comm_manager!=null) {
534 534 this.comm_manager.register_target(widget_model_name, $.proxy(this._handle_com_open, this));
535 535 }
536 536 this.widget_model_types[widget_model_name] = widget_model_type;
537 537 }
538 538
539 539
540 540 WidgetManager.prototype.register_widget_view = function (widget_view_name, widget_view_type) {
541 541 this.widget_view_types[widget_view_name] = widget_view_type;
542 542 }
543 543
544 544
545 545 WidgetManager.prototype.get_msg_cell = function (msg_id) {
546 546 if (IPython.notebook != undefined && IPython.notebook != null) {
547 547 return IPython.notebook.get_msg_cell(msg_id);
548 548 }
549 549 }
550 550
551 551
552 552 WidgetManager.prototype.on_create_widget = function (callback) {
553 553 this._create_widget_callback = callback;
554 554 }
555 555
556 556
557 557 WidgetManager.prototype._handle_create_widget = function (widget_model) {
558 558 if (this._create_widget_callback) {
559 559 try {
560 560 this._create_widget_callback(widget_model);
561 561 } catch (e) {
562 562 console.log("Exception in WidgetManager callback", e, widget_model);
563 563 }
564 564 }
565 565 }
566 566
567 567
568 568 WidgetManager.prototype._handle_com_open = function (comm, msg) {
569 569 var widget_type_name = msg.content.target_name;
570 570 var widget_model = new this.widget_model_types[widget_type_name](this.comm_manager, comm, this);
571 571 this._handle_create_widget(widget_model);
572 572 }
573 573
574 574
575 575 //--------------------------------------------------------------------
576 576 // Init code
577 577 //--------------------------------------------------------------------
578 578 IPython.WidgetManager = WidgetManager;
579 579 IPython.WidgetModel = WidgetModel;
580 580 IPython.WidgetView = WidgetView;
581 581
582 582 if (IPython.widget_manager==undefined || IPython.widget_manager==null) {
583 583 IPython.widget_manager = new WidgetManager();
584 584 }
585 585
586 586 return IPython.widget_manager;
587 587 });
General Comments 0
You need to be logged in to leave comments. Login now