jParse^beta

Download Zip File (Beta 0.3.2)

Click here to download a .zip file that contains the following:

• Minified Code
• Fully Commented Code

Minified Code (Beta 0.3.2):

/* * jParse (Beta) v0.3.2 * jparse.kylerush.net * * Copyright (c) 2009 Kyle Rush * Licensed under the MIT license. * http://creativecommons.org/licenses/MIT/ * * Date: Saturday, 20 Feb 2010 20:00 (GMT - 5:00) */ (function(c){c.fn.extend({jParse:function(o){settings=c.extend(true,{ajaxOpts:{dataType:c.browser.msie?"text":"xml",contentType:"text/xml"},parentElement:"item",elementTag:["title","link","description"],output:'<div><h2><a href="jpet1">jpet0</a></h2><p>jpet2</p></div>'},o);settings.precallback!==undefined&&settings.precallback();var j=c(this),p=/\:/;settings.ajaxOpts.success=function(e){function k(f){elemTagName=p.test(f)===true?"[nodeName="+f+"]":f}function l(f,g){if(a.elementTag[b].elem===undefined){k(f); elemTagValue=c(g).find(elemTagName).text();elemTagValue=elemTagValue.replace(/^\[CDATA\[/,"").replace(/\]\]$/,"")}else{k(f);if(a.elementTag[b].attr===undefined)if(a.elementTag[b].select!==undefined){f=c(g).find(elemTagName);elemTagValue=c(f[a.elementTag[b].select]).text()}else{if(a.elementTag[b].select===undefined)elemTagValue=c(g).find(elemTagName).text()}else elemTagValue=c(g).find(elemTagName).attr(a.elementTag[b].attr);if(a.elementTag[b].exclude!==undefined)if((new RegExp(a.elementTag[b].exclude)).test(elemTagValue)=== true)m=true;if(a.elementTag[b].format!==undefined)elemTagValue=a.elementTag[b].format(elemTagValue);if(a.elementTag[b].dateFormat!==undefined)elemTagValue=date(a.elementTag[b].dateFormat,elemTagValue)}}var d;if(typeof e=="string"){d=new ActiveXObject("Microsoft.XMLDOM");d.async=false;d.loadXML(e)}else d=e;var a=settings;e=c(d).find(a.parentElement);d="";var n=0;a.count!==undefined&&jQuery(a.count).append(e.length);for(var h=0;h<e.length;h++){if(n>=settings.limit){c(j).append(d);settings.callback!== undefined&&settings.callback();return false}for(var i=a.output,m=false,b=0;b<a.elementTag.length;b++){var q=new RegExp("jpet"+[b],"g");if(a.elementTag[b].constructor==String)l(a.elementTag[b],e[h]);else a.elementTag[b].constructor==Object&&l(a.elementTag[b].elem,e[h]);i=i.replace(q,elemTagValue)}if(m!==true){d+=i;n++}}c(j).append(d);settings.callback!==undefined&&settings.callback()};return this.each(function(){c.ajax(settings.ajaxOpts)})}})})(jQuery);

Full, Commented Code (Beta 0.3.2):

/* * jParse (Beta) v0.3.2 * jparse.kylerush.net * * Copyright (c) 2009 Kyle Rush * Licensed under the MIT license. * http://creativecommons.org/licenses/MIT/ * * Date: Saturday, 20 Feb 2010 20:00 (GMT - 5:00) */ (function($){ $.fn.extend({ //pass the options variable to the function jParse: function(options) { //Set the default values, use comma to separate the o2, example: var defaults = { ajaxOpts: {dataType: ($.browser.msie) ? "text" : "xml", contentType: 'text/xml'}, parentElement: 'item', elementTag: ['title', 'link', 'description'], output: '<div><h2><a href="jpet1">jpet0</a></h2><p>jpet2</p></div>' }; //consolidate both user defined and default functions settings = $.extend(true, defaults, options); //run precallback if(settings.precallback !== undefined){ settings.precallback(); } //assign the selected element to the variable 'slected' var selected = $(this); //master colon regexp var colon = /\:/; //settings.ajaxOpts.dataType = ($.browser.msie) ? "text" : "xml"; settings.ajaxOpts.success = function(data){ //extra code for ie content type handling var xml; if (typeof data == "string") { xml = new ActiveXObject("Microsoft.XMLDOM"); xml.async = false; xml.loadXML(data); } else { xml = data; } //shortcut for referencing settings var o = settings; //create an object/array of all specified 'items' in xml document var parentElementArray = $(xml).find(o.parentElement); //initiate the containg variable var container = ''; //initiate the number of included elements variable var numberIncluded = 0; //this nodeChecker function formats entry variables for proper namespace parsing function nodeChecker(node){ //if there is a colon in the entryTag name if(colon.test(node) === true){ //asign the elemTagName variable to a jQuery parsable attribute selector elemTagName = '[nodeName=' + node + ']'; } else { elemTagName = node; } } //element value processor function function processElementValue(elementValue, elementParent){ //detect if the specified element tag is a string or an object if(o.elementTag[n].elem === undefined){ //run the node checker function nodeChecker(elementValue); //set the element's value elemTagValue = $(elementParent).find(elemTagName).text(); //strip any CDATA text from the result if it exists elemTagValue = elemTagValue.replace(/^\[CDATA\[/, '').replace(/\]\]$/, ''); } else { //run the node checker function nodeChecker(elementValue); //detect if the the user has not specified an attribute to pull if(o.elementTag[n].attr === undefined){ //detect if array of element tag was provided if(o.elementTag[n].select !== undefined){ var arrayElements = $(elementParent).find(elemTagName); elemTagValue = $(arrayElements[o.elementTag[n].select]).text(); } else if(o.elementTag[n].select === undefined) { elemTagValue = $(elementParent).find(elemTagName).text(); } } else { elemTagValue = $(elementParent).find(elemTagName).attr(o.elementTag[n].attr); } //detect for the exclude variable if specified if(o.elementTag[n].exclude !== undefined){ var excluder = new RegExp(o.elementTag[n].exclude); if(excluder.test(elemTagValue) === true){ //increment the value of the excludeFound variable excludeFound = true; } } //Format function if (o.elementTag[n].format !== undefined) { elemTagValue = o.elementTag[n].format(elemTagValue); } //JS Date Format if(o.elementTag[n].dateFormat !== undefined){ elemTagValue = date(o.elementTag[n].dateFormat, elemTagValue); } } }//END processElementValue Function //detect count variable if(o.count !== undefined){ jQuery(o.count).append(parentElementArray.length); } //MAIN LOOP: FOR EACH PARENT ELEMENT for(var i = 0; i < parentElementArray.length; i++){ //detect if number of exclude variable has been satisfied if(numberIncluded >= settings.limit){ $(selected).append(container); if(settings.callback !== undefined){ settings.callback(); } return false; } //define the output variable option var outputVar = o.output; //initiate the exclude variable var excludeFound = false; //SUB LOOP: through each specified 'elementTag' for(var n = 0; n < o.elementTag.length; n++){ //create a regular expression to find the position for the element tag var position = new RegExp('jpet' + [n], 'g'); //detect if the elementTag is a simple string or object if(o.elementTag[n].constructor == String){ processElementValue(o.elementTag[n], parentElementArray[i]); } else if(o.elementTag[n].constructor == Object){ processElementValue(o.elementTag[n].elem, parentElementArray[i]); } //replace the position with the value of the selected element tag outputVar = outputVar.replace(position, elemTagValue); } //END SUB LOOP //append the results to the container if(excludeFound !== true){ container += outputVar; numberIncluded++; } }//END MAIN LOOP //append the results to the selected element $(selected).append(container); //run callback if(settings.callback !== undefined){ settings.callback(); } }; return this.each(function() { $.ajax(settings.ajaxOpts); }); } }); })(jQuery);

To download older versions of jParse, please see the change log.