jQuery Forum

Hi, everyone,

I have a nice  idea here,

a update version, simple, powerful

found in below
-------------------------------------------------------------------------------------
. mark()       and       . addMark()


this api is similar to addBack() ;  but a great different improve,

more information,
(A) add a mark to a set of matched elements, using  .mark( your_any_Label )
(B) pick up a set of matched elements, using  .addMark(  your_any_Label )

 
 this A api not change anything on the current set of matched elements,  just leave a mark. 
 when you decide somewhere  to add a set of matched elements, just call its marked " label".
 
 .addMark( a Label );


for example

         $(selector1). mark('abc').other_more_JQuery_API();        

 explanation, in this line, a set of matched elements is marked with label "abc",
 
   

somewhere you want to pick up it back, OK,

     $( selector2). addMark('abc').other_more_JQuery_API(); 

in this line, this set of matched elements of selector1 has been picked up and add into the current set of matched elements of selector2.
in other way, a same meaning is  $(selector2).add( $(selector1) );   


sample code 2

      $('#id7', 'div.txt').find('p').mark(6).find(etc).........;  

 somewhere

     $('#ID8').addMark(6).addMark('abc').find(etc)......

in this line, the current set adds up 2 sets of elements from label 6 and label abc .


for example 3
 in one line, you can do anything more than before,

   $('#myID').mark('c3').prevUntil('#id5').mark('item5').prev().prev()
.find('a.visited').addMark('c3').addMark('item5').addMark("abc")
.each(myFunc).otherAPI(etc);


now, you know this ideas, What about it ??? enough good ?

 so, you using api .mark()  to mark up a set to one label, and you can mark up many sets.

 later you will easy pick them up back into your current jquery object --- anywhere by addMark()


  // ----------------------------- codes for API mark() and addMark()-----------------------------------------    

1.  ;(function(){ //extention of mark api 
   
2.      var cache = {};
3. 
     jQuery.fn.mark = function markIt( label ){
          cache[label] = this;
         return this;
     }
4. 
     jQuery.fn.addMark = function( label ){ // add_a_marked_set_into_current_set
          if(arguments.length <2 )
               return    $(this).add(cache[label]);  
     }
5. 
    })();

 

further more,
the addMark() also can be updated for easy using:

    addMark(p1, p2, p3, p4, .... )

multi lables can be add() at once

further api,  delMark() can be using to work as  not() + addMark()
for example,
       $('table.he').delMark('abc')  

this is meaning   $('table.he').not($.addMark('abc'));


by K100