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          */
  35         $.fn.badge = function ( text, inline ) {
  36                 var $badge = this.find( '.mw-badge' );
  37
  38                 if ( text ) {
  39                         // If a badge already exists, reuse it
  40                         if ( $badge.length ) {
  41                                 $badge.find( '.mw-badge-content' ).text( text );
  42                         } else {
  43                                 // Otherwise, create a new badge with the specified text and style
  44                                 $badge = $( '<div class="mw-badge mw-badge-' + ( inline ? 'inline' : 'overlay' ) + '"></div>' )
  45                                         .append( $( '<span class="mw-badge-content"></span>' ).text ( text ) )
  46                                         .appendTo( this );
  47                         }
  48                 } else {
  49                         $badge.remove();
  50                 }
  51                 return this;
  52         };
  53 }( jQuery ) );