Clear Up
SharpKit Reference

jQuery.sub Method

There are two specific use cases for which jQuery.sub() was created. The first was for providing a painless way of overriding jQuery methods without completely destroying the original methods and another was for helping to do encapsulation and basic namespacing for jQuery plugins. Note that jQuery.sub() doesn't attempt to do any sort of isolation - that's not its intention. All the methods on the sub'd version of jQuery will still point to the original jQuery (events bound and triggered will still be through the main jQuery, data will be bound to elements through the main jQuery, Ajax queries and events will run through the main jQuery, etc.). Note that if you're looking to use this for plugin development you should first strongly consider using something like the jQuery UI widget factory which manages both state and plugin sub-methods. Some examples of using the jQuery UI widget factory to build a plugin. The particular use cases of this method can be best described through some examples. Adding a method to a jQuery sub so that it isn't exposed externally:

(function(){
  var sub$ = jQuery.sub();
  sub$.fn.myCustomMethod = function(){
return 'just for me';
};
sub$(document).ready(function() {
sub$('body').myCustomMethod() // 'just for me'
});
})();
typeof jQuery('body').myCustomMethod // undefined
             
Override some jQuery methods to provide new functionality.
 (function() {
  var myjQuery = jQuery.sub();
            
 myjQuery.fn.remove = function() {
 // New functionality: Trigger a remove event
 this.trigger("remove");
            
 // Be sure to call the original jQuery remove method
 return jQuery.fn.remove.apply( this, arguments );
};
            
 myjQuery(function($) {
 $(".menu").click(function() {
 $(this).find(".submenu").remove();
 });
            
 // A new remove event is now triggered from this copy of jQuery
 $(document).bind("remove", function(e) {
 $(e.target).parent().hide();
 });
 });
 })();
            
 // Regular jQuery doesn't trigger a remove event when removing an element
 // This functionality is only contained within the modified 'myjQuery'.
             
Create a plugin that returns plugin-specific methods.
 (function() {
  // Create a new copy of jQuery using sub()
  var plugin = jQuery.sub();
            
  // Extend that copy with the new plugin methods
  plugin.fn.extend({
    open: function() {
      return this.show();
    },
    close: function() {
      return this.hide();
    }
  });
            
  // Add our plugin to the original jQuery
  jQuery.fn.myplugin = function() {
    this.addClass("plugin");
            
    // Make sure our plugin returns our special plugin version of jQuery
    return plugin( this );
  };
})();
            
$(document).ready(function() {
  // Call the plugin, open method now exists
  $('#main').myplugin().open();
            
  // Note: Calling just $("#main").open() won't work as open doesn't exist!
});        
             

Namespace: SharpKit.jQuery

Class: jQuery

Syntax

public static jQuery sub()

Return Value

Type: SharpKit.jQuery.jQuery
© Copyright 2005-2011 SharpKit. All rights reserved.