Bridget tests

'); 16 | assert.ok( $div.niceGreeter, '.niceGreeter method is there' ); 17 | $div.niceGreeter(); 18 | assert.equal( typeof $div.data('niceGreeter'), 'object', 19 | 'instance accessible in .data()' ); 20 | } ); 21 | 22 | QUnit.test( 'niceGreeter', function( assert ) { 23 | let $ex1 = $('#ex1'); 24 | $ex1.niceGreeter(); 25 | let greeter = $ex1.data('niceGreeter'); 26 | assert.equal( typeof $ex1.data('niceGreeter'), 'object', 27 | 'instance accessible in .data()' ); 28 | assert.equal( $ex1.text(), 'hello world', 'default settings' ); 29 | // method with argument 30 | $ex1.niceGreeter( 'sayHi', 'pretty boy' ); 31 | assert.equal( $ex1.text(), 'hello pretty boy', 'sayHi method with argument' ); 32 | // option setter 33 | let ret = $ex1.niceGreeter( 'option', { greeting: 'bonjour' } ); 34 | assert.equal( ret, $ex1, 'return value of method is jQuery object' ); 35 | ret.niceGreeter(); 36 | assert.equal( greeter.options.greeting, 'bonjour', 37 | 'greeter.options.greeting = bonjour' ); 38 | assert.equal( $ex1.text(), 'bonjour world', 'option setter' ); 39 | // method 40 | $ex1.niceGreeter({ loudGreeting: 'well hi there' }); 41 | $ex1.niceGreeter('shout'); 42 | assert.equal( $ex1.text(), 'WELL HI THERE WORLD', 'shout method with argument' ); 43 | // private method _whisper 44 | $ex1.niceGreeter( '_whisper', 'sweet nothings' ); 45 | assert.notEqual( $ex1.text(), 'sweet nothings', 46 | 'private method _whisper is private' ); 47 | 48 | // set second instance 49 | let $ex2 = $('#ex2').niceGreeter({ 50 | greeting: 'aloha', 51 | recipient: 'uncle', 52 | }); 53 | let greeter2 = $ex2.data('niceGreeter'); 54 | let $examples = $('.example'); 55 | // method on multiple instances 56 | $examples.niceGreeter( 'option', { 57 | loudGreeting: 'yaaarg', 58 | } ); 59 | assert.equal( greeter.options.loudGreeting, 'yaaarg', 'first greeter method worked' ); 60 | assert.equal( greeter2.options.loudGreeting, 'yaaarg', 61 | 'second greeter method worked' ); 62 | // getter method 63 | let message = $examples.niceGreeter('getMessage'); 64 | assert.equal( message, 'bonjour world', 'getter method returns first value' ); 65 | } ); 66 | 67 | QUnit.test( 'jQueryBridget', function( assert ) { 68 | jQueryBridget( 'noopPlugin', function() {} ); 69 | assert.ok( $.fn.noopPlugin, 'jQueryBridget()' ); 70 | } ); 71 | 72 | } )( window, window.jQuery ); 73 | -------------------------------------------------------------------------------- /jquery-bridget.js: -------------------------------------------------------------------------------- 1 | /** 2 | * Bridget makes jQuery widgets 3 | * v3.0.1 4 | * MIT license 5 | */ 6 | 7 | ( function( window, factory ) { 8 | // module definition 9 | if ( typeof module == 'object' && module.exports ) { 10 | // CommonJS 11 | module.exports = factory( 12 | window, 13 | require('jquery'), 14 | ); 15 | } else { 16 | // browser global 17 | window.jQueryBridget = factory( 18 | window, 19 | window.jQuery, 20 | ); 21 | } 22 | 23 | }( window, function factory( window, jQuery ) { 24 | 25 | // ----- utils ----- // 26 | 27 | // helper function for logging errors 28 | // $.error breaks jQuery chaining 29 | let console = window.console; 30 | let logError = typeof console == 'undefined' ? function() {} : 31 | function( message ) { 32 | console.error( message ); 33 | }; 34 | 35 | // ----- jQueryBridget ----- // 36 | 37 | function jQueryBridget( namespace, PluginClass, $ ) { 38 | $ = $ || jQuery || window.jQuery; 39 | if ( !$ ) { 40 | return; 41 | } 42 | 43 | // add option method -> $().plugin('option', {...}) 44 | if ( !PluginClass.prototype.option ) { 45 | // option setter 46 | PluginClass.prototype.option = function( opts ) { 47 | if ( !opts ) return; 48 | 49 | this.options = Object.assign( this.options || {}, opts ); 50 | }; 51 | } 52 | 53 | // make jQuery plugin 54 | $.fn[ namespace ] = function( arg0, ...args ) { 55 | if ( typeof arg0 == 'string' ) { 56 | // method call $().plugin( 'methodName', { options } ) 57 | return methodCall( this, arg0, args ); 58 | } 59 | // just $().plugin({ options }) 60 | plainCall( this, arg0 ); 61 | return this; 62 | }; 63 | 64 | // $().plugin('methodName') 65 | function methodCall( $elems, methodName, args ) { 66 | let returnValue; 67 | let pluginMethodStr = `$().${namespace}("${methodName}")`; 68 | 69 | $elems.each( function( i, elem ) { 70 | // get instance 71 | let instance = $.data( elem, namespace ); 72 | if ( !instance ) { 73 | logError( `${namespace} not initialized.` + 74 | ` Cannot call method ${pluginMethodStr}` ); 75 | return; 76 | } 77 | 78 | let method = instance[ methodName ]; 79 | if ( !method || methodName.charAt( 0 ) == '_' ) { 80 | logError(`${pluginMethodStr} is not a valid method`); 81 | return; 82 | } 83 | 84 | // apply method, get return value 85 | let value = method.apply( instance, args ); 86 | // set return value if value is returned, use only first value 87 | returnValue = returnValue === undefined ? value : returnValue; 88 | } ); 89 | 90 | return returnValue !== undefined ? returnValue : $elems; 91 | } 92 | 93 | function plainCall( $elems, options ) { 94 | $elems.each( function( i, elem ) { 95 | let instance = $.data( elem, namespace ); 96 | if ( instance ) { 97 | // set options & init 98 | instance.option( options ); 99 | instance._init(); 100 | } else { 101 | // initialize new instance 102 | instance = new PluginClass( elem, options ); 103 | $.data( elem, namespace, instance ); 104 | } 105 | } ); 106 | } 107 | 108 | } 109 | 110 | // ----- ----- // 111 | 112 | return jQueryBridget; 113 | 114 | } ) ); 115 | --------------------------------------------------------------------------------