resources/jquery/jquery.badge.js

   1 /**
   2  * jQuery Badge plugin
   3  *
   4  * @license MIT
   5  */
   6
   7 /**
   8  * @author Ryan Kaldari <rkaldari@wikimedia.org>, 2012
   9  * @author Andrew Garrett <agarrett@wikimedia.org>, 2012
  10  * @author Marius Hoch <hoo@online.de>, 2012
  11  *
  12  * Permission is hereby granted, free of charge, to any person obtaining a copy
  13  * of this software and associated documentation files (the "Software"), to deal
  14  * in the Software without restriction, including without limitation the rights
  15  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  16  * copies of the Software, and to permit persons to whom the Software is
  17  * furnished to do so, subject to the following conditions:
  18  *
  19  * The above copyright notice and this permission notice shall be included in
  20  * all copies or substantial portions of the Software.
  21  *
  22  * This program is distributed WITHOUT ANY WARRANTY.
  23  */
  24 ( function ( $ ) {
  25         /**
  26          * Allows you to put a "badge" on an item on the page. The badge container
  27          * will be appended to the selected element(s).
  28          * See mediawiki.org/wiki/ResourceLoader/Default_modules#jQuery.badge
  29          *
  30          * @param text The value to display in the badge. If the value is falsey (0,
  31          *   null, false, '', etc.), any existing badge will be removed.
  32          * @param boolean inline True if the badge should be displayed inline, false
  33          *   if the badge should overlay the parent element (default is inline)
  34          * @param boolean displayZero True if the number zero should be displayed,
  35          *   false if the number zero should result in the badge being hidden
  36          *   (default is zero will result in the badge being hidden)
  37          */
  38         $.fn.badge = function ( text, inline, displayZero ) {
  39                 var $badge = this.find( '.mw-badge' ),
  40                         badgeStyleClass = 'mw-badge-' + ( inline ? 'inline' : 'overlay' ),
  41                         badgeColorClass = 'mw-badge-red'; // default color is red
  42
  43                 // If we're displaying zero, change the color to grey
  44                 if ( displayZero && text === 0 ) {
  45                         badgeColorClass = 'mw-badge-grey';
  46                         // Change zero to string so that it will be displayed
  47                         text = '0';
  48                 }
  49                 if ( text ) {
  50                         // If a badge already exists, reuse it
  51                         if ( $badge.length ) {
  52                                 $badge.find( '.mw-badge-content' ).text( text );
  53                         } else {
  54                                 // Otherwise, create a new badge with the specified text and style
  55                                 $badge = $( '<div class="mw-badge"></div>' )
  56                                         .addClass( badgeStyleClass )
  57                                         .addClass( badgeColorClass )
  58                                         .append( $( '<span class="mw-badge-content"></span>' ).text ( text ) )
  59                                         .appendTo( this );
  60                         }
  61                 } else {
  62                         $badge.remove();
  63                 }
  64                 return this;
  65         };
  66 }( jQuery ) );