Search jQuery

jQuery Forum

.mark( ) api

in Developing jQuery Plugins • 7 years ago

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()-----------------------------------------

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

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

Replies(2)

jakecigar

Re: .mark() api

7 years ago

Sounds like an interesting plugin. I doubt it would make it into the jQuery core.

I can see another function you might need

jQuery.mark = function(label) {
return cache[label]
}

JΛ̊KE

I moved the post to developing jQuery plugins.

abc here

Re: .mark( ) api

6 years ago

// HI, everyone

// simple to use

// a updated version

//----------------------------------------------------------------------------------------------------------------

//    manual & Doc
//
//   API just three:    sa()   ga()   ra()
//
//
// sa() set a label, or set many labels; --- NOT modified the jQuery Object of the current Set
//
// ga() get a label, or many labels, and they add into the current Set or remove from the current Set
// --------- YES ga() api has modified the jQuery Object of the current Set
//
// ra()        remove a label, or many labels to NULL, clean it; ----- NOT modified the jQuery Object of the current Set

//
// details manual
   var storage = cache;

// usage:
// sa("aLabel")            // save a label, set a label for the current Set into storage;
// sa("aLabel", opt_clean ) // set it NULL, clean a label, in cache
// sa("aL1","aL2","aL3", ..., opt_clean) // set many labels to NULL, clean them NULL in storage;
// "opt_clean" only accept "opt_clean = null"
// sa() --- NOT modified the jQuery Object of the current Set

// ga("aLabel")           // get a label, add it into the current set
// ga("aL1","aL2","aL3", ... ) // get many labels, add them into the current set
// ga("aLabel", opt_decrease)           // get a label, decrease it from the current set ;
// ga("aL1","aL2","aL3", ..., opt_decrease)   // get many labels in total, to decrease from the current set
//   "opt_decrease" = boolean true or false   or "-------"any piece
// --------- YES ga() api has modified the jQuery Object of the current Set

// ra("aLabel")   // remove a label in storage, clean it to NULL
// ra("aL1", 'aL2', "aL3", ... )   // remove many labels in storage, clean them to NULL
// ra();         // remove all, the storage to be clean empty
// this api --- NOT modified the jQuery Object of the current Set

// further more,
// to input many labels, you can do like this,
// list single
// api ( aL1, aL2, aL3, ... )    as the above
// or array
// api ( [ aL1, aL2, aL3, ...] )
// or mix
// api ( [L1, L2, L3,....], L21, L22, ..... [L31, L32, L33, ....] )

// example
// $(selector).sa(alabel).other_jQuery_api()
// jQuery("a[href]").sa("123").css(...).text()
// $("p[id^=c11]").ga("123").css(..).on("click", callback).other_api();
// ....more....
// $.ra(); "if you dont need them";

//------------------------------------------------------------------------------------------------------------------

;(function power_mark_current_set(){

var cache = {} // storage
jQuery.fn.sa = function set_a_label_ON_or_Clean(label, opt_clean) {
    var g = rich_arg(arguments);
    if (g.length == 1) {
        cache[label] = this;
    } else if (g.pop() === null) {
        g.forEach(function (p, j) {
            if (p || p === 0)
                delete cache[p];
        });
    } else {}
    return this;
}
jQuery.fn.ga = function get_label_to_addIn_or_decreaseFrom__the_current_set(label, opt_decrease) {
    var g = rich_arg(arguments);
    var last = g.pop();
    var out = this;
    var action = "";
    if (last === true || last === false || last == "----" || /^\-+$/.test(last)) {
        action = "not";
    } else if (last || last === 0 || last === "") {
        g.push(last);
        action = "add";
    } else {}
    if (action) {
        g.forEach(function (_label, j) {
            if (_label || _label === 0) {
                out = out[action](cache[_label]);
            }
        });
    }
    return out;
}
jQuery.fn.ra = function remove_label_from_storage(label) {
    var g = rich_arg(arguments);
    if (g.length) {
        g.forEach(function (p, j) {
            if (p || p === 0)
                delete cache[p];
        });
    } else {
        for (var p in cache) {
            delete cache[p];
        }
    }
    return this;
}
function rich_arg(_arguments) {
    var g = [].slice.call(_arguments);
    var out = [].concat.apply([], g);
    return out;
};
var meth = ["sa", "ga", "ra"];
meth.forEach(function (p, j) {
    jQuery[p] = function real_handler() {
        var g = [].slice.call(arguments);
        var _this = jQuery();
        return jQuery.fn[p].apply(_this, g);
    };
});

// version 2014-12-06 RC
// my song writer going on ...

})();

//-----------------------------------------------------------------------------------------------

// just, enjoy it

// writing less, do more

Top Reply

Response title

Attachments

jQuery Forum

.mark( ) api

Replies(2)

Re: .mark() api

Re: .mark( ) api

Statistics

Tags

Actions