plugins/messages/messages.js

   1 /**
   2  * Description: display messages in a dedicated area, with buttons for filtering on level
   3  * Copyright (c) 2012 UPMC Sorbonne Universite - INRIA
   4  * License: GPLv3
   5  */
   6
   7 ( function($) {
   8
   9     /* Method calling logic */
  10     $.fn.Messages = function( method ) {
  11         if ( methods[method] ) {
  12             return methods[ method ].apply( this, Array.prototype.slice.call( arguments, 1 ));
  13         } else if ( typeof method === 'object' || ! method ) {
  14             return methods.init.apply( this, arguments );
  15         } else {
  16             $.error( 'Method ' +  method + ' does not exist on $.Messages' );
  17         }
  18     };
  19
  20     var methods = {
  21         init : function( options ) {
  22
  23             return this.each (function() {
  24                 var $this = $(this);
  25                 instance=new Messages (options,$this);
  26                 $this.data('Messages',instance);
  27                 for (level in options.levels) {
  28                     (function (instance,level) {
  29                         $.subscribe("/messages/"+level, function (e, msg){ instance.display_message (msg,level)});
  30                     }) (instance,level);
  31                 }
  32                 // this happens very early - even before the document is loaded
  33                 // so it won't show right away; no big deal though
  34                 $.publish  ("/messages/info", 'Subscribed to all 5 message channels');
  35             });
  36         },
  37         destroy : function( ) {
  38
  39             return this.each(function(){
  40                 var $this = $(this), instance = $this.data('Messages');
  41                 $(window).unbind('Messages');
  42                 instance.remove();
  43                 $this.removeData('Messages');
  44             });
  45         },
  46 /*
  47     reposition : function( ) { // ... },
  48     show : function( ) { // ... },
  49     hide : function( ) { // ... },
  50 */
  51         update : function( content ) { },
  52     };
  53
  54     function Messages (options,plugindiv) {
  55         this.options=options;
  56         this.plugindiv=plugindiv;
  57         /* cannot use 'this' directly of course */
  58         (function (instance) { $( function () {instance.initialize();}) }) (this);
  59
  60         this.is_active = function (level) {
  61             return this.plugindiv.find("div.messages-buttons>input[name="+level+"]").attr('checked');
  62         }
  63         this.display_message = function (incoming, level) {
  64             var domid=this.plugindiv.attr('id');
  65             var html="";
  66             html += "<li class='" + level +"'";
  67             if ( ! this.is_active(level) ) html += " style='display:none'";
  68             html += ">";
  69             html += "<span class='messages-date'>" + new Date() + "</span>";
  70             html += "<span class='messages-level'>" + level + "</span>";
  71             //  html += "[" + domid + "]";
  72             html += " " + incoming + "</li>";
  73             $("ul#"+domid+".messages").append(html);
  74         },
  75
  76         this.initialize = function () {
  77             var init_button=this.init_button;
  78             var levels=this.options.levels;
  79             this.plugindiv.find("div.messages-buttons>input").each(
  80                 function (i,input) {init_button (input, levels)});
  81             var arm_button=this.arm_button;
  82             var toggle_handler=this.toggle_handler;
  83             this.plugindiv.find("div.messages-buttons>input").each(
  84                 function (i,input) {arm_button (input,toggle_handler); });
  85         },
  86         this.init_button = function (input,levels) {
  87             /* set initial 'checked' state for that input from global 'levels' above */
  88             var level=input.name;
  89             if (levels[level]) $(input).attr('checked','checked');
  90         },
  91         this.arm_button = function (input,handler) {
  92             $(input).click (handler);
  93         },
  94         /* as an event handler toggle_handler will see the DOM <input> as 'this' */
  95         this.toggle_handler = function (e) {
  96             var $this=$(this);
  97             // toggle the state of the checkbox
  98             if ($this.attr('checked')) $this.removeAttr('checked');
  99             else $this.attr('checked',true);
 100             // turn messages on or off
 101             var level=this.name;
 102             var display = $this.attr('checked') ? "list-item" : "none";
 103             var plugindiv=$this.closest("div.Messages");
 104             plugindiv.find("li."+level).css("display",display);
 105         }
 106
 107     };
 108
 109 })(jQuery);
 110
 111 /* turn this on for an auto-test on startup
 112 var messages_test = {
 113     // set this to 0 to disable
 114     counter : 2,
 115     period : 1000,
 116     sample : function () {
 117         $.publish("/messages/fatal","a fatal message (" + messages_test.counter + " runs to go)");
 118         $.publish("/messages/error","an error message");
 119         $.publish("/messages/warning","a warning message");
 120         $.publish("/messages/info","an info message");
 121         $.publish("/messages/debug","a debug message");
 122         messages_test.counter -= 1;
 123         if (messages_test.counter == 0)
 124             window.clearInterval (messages_test.interval_id);
 125     },
 126     run: function () {
 127         messages_test.interval_id=window.setInterval(messages_test.sample , messages_test.period);
 128     }
 129 }
 130 messages_test.run()
 131 */