https://www.ziptrak.com.au/wp-content/themes/wp-theme-ziptrak/includes/js/vendor/jquery.ba-replacetext.js

1/*!
2 * jQuery replaceText - v1.1 - 11/21/2009
3 * http://benalman.com/projects/jquery-replacetext-plugin/
4 * 
5 * Copyright (c) 2009 "Cowboy" Ben Alman
6 * Dual licensed under the MIT and GPL licenses.
7 * http://benalman.com/about/license/
8 */
9
10// Script: jQuery replaceText: String replace for your jQueries!
11//
12// *Version: 1.1, Last updated: 11/21/2009*
13// 
14// Project Home - http://benalman.com/projects/jquery-replacetext-plugin/
15// GitHub       - http://github.com/cowboy/jquery-replacetext/
16// Source       - http://github.com/cowboy/jquery-replacetext/raw/master/jquery.ba-replacetext.js
17// (Minified)   - http://github.com/cowboy/jquery-replacetext/raw/master/jquery.ba-replacetext.min.js (0.5kb)
18// 
19// About: License
20// 
21// Copyright (c) 2009 "Cowboy" Ben Alman,
22// Dual licensed under the MIT and GPL licenses.
23// http://benalman.com/about/license/
24// 
25// About: Examples
26// 
27// This working example, complete with fully commented code, illustrates one way
28// in which this plugin can be used.
29// 
30// replaceText - http://benalman.com/code/projects/jquery-replacetext/examples/replacetext/
31// 
32// About: Support and Testing
33// 
34// Information about what version or versions of jQuery this plugin has been
35// tested with, and what browsers it has been tested in.
36// 
37// jQuery Versions - 1.3.2, 1.4.1
38// Browsers Tested - Internet Explorer 6-8, Firefox 2-3.6, Safari 3-4, Chrome, Opera 9.6-10.1.
39// 
40// About: Release History
41// 
42// 1.1 - (11/21/2009) Simplified the code and API substantially.
43// 1.0 - (11/21/2009) Initial release
44
45(function($){
46  '$:nomunge'; // Used by YUI compressor.
47  
48  // Method: jQuery.fn.replaceText
49  // 
50  // Replace text in specified elements. Note that only text content will be
51  // modified, leaving all tags and attributes untouched. The new text can be
52  // either text or HTML.
53  // 
54  // Uses the String prototype replace method, full documentation on that method
55  // can be found here: 
56  // 
57  // https://developer.mozilla.org/En/Core_JavaScript_1.5_Reference/Objects/String/Replace
58  // 
59  // Usage:
60  // 
61  // > jQuery('selector').replaceText( search, replace [, text_only ] );
62  // 
63  // Arguments:
64  // 
65  //  search - (RegExp|String) A RegExp object or substring to be replaced.
66  //    Because the String prototype replace method is used internally, this
67  //    argument should be specified accordingly.
68  //  replace - (String|Function) The String that replaces the substring received
69  //    from the search argument, or a function to be invoked to create the new
70  //    substring. Because the String prototype replace method is used internally,
71  //    this argument should be specified accordingly.
72  //  text_only - (Boolean) If true, any HTML will be rendered as text. Defaults
73  //    to false.
74  // 
75  // Returns:
76  // 
77  //  (jQuery) The initial jQuery collection of elements.
78  
79  $.fn.replaceText = function( search, replace, text_only ) {
80    return this.each(function(){
81      var node = this.firstChild,
82        val,
83        new_val,
84        
85        // Elements to be removed at the end.
86        remove = [];
87      
88      // Only continue if firstChild exists.
89      if ( node ) {
90        
91        // Loop over all childNodes.
92        do {
93          
94          // Only process text nodes.
95          if ( node.nodeType === 3 ) {
96            
97            // The original node value.
98            val = node.nodeValue;
99            
100            // The new value.
101            new_val = val.replace( search, replace );
102            
103            // Only replace text if the new value is actually different!
104            if ( new_val !== val ) {
105              
106              if ( !text_only && /</.test( new_val ) ) {
107                // The new value contains HTML, set it in a slower but far more
108                // robust way.
109                $(node).before( new_val );
110                
111                // Don't remove the node yet, or the loop will lose its place.
112                remove.push( node );
113              } else {
114                // The new value contains no HTML, so it can be set in this
115                // very fast, simple way.
116                node.nodeValue = new_val;
117              }
118            }
119          }
120          
121        } while ( node = node.nextSibling );
122      }
123      
124      // Time to remove those elements!
125      remove.length && $(remove).remove();
126    });
127  };  
128  
129})(jQuery);