/*! jQuery v1.7.2 jquery.com | jquery.org/license */ (function(a,b){function cy(a){return f.isWindow(a)?a:a.nodeType===9?a.defaultView||a.parentWindow:!1}function cu(a){if(!cj[a]){var b=c.body,d=f("<"+a+">").appendTo(b),e=d.css("display");d.remove();if(e==="none"||e===""){ck||(ck=c.createElement("iframe"),ck.frameBorder=ck.width=ck.height=0),b.appendChild(ck);if(!cl||!ck.createElement)cl=(ck.contentWindow||ck.contentDocument).document,cl.write((f.support.boxModel?"":"")+""),cl.close();d=cl.createElement(a),cl.body.appendChild(d),e=f.css(d,"display"),b.removeChild(ck)}cj[a]=e}return cj[a]}function ct(a,b){var c={};f.each(cp.concat.apply([],cp.slice(0,b)),function(){c[this]=a});return c}function cs(){cq=b}function cr(){setTimeout(cs,0);return cq=f.now()}function ci(){try{return new a.ActiveXObject("Microsoft.XMLHTTP")}catch(b){}}function ch(){try{return new a.XMLHttpRequest}catch(b){}}function cb(a,c){a.dataFilter&&(c=a.dataFilter(c,a.dataType));var d=a.dataTypes,e={},g,h,i=d.length,j,k=d[0],l,m,n,o,p;for(g=1;g0){if(c!=="border")for(;e=0===c})}function S(a){return!a||!a.parentNode||a.parentNode.nodeType===11}function K(){return!0}function J(){return!1}function n(a,b,c){var d=b+"defer",e=b+"queue",g=b+"mark",h=f._data(a,d);h&&(c==="queue"||!f._data(a,e))&&(c==="mark"||!f._data(a,g))&&setTimeout(function(){!f._data(a,e)&&!f._data(a,g)&&(f.removeData(a,d,!0),h.fire())},0)}function m(a){for(var b in a){if(b==="data"&&f.isEmptyObject(a[b]))continue;if(b!=="toJSON")return!1}return!0}function l(a,c,d){if(d===b&&a.nodeType===1){var e="data-"+c.replace(k,"-$1").toLowerCase();d=a.getAttribute(e);if(typeof d=="string"){try{d=d==="true"?!0:d==="false"?!1:d==="null"?null:f.isNumeric(d)?+d:j.test(d)?f.parseJSON(d):d}catch(g){}f.data(a,c,d)}else d=b}return d}function h(a){var b=g[a]={},c,d;a=a.split(/\s+/);for(c=0,d=a.length;c)[^>]*$|#([\w\-]*)$)/,j=/\S/,k=/^\s+/,l=/\s+$/,m=/^<(\w+)\s*\/?>(?:<\/\1>)?$/,n=/^[\],:{}\s]*$/,o=/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g,p=/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g,q=/(?:^|:|,)(?:\s*\[)+/g,r=/(webkit)[ \/]([\w.]+)/,s=/(opera)(?:.*version)?[ \/]([\w.]+)/,t=/(msie) ([\w.]+)/,u=/(mozilla)(?:.*? rv:([\w.]+))?/,v=/-([a-z]|[0-9])/ig,w=/^-ms-/,x=function(a,b){return(b+"").toUpperCase()},y=d.userAgent,z,A,B,C=Object.prototype.toString,D=Object.prototype.hasOwnProperty,E=Array.prototype.push,F=Array.prototype.slice,G=String.prototype.trim,H=Array.prototype.indexOf,I={};e.fn=e.prototype={constructor:e,init:function(a,d,f){var g,h,j,k;if(!a)return this;if(a.nodeType){this.context=this[0]=a,this.length=1;return this}if(a==="body"&&!d&&c.body){this.context=c,this[0]=c.body,this.selector=a,this.length=1;return this}if(typeof a=="string"){a.charAt(0)!=="<"||a.charAt(a.length-1)!==">"||a.length<3?g=i.exec(a):g=[null,a,null];if(g&&(g[1]||!d)){if(g[1]){d=d instanceof e?d[0]:d,k=d?d.ownerDocument||d:c,j=m.exec(a),j?e.isPlainObject(d)?(a=[c.createElement(j[1])],e.fn.attr.call(a,d,!0)):a=[k.createElement(j[1])]:(j=e.buildFragment([g[1]],[k]),a=(j.cacheable?e.clone(j.fragment):j.fragment).childNodes);return e.merge(this,a)}h=c.getElementById(g[2]);if(h&&h.parentNode){if(h.id!==g[2])return f.find(a);this.length=1,this[0]=h}this.context=c,this.selector=a;return this}return!d||d.jquery?(d||f).find(a):this.constructor(d).find(a)}if(e.isFunction(a))return f.ready(a);a.selector!==b&&(this.selector=a.selector,this.context=a.context);return e.makeArray(a,this)},selector:"",jquery:"1.7.2",length:0,size:function(){return this.length},toArray:function(){return F.call(this,0)},get:function(a){return a==null?this.toArray():a<0?this[this.length+a]:this[a]},pushStack:function(a,b,c){var d=this.constructor();e.isArray(a)?E.apply(d,a):e.merge(d,a),d.prevObject=this,d.context=this.context,b==="find"?d.selector=this.selector+(this.selector?" ":"")+c:b&&(d.selector=this.selector+"."+b+"("+c+")");return d},each:function(a,b){return e.each(this,a,b)},ready:function(a){e.bindReady(),A.add(a);return this},eq:function(a){a=+a;return a===-1?this.slice(a):this.slice(a,a+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(F.apply(this,arguments),"slice",F.call(arguments).join(","))},map:function(a){return this.pushStack(e.map(this,function(b,c){return a.call(b,c,b)}))},end:function(){return this.prevObject||this.constructor(null)},push:E,sort:[].sort,splice:[].splice},e.fn.init.prototype=e.fn,e.extend=e.fn.extend=function(){var a,c,d,f,g,h,i=arguments[0]||{},j=1,k=arguments.length,l=!1;typeof i=="boolean"&&(l=i,i=arguments[1]||{},j=2),typeof i!="object"&&!e.isFunction(i)&&(i={}),k===j&&(i=this,--j);for(;j0)return;A.fireWith(c,[e]),e.fn.trigger&&e(c).trigger("ready").off("ready")}},bindReady:function(){if(!A){A=e.Callbacks("once memory");if(c.readyState==="complete")return setTimeout(e.ready,1);if(c.addEventListener)c.addEventListener("DOMContentLoaded",B,!1),a.addEventListener("load",e.ready,!1);else if(c.attachEvent){c.attachEvent("onreadystatechange",B),a.attachEvent("onload",e.ready);var b=!1;try{b=a.frameElement==null}catch(d){}c.documentElement.doScroll&&b&&J()}}},isFunction:function(a){return e.type(a)==="function"},isArray:Array.isArray||function(a){return e.type(a)==="array"},isWindow:function(a){return a!=null&&a==a.window},isNumeric:function(a){return!isNaN(parseFloat(a))&&isFinite(a)},type:function(a){return a==null?String(a):I[C.call(a)]||"object"},isPlainObject:function(a){if(!a||e.type(a)!=="object"||a.nodeType||e.isWindow(a))return!1;try{if(a.constructor&&!D.call(a,"constructor")&&!D.call(a.constructor.prototype,"isPrototypeOf"))return!1}catch(c){return!1}var d;for(d in a);return d===b||D.call(a,d)},isEmptyObject:function(a){for(var b in a)return!1;return!0},error:function(a){throw new Error(a)},parseJSON:function(b){if(typeof b!="string"||!b)return null;b=e.trim(b);if(a.JSON&&a.JSON.parse)return a.JSON.parse(b);if(n.test(b.replace(o,"@").replace(p,"]").replace(q,"")))return(new Function("return "+b))();e.error("Invalid JSON: "+b)},parseXML:function(c){if(typeof c!="string"||!c)return null;var d,f;try{a.DOMParser?(f=new DOMParser,d=f.parseFromString(c,"text/xml")):(d=new ActiveXObject("Microsoft.XMLDOM"),d.async="false",d.loadXML(c))}catch(g){d=b}(!d||!d.documentElement||d.getElementsByTagName("parsererror").length)&&e.error("Invalid XML: "+c);return d},noop:function(){},globalEval:function(b){b&&j.test(b)&&(a.execScript||function(b){a.eval.call(a,b)})(b)},camelCase:function(a){return a.replace(w,"ms-").replace(v,x)},nodeName:function(a,b){return a.nodeName&&a.nodeName.toUpperCase()===b.toUpperCase()},each:function(a,c,d){var f,g=0,h=a.length,i=h===b||e.isFunction(a);if(d){if(i){for(f in a)if(c.apply(a[f],d)===!1)break}else for(;g0&&a[0]&&a[j-1]||j===0||e.isArray(a));if(k)for(;i1?i.call(arguments,0):b,j.notifyWith(k,e)}}function l(a){return function(c){b[a]=arguments.length>1?i.call(arguments,0):c,--g||j.resolveWith(j,b)}}var b=i.call(arguments,0),c=0,d=b.length,e=Array(d),g=d,h=d,j=d<=1&&a&&f.isFunction(a.promise)?a:f.Deferred(),k=j.promise();if(d>1){for(;c
a",d=p.getElementsByTagName("*"),e=p.getElementsByTagName("a")[0];if(!d||!d.length||!e)return{};g=c.createElement("select"),h=g.appendChild(c.createElement("option")),i=p.getElementsByTagName("input")[0],b={leadingWhitespace:p.firstChild.nodeType===3,tbody:!p.getElementsByTagName("tbody").length,htmlSerialize:!!p.getElementsByTagName("link").length,style:/top/.test(e.getAttribute("style")),hrefNormalized:e.getAttribute("href")==="/a",opacity:/^0.55/.test(e.style.opacity),cssFloat:!!e.style.cssFloat,checkOn:i.value==="on",optSelected:h.selected,getSetAttribute:p.className!=="t",enctype:!!c.createElement("form").enctype,html5Clone:c.createElement("nav").cloneNode(!0).outerHTML!=="<:nav>",submitBubbles:!0,changeBubbles:!0,focusinBubbles:!1,deleteExpando:!0,noCloneEvent:!0,inlineBlockNeedsLayout:!1,shrinkWrapBlocks:!1,reliableMarginRight:!0,pixelMargin:!0},f.boxModel=b.boxModel=c.compatMode==="CSS1Compat",i.checked=!0,b.noCloneChecked=i.cloneNode(!0).checked,g.disabled=!0,b.optDisabled=!h.disabled;try{delete p.test}catch(r){b.deleteExpando=!1}!p.addEventListener&&p.attachEvent&&p.fireEvent&&(p.attachEvent("onclick",function(){b.noCloneEvent=!1}),p.cloneNode(!0).fireEvent("onclick")),i=c.createElement("input"),i.value="t",i.setAttribute("type","radio"),b.radioValue=i.value==="t",i.setAttribute("checked","checked"),i.setAttribute("name","t"),p.appendChild(i),j=c.createDocumentFragment(),j.appendChild(p.lastChild),b.checkClone=j.cloneNode(!0).cloneNode(!0).lastChild.checked,b.appendChecked=i.checked,j.removeChild(i),j.appendChild(p);if(p.attachEvent)for(n in{submit:1,change:1,focusin:1})m="on"+n,o=m in p,o||(p.setAttribute(m,"return;"),o=typeof p[m]=="function"),b[n+"Bubbles"]=o;j.removeChild(p),j=g=h=p=i=null,f(function(){var d,e,g,h,i,j,l,m,n,q,r,s,t,u=c.getElementsByTagName("body")[0];!u||(m=1,t="padding:0;margin:0;border:",r="position:absolute;top:0;left:0;width:1px;height:1px;",s=t+"0;visibility:hidden;",n="style='"+r+t+"5px solid #000;",q="
"+""+"
",d=c.createElement("div"),d.style.cssText=s+"width:0;height:0;position:static;top:0;margin-top:"+m+"px",u.insertBefore(d,u.firstChild),p=c.createElement("div"),d.appendChild(p),p.innerHTML="
t
",k=p.getElementsByTagName("td"),o=k[0].offsetHeight===0,k[0].style.display="",k[1].style.display="none",b.reliableHiddenOffsets=o&&k[0].offsetHeight===0,a.getComputedStyle&&(p.innerHTML="",l=c.createElement("div"),l.style.width="0",l.style.marginRight="0",p.style.width="2px",p.appendChild(l),b.reliableMarginRight=(parseInt((a.getComputedStyle(l,null)||{marginRight:0}).marginRight,10)||0)===0),typeof p.style.zoom!="undefined"&&(p.innerHTML="",p.style.width=p.style.padding="1px",p.style.border=0,p.style.overflow="hidden",p.style.display="inline",p.style.zoom=1,b.inlineBlockNeedsLayout=p.offsetWidth===3,p.style.display="block",p.style.overflow="visible",p.innerHTML="
",b.shrinkWrapBlocks=p.offsetWidth!==3),p.style.cssText=r+s,p.innerHTML=q,e=p.firstChild,g=e.firstChild,i=e.nextSibling.firstChild.firstChild,j={doesNotAddBorder:g.offsetTop!==5,doesAddBorderForTableAndCells:i.offsetTop===5},g.style.position="fixed",g.style.top="20px",j.fixedPosition=g.offsetTop===20||g.offsetTop===15,g.style.position=g.style.top="",e.style.overflow="hidden",e.style.position="relative",j.subtractsBorderForOverflowNotVisible=g.offsetTop===-5,j.doesNotIncludeMarginInBodyOffset=u.offsetTop!==m,a.getComputedStyle&&(p.style.marginTop="1%",b.pixelMargin=(a.getComputedStyle(p,null)||{marginTop:0}).marginTop!=="1%"),typeof d.style.zoom!="undefined"&&(d.style.zoom=1),u.removeChild(d),l=p=d=null,f.extend(b,j))});return b}();var j=/^(?:\{.*\}|\[.*\])$/,k=/([A-Z])/g;f.extend({cache:{},uuid:0,expando:"jQuery"+(f.fn.jquery+Math.random()).replace(/\D/g,""),noData:{embed:!0,object:"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000",applet:!0},hasData:function(a){a=a.nodeType?f.cache[a[f.expando]]:a[f.expando];return!!a&&!m(a)},data:function(a,c,d,e){if(!!f.acceptData(a)){var g,h,i,j=f.expando,k=typeof c=="string",l=a.nodeType,m=l?f.cache:a,n=l?a[j]:a[j]&&j,o=c==="events";if((!n||!m[n]||!o&&!e&&!m[n].data)&&k&&d===b)return;n||(l?a[j]=n=++f.uuid:n=j),m[n]||(m[n]={},l||(m[n].toJSON=f.noop));if(typeof c=="object"||typeof c=="function")e?m[n]=f.extend(m[n],c):m[n].data=f.extend(m[n].data,c);g=h=m[n],e||(h.data||(h.data={}),h=h.data),d!==b&&(h[f.camelCase(c)]=d);if(o&&!h[c])return g.events;k?(i=h[c],i==null&&(i=h[f.camelCase(c)])):i=h;return i}},removeData:function(a,b,c){if(!!f.acceptData(a)){var d,e,g,h=f.expando,i=a.nodeType,j=i?f.cache:a,k=i?a[h]:h;if(!j[k])return;if(b){d=c?j[k]:j[k].data;if(d){f.isArray(b)||(b in d?b=[b]:(b=f.camelCase(b),b in d?b=[b]:b=b.split(" ")));for(e=0,g=b.length;e1,null,!1)},removeData:function(a){return this.each(function(){f.removeData(this,a)})}}),f.extend({_mark:function(a,b){a&&(b=(b||"fx")+"mark",f._data(a,b,(f._data(a,b)||0)+1))},_unmark:function(a,b,c){a!==!0&&(c=b,b=a,a=!1);if(b){c=c||"fx";var d=c+"mark",e=a?0:(f._data(b,d)||1)-1;e?f._data(b,d,e):(f.removeData(b,d,!0),n(b,c,"mark"))}},queue:function(a,b,c){var d;if(a){b=(b||"fx")+"queue",d=f._data(a,b),c&&(!d||f.isArray(c)?d=f._data(a,b,f.makeArray(c)):d.push(c));return d||[]}},dequeue:function(a,b){b=b||"fx";var c=f.queue(a,b),d=c.shift(),e={};d==="inprogress"&&(d=c.shift()),d&&(b==="fx"&&c.unshift("inprogress"),f._data(a,b+".run",e),d.call(a,function(){f.dequeue(a,b)},e)),c.length||(f.removeData(a,b+"queue "+b+".run",!0),n(a,b,"queue"))}}),f.fn.extend({queue:function(a,c){var d=2;typeof a!="string"&&(c=a,a="fx",d--);if(arguments.length1)},removeAttr:function(a){return this.each(function(){f.removeAttr(this,a)})},prop:function(a,b){return f.access(this,f.prop,a,b,arguments.length>1)},removeProp:function(a){a=f.propFix[a]||a;return this.each(function(){try{this[a]=b,delete this[a]}catch(c){}})},addClass:function(a){var b,c,d,e,g,h,i;if(f.isFunction(a))return this.each(function(b){f(this).addClass(a.call(this,b,this.className))});if(a&&typeof a=="string"){b=a.split(p);for(c=0,d=this.length;c-1)return!0;return!1},val:function(a){var c,d,e,g=this[0];{if(!!arguments.length){e=f.isFunction(a);return this.each(function(d){var g=f(this),h;if(this.nodeType===1){e?h=a.call(this,d,g.val()):h=a,h==null?h="":typeof h=="number"?h+="":f.isArray(h)&&(h=f.map(h,function(a){return a==null?"":a+""})),c=f.valHooks[this.type]||f.valHooks[this.nodeName.toLowerCase()];if(!c||!("set"in c)||c.set(this,h,"value")===b)this.value=h}})}if(g){c=f.valHooks[g.type]||f.valHooks[g.nodeName.toLowerCase()];if(c&&"get"in c&&(d=c.get(g,"value"))!==b)return d;d=g.value;return typeof d=="string"?d.replace(q,""):d==null?"":d}}}}),f.extend({valHooks:{option:{get:function(a){var b=a.attributes.value;return!b||b.specified?a.value:a.text}},select:{get:function(a){var b,c,d,e,g=a.selectedIndex,h=[],i=a.options,j=a.type==="select-one";if(g<0)return null;c=j?g:0,d=j?g+1:i.length;for(;c=0}),c.length||(a.selectedIndex=-1);return c}}},attrFn:{val:!0,css:!0,html:!0,text:!0,data:!0,width:!0,height:!0,offset:!0},attr:function(a,c,d,e){var g,h,i,j=a.nodeType;if(!!a&&j!==3&&j!==8&&j!==2){if(e&&c in f.attrFn)return f(a)[c](d);if(typeof a.getAttribute=="undefined")return f.prop(a,c,d);i=j!==1||!f.isXMLDoc(a),i&&(c=c.toLowerCase(),h=f.attrHooks[c]||(u.test(c)?x:w));if(d!==b){if(d===null){f.removeAttr(a,c);return}if(h&&"set"in h&&i&&(g=h.set(a,d,c))!==b)return g;a.setAttribute(c,""+d);return d}if(h&&"get"in h&&i&&(g=h.get(a,c))!==null)return g;g=a.getAttribute(c);return g===null?b:g}},removeAttr:function(a,b){var c,d,e,g,h,i=0;if(b&&a.nodeType===1){d=b.toLowerCase().split(p),g=d.length;for(;i=0}})});var z=/^(?:textarea|input|select)$/i,A=/^([^\.]*)?(?:\.(.+))?$/,B=/(?:^|\s)hover(\.\S+)?\b/,C=/^key/,D=/^(?:mouse|contextmenu)|click/,E=/^(?:focusinfocus|focusoutblur)$/,F=/^(\w*)(?:#([\w\-]+))?(?:\.([\w\-]+))?$/,G=function( a){var b=F.exec(a);b&&(b[1]=(b[1]||"").toLowerCase(),b[3]=b[3]&&new RegExp("(?:^|\\s)"+b[3]+"(?:\\s|$)"));return b},H=function(a,b){var c=a.attributes||{};return(!b[1]||a.nodeName.toLowerCase()===b[1])&&(!b[2]||(c.id||{}).value===b[2])&&(!b[3]||b[3].test((c["class"]||{}).value))},I=function(a){return f.event.special.hover?a:a.replace(B,"mouseenter$1 mouseleave$1")};f.event={add:function(a,c,d,e,g){var h,i,j,k,l,m,n,o,p,q,r,s;if(!(a.nodeType===3||a.nodeType===8||!c||!d||!(h=f._data(a)))){d.handler&&(p=d,d=p.handler,g=p.selector),d.guid||(d.guid=f.guid++),j=h.events,j||(h.events=j={}),i=h.handle,i||(h.handle=i=function(a){return typeof f!="undefined"&&(!a||f.event.triggered!==a.type)?f.event.dispatch.apply(i.elem,arguments):b},i.elem=a),c=f.trim(I(c)).split(" ");for(k=0;k=0&&(h=h.slice(0,-1),k=!0),h.indexOf(".")>=0&&(i=h.split("."),h=i.shift(),i.sort());if((!e||f.event.customEvent[h])&&!f.event.global[h])return;c=typeof c=="object"?c[f.expando]?c:new f.Event(h,c):new f.Event(h),c.type=h,c.isTrigger=!0,c.exclusive=k,c.namespace=i.join("."),c.namespace_re=c.namespace?new RegExp("(^|\\.)"+i.join("\\.(?:.*\\.)?")+"(\\.|$)"):null,o=h.indexOf(":")<0?"on"+h:"";if(!e){j=f.cache;for(l in j)j[l].events&&j[l].events[h]&&f.event.trigger(c,d,j[l].handle.elem,!0);return}c.result=b,c.target||(c.target=e),d=d!=null?f.makeArray(d):[],d.unshift(c),p=f.event.special[h]||{};if(p.trigger&&p.trigger.apply(e,d)===!1)return;r=[[e,p.bindType||h]];if(!g&&!p.noBubble&&!f.isWindow(e)){s=p.delegateType||h,m=E.test(s+h)?e:e.parentNode,n=null;for(;m;m=m.parentNode)r.push([m,s]),n=m;n&&n===e.ownerDocument&&r.push([n.defaultView||n.parentWindow||a,s])}for(l=0;le&&j.push({elem:this,matches:d.slice(e)});for(k=0;k0?this.on(b,null,a,c):this.trigger(b)},f.attrFn&&(f.attrFn[b]=!0),C.test(b)&&(f.event.fixHooks[b]=f.event.keyHooks),D.test(b)&&(f.event.fixHooks[b]=f.event.mouseHooks)}),function(){function x(a,b,c,e,f,g){for(var h=0,i=e.length;h0){k=j;break}}j=j[a]}e[h]=k}}}function w(a,b,c,e,f,g){for(var h=0,i=e.length;h+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g,d="sizcache"+(Math.random()+"").replace(".",""),e=0,g=Object.prototype.toString,h=!1,i=!0,j=/\\/g,k=/\r\n/g,l=/\W/;[0,0].sort(function(){i=!1;return 0});var m=function(b,d,e,f){e=e||[],d=d||c;var h=d;if(d.nodeType!==1&&d.nodeType!==9)return[];if(!b||typeof b!="string")return e;var i,j,k,l,n,q,r,t,u=!0,v=m.isXML(d),w=[],x=b;do{a.exec(""),i=a.exec(x);if(i){x=i[3],w.push(i[1]);if(i[2]){l=i[3];break}}}while(i);if(w.length>1&&p.exec(b))if(w.length===2&&o.relative[w[0]])j=y(w[0]+w[1],d,f);else{j=o.relative[w[0]]?[d]:m(w.shift(),d);while(w.length)b=w.shift(),o.relative[b]&&(b+=w.shift()),j=y(b,j,f)}else{!f&&w.length>1&&d.nodeType===9&&!v&&o.match.ID.test(w[0])&&!o.match.ID.test(w[w.length-1])&&(n=m.find(w.shift(),d,v),d=n.expr?m.filter(n.expr,n.set)[0]:n.set[0]);if(d){n=f?{expr:w.pop(),set:s(f)}:m.find(w.pop(),w.length===1&&(w[0]==="~"||w[0]==="+")&&d.parentNode?d.parentNode:d,v),j=n.expr?m.filter(n.expr,n.set):n.set,w.length>0?k=s(j):u=!1;while(w.length)q=w.pop(),r=q,o.relative[q]?r=w.pop():q="",r==null&&(r=d),o.relative[q](k,r,v)}else k=w=[]}k||(k=j),k||m.error(q||b);if(g.call(k)==="[object Array]")if(!u)e.push.apply(e,k);else if(d&&d.nodeType===1)for(t=0;k[t]!=null;t++)k[t]&&(k[t]===!0||k[t].nodeType===1&&m.contains(d,k[t]))&&e.push(j[t]);else for(t=0;k[t]!=null;t++)k[t]&&k[t].nodeType===1&&e.push(j[t]);else s(k,e);l&&(m(l,h,e,f),m.uniqueSort(e));return e};m.uniqueSort=function(a){if(u){h=i,a.sort(u);if(h)for(var b=1;b0},m.find=function(a,b,c){var d,e,f,g,h,i;if(!a)return[];for(e=0,f=o.order.length;e":function(a,b){var c,d=typeof b=="string",e=0,f=a.length;if(d&&!l.test(b)){b=b.toLowerCase();for(;e=0)?c||d.push(h):c&&(b[g]=!1));return!1},ID:function(a){return a[1].replace(j,"")},TAG:function(a,b){return a[1].replace(j,"").toLowerCase()},CHILD:function(a){if(a[1]==="nth"){a[2]||m.error(a[0]),a[2]=a[2].replace(/^\+|\s*/g,"");var b=/(-?)(\d*)(?:n([+\-]?\d*))?/.exec(a[2]==="even"&&"2n"||a[2]==="odd"&&"2n+1"||!/\D/.test(a[2])&&"0n+"+a[2]||a[2]);a[2]=b[1]+(b[2]||1)-0,a[3]=b[3]-0}else a[2]&&m.error(a[0]);a[0]=e++;return a},ATTR:function(a,b,c,d,e,f){var g=a[1]=a[1].replace(j,"");!f&&o.attrMap[g]&&(a[1]=o.attrMap[g]),a[4]=(a[4]||a[5]||"").replace(j,""),a[2]==="~="&&(a[4]=" "+a[4]+" ");return a},PSEUDO:function(b,c,d,e,f){if(b[1]==="not")if((a.exec(b[3])||"").length>1||/^\w/.test(b[3]))b[3]=m(b[3],null,null,c);else{var g=m.filter(b[3],c,d,!0^f);d||e.push.apply(e,g);return!1}else if(o.match.POS.test(b[0])||o.match.CHILD.test(b[0]))return!0;return b},POS:function(a){a.unshift(!0);return a}},filters:{enabled:function(a){return a.disabled===!1&&a.type!=="hidden"},disabled:function(a){return a.disabled===!0},checked:function(a){return a.checked===!0},selected:function(a){a.parentNode&&a.parentNode.selectedIndex;return a.selected===!0},parent:function(a){return!!a.firstChild},empty:function(a){return!a.firstChild},has:function(a,b,c){return!!m(c[3],a).length},header:function(a){return/h\d/i.test(a.nodeName)},text:function(a){var b=a.getAttribute("type"),c=a.type;return a.nodeName.toLowerCase()==="input"&&"text"===c&&(b===c||b===null)},radio:function(a){return a.nodeName.toLowerCase()==="input"&&"radio"===a.type},checkbox:function(a){return a.nodeName.toLowerCase()==="input"&&"checkbox"===a.type},file:function(a){return a.nodeName.toLowerCase()==="input"&&"file"===a.type},password:function(a){return a.nodeName.toLowerCase()==="input"&&"password"===a.type},submit:function(a){var b=a.nodeName.toLowerCase();return(b==="input"||b==="button")&&"submit"===a.type},image:function(a){return a.nodeName.toLowerCase()==="input"&&"image"===a.type},reset:function(a){var b=a.nodeName.toLowerCase();return(b==="input"||b==="button")&&"reset"===a.type},button:function(a){var b=a.nodeName.toLowerCase();return b==="input"&&"button"===a.type||b==="button"},input:function(a){return/input|select|textarea|button/i.test(a.nodeName)},focus:function(a){return a===a.ownerDocument.activeElement}},setFilters:{first:function(a,b){return b===0},last:function(a,b,c,d){return b===d.length-1},even:function(a,b){return b%2===0},odd:function(a,b){return b%2===1},lt:function(a,b,c){return bc[3]-0},nth:function(a,b,c){return c[3]-0===b},eq:function(a,b,c){return c[3]-0===b}},filter:{PSEUDO:function(a,b,c,d){var e=b[1],f=o.filters[e];if(f)return f(a,c,b,d);if(e==="contains")return(a.textContent||a.innerText||n([a])||"").indexOf(b[3])>=0;if(e==="not"){var g=b[3];for(var h=0,i=g.length;h=0}},ID:function(a,b){return a.nodeType===1&&a.getAttribute("id")===b},TAG:function(a,b){return b==="*"&&a.nodeType===1||!!a.nodeName&&a.nodeName.toLowerCase()===b},CLASS:function(a,b){return(" "+(a.className||a.getAttribute("class"))+" ").indexOf(b)>-1},ATTR:function(a,b){var c=b[1],d=m.attr?m.attr(a,c):o.attrHandle[c]?o.attrHandle[c](a):a[c]!=null?a[c]:a.getAttribute(c),e=d+"",f=b[2],g=b[4];return d==null?f==="!=":!f&&m.attr?d!=null:f==="="?e===g:f==="*="?e.indexOf(g)>=0:f==="~="?(" "+e+" ").indexOf(g)>=0:g?f==="!="?e!==g:f==="^="?e.indexOf(g)===0:f==="$="?e.substr(e.length-g.length)===g:f==="|="?e===g||e.substr(0,g.length+1)===g+"-":!1:e&&d!==!1},POS:function(a,b,c,d){var e=b[2],f=o.setFilters[e];if(f)return f(a,c,b,d)}}},p=o.match.POS,q=function(a,b){return"\\"+(b-0+1)};for(var r in o.match)o.match[r]=new RegExp(o.match[r].source+/(?![^\[]*\])(?![^\(]*\))/.source),o.leftMatch[r]=new RegExp(/(^(?:.|\r|\n)*?)/.source+o.match[r].source.replace(/\\(\d+)/g,q));o.match.globalPOS=p;var s=function(a,b){a=Array.prototype.slice.call(a,0);if(b){b.push.apply(b,a);return b}return a};try{Array.prototype.slice.call(c.documentElement.childNodes,0)[0].nodeType}catch(t){s=function(a,b){var c=0,d=b||[];if(g.call(a)==="[object Array]")Array.prototype.push.apply(d,a);else if(typeof a.length=="number")for(var e=a.length;c",e.insertBefore(a,e.firstChild),c.getElementById(d)&&(o.find.ID=function(a,c,d){if(typeof c.getElementById!="undefined"&&!d){var e=c.getElementById(a[1]);return e?e.id===a[1]||typeof e.getAttributeNode!="undefined"&&e.getAttributeNode("id").nodeValue===a[1]?[e]:b:[]}},o.filter.ID=function(a,b){var c=typeof a.getAttributeNode!="undefined"&&a.getAttributeNode("id");return a.nodeType===1&&c&&c.nodeValue===b}),e.removeChild(a),e=a=null}(),function(){var a=c.createElement("div");a.appendChild(c.createComment("")),a.getElementsByTagName("*").length>0&&(o.find.TAG=function(a,b){var c=b.getElementsByTagName(a[1]);if(a[1]==="*"){var d=[];for(var e=0;c[e];e++)c[e].nodeType===1&&d.push(c[e]);c=d}return c}),a.innerHTML="",a.firstChild&&typeof a.firstChild.getAttribute!="undefined"&&a.firstChild.getAttribute("href")!=="#"&&(o.attrHandle.href=function(a){return a.getAttribute("href",2)}),a=null}(),c.querySelectorAll&&function(){var a=m,b=c.createElement("div"),d="__sizzle__";b.innerHTML="

";if(!b.querySelectorAll||b.querySelectorAll(".TEST").length!==0){m=function(b,e,f,g){e=e||c;if(!g&&!m.isXML(e)){var h=/^(\w+$)|^\.([\w\-]+$)|^#([\w\-]+$)/.exec(b);if(h&&(e.nodeType===1||e.nodeType===9)){if(h[1])return s(e.getElementsByTagName(b),f);if(h[2]&&o.find.CLASS&&e.getElementsByClassName)return s(e.getElementsByClassName(h[2]),f)}if(e.nodeType===9){if(b==="body"&&e.body)return s([e.body],f);if(h&&h[3]){var i=e.getElementById(h[3]);if(!i||!i.parentNode)return s([],f);if(i.id===h[3])return s([i],f)}try{return s(e.querySelectorAll(b),f)}catch(j){}}else if(e.nodeType===1&&e.nodeName.toLowerCase()!=="object"){var k=e,l=e.getAttribute("id"),n=l||d,p=e.parentNode,q=/^\s*[+~]/.test(b);l?n=n.replace(/'/g,"\\$&"):e.setAttribute("id",n),q&&p&&(e=e.parentNode);try{if(!q||p)return s(e.querySelectorAll("[id='"+n+"'] "+b),f)}catch(r){}finally{l||k.removeAttribute("id")}}}return a(b,e,f,g)};for(var e in a)m[e]=a[e];b=null}}(),function(){var a=c.documentElement,b=a.matchesSelector||a.mozMatchesSelector||a.webkitMatchesSelector||a.msMatchesSelector;if(b){var d=!b.call(c.createElement("div"),"div"),e=!1;try{b.call(c.documentElement,"[test!='']:sizzle")}catch(f){e=!0}m.matchesSelector=function(a,c){c=c.replace(/\=\s*([^'"\]]*)\s*\]/g,"='$1']");if(!m.isXML(a))try{if(e||!o.match.PSEUDO.test(c)&&!/!=/.test(c)){var f=b.call(a,c);if(f||!d||a.document&&a.document.nodeType!==11)return f}}catch(g){}return m(c,null,null,[a]).length>0}}}(),function(){var a=c.createElement("div");a.innerHTML="
";if(!!a.getElementsByClassName&&a.getElementsByClassName("e").length!==0){a.lastChild.className="e";if(a.getElementsByClassName("e").length===1)return;o.order.splice(1,0,"CLASS"),o.find.CLASS=function(a,b,c){if(typeof b.getElementsByClassName!="undefined"&&!c)return b.getElementsByClassName(a[1])},a=null}}(),c.documentElement.contains?m.contains=function(a,b){return a!==b&&(a.contains?a.contains(b):!0)}:c.documentElement.compareDocumentPosition?m.contains=function(a,b){return!!(a.compareDocumentPosition(b)&16)}:m.contains=function(){return!1},m.isXML=function(a){var b=(a?a.ownerDocument||a:0).documentElement;return b?b.nodeName!=="HTML":!1};var y=function(a,b,c){var d,e=[],f="",g=b.nodeType?[b]:b;while(d=o.match.PSEUDO.exec(a))f+=d[0],a=a.replace(o.match.PSEUDO,"");a=o.relative[a]?a+"*":a;for(var h=0,i=g.length;h0)for(h=g;h=0:f.filter(a,this).length>0:this.filter(a).length>0)},closest:function(a,b){var c=[],d,e,g=this[0];if(f.isArray(a)){var h=1;while(g&&g.ownerDocument&&g!==b){for(d=0;d-1:f.find.matchesSelector(g,a)){c.push(g);break}g=g.parentNode;if(!g||!g.ownerDocument||g===b||g.nodeType===11)break}}c=c.length>1?f.unique(c):c;return this.pushStack(c,"closest",a)},index:function(a){if(!a)return this[0]&&this[0].parentNode?this.prevAll().length:-1;if(typeof a=="string")return f.inArray(this[0],f(a));return f.inArray(a.jquery?a[0]:a,this)},add:function(a,b){var c=typeof a=="string"?f(a,b):f.makeArray(a&&a.nodeType?[a]:a),d=f.merge(this.get(),c);return this.pushStack(S(c[0])||S(d[0])?d:f.unique(d))},andSelf:function(){return this.add(this.prevObject)}}),f.each({parent:function(a){var b=a.parentNode;return b&&b.nodeType!==11?b:null},parents:function(a){return f.dir(a,"parentNode")},parentsUntil:function(a,b,c){return f.dir(a,"parentNode",c)},next:function(a){return f.nth(a,2,"nextSibling")},prev:function(a){return f.nth(a,2,"previousSibling")},nextAll:function(a){return f.dir(a,"nextSibling")},prevAll:function(a){return f.dir(a,"previousSibling")},nextUntil:function(a,b,c){return f.dir(a,"nextSibling",c)},prevUntil:function(a,b,c){return f.dir(a,"previousSibling",c)},siblings:function(a){return f.sibling((a.parentNode||{}).firstChild,a)},children:function(a){return f.sibling(a.firstChild)},contents:function(a){return f.nodeName(a,"iframe")?a.contentDocument||a.contentWindow.document:f.makeArray(a.childNodes)}},function(a,b){f.fn[a]=function(c,d){var e=f.map(this,b,c);L.test(a)||(d=c),d&&typeof d=="string"&&(e=f.filter(d,e)),e=this.length>1&&!R[a]?f.unique(e):e,(this.length>1||N.test(d))&&M.test(a)&&(e=e.reverse());return this.pushStack(e,a,P.call(arguments).join(","))}}),f.extend({filter:function(a,b,c){c&&(a=":not("+a+")");return b.length===1?f.find.matchesSelector(b[0],a)?[b[0]]:[]:f.find.matches(a,b)},dir:function(a,c,d){var e=[],g=a[c];while(g&&g.nodeType!==9&&(d===b||g.nodeType!==1||!f(g).is(d)))g.nodeType===1&&e.push(g),g=g[c];return e},nth:function(a,b,c,d){b=b||1;var e=0;for(;a;a=a[c])if(a.nodeType===1&&++e===b)break;return a},sibling:function(a,b){var c=[];for(;a;a=a.nextSibling)a.nodeType===1&&a!==b&&c.push(a);return c}});var V="abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",W=/ jQuery\d+="(?:\d+|null)"/g,X=/^\s+/,Y=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig,Z=/<([\w:]+)/,$=/]","i"),bd=/checked\s*(?:[^=]|=\s*.checked.)/i,be=/\/(java|ecma)script/i,bf=/^\s*",""],legend:[1,"
","
"],thead:[1,"","
"],tr:[2,"","
"],td:[3,"","
"],col:[2,"","
"],area:[1,"",""],_default:[0,"",""]},bh=U(c);bg.optgroup=bg.option,bg.tbody=bg.tfoot=bg.colgroup=bg.caption=bg.thead,bg.th=bg.td,f.support.htmlSerialize||(bg._default=[1,"div
","
"]),f.fn.extend({text:function(a){return f.access(this,function(a){return a===b?f.text(this):this.empty().append((this[0]&&this[0].ownerDocument||c).createTextNode(a))},null,a,arguments.length)},wrapAll:function(a){if(f.isFunction(a))return this.each(function(b){f(this).wrapAll(a.call(this,b))});if(this[0]){var b=f(a,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&b.insertBefore(this[0]),b.map(function(){var a=this;while(a.firstChild&&a.firstChild.nodeType===1)a=a.firstChild;return a}).append(this)}return this},wrapInner:function(a){if(f.isFunction(a))return this.each(function(b){f(this).wrapInner(a.call(this,b))});return this.each(function(){var b=f(this),c=b.contents();c.length?c.wrapAll(a):b.append(a)})},wrap:function(a){var b=f.isFunction(a);return this.each(function(c){f(this).wrapAll(b?a.call(this,c):a)})},unwrap:function(){return this.parent().each(function(){f.nodeName(this,"body")||f(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,!0,function(a){this.nodeType===1&&this.appendChild(a)})},prepend:function(){return this.domManip(arguments,!0,function(a){this.nodeType===1&&this.insertBefore(a,this.firstChild)})},before:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,!1,function(a){this.parentNode.insertBefore(a,this)});if(arguments.length){var a=f .clean(arguments);a.push.apply(a,this.toArray());return this.pushStack(a,"before",arguments)}},after:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,!1,function(a){this.parentNode.insertBefore(a,this.nextSibling)});if(arguments.length){var a=this.pushStack(this,"after",arguments);a.push.apply(a,f.clean(arguments));return a}},remove:function(a,b){for(var c=0,d;(d=this[c])!=null;c++)if(!a||f.filter(a,[d]).length)!b&&d.nodeType===1&&(f.cleanData(d.getElementsByTagName("*")),f.cleanData([d])),d.parentNode&&d.parentNode.removeChild(d);return this},empty:function(){for(var a=0,b;(b=this[a])!=null;a++){b.nodeType===1&&f.cleanData(b.getElementsByTagName("*"));while(b.firstChild)b.removeChild(b.firstChild)}return this},clone:function(a,b){a=a==null?!1:a,b=b==null?a:b;return this.map(function(){return f.clone(this,a,b)})},html:function(a){return f.access(this,function(a){var c=this[0]||{},d=0,e=this.length;if(a===b)return c.nodeType===1?c.innerHTML.replace(W,""):null;if(typeof a=="string"&&!ba.test(a)&&(f.support.leadingWhitespace||!X.test(a))&&!bg[(Z.exec(a)||["",""])[1].toLowerCase()]){a=a.replace(Y,"<$1>");try{for(;d1&&l0?this.clone(!0):this).get();f(e[h])[b](j),d=d.concat(j)}return this.pushStack(d,a,e.selector)}}),f.extend({clone:function(a,b,c){var d,e,g,h=f.support.html5Clone||f.isXMLDoc(a)||!bc.test("<"+a.nodeName+">")?a.cloneNode(!0):bo(a);if((!f.support.noCloneEvent||!f.support.noCloneChecked)&&(a.nodeType===1||a.nodeType===11)&&!f.isXMLDoc(a)){bk(a,h),d=bl(a),e=bl(h);for(g=0;d[g];++g)e[g]&&bk(d[g],e[g])}if(b){bj(a,h);if(c){d=bl(a),e=bl(h);for(g=0;d[g];++g)bj(d[g],e[g])}}d=e=null;return h},clean:function(a,b,d,e){var g,h,i,j=[];b=b||c,typeof b.createElement=="undefined"&&(b=b.ownerDocument||b[0]&&b[0].ownerDocument||c);for(var k=0,l;(l=a[k])!=null;k++){typeof l=="number"&&(l+="");if(!l)continue;if(typeof l=="string")if(!_.test(l))l=b.createTextNode(l);else{l=l.replace(Y,"<$1>");var m=(Z.exec(l)||["",""])[1].toLowerCase(),n=bg[m]||bg._default,o=n[0],p=b.createElement("div"),q=bh.childNodes,r;b===c?bh.appendChild(p):U(b).appendChild(p),p.innerHTML=n[1]+l+n[2];while(o--)p=p.lastChild;if(!f.support.tbody){var s=$.test(l),t=m==="table"&&!s?p.firstChild&&p.firstChild.childNodes:n[1]===""&&!s?p.childNodes:[];for(i=t.length-1;i>=0;--i)f.nodeName(t[i],"tbody")&&!t[i].childNodes.length&&t[i].parentNode.removeChild(t[i])}!f.support.leadingWhitespace&&X.test(l)&&p.insertBefore(b.createTextNode(X.exec(l)[0]),p.firstChild),l=p.childNodes,p&&(p.parentNode.removeChild(p),q.length>0&&(r=q[q.length-1],r&&r.parentNode&&r.parentNode.removeChild(r)))}var u;if(!f.support.appendChecked)if(l[0]&&typeof (u=l.length)=="number")for(i=0;i1)},f.extend({cssHooks:{opacity:{get:function(a,b){if(b){var c=by(a,"opacity");return c===""?"1":c}return a.style.opacity}}},cssNumber:{fillOpacity:!0,fontWeight:!0,lineHeight:!0,opacity:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{"float":f.support.cssFloat?"cssFloat":"styleFloat"},style:function(a,c,d,e){if(!!a&&a.nodeType!==3&&a.nodeType!==8&&!!a.style){var g,h,i=f.camelCase(c),j=a.style,k=f.cssHooks[i];c=f.cssProps[i]||i;if(d===b){if(k&&"get"in k&&(g=k.get(a,!1,e))!==b)return g;return j[c]}h=typeof d,h==="string"&&(g=bu.exec(d))&&(d=+(g[1]+1)*+g[2]+parseFloat(f.css(a,c)),h="number");if(d==null||h==="number"&&isNaN(d))return;h==="number"&&!f.cssNumber[i]&&(d+="px");if(!k||!("set"in k)||(d=k.set(a,d))!==b)try{j[c]=d}catch(l){}}},css:function(a,c,d){var e,g;c=f.camelCase(c),g=f.cssHooks[c],c=f.cssProps[c]||c,c==="cssFloat"&&(c="float");if(g&&"get"in g&&(e=g.get(a,!0,d))!==b)return e;if(by)return by(a,c)},swap:function(a,b,c){var d={},e,f;for(f in b)d[f]=a.style[f],a.style[f]=b[f];e=c.call(a);for(f in b)a.style[f]=d[f];return e}}),f.curCSS=f.css,c.defaultView&&c.defaultView.getComputedStyle&&(bz=function(a,b){var c,d,e,g,h=a.style;b=b.replace(br,"-$1").toLowerCase(),(d=a.ownerDocument.defaultView)&&(e=d.getComputedStyle(a,null))&&(c=e.getPropertyValue(b),c===""&&!f.contains(a.ownerDocument.documentElement,a)&&(c=f.style(a,b))),!f.support.pixelMargin&&e&&bv.test(b)&&bt.test(c)&&(g=h.width,h.width=c,c=e.width,h.width=g);return c}),c.documentElement.currentStyle&&(bA=function(a,b){var c,d,e,f=a.currentStyle&&a.currentStyle[b],g=a.style;f==null&&g&&(e=g[b])&&(f=e),bt.test(f)&&(c=g.left,d=a.runtimeStyle&&a.runtimeStyle.left,d&&(a.runtimeStyle.left=a.currentStyle.left),g.left=b==="fontSize"?"1em":f,f=g.pixelLeft+"px",g.left=c,d&&(a.runtimeStyle.left=d));return f===""?"auto":f}),by=bz||bA,f.each(["height","width"],function(a,b){f.cssHooks[b]={get:function(a,c,d){if(c)return a.offsetWidth!==0?bB(a,b,d):f.swap(a,bw,function(){return bB(a,b,d)})},set:function(a,b){return bs.test(b)?b+"px":b}}}),f.support.opacity||(f.cssHooks.opacity={get:function(a,b){return bq.test((b&&a.currentStyle?a.currentStyle.filter:a.style.filter)||"")?parseFloat(RegExp.$1)/100+"":b?"1":""},set:function(a,b){var c=a.style,d=a.currentStyle,e=f.isNumeric(b)?"alpha(opacity="+b*100+")":"",g=d&&d.filter||c.filter||"";c.zoom=1;if(b>=1&&f.trim(g.replace(bp,""))===""){c.removeAttribute("filter");if(d&&!d.filter)return}c.filter=bp.test(g)?g.replace(bp,e):g+" "+e}}),f(function(){f.support.reliableMarginRight||(f.cssHooks.marginRight={get:function(a,b){return f.swap(a,{display:"inline-block"},function(){return b?by(a,"margin-right"):a.style.marginRight})}})}),f.expr&&f.expr.filters&&(f.expr.filters.hidden=function(a){var b=a.offsetWidth,c=a.offsetHeight;return b===0&&c===0||!f.support.reliableHiddenOffsets&&(a.style&&a.style.display||f.css(a,"display"))==="none"},f.expr.filters.visible=function(a){return!f.expr.filters.hidden(a)}),f.each({margin:"",padding:"",border:"Width"},function(a,b){f.cssHooks[a+b]={expand:function(c){var d,e=typeof c=="string"?c.split(" "):[c],f={};for(d=0;d<4;d++)f[a+bx[d]+b]=e[d]||e[d-2]||e[0];return f}}});var bC=/%20/g,bD=/\[\]$/,bE=/\r?\n/g,bF=/#.*$/,bG=/^(.*?):[ \t]*([^\r\n]*)\r?$/mg,bH=/^(?:color|date|datetime|datetime-local|email|hidden|month|number|password|range|search|tel|text|time|url|week)$/i,bI=/^(?:about|app|app\-storage|.+\-extension|file|res|widget):$/,bJ=/^(?:GET|HEAD)$/,bK=/^\/\//,bL=/\?/,bM=/)<[^<]*)*<\/script>/gi,bN=/^(?:select|textarea)/i,bO=/\s+/,bP=/([?&])_=[^&]*/,bQ=/^([\w\+\.\-]+:)(?:\/\/([^\/?#:]*)(?::(\d+))?)?/,bR=f.fn.load,bS={},bT={},bU,bV,bW=["*/"]+["*"];try{bU=e.href}catch(bX){bU=c.createElement("a"),bU.href="",bU=bU.href}bV=bQ.exec(bU.toLowerCase())||[],f.fn.extend({load:function(a,c,d){if(typeof a!="string"&&bR)return bR.apply(this,arguments);if(!this.length)return this;var e=a.indexOf(" ");if(e>=0){var g=a.slice(e,a.length);a=a.slice(0,e)}var h="GET";c&&(f.isFunction(c)?(d=c,c=b):typeof c=="object"&&(c=f.param(c,f.ajaxSettings.traditional),h="POST"));var i=this;f.ajax({url:a,type:h,dataType:"html",data:c,complete:function(a,b,c){c=a.responseText,a.isResolved()&&(a.done(function(a){c=a}),i.html(g?f("
").append(c.replace(bM,"")).find(g):c)),d&&i.each(d,[c,b,a])}});return this},serialize:function(){return f.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?f.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||bN.test(this.nodeName)||bH.test(this.type))}).map(function(a,b){var c=f(this).val();return c==null?null:f.isArray(c)?f.map(c,function(a,c){return{name:b.name,value:a.replace(bE,"\r\n")}}):{name:b.name,value:c.replace(bE,"\r\n")}}).get()}}),f.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "),function(a,b){f.fn[b]=function(a){return this.on(b,a)}}),f.each(["get","post"],function(a,c){f[c]=function(a,d,e,g){f.isFunction(d)&&(g=g||e,e=d,d=b);return f.ajax({type:c,url:a,data:d,success:e,dataType:g})}}),f.extend({getScript:function(a,c){return f.get(a,b,c,"script")},getJSON:function(a,b,c){return f.get(a,b,c,"json")},ajaxSetup:function(a,b){b?b$(a,f.ajaxSettings):(b=a,a=f.ajaxSettings),b$(a,b);return a},ajaxSettings:{url:bU,isLocal:bI.test(bV[1]),global:!0,type:"GET",contentType:"application/x-www-form-urlencoded; charset=UTF-8",processData:!0,async:!0,accepts:{xml:"application/xml, text/xml",html:"text/html",text:"text/plain",json:"application/json, text/javascript","*":bW},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText"},converters:{"* text":a.String,"text html":!0,"text json":f.parseJSON,"text xml":f.parseXML},flatOptions:{context:!0,url:!0}},ajaxPrefilter:bY(bS),ajaxTransport:bY(bT),ajax:function(a,c){function w(a,c,l,m){if(s!==2){s=2,q&&clearTimeout(q),p=b,n=m||"",v.readyState=a>0?4:0;var o,r,u,w=c,x=l?ca(d,v,l):b,y,z;if(a>=200&&a<300||a===304){if(d.ifModified){if(y=v.getResponseHeader("Last-Modified"))f.lastModified[k]=y;if(z=v.getResponseHeader("Etag"))f.etag[k]=z}if(a===304)w="notmodified",o=!0;else try{r=cb(d,x),w="success",o=!0}catch(A){w="parsererror",u=A}}else{u=w;if(!w||a)w="error",a<0&&(a=0)}v.status=a,v.statusText=""+(c||w),o?h.resolveWith(e,[r,w,v]):h.rejectWith(e,[v,w,u]),v.statusCode(j),j=b,t&&g.trigger("ajax"+(o?"Success":"Error"),[v,d,o?r:u]),i.fireWith(e,[v,w]),t&&(g.trigger("ajaxComplete",[v,d]),--f.active||f.event.trigger("ajaxStop"))}}typeof a=="object"&&(c=a,a=b),c=c||{};var d=f.ajaxSetup({},c),e=d.context||d,g=e!==d&&(e.nodeType||e instanceof f)?f(e):f.event,h=f.Deferred(),i=f.Callbacks("once memory"),j=d.statusCode||{},k,l={},m={},n,o,p,q,r,s=0,t,u,v={readyState:0,setRequestHeader:function(a,b){if(!s){var c=a.toLowerCase();a=m[c]=m[c]||a,l[a]=b}return this},getAllResponseHeaders:function(){return s===2?n:null},getResponseHeader:function(a){var c;if(s===2){if(!o){o={};while(c=bG.exec(n))o[c[1].toLowerCase()]=c[2]}c=o[a.toLowerCase()]}return c===b?null:c},overrideMimeType:function(a){s||(d.mimeType=a);return this},abort:function(a){a=a||"abort",p&&p.abort(a),w(0,a);return this}};h.promise(v),v.success=v.done,v.error=v.fail,v.complete=i.add,v.statusCode=function(a){if(a){var b;if(s<2)for(b in a)j[b]=[j[b],a[b]];else b=a[v.status],v.then(b,b)}return this},d.url=((a||d.url)+"").replace(bF,"").replace(bK,bV[1]+"//"),d.dataTypes=f.trim(d.dataType||"*").toLowerCase().split(bO),d.crossDomain==null&&(r=bQ.exec(d.url.toLowerCase()),d.crossDomain=!(!r||r[1]==bV[1]&&r[2]==bV[2]&&(r[3]||(r[1]==="http:"?80:443))==(bV[3]||(bV[1]==="http:"?80:443)))),d.data&&d.processData&&typeof d.data!="string"&&(d.data=f.param(d.data,d.traditional)),bZ(bS,d,c,v);if(s===2)return!1;t=d.global,d.type=d.type.toUpperCase(),d.hasContent=!bJ.test(d.type),t&&f.active++===0&&f.event.trigger("ajaxStart");if(!d.hasContent){d.data&&(d.url+=(bL.test(d.url)?"&":"?")+d.data,delete d.data),k=d.url;if(d.cache===!1){var x=f.now(),y=d.url.replace(bP,"$1_="+x);d.url=y+(y===d.url?(bL.test(d.url)?"&":"?")+"_="+x:"")}}(d.data&&d.hasContent&&d.contentType!==!1||c.contentType)&&v.setRequestHeader("Content-Type",d.contentType),d.ifModified&&(k=k||d.url,f.lastModified[k]&&v.setRequestHeader("If-Modified-Since",f.lastModified[k]),f.etag[k]&&v.setRequestHeader("If-None-Match",f.etag[k])),v.setRequestHeader("Accept",d.dataTypes[0]&&d.accepts[d.dataTypes[0]]?d.accepts[d.dataTypes[0]]+(d.dataTypes[0]!=="*"?", "+bW+"; q=0.01":""):d.accepts["*"]);for(u in d.headers)v.setRequestHeader(u,d.headers[u]);if(d.beforeSend&&(d.beforeSend.call(e,v,d)===!1||s===2)){v.abort();return!1}for(u in{success:1,error:1,complete:1})v[u](d[u]);p=bZ(bT,d,c,v);if(!p)w(-1,"No Transport");else{v.readyState=1,t&&g.trigger("ajaxSend",[v,d]),d.async&&d.timeout>0&&(q=setTimeout(function(){v.abort("timeout")},d.timeout));try{s=1,p.send(l,w)}catch(z){if(s<2)w(-1,z);else throw z}}return v},param:function(a,c){var d=[],e=function(a,b){b=f.isFunction(b)?b():b,d[d.length]=encodeURIComponent(a)+"="+encodeURIComponent(b)};c===b&&(c=f.ajaxSettings.traditional);if(f.isArray(a)||a.jquery&&!f.isPlainObject(a))f.each(a,function(){e(this.name,this.value)});else for(var g in a)b_(g,a[g],c,e);return d.join("&").replace(bC,"+")}}),f.extend({active:0,lastModified:{},etag:{}});var cc=f.now(),cd=/(\=)\?(&|$)|\?\?/i;f.ajaxSetup({jsonp:"callback",jsonpCallback:function(){return f.expando+"_"+cc++}}),f.ajaxPrefilter("json jsonp",function(b,c,d){var e=typeof b.data=="string"&&/^application\/x\-www\-form\-urlencoded/.test(b.contentType);if(b.dataTypes[0]==="jsonp"||b.jsonp!==!1&&(cd.test(b.url)||e&&cd.test(b.data))){var g,h=b.jsonpCallback=f.isFunction(b.jsonpCallback)?b.jsonpCallback():b.jsonpCallback,i=a[h],j=b.url,k=b.data,l="$1"+h+"$2";b.jsonp!==!1&&(j=j.replace(cd,l),b.url===j&&(e&&(k=k.replace(cd,l)),b.data===k&&(j+=(/\?/.test(j)?"&":"?")+b.jsonp+"="+h))),b.url=j,b.data=k,a[h]=function(a){g=[a]},d.always(function(){a[h]=i,g&&f.isFunction(i)&&a[h](g[0])}),b.converters["script json"]=function(){g||f.error(h+" was not called");return g[0]},b.dataTypes[0]="json";return"script"}}),f.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/javascript|ecmascript/},converters:{"text script":function(a){f.globalEval(a);return a}}}),f.ajaxPrefilter("script",function(a){a.cache===b&&(a.cache=!1),a.crossDomain&&(a.type="GET",a.global=!1)}),f.ajaxTransport("script",function(a){if(a.crossDomain){var d,e=c.head||c.getElementsByTagName("head")[0]||c.documentElement;return{send:function(f,g){d=c.createElement("script"),d.async="async",a.scriptCharset&&(d.charset=a.scriptCharset),d.src=a.url,d.onload=d.onreadystatechange=function(a,c){if(c||!d.readyState||/loaded|complete/.test(d.readyState))d.onload=d.onreadystatechange=null,e&&d.parentNode&&e.removeChild(d),d=b,c||g(200,"success")},e.insertBefore(d,e.firstChild)},abort:function(){d&&d.onload(0,1)}}}});var ce=a.ActiveXObject?function(){for(var a in cg)cg[a](0,1)}:!1,cf=0,cg;f.ajaxSettings.xhr=a.ActiveXObject?function(){return!this.isLocal&&ch()||ci()}:ch,function(a){f.extend(f.support,{ajax:!!a,cors:!!a&&"withCredentials"in a})}(f.ajaxSettings.xhr()),f.support.ajax&&f.ajaxTransport(function(c){if(!c.crossDomain||f.support.cors){var d;return{send:function(e,g){var h=c.xhr(),i,j;c.username?h.open(c.type,c.url,c.async,c.username,c.password):h.open(c.type,c.url,c.async);if(c.xhrFields)for(j in c.xhrFields)h[j]=c.xhrFields[j];c.mimeType&&h.overrideMimeType&&h.overrideMimeType(c.mimeType),!c.crossDomain&&!e["X-Requested-With"]&&(e["X-Requested-With"]="XMLHttpRequest");try{for(j in e)h.setRequestHeader(j,e[j])}catch(k){}h.send(c.hasContent&&c.data||null),d=function(a,e){var j,k,l,m,n;try{if(d&&(e||h.readyState===4)){d=b,i&&(h.onreadystatechange=f.noop,ce&&delete cg[i]);if(e)h.readyState!==4&&h.abort();else{j=h.status,l=h.getAllResponseHeaders(),m={},n=h.responseXML,n&&n.documentElement&&(m.xml=n);try{m.text=h.responseText}catch(a){}try{k=h.statusText}catch(o){k=""}!j&&c.isLocal&&!c.crossDomain?j=m.text?200:404:j===1223&&(j=204)}}}catch(p){e||g(-1,p)}m&&g(j,k,m,l)},!c.async||h.readyState===4?d():(i=++cf,ce&&(cg||(cg={},f(a).unload(ce)),cg[i]=d),h.onreadystatechange=d)},abort:function(){d&&d(0,1)}}}});var cj={},ck,cl,cm=/^(?:toggle|show|hide)$/,cn=/^([+\-]=)?([\d+.\-]+)([a-z%]*)$/i,co,cp=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]],cq;f.fn.extend({show:function(a,b,c){var d,e;if(a||a===0)return this.animate(ct("show",3),a,b,c);for(var g=0,h=this.length;g=i.duration+this.startTime){this.now=this.end,this.pos=this.state=1,this.update(),i.animatedProperties[this.prop]=!0;for(b in i.animatedProperties)i.animatedProperties[b]!==!0&&(g=!1);if(g){i.overflow!=null&&!f.support.shrinkWrapBlocks&&f.each(["","X","Y"],function(a,b){h.style["overflow"+b]=i.overflow[a]}),i.hide&&f(h).hide();if(i.hide||i.show)for(b in i.animatedProperties)f.style(h,b,i.orig[b]),f.removeData(h,"fxshow"+b,!0),f.removeData(h,"toggle"+b,!0);d=i.complete,d&&(i.complete=!1,d.call(h))}return!1}i.duration==Infinity?this.now=e:(c=e-this.startTime,this.state=c/i.duration,this.pos=f.easing[i.animatedProperties[this.prop]](this.state,c,0,1,i.duration),this.now=this.start+(this.end-this.start)*this.pos),this.update();return!0}},f.extend(f.fx,{tick:function(){var a,b=f.timers,c=0;for(;c-1,k={},l={},m,n;j?(l=e.position(),m=l.top,n=l.left):(m=parseFloat(h)||0,n=parseFloat(i)||0),f.isFunction(b)&&(b=b.call(a,c,g)),b.top!=null&&(k.top=b.top-g.top+m),b.left!=null&&(k.left=b.left-g.left+n),"using"in b?b.using.call(a,k):e.css(k)}},f.fn.extend({position:function(){if(!this[0])return null;var a=this[0],b=this.offsetParent(),c=this.offset(),d=cx.test(b[0].nodeName)?{top:0,left:0}:b.offset();c.top-=parseFloat(f.css(a,"marginTop"))||0,c.left-=parseFloat(f.css(a,"marginLeft"))||0,d.top+=parseFloat(f.css(b[0],"borderTopWidth"))||0,d.left+=parseFloat(f.css(b[0],"borderLeftWidth"))||0;return{top:c.top-d.top,left:c.left-d.left}},offsetParent:function(){return this.map(function(){var a=this.offsetParent||c.body;while(a&&!cx.test(a.nodeName)&&f.css(a,"position")==="static")a=a.offsetParent;return a})}}),f.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(a,c){var d=/Y/.test(c);f.fn[a]=function(e){return f.access(this,function(a,e,g){var h=cy(a);if(g===b)return h?c in h?h[c]:f.support.boxModel&&h.document.documentElement[e]||h.document.body[e]:a[e];h?h.scrollTo(d?f(h).scrollLeft():g,d?g:f(h).scrollTop()):a[e]=g},a,e,arguments.length,null)}}),f.each({Height:"height",Width:"width"},function(a,c){var d="client"+a,e="scroll"+a,g="offset"+a;f.fn["inner"+a]=function(){var a=this[0];return a?a.style?parseFloat(f.css(a,c,"padding")):this[c]():null},f.fn["outer"+a]=function(a){var b=this[0];return b?b.style?parseFloat(f.css(b,c,a?"margin":"border")):this[c]():null},f.fn[c]=function(a){return f.access(this,function(a,c,h){var i,j,k,l;if(f.isWindow(a)){i=a.document,j=i.documentElement[d];return f.support.boxModel&&j||i.body&&i.body[d]||j}if(a.nodeType===9){i=a.documentElement;if(i[d]>=i[e])return i[d];return Math.max(a.body[e],i[e],a.body[g],i[g])}if(h===b){k=f.css(a,c),l=parseFloat(k);return f.isNumeric(l)?l:k}f(a).css(c,h)},c,a,arguments.length,null)}}),a.jQuery=a.$=f,typeof define=="function"&&define.amd&&define.amd.jQuery&&define("jquery",[],function(){return f})})(window); ;/*jshint evil:true*/ minispade = { root: null, modules: {}, loaded: {}, globalEval: function(data) { if ( data ) { // We use execScript on Internet Explorer // We use an anonymous function so that context is window // rather than jQuery in Firefox ( window.execScript || function( data ) { window[ "eval" ].call( window, data ); } )( data ); } }, require: function(name) { var loaded = minispade.loaded[name]; var mod = minispade.modules[name]; if (!loaded) { if (mod) { minispade.loaded[name] = true; if (typeof mod === "string") { this.globalEval(mod); } else { mod(); } } else { if (minispade.root && name.substr(0,minispade.root.length) !== minispade.root) { return minispade.require(minispade.root+name); } else { throw "The module '" + name + "' could not be found"; } } } return loaded; }, requireAll: function(regex) { for (var module in this.modules) { if (!this.modules.hasOwnProperty(module)) { continue; } if (regex && !regex.test(module)) { continue; } minispade.require(module); } }, register: function(name, callback) { minispade.modules[name] = callback; } }; ;// lib/handlebars/base.js /*jshint eqnull:true*/ this.Handlebars = {}; (function() { Handlebars.VERSION = "1.0.rc.1"; Handlebars.helpers = {}; Handlebars.partials = {}; Handlebars.registerHelper = function(name, fn, inverse) { if(inverse) { fn.not = inverse; } this.helpers[name] = fn; }; Handlebars.registerPartial = function(name, str) { this.partials[name] = str; }; Handlebars.registerHelper('helperMissing', function(arg) { if(arguments.length === 2) { return undefined; } else { throw new Error("Could not find property '" + arg + "'"); } }); var toString = Object.prototype.toString, functionType = "[object Function]"; Handlebars.registerHelper('blockHelperMissing', function(context, options) { var inverse = options.inverse || function() {}, fn = options.fn; var ret = ""; var type = toString.call(context); if(type === functionType) { context = context.call(this); } if(context === true) { return fn(this); } else if(context === false || context == null) { return inverse(this); } else if(type === "[object Array]") { if(context.length > 0) { for(var i=0, j=context.length; i 0) { for(var i=0, j=context.length; i 2) { expected.push("'"+this.terminals_[p]+"'"); } var errStr = ''; if (this.lexer.showPosition) { errStr = 'Parse error on line '+(yylineno+1)+":\n"+this.lexer.showPosition()+"\nExpecting "+expected.join(', ') + ", got '" + this.terminals_[symbol]+ "'"; } else { errStr = 'Parse error on line '+(yylineno+1)+": Unexpected " + (symbol == 1 /*EOF*/ ? "end of input" : ("'"+(this.terminals_[symbol] || symbol)+"'")); } this.parseError(errStr, {text: this.lexer.match, token: this.terminals_[symbol] || symbol, line: this.lexer.yylineno, loc: yyloc, expected: expected}); } // just recovered from another error if (recovering == 3) { if (symbol == EOF) { throw new Error(errStr || 'Parsing halted.'); } // discard current lookahead and grab another yyleng = this.lexer.yyleng; yytext = this.lexer.yytext; yylineno = this.lexer.yylineno; yyloc = this.lexer.yylloc; symbol = lex(); } // try to recover from error while (1) { // check for error recovery rule in this state if ((TERROR.toString()) in table[state]) { break; } if (state == 0) { throw new Error(errStr || 'Parsing halted.'); } popStack(1); state = stack[stack.length-1]; } preErrorSymbol = symbol; // save the lookahead token symbol = TERROR; // insert generic error symbol as new lookahead state = stack[stack.length-1]; action = table[state] && table[state][TERROR]; recovering = 3; // allow 3 real symbols to be shifted before reporting a new error } // this shouldn't happen, unless resolve defaults are off if (action[0] instanceof Array && action.length > 1) { throw new Error('Parse Error: multiple actions possible at state: '+state+', token: '+symbol); } switch (action[0]) { case 1: // shift //this.shiftCount++; stack.push(symbol); vstack.push(this.lexer.yytext); lstack.push(this.lexer.yylloc); stack.push(action[1]); // push state symbol = null; if (!preErrorSymbol) { // normal execution/no error yyleng = this.lexer.yyleng; yytext = this.lexer.yytext; yylineno = this.lexer.yylineno; yyloc = this.lexer.yylloc; if (recovering > 0) recovering--; } else { // error just occurred, resume old lookahead f/ before error symbol = preErrorSymbol; preErrorSymbol = null; } break; case 2: // reduce //this.reductionCount++; len = this.productions_[action[1]][1]; // perform semantic action yyval.$ = vstack[vstack.length-len]; // default to $$ = $1 // default location, uses first token for firsts, last for lasts yyval._$ = { first_line: lstack[lstack.length-(len||1)].first_line, last_line: lstack[lstack.length-1].last_line, first_column: lstack[lstack.length-(len||1)].first_column, last_column: lstack[lstack.length-1].last_column }; r = this.performAction.call(yyval, yytext, yyleng, yylineno, this.yy, action[1], vstack, lstack); if (typeof r !== 'undefined') { return r; } // pop off stack if (len) { stack = stack.slice(0,-1*len*2); vstack = vstack.slice(0, -1*len); lstack = lstack.slice(0, -1*len); } stack.push(this.productions_[action[1]][0]); // push nonterminal (reduce) vstack.push(yyval.$); lstack.push(yyval._$); // goto new state = table[STATE][NONTERMINAL] newState = table[stack[stack.length-2]][stack[stack.length-1]]; stack.push(newState); break; case 3: // accept return true; } } return true; }};/* Jison generated lexer */ var lexer = (function(){ var lexer = ({EOF:1, parseError:function parseError(str, hash) { if (this.yy.parseError) { this.yy.parseError(str, hash); } else { throw new Error(str); } }, setInput:function (input) { this._input = input; this._more = this._less = this.done = false; this.yylineno = this.yyleng = 0; this.yytext = this.matched = this.match = ''; this.conditionStack = ['INITIAL']; this.yylloc = {first_line:1,first_column:0,last_line:1,last_column:0}; return this; }, input:function () { var ch = this._input[0]; this.yytext+=ch; this.yyleng++; this.match+=ch; this.matched+=ch; var lines = ch.match(/\n/); if (lines) this.yylineno++; this._input = this._input.slice(1); return ch; }, unput:function (ch) { this._input = ch + this._input; return this; }, more:function () { this._more = true; return this; }, pastInput:function () { var past = this.matched.substr(0, this.matched.length - this.match.length); return (past.length > 20 ? '...':'') + past.substr(-20).replace(/\n/g, ""); }, upcomingInput:function () { var next = this.match; if (next.length < 20) { next += this._input.substr(0, 20-next.length); } return (next.substr(0,20)+(next.length > 20 ? '...':'')).replace(/\n/g, ""); }, showPosition:function () { var pre = this.pastInput(); var c = new Array(pre.length + 1).join("-"); return pre + this.upcomingInput() + "\n" + c+"^"; }, next:function () { if (this.done) { return this.EOF; } if (!this._input) this.done = true; var token, match, col, lines; if (!this._more) { this.yytext = ''; this.match = ''; } var rules = this._currentRules(); for (var i=0;i < rules.length; i++) { match = this._input.match(this.rules[rules[i]]); if (match) { lines = match[0].match(/\n.*/g); if (lines) this.yylineno += lines.length; this.yylloc = {first_line: this.yylloc.last_line, last_line: this.yylineno+1, first_column: this.yylloc.last_column, last_column: lines ? lines[lines.length-1].length-1 : this.yylloc.last_column + match[0].length} this.yytext += match[0]; this.match += match[0]; this.matches = match; this.yyleng = this.yytext.length; this._more = false; this._input = this._input.slice(match[0].length); this.matched += match[0]; token = this.performAction.call(this, this.yy, this, rules[i],this.conditionStack[this.conditionStack.length-1]); if (token) return token; else return; } } if (this._input === "") { return this.EOF; } else { this.parseError('Lexical error on line '+(this.yylineno+1)+'. Unrecognized text.\n'+this.showPosition(), {text: "", token: null, line: this.yylineno}); } }, lex:function lex() { var r = this.next(); if (typeof r !== 'undefined') { return r; } else { return this.lex(); } }, begin:function begin(condition) { this.conditionStack.push(condition); }, popState:function popState() { return this.conditionStack.pop(); }, _currentRules:function _currentRules() { return this.conditions[this.conditionStack[this.conditionStack.length-1]].rules; }, topState:function () { return this.conditionStack[this.conditionStack.length-2]; }, pushState:function begin(condition) { this.begin(condition); }}); lexer.performAction = function anonymous(yy,yy_,$avoiding_name_collisions,YY_START) { var YYSTATE=YY_START switch($avoiding_name_collisions) { case 0: if(yy_.yytext.slice(-1) !== "\\") this.begin("mu"); if(yy_.yytext.slice(-1) === "\\") yy_.yytext = yy_.yytext.substr(0,yy_.yyleng-1), this.begin("emu"); if(yy_.yytext) return 14; break; case 1: return 14; break; case 2: this.popState(); return 14; break; case 3: return 24; break; case 4: return 16; break; case 5: return 20; break; case 6: return 19; break; case 7: return 19; break; case 8: return 23; break; case 9: return 23; break; case 10: yy_.yytext = yy_.yytext.substr(3,yy_.yyleng-5); this.popState(); return 15; break; case 11: return 22; break; case 12: return 34; break; case 13: return 33; break; case 14: return 33; break; case 15: return 36; break; case 16: /*ignore whitespace*/ break; case 17: this.popState(); return 18; break; case 18: this.popState(); return 18; break; case 19: yy_.yytext = yy_.yytext.substr(1,yy_.yyleng-2).replace(/\\"/g,'"'); return 28; break; case 20: return 30; break; case 21: return 30; break; case 22: return 29; break; case 23: return 33; break; case 24: yy_.yytext = yy_.yytext.substr(1, yy_.yyleng-2); return 33; break; case 25: return 'INVALID'; break; case 26: return 5; break; } }; lexer.rules = [/^[^\x00]*?(?=(\{\{))/,/^[^\x00]+/,/^[^\x00]{2,}?(?=(\{\{))/,/^\{\{>/,/^\{\{#/,/^\{\{\//,/^\{\{\^/,/^\{\{\s*else\b/,/^\{\{\{/,/^\{\{&/,/^\{\{![\s\S]*?\}\}/,/^\{\{/,/^=/,/^\.(?=[} ])/,/^\.\./,/^[\/.]/,/^\s+/,/^\}\}\}/,/^\}\}/,/^"(\\["]|[^"])*"/,/^true(?=[}\s])/,/^false(?=[}\s])/,/^[0-9]+(?=[}\s])/,/^[a-zA-Z0-9_$-]+(?=[=}\s\/.])/,/^\[[^\]]*\]/,/^./,/^$/]; lexer.conditions = {"mu":{"rules":[3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26],"inclusive":false},"emu":{"rules":[2],"inclusive":false},"INITIAL":{"rules":[0,1,26],"inclusive":true}};return lexer;})() parser.lexer = lexer; return parser; })(); if (typeof require !== 'undefined' && typeof exports !== 'undefined') { exports.parser = handlebars; exports.parse = function () { return handlebars.parse.apply(handlebars, arguments); } exports.main = function commonjsMain(args) { if (!args[1]) throw new Error('Usage: '+args[0]+' FILE'); if (typeof process !== 'undefined') { var source = require('fs').readFileSync(require('path').join(process.cwd(), args[1]), "utf8"); } else { var cwd = require("file").path(require("file").cwd()); var source = cwd.join(args[1]).read({charset: "utf-8"}); } return exports.parser.parse(source); } if (typeof module !== 'undefined' && require.main === module) { exports.main(typeof process !== 'undefined' ? process.argv.slice(1) : require("system").args); } }; ; // lib/handlebars/compiler/base.js Handlebars.Parser = handlebars; Handlebars.parse = function(string) { Handlebars.Parser.yy = Handlebars.AST; return Handlebars.Parser.parse(string); }; Handlebars.print = function(ast) { return new Handlebars.PrintVisitor().accept(ast); }; Handlebars.logger = { DEBUG: 0, INFO: 1, WARN: 2, ERROR: 3, level: 3, // override in the host environment log: function(level, str) {} }; Handlebars.log = function(level, str) { Handlebars.logger.log(level, str); }; ; // lib/handlebars/compiler/ast.js (function() { Handlebars.AST = {}; Handlebars.AST.ProgramNode = function(statements, inverse) { this.type = "program"; this.statements = statements; if(inverse) { this.inverse = new Handlebars.AST.ProgramNode(inverse); } }; Handlebars.AST.MustacheNode = function(rawParams, hash, unescaped) { this.type = "mustache"; this.escaped = !unescaped; this.hash = hash; var id = this.id = rawParams[0]; var params = this.params = rawParams.slice(1); // a mustache is an eligible helper if: // * its id is simple (a single part, not `this` or `..`) var eligibleHelper = this.eligibleHelper = id.isSimple; // a mustache is definitely a helper if: // * it is an eligible helper, and // * it has at least one parameter or hash segment this.isHelper = eligibleHelper && (params.length || hash); // if a mustache is an eligible helper but not a definite // helper, it is ambiguous, and will be resolved in a later // pass or at runtime. }; Handlebars.AST.PartialNode = function(id, context) { this.type = "partial"; // TODO: disallow complex IDs this.id = id; this.context = context; }; var verifyMatch = function(open, close) { if(open.original !== close.original) { throw new Handlebars.Exception(open.original + " doesn't match " + close.original); } }; Handlebars.AST.BlockNode = function(mustache, program, inverse, close) { verifyMatch(mustache.id, close); this.type = "block"; this.mustache = mustache; this.program = program; this.inverse = inverse; if (this.inverse && !this.program) { this.isInverse = true; } }; Handlebars.AST.ContentNode = function(string) { this.type = "content"; this.string = string; }; Handlebars.AST.HashNode = function(pairs) { this.type = "hash"; this.pairs = pairs; }; Handlebars.AST.IdNode = function(parts) { this.type = "ID"; this.original = parts.join("."); var dig = [], depth = 0; for(var i=0,l=parts.length; i": ">", '"': """, "'": "'", "`": "`" }; var badChars = /&(?!\w+;)|[<>"'`]/g; var possible = /[&<>"'`]/; var escapeChar = function(chr) { return escape[chr] || "&"; }; Handlebars.Utils = { escapeExpression: function(string) { // don't escape SafeStrings, since they're already safe if (string instanceof Handlebars.SafeString) { return string.toString(); } else if (string == null || string === false) { return ""; } if(!possible.test(string)) { return string; } return string.replace(badChars, escapeChar); }, isEmpty: function(value) { if (typeof value === "undefined") { return true; } else if (value === null) { return true; } else if (value === false) { return true; } else if(Object.prototype.toString.call(value) === "[object Array]" && value.length === 0) { return true; } else { return false; } } }; })();; // lib/handlebars/compiler/compiler.js /*jshint eqnull:true*/ Handlebars.Compiler = function() {}; Handlebars.JavaScriptCompiler = function() {}; (function(Compiler, JavaScriptCompiler) { // the foundHelper register will disambiguate helper lookup from finding a // function in a context. This is necessary for mustache compatibility, which // requires that context functions in blocks are evaluated by blockHelperMissing, // and then proceed as if the resulting value was provided to blockHelperMissing. Compiler.prototype = { compiler: Compiler, disassemble: function() { var opcodes = this.opcodes, opcode, out = [], params, param; for (var i=0, l=opcodes.length; i 0) { this.source[1] = this.source[1] + ", " + locals.join(", "); } // Generate minimizer alias mappings if (!this.isChild) { var aliases = []; for (var alias in this.context.aliases) { this.source[1] = this.source[1] + ', ' + alias + '=' + this.context.aliases[alias]; } } if (this.source[1]) { this.source[1] = "var " + this.source[1].substring(2) + ";"; } // Merge children if (!this.isChild) { this.source[1] += '\n' + this.context.programs.join('\n') + '\n'; } if (!this.environment.isSimple) { this.source.push("return buffer;"); } var params = this.isChild ? ["depth0", "data"] : ["Handlebars", "depth0", "helpers", "partials", "data"]; for(var i=0, l=this.environment.depths.list.length; i this.stackVars.length) { this.stackVars.push("stack" + this.stackSlot); } return "stack" + this.stackSlot; }, popStack: function() { var item = this.compileStack.pop(); if (item instanceof Literal) { return item.value; } else { this.stackSlot--; return item; } }, topStack: function() { var item = this.compileStack[this.compileStack.length - 1]; if (item instanceof Literal) { return item.value; } else { return item; } }, quotedString: function(str) { return '"' + str .replace(/\\/g, '\\\\') .replace(/"/g, '\\"') .replace(/\n/g, '\\n') .replace(/\r/g, '\\r') + '"'; }, setupHelper: function(paramSize, name) { var params = []; this.setupParams(paramSize, params); var foundHelper = this.nameLookup('helpers', name, 'helper'); return { params: params, name: foundHelper, callParams: ["depth0"].concat(params).join(", "), helperMissingParams: ["depth0", this.quotedString(name)].concat(params).join(", ") }; }, // the params and contexts arguments are passed in arrays // to fill in setupParams: function(paramSize, params) { var options = [], contexts = [], param, inverse, program; options.push("hash:" + this.popStack()); inverse = this.popStack(); program = this.popStack(); // Avoid setting fn and inverse if neither are set. This allows // helpers to do a check for `if (options.fn)` if (program || inverse) { if (!program) { this.context.aliases.self = "this"; program = "self.noop"; } if (!inverse) { this.context.aliases.self = "this"; inverse = "self.noop"; } options.push("inverse:" + inverse); options.push("fn:" + program); } for(var i=0; i\s*\(([^\)]+)\)/gm, '{anonymous}($1)').split('\n'); stack.shift(); } else { // Firefox stack = error.stack.replace(/(?:\n@:0)?\s+$/m, ''). replace(/^\(/gm, '{anonymous}(').split('\n'); } stackStr = "\n " + stack.slice(2).join("\n "); message = message + stackStr; } Ember.Logger.warn("DEPRECATION: "+message); }; /** Display a deprecation warning with the provided message and a stack trace (Chrome and Firefox only) when the wrapped method is called. Ember build tools will not remove calls to Ember.deprecateFunc(), though no warnings will be shown in production. @method deprecateFunc @param {String} message A description of the deprecation. @param {Function} func The function to be deprecated. */ Ember.deprecateFunc = function(message, func) { return function() { Ember.deprecate(message); return func.apply(this, arguments); }; }; window.ember_assert = Ember.deprecateFunc("ember_assert is deprecated. Please use Ember.assert instead.", Ember.assert); window.ember_warn = Ember.deprecateFunc("ember_warn is deprecated. Please use Ember.warn instead.", Ember.warn); window.ember_deprecate = Ember.deprecateFunc("ember_deprecate is deprecated. Please use Ember.deprecate instead.", Ember.deprecate); window.ember_deprecateFunc = Ember.deprecateFunc("ember_deprecateFunc is deprecated. Please use Ember.deprecateFunc instead.", Ember.deprecateFunc); })(); // Version: v1.0.pre-243-g2578a65 // Last commit: 2578a65 (2012-10-21 18:51:25 +0200) (function() { /*globals Em:true ENV */ /** @module ember @submodule ember-metal */ /** All Ember methods and functions are defined inside of this namespace. You generally should not add new properties to this namespace as it may be overwritten by future versions of Ember. You can also use the shorthand "Em" instead of "Ember". Ember-Runtime is a framework that provides core functions for Ember including cross-platform functions, support for property observing and objects. Its focus is on small size and performance. You can use this in place of or along-side other cross-platform libraries such as jQuery. The core Runtime framework is based on the jQuery API with a number of performance optimizations. @class Ember @static @version 1.0.pre */ if ('undefined' === typeof Ember) { // Create core object. Make it act like an instance of Ember.Namespace so that // objects assigned to it are given a sane string representation. Ember = {}; } // Default imports, exports and lookup to the global object; var imports = Ember.imports = Ember.imports || this; var exports = Ember.exports = Ember.exports || this; var lookup = Ember.lookup = Ember.lookup || this; // aliases needed to keep minifiers from removing the global context exports.Em = exports.Ember = Em = Ember; // Make sure these are set whether Ember was already defined or not Ember.isNamespace = true; Ember.toString = function() { return "Ember"; }; /** @property VERSION @type String @default '1.0.pre' @final */ Ember.VERSION = '1.0.pre'; /** Standard environmental variables. You can define these in a global `ENV` variable before loading Ember to control various configuration settings. @property ENV @type Hash */ Ember.ENV = Ember.ENV || ('undefined' === typeof ENV ? {} : ENV); Ember.config = Ember.config || {}; // .......................................................... // BOOTSTRAP // /** Determines whether Ember should enhances some built-in object prototypes to provide a more friendly API. If enabled, a few methods will be added to Function, String, and Array. Object.prototype will not be enhanced, which is the one that causes most trouble for people. In general we recommend leaving this option set to true since it rarely conflicts with other code. If you need to turn it off however, you can define an ENV.EXTEND_PROTOTYPES config to disable it. @property EXTEND_PROTOTYPES @type Boolean @default true */ Ember.EXTEND_PROTOTYPES = Ember.ENV.EXTEND_PROTOTYPES; if (typeof Ember.EXTEND_PROTOTYPES === 'undefined') { Ember.EXTEND_PROTOTYPES = true; } /** Determines whether Ember logs a full stack trace during deprecation warnings @property LOG_STACKTRACE_ON_DEPRECATION @type Boolean @default true */ Ember.LOG_STACKTRACE_ON_DEPRECATION = (Ember.ENV.LOG_STACKTRACE_ON_DEPRECATION !== false); /** Determines whether Ember should add ECMAScript 5 shims to older browsers. @property SHIM_ES5 @type Boolean @default Ember.EXTEND_PROTOTYPES */ Ember.SHIM_ES5 = (Ember.ENV.SHIM_ES5 === false) ? false : Ember.EXTEND_PROTOTYPES; /** Empty function. Useful for some operations. @method K @private @return {Object} */ Ember.K = function() { return this; }; // Stub out the methods defined by the ember-debug package in case it's not loaded if ('undefined' === typeof Ember.assert) { Ember.assert = Ember.K; } if ('undefined' === typeof Ember.warn) { Ember.warn = Ember.K; } if ('undefined' === typeof Ember.deprecate) { Ember.deprecate = Ember.K; } if ('undefined' === typeof Ember.deprecateFunc) { Ember.deprecateFunc = function(_, func) { return func; }; } // These are deprecated but still supported if ('undefined' === typeof ember_assert) { exports.ember_assert = Ember.K; } if ('undefined' === typeof ember_warn) { exports.ember_warn = Ember.K; } if ('undefined' === typeof ember_deprecate) { exports.ember_deprecate = Ember.K; } if ('undefined' === typeof ember_deprecateFunc) { exports.ember_deprecateFunc = function(_, func) { return func; }; } // .......................................................... // LOGGER // /** Inside Ember-Metal, simply uses the imports.console object. Override this to provide more robust logging functionality. @class Logger @namespace Ember */ Ember.Logger = imports.console || { log: Ember.K, warn: Ember.K, error: Ember.K, info: Ember.K, debug: Ember.K }; // .......................................................... // ERROR HANDLING // /** A function may be assigned to `Ember.onerror` to be called when Ember internals encounter an error. This is useful for specialized error handling and reporting code. @event onerror @for Ember @param {Exception} error the error object */ Ember.onerror = null; /** @private Wrap code block in a try/catch if {{#crossLink "Ember/onerror"}}{{/crossLink}} is set. @method handleErrors @for Ember @param {Function} func @param [context] */ Ember.handleErrors = function(func, context) { // Unfortunately in some browsers we lose the backtrace if we rethrow the existing error, // so in the event that we don't have an `onerror` handler we don't wrap in a try/catch if ('function' === typeof Ember.onerror) { try { return func.apply(context || this); } catch (error) { Ember.onerror(error); } } else { return func.apply(context || this); } }; })(); (function() { /** The purpose of the Ember Instrumentation module is to provide efficient, general-purpose instrumentation for Ember. Subscribe to a listener by using `Ember.subscribe`: Ember.subscribe("render", { before: function(name, timestamp, payload) { }, after: function(name, timestamp, payload) { } }); If you return a value from the `before` callback, that same value will be passed as a fourth parameter to the `after` callback. Instrument a block of code by using `Ember.instrument`: Ember.instrument("render.handlebars", payload, function() { // rendering logic }, binding); Event names passed to `Ember.instrument` are namespaced by periods, from more general to more specific. Subscribers can listen for events by whatever level of granularity they are interested in. In the above example, the event is `render.handlebars`, and the subscriber listened for all events beginning with `render`. It would receive callbacks for events named `render`, `render.handlebars`, `render.container`, or even `render.handlebars.layout`. @class Instrumentation @namespace Ember @static */ Ember.Instrumentation = {}; var subscribers = [], cache = {}; var populateListeners = function(name) { var listeners = [], subscriber; for (var i=0, l=subscribers.length; i -1; }; // From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/map var arrayMap = isNativeFunc(Array.prototype.map) ? Array.prototype.map : function(fun /*, thisp */) { //"use strict"; if (this === void 0 || this === null) { throw new TypeError(); } var t = Object(this); var len = t.length >>> 0; if (typeof fun !== "function") { throw new TypeError(); } var res = new Array(len); var thisp = arguments[1]; for (var i = 0; i < len; i++) { if (i in t) { res[i] = fun.call(thisp, t[i], i, t); } } return res; }; // From: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/array/foreach var arrayForEach = isNativeFunc(Array.prototype.forEach) ? Array.prototype.forEach : function(fun /*, thisp */) { //"use strict"; if (this === void 0 || this === null) { throw new TypeError(); } var t = Object(this); var len = t.length >>> 0; if (typeof fun !== "function") { throw new TypeError(); } var thisp = arguments[1]; for (var i = 0; i < len; i++) { if (i in t) { fun.call(thisp, t[i], i, t); } } }; var arrayIndexOf = isNativeFunc(Array.prototype.indexOf) ? Array.prototype.indexOf : function (obj, fromIndex) { if (fromIndex === null || fromIndex === undefined) { fromIndex = 0; } else if (fromIndex < 0) { fromIndex = Math.max(0, this.length + fromIndex); } for (var i = fromIndex, j = this.length; i < j; i++) { if (this[i] === obj) { return i; } } return -1; }; Ember.ArrayPolyfills = { map: arrayMap, forEach: arrayForEach, indexOf: arrayIndexOf }; var utils = Ember.EnumerableUtils = { map: function(obj, callback, thisArg) { return obj.map ? obj.map.call(obj, callback, thisArg) : arrayMap.call(obj, callback, thisArg); }, forEach: function(obj, callback, thisArg) { return obj.forEach ? obj.forEach.call(obj, callback, thisArg) : arrayForEach.call(obj, callback, thisArg); }, indexOf: function(obj, element, index) { return obj.indexOf ? obj.indexOf.call(obj, element, index) : arrayIndexOf.call(obj, element, index); }, indexesOf: function(obj, elements) { return elements === undefined ? [] : utils.map(elements, function(item) { return utils.indexOf(obj, item); }); }, removeObject: function(array, item) { var index = utils.indexOf(array, item); if (index !== -1) { array.splice(index, 1); } }, replace: function(array, idx, amt, objects) { if (array.replace) { return array.replace(idx, amt, objects); } else { var args = Array.prototype.concat.apply([idx, amt], objects); return array.splice.apply(array, args); } } }; if (Ember.SHIM_ES5) { if (!Array.prototype.map) { Array.prototype.map = arrayMap; } if (!Array.prototype.forEach) { Array.prototype.forEach = arrayForEach; } if (!Array.prototype.indexOf) { Array.prototype.indexOf = arrayIndexOf; } } })(); (function() { /*globals Node */ /** @module ember-metal */ /** Platform specific methods and feature detectors needed by the framework. @class platform @namespace Ember @static */ var platform = Ember.platform = {}; /** Identical to Object.create(). Implements if not available natively. @method create @for Ember */ Ember.create = Object.create; if (!Ember.create) { var K = function() {}; Ember.create = function(obj, props) { K.prototype = obj; obj = new K(); if (props) { K.prototype = obj; for (var prop in props) { K.prototype[prop] = props[prop].value; } obj = new K(); } K.prototype = null; return obj; }; Ember.create.isSimulated = true; } var defineProperty = Object.defineProperty; var canRedefineProperties, canDefinePropertyOnDOM; // Catch IE8 where Object.defineProperty exists but only works on DOM elements if (defineProperty) { try { defineProperty({}, 'a',{get:function(){}}); } catch (e) { defineProperty = null; } } if (defineProperty) { // Detects a bug in Android <3.2 where you cannot redefine a property using // Object.defineProperty once accessors have already been set. canRedefineProperties = (function() { var obj = {}; defineProperty(obj, 'a', { configurable: true, enumerable: true, get: function() { }, set: function() { } }); defineProperty(obj, 'a', { configurable: true, enumerable: true, writable: true, value: true }); return obj.a === true; })(); // This is for Safari 5.0, which supports Object.defineProperty, but not // on DOM nodes. canDefinePropertyOnDOM = (function(){ try { defineProperty(document.createElement('div'), 'definePropertyOnDOM', {}); return true; } catch(e) { } return false; })(); if (!canRedefineProperties) { defineProperty = null; } else if (!canDefinePropertyOnDOM) { defineProperty = function(obj, keyName, desc){ var isNode; if (typeof Node === "object") { isNode = obj instanceof Node; } else { isNode = typeof obj === "object" && typeof obj.nodeType === "number" && typeof obj.nodeName === "string"; } if (isNode) { // TODO: Should we have a warning here? return (obj[keyName] = desc.value); } else { return Object.defineProperty(obj, keyName, desc); } }; } } /** @class platform @namespace Ember */ /** Identical to Object.defineProperty(). Implements as much functionality as possible if not available natively. @method defineProperty @param {Object} obj The object to modify @param {String} keyName property name to modify @param {Object} desc descriptor hash @return {void} */ platform.defineProperty = defineProperty; /** Set to true if the platform supports native getters and setters. @property hasPropertyAccessors @final */ platform.hasPropertyAccessors = true; if (!platform.defineProperty) { platform.hasPropertyAccessors = false; platform.defineProperty = function(obj, keyName, desc) { if (!desc.get) { obj[keyName] = desc.value; } }; platform.defineProperty.isSimulated = true; } if (Ember.ENV.MANDATORY_SETTER && !platform.hasPropertyAccessors) { Ember.ENV.MANDATORY_SETTER = false; } })(); (function() { /** @module ember-metal */ var o_defineProperty = Ember.platform.defineProperty, o_create = Ember.create, // Used for guid generation... GUID_KEY = '__ember'+ (+ new Date()), uuid = 0, numberCache = [], stringCache = {}; var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER; /** @private A unique key used to assign guids and other private metadata to objects. If you inspect an object in your browser debugger you will often see these. They can be safely ignored. On browsers that support it, these properties are added with enumeration disabled so they won't show up when you iterate over your properties. @property GUID_KEY @for Ember @type String @final */ Ember.GUID_KEY = GUID_KEY; var GUID_DESC = { writable: false, configurable: false, enumerable: false, value: null }; /** @private Generates a new guid, optionally saving the guid to the object that you pass in. You will rarely need to use this method. Instead you should call Ember.guidFor(obj), which return an existing guid if available. @method generateGuid @for Ember @param {Object} [obj] Object the guid will be used for. If passed in, the guid will be saved on the object and reused whenever you pass the same object again. If no object is passed, just generate a new guid. @param {String} [prefix] Prefix to place in front of the guid. Useful when you want to separate the guid into separate namespaces. @return {String} the guid */ Ember.generateGuid = function generateGuid(obj, prefix) { if (!prefix) prefix = 'ember'; var ret = (prefix + (uuid++)); if (obj) { GUID_DESC.value = ret; o_defineProperty(obj, GUID_KEY, GUID_DESC); } return ret ; }; /** @private Returns a unique id for the object. If the object does not yet have a guid, one will be assigned to it. You can call this on any object, Ember.Object-based or not, but be aware that it will add a _guid property. You can also use this method on DOM Element objects. @method guidFor @for Ember @param obj {Object} any object, string, number, Element, or primitive @return {String} the unique guid for this instance. */ Ember.guidFor = function guidFor(obj) { // special cases where we don't want to add a key to object if (obj === undefined) return "(undefined)"; if (obj === null) return "(null)"; var cache, ret; var type = typeof obj; // Don't allow prototype changes to String etc. to change the guidFor switch(type) { case 'number': ret = numberCache[obj]; if (!ret) ret = numberCache[obj] = 'nu'+obj; return ret; case 'string': ret = stringCache[obj]; if (!ret) ret = stringCache[obj] = 'st'+(uuid++); return ret; case 'boolean': return obj ? '(true)' : '(false)'; default: if (obj[GUID_KEY]) return obj[GUID_KEY]; if (obj === Object) return '(Object)'; if (obj === Array) return '(Array)'; ret = 'ember'+(uuid++); GUID_DESC.value = ret; o_defineProperty(obj, GUID_KEY, GUID_DESC); return ret; } }; // .......................................................... // META // var META_DESC = { writable: true, configurable: false, enumerable: false, value: null }; var META_KEY = Ember.GUID_KEY+'_meta'; /** The key used to store meta information on object for property observing. @property META_KEY @for Ember @private @final @type String */ Ember.META_KEY = META_KEY; // Placeholder for non-writable metas. var EMPTY_META = { descs: {}, watching: {} }; if (MANDATORY_SETTER) { EMPTY_META.values = {}; } Ember.EMPTY_META = EMPTY_META; if (Object.freeze) Object.freeze(EMPTY_META); var isDefinePropertySimulated = Ember.platform.defineProperty.isSimulated; function Meta(obj) { this.descs = {}; this.watching = {}; this.cache = {}; this.source = obj; } if (isDefinePropertySimulated) { // on platforms that don't support enumerable false // make meta fail jQuery.isPlainObject() to hide from // jQuery.extend() by having a property that fails // hasOwnProperty check. Meta.prototype.__preventPlainObject__ = true; } /** Retrieves the meta hash for an object. If 'writable' is true ensures the hash is writable for this object as well. The meta object contains information about computed property descriptors as well as any watched properties and other information. You generally will not access this information directly but instead work with higher level methods that manipulate this hash indirectly. @method meta @for Ember @private @param {Object} obj The object to retrieve meta for @param {Boolean} [writable=true] Pass false if you do not intend to modify the meta hash, allowing the method to avoid making an unnecessary copy. @return {Hash} */ Ember.meta = function meta(obj, writable) { var ret = obj[META_KEY]; if (writable===false) return ret || EMPTY_META; if (!ret) { if (!isDefinePropertySimulated) o_defineProperty(obj, META_KEY, META_DESC); ret = new Meta(obj); if (MANDATORY_SETTER) { ret.values = {}; } obj[META_KEY] = ret; // make sure we don't accidentally try to create constructor like desc ret.descs.constructor = null; } else if (ret.source !== obj) { if (!isDefinePropertySimulated) o_defineProperty(obj, META_KEY, META_DESC); ret = o_create(ret); ret.descs = o_create(ret.descs); ret.watching = o_create(ret.watching); ret.cache = {}; ret.source = obj; if (MANDATORY_SETTER) { ret.values = o_create(ret.values); } obj[META_KEY] = ret; } return ret; }; Ember.getMeta = function getMeta(obj, property) { var meta = Ember.meta(obj, false); return meta[property]; }; Ember.setMeta = function setMeta(obj, property, value) { var meta = Ember.meta(obj, true); meta[property] = value; return value; }; /** @private In order to store defaults for a class, a prototype may need to create a default meta object, which will be inherited by any objects instantiated from the class's constructor. However, the properties of that meta object are only shallow-cloned, so if a property is a hash (like the event system's `listeners` hash), it will by default be shared across all instances of that class. This method allows extensions to deeply clone a series of nested hashes or other complex objects. For instance, the event system might pass ['listeners', 'foo:change', 'ember157'] to `prepareMetaPath`, which will walk down the keys provided. For each key, if the key does not exist, it is created. If it already exists and it was inherited from its constructor, the constructor's key is cloned. You can also pass false for `writable`, which will simply return undefined if `prepareMetaPath` discovers any part of the path that shared or undefined. @method metaPath @for Ember @param {Object} obj The object whose meta we are examining @param {Array} path An array of keys to walk down @param {Boolean} writable whether or not to create a new meta (or meta property) if one does not already exist or if it's shared with its constructor */ Ember.metaPath = function metaPath(obj, path, writable) { var meta = Ember.meta(obj, writable), keyName, value; for (var i=0, l=path.length; i [] Ember.makeArray(null); => [] Ember.makeArray(undefined); => [] Ember.makeArray('lindsay'); => ['lindsay'] Ember.makeArray([1,2,42]); => [1,2,42] var controller = Ember.ArrayProxy.create({ content: [] }); Ember.makeArray(controller) === controller; => true @method makeArray @for Ember @param {Object} obj the object @return {Array} */ Ember.makeArray = function(obj) { if (obj === null || obj === undefined) { return []; } return Ember.isArray(obj) ? obj : [obj]; }; function canInvoke(obj, methodName) { return !!(obj && typeof obj[methodName] === 'function'); } /** Checks to see if the `methodName` exists on the `obj`. @method canInvoke @for Ember @param {Object} obj The object to check for the method @param {String} methodName The method name to check for */ Ember.canInvoke = canInvoke; /** Checks to see if the `methodName` exists on the `obj`, and if it does, invokes it with the arguments passed. @method tryInvoke @for Ember @param {Object} obj The object to check for the method @param {String} methodName The method name to check for @param {Array} [args] The arguments to pass to the method @return {anything} the return value of the invoked method or undefined if it cannot be invoked */ Ember.tryInvoke = function(obj, methodName, args) { if (canInvoke(obj, methodName)) { return obj[methodName].apply(obj, args || []); } }; })(); (function() { /** @module ember-metal */ /* JavaScript (before ES6) does not have a Map implementation. Objects, which are often used as dictionaries, may only have Strings as keys. Because Ember has a way to get a unique identifier for every object via `Ember.guidFor`, we can implement a performant Map with arbitrary keys. Because it is commonly used in low-level bookkeeping, Map is implemented as a pure JavaScript object for performance. This implementation follows the current iteration of the ES6 proposal for maps (http://wiki.ecmascript.org/doku.php?id=harmony:simple_maps_and_sets), with two exceptions. First, because we need our implementation to be pleasant on older browsers, we do not use the `delete` name (using `remove` instead). Second, as we do not have the luxury of in-VM iteration, we implement a forEach method for iteration. Map is mocked out to look like an Ember object, so you can do `Ember.Map.create()` for symmetry with other Ember classes. */ var guidFor = Ember.guidFor, indexOf = Ember.ArrayPolyfills.indexOf; var copy = function(obj) { var output = {}; for (var prop in obj) { if (obj.hasOwnProperty(prop)) { output[prop] = obj[prop]; } } return output; }; var copyMap = function(original, newObject) { var keys = original.keys.copy(), values = copy(original.values); newObject.keys = keys; newObject.values = values; return newObject; }; /** This class is used internally by Ember.js and Ember Data. Please do not use it at this time. We plan to clean it up and add many tests soon. @class OrderedSet @namespace Ember @constructor @private */ var OrderedSet = Ember.OrderedSet = function() { this.clear(); }; /** @method create @static @return {Ember.OrderedSet} */ OrderedSet.create = function() { return new OrderedSet(); }; OrderedSet.prototype = { /** @method clear */ clear: function() { this.presenceSet = {}; this.list = []; }, /** @method add @param obj */ add: function(obj) { var guid = guidFor(obj), presenceSet = this.presenceSet, list = this.list; if (guid in presenceSet) { return; } presenceSet[guid] = true; list.push(obj); }, /** @method remove @param obj */ remove: function(obj) { var guid = guidFor(obj), presenceSet = this.presenceSet, list = this.list; delete presenceSet[guid]; var index = indexOf.call(list, obj); if (index > -1) { list.splice(index, 1); } }, /** @method isEmpty @return {Boolean} */ isEmpty: function() { return this.list.length === 0; }, /** @method has @param obj @return {Boolean} */ has: function(obj) { var guid = guidFor(obj), presenceSet = this.presenceSet; return guid in presenceSet; }, /** @method forEach @param {Function} function @param target */ forEach: function(fn, self) { // allow mutation during iteration var list = this.list.slice(); for (var i = 0, j = list.length; i < j; i++) { fn.call(self, list[i]); } }, /** @method toArray @return {Array} */ toArray: function() { return this.list.slice(); }, /** @method copy @return {Ember.OrderedSet} */ copy: function() { var set = new OrderedSet(); set.presenceSet = copy(this.presenceSet); set.list = this.list.slice(); return set; } }; /** A Map stores values indexed by keys. Unlike JavaScript's default Objects, the keys of a Map can be any JavaScript object. Internally, a Map has two data structures: `keys`: an OrderedSet of all of the existing keys `values`: a JavaScript Object indexed by the Ember.guidFor(key) When a key/value pair is added for the first time, we add the key to the `keys` OrderedSet, and create or replace an entry in `values`. When an entry is deleted, we delete its entry in `keys` and `values`. @class Map @namespace Ember @private @constructor */ var Map = Ember.Map = function() { this.keys = Ember.OrderedSet.create(); this.values = {}; }; /** @method create @static */ Map.create = function() { return new Map(); }; Map.prototype = { /** Retrieve the value associated with a given key. @method get @param {anything} key @return {anything} the value associated with the key, or undefined */ get: function(key) { var values = this.values, guid = guidFor(key); return values[guid]; }, /** Adds a value to the map. If a value for the given key has already been provided, the new value will replace the old value. @method set @param {anything} key @param {anything} value */ set: function(key, value) { var keys = this.keys, values = this.values, guid = guidFor(key); keys.add(key); values[guid] = value; }, /** Removes a value from the map for an associated key. @method remove @param {anything} key @return {Boolean} true if an item was removed, false otherwise */ remove: function(key) { // don't use ES6 "delete" because it will be annoying // to use in browsers that are not ES6 friendly; var keys = this.keys, values = this.values, guid = guidFor(key), value; if (values.hasOwnProperty(guid)) { keys.remove(key); value = values[guid]; delete values[guid]; return true; } else { return false; } }, /** Check whether a key is present. @method has @param {anything} key @return {Boolean} true if the item was present, false otherwise */ has: function(key) { var values = this.values, guid = guidFor(key); return values.hasOwnProperty(guid); }, /** Iterate over all the keys and values. Calls the function once for each key, passing in the key and value, in that order. The keys are guaranteed to be iterated over in insertion order. @method forEach @param {Function} callback @param {anything} self if passed, the `this` value inside the callback. By default, `this` is the map. */ forEach: function(callback, self) { var keys = this.keys, values = this.values; keys.forEach(function(key) { var guid = guidFor(key); callback.call(self, key, values[guid]); }); }, /** @method copy @return {Ember.Map} */ copy: function() { return copyMap(this, new Map()); } }; /** @class MapWithDefault @namespace Ember @extends Ember.Map @private @constructor @param [options] @param {anything} [options.defaultValue] */ var MapWithDefault = Ember.MapWithDefault = function(options) { Map.call(this); this.defaultValue = options.defaultValue; }; /** @method create @static @param [options] @param {anything} [options.defaultValue] @return {Ember.MapWithDefault|Ember.Map} If options are passed, returns Ember.MapWithDefault otherwise returns Ember.Map */ MapWithDefault.create = function(options) { if (options) { return new MapWithDefault(options); } else { return new Map(); } }; MapWithDefault.prototype = Ember.create(Map.prototype); /** Retrieve the value associated with a given key. @method get @param {anything} key @return {anything} the value associated with the key, or the default value */ MapWithDefault.prototype.get = function(key) { var hasValue = this.has(key); if (hasValue) { return Map.prototype.get.call(this, key); } else { var defaultValue = this.defaultValue(key); this.set(key, defaultValue); return defaultValue; } }; /** @method copy @return {Ember.MapWithDefault} */ MapWithDefault.prototype.copy = function() { return copyMap(this, new MapWithDefault({ defaultValue: this.defaultValue })); }; })(); (function() { /** @module ember-metal */ var META_KEY = Ember.META_KEY, get, set; var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER; var IS_GLOBAL = /^([A-Z$]|([0-9][A-Z$]))/; var IS_GLOBAL_PATH = /^([A-Z$]|([0-9][A-Z$])).*[\.\*]/; var HAS_THIS = /^this[\.\*]/; var FIRST_KEY = /^([^\.\*]+)/; // .......................................................... // GET AND SET // // If we are on a platform that supports accessors we can get use those. // Otherwise simulate accessors by looking up the property directly on the // object. /** Gets the value of a property on an object. If the property is computed, the function will be invoked. If the property is not defined but the object implements the unknownProperty() method then that will be invoked. If you plan to run on IE8 and older browsers then you should use this method anytime you want to retrieve a property on an object that you don't know for sure is private. (My convention only properties beginning with an underscore '_' are considered private.) On all newer browsers, you only need to use this method to retrieve properties if the property might not be defined on the object and you want to respect the unknownProperty() handler. Otherwise you can ignore this method. Note that if the obj itself is null, this method will simply return undefined. @method get @for Ember @param {Object} obj The object to retrieve from. @param {String} keyName The property key to retrieve @return {Object} the property value or null. */ get = function get(obj, keyName) { // Helpers that operate with 'this' within an #each if (keyName === '') { return obj; } if (!keyName && 'string'===typeof obj) { keyName = obj; obj = null; } if (!obj || keyName.indexOf('.') !== -1) { return getPath(obj, keyName); } Ember.assert("You need to provide an object and key to `get`.", !!obj && keyName); var meta = obj[META_KEY], desc = meta && meta.descs[keyName], ret; if (desc) { return desc.get(obj, keyName); } else { if (MANDATORY_SETTER && meta && meta.watching[keyName] > 0) { ret = meta.values[keyName]; } else { ret = obj[keyName]; } if (ret === undefined && 'object' === typeof obj && !(keyName in obj) && 'function' === typeof obj.unknownProperty) { return obj.unknownProperty(keyName); } return ret; } }; /** Sets the value of a property on an object, respecting computed properties and notifying observers and other listeners of the change. If the property is not defined but the object implements the unknownProperty() method then that will be invoked as well. If you plan to run on IE8 and older browsers then you should use this method anytime you want to set a property on an object that you don't know for sure is private. (My convention only properties beginning with an underscore '_' are considered private.) On all newer browsers, you only need to use this method to set properties if the property might not be defined on the object and you want to respect the unknownProperty() handler. Otherwise you can ignore this method. @method set @for Ember @param {Object} obj The object to modify. @param {String} keyName The property key to set @param {Object} value The value to set @return {Object} the passed value. */ set = function set(obj, keyName, value, tolerant) { if (typeof obj === 'string') { Ember.assert("Path '" + obj + "' must be global if no obj is given.", IS_GLOBAL.test(obj)); value = keyName; keyName = obj; obj = null; } if (!obj || keyName.indexOf('.') !== -1) { return setPath(obj, keyName, value, tolerant); } Ember.assert("You need to provide an object and key to `set`.", !!obj && keyName !== undefined); Ember.assert('calling set on destroyed object', !obj.isDestroyed); var meta = obj[META_KEY], desc = meta && meta.descs[keyName], isUnknown, currentValue; if (desc) { desc.set(obj, keyName, value); } else { isUnknown = 'object' === typeof obj && !(keyName in obj); // setUnknownProperty is called if `obj` is an object, // the property does not already exist, and the // `setUnknownProperty` method exists on the object if (isUnknown && 'function' === typeof obj.setUnknownProperty) { obj.setUnknownProperty(keyName, value); } else if (meta && meta.watching[keyName] > 0) { if (MANDATORY_SETTER) { currentValue = meta.values[keyName]; } else { currentValue = obj[keyName]; } // only trigger a change if the value has changed if (value !== currentValue) { Ember.propertyWillChange(obj, keyName); if (MANDATORY_SETTER) { if (currentValue === undefined && !(keyName in obj)) { Ember.defineProperty(obj, keyName, null, value); // setup mandatory setter } else { meta.values[keyName] = value; } } else { obj[keyName] = value; } Ember.propertyDidChange(obj, keyName); } } else { obj[keyName] = value; } } return value; }; // Currently used only by Ember Data tests if (Ember.config.overrideAccessors) { Ember.get = get; Ember.set = set; Ember.config.overrideAccessors(); get = Ember.get; set = Ember.set; } function firstKey(path) { return path.match(FIRST_KEY)[0]; } // assumes path is already normalized function normalizeTuple(target, path) { var hasThis = HAS_THIS.test(path), isGlobal = !hasThis && IS_GLOBAL_PATH.test(path), key; if (!target || isGlobal) target = Ember.lookup; if (hasThis) path = path.slice(5); if (target === Ember.lookup) { key = firstKey(path); target = get(target, key); path = path.slice(key.length+1); } // must return some kind of path to be valid else other things will break. if (!path || path.length===0) throw new Error('Invalid Path'); return [ target, path ]; } function getPath(root, path) { var hasThis, parts, tuple, idx, len; // If there is no root and path is a key name, return that // property from the global object. // E.g. get('Ember') -> Ember if (root === null && path.indexOf('.') === -1) { return get(Ember.lookup, path); } // detect complicated paths and normalize them hasThis = HAS_THIS.test(path); if (!root || hasThis) { tuple = normalizeTuple(root, path); root = tuple[0]; path = tuple[1]; tuple.length = 0; } parts = path.split("."); len = parts.length; for (idx=0; root && idx 0; if (existingDesc instanceof Ember.Descriptor) { existingDesc.teardown(obj, keyName); } if (desc instanceof Ember.Descriptor) { value = desc; descs[keyName] = desc; if (MANDATORY_SETTER && watching) { objectDefineProperty(obj, keyName, { configurable: true, enumerable: true, writable: true, value: undefined // make enumerable }); } else { obj[keyName] = undefined; // make enumerable } desc.setup(obj, keyName); } else { descs[keyName] = undefined; // shadow descriptor in proto if (desc == null) { value = data; if (MANDATORY_SETTER && watching) { meta.values[keyName] = data; objectDefineProperty(obj, keyName, { configurable: true, enumerable: true, set: function() { Ember.assert('Must use Ember.set() to access this property', false); }, get: function() { var meta = this[META_KEY]; return meta && meta.values[keyName]; } }); } else { obj[keyName] = data; } } else { value = desc; // compatibility with ES5 objectDefineProperty(obj, keyName, desc); } } // if key is being watched, override chains that // were initialized with the prototype if (watching) { Ember.overrideChains(obj, keyName, meta); } // The `value` passed to the `didDefineProperty` hook is // either the descriptor or data, whichever was passed. if (obj.didDefineProperty) { obj.didDefineProperty(obj, keyName, value); } return this; }; })(); (function() { /** @module ember-metal */ var AFTER_OBSERVERS = ':change'; var BEFORE_OBSERVERS = ':before'; var guidFor = Ember.guidFor; var deferred = 0; var array_Slice = [].slice; var ObserverSet = function () { this.targetSet = {}; }; ObserverSet.prototype.add = function (target, path) { var targetSet = this.targetSet, targetGuid = Ember.guidFor(target), pathSet = targetSet[targetGuid]; if (!pathSet) { targetSet[targetGuid] = pathSet = {}; } if (pathSet[path]) { return false; } else { return pathSet[path] = true; } }; ObserverSet.prototype.clear = function () { this.targetSet = {}; }; var DeferredEventQueue = function() { this.targetSet = {}; this.queue = []; }; DeferredEventQueue.prototype.push = function(target, eventName, keyName) { var targetSet = this.targetSet, queue = this.queue, targetGuid = Ember.guidFor(target), eventNameSet = targetSet[targetGuid], index; if (!eventNameSet) { targetSet[targetGuid] = eventNameSet = {}; } index = eventNameSet[eventName]; if (index === undefined) { eventNameSet[eventName] = queue.push(Ember.deferEvent(target, eventName, [target, keyName])) - 1; } else { queue[index] = Ember.deferEvent(target, eventName, [target, keyName]); } }; DeferredEventQueue.prototype.flush = function() { var queue = this.queue; this.queue = []; this.targetSet = {}; for (var i=0, len=queue.length; i < len; ++i) { queue[i](); } }; var queue = new DeferredEventQueue(), beforeObserverSet = new ObserverSet(); function notifyObservers(obj, eventName, keyName, forceNotification) { if (deferred && !forceNotification) { queue.push(obj, eventName, keyName); } else { Ember.sendEvent(obj, eventName, [obj, keyName]); } } function flushObserverQueue() { beforeObserverSet.clear(); queue.flush(); } /** @method beginPropertyChanges @chainable */ Ember.beginPropertyChanges = function() { deferred++; return this; }; /** @method endPropertyChanges */ Ember.endPropertyChanges = function() { deferred--; if (deferred<=0) flushObserverQueue(); }; /** Make a series of property changes together in an exception-safe way. Ember.changeProperties(function() { obj1.set('foo', mayBlowUpWhenSet); obj2.set('bar', baz); }); @method changeProperties @param {Function} callback @param [binding] */ Ember.changeProperties = function(cb, binding){ Ember.beginPropertyChanges(); try { cb.call(binding); } finally { Ember.endPropertyChanges(); } }; /** Set a list of properties on an object. These properties are set inside a single `beginPropertyChanges` and `endPropertyChanges` batch, so observers will be buffered. @method setProperties @param target @param {Hash} properties @return target */ Ember.setProperties = function(self, hash) { Ember.changeProperties(function(){ for(var prop in hash) { if (hash.hasOwnProperty(prop)) Ember.set(self, prop, hash[prop]); } }); return self; }; function changeEvent(keyName) { return keyName+AFTER_OBSERVERS; } function beforeEvent(keyName) { return keyName+BEFORE_OBSERVERS; } /** @method addObserver @param obj @param {String} path @param {Object|Function} targetOrMethod @param {Function|String} [method] */ Ember.addObserver = function(obj, path, target, method) { Ember.addListener(obj, changeEvent(path), target, method); Ember.watch(obj, path); return this; }; Ember.observersFor = function(obj, path) { return Ember.listenersFor(obj, changeEvent(path)); }; /** @method removeObserver @param obj @param {String} path @param {Object|Function} targetOrMethod @param {Function|String} [method] */ Ember.removeObserver = function(obj, path, target, method) { Ember.unwatch(obj, path); Ember.removeListener(obj, changeEvent(path), target, method); return this; }; /** @method addBeforeObserver @param obj @param {String} path @param {Object|Function} targetOrMethod @param {Function|String} [method] */ Ember.addBeforeObserver = function(obj, path, target, method) { Ember.addListener(obj, beforeEvent(path), target, method); Ember.watch(obj, path); return this; }; // Suspend observer during callback. // // This should only be used by the target of the observer // while it is setting the observed path. Ember._suspendBeforeObserver = function(obj, path, target, method, callback) { return Ember._suspendListener(obj, beforeEvent(path), target, method, callback); }; Ember._suspendObserver = function(obj, path, target, method, callback) { return Ember._suspendListener(obj, changeEvent(path), target, method, callback); }; var map = Ember.ArrayPolyfills.map; Ember._suspendBeforeObservers = function(obj, paths, target, method, callback) { var events = map.call(paths, beforeEvent); return Ember._suspendListeners(obj, events, target, method, callback); }; Ember._suspendObservers = function(obj, paths, target, method, callback) { var events = map.call(paths, changeEvent); return Ember._suspendListeners(obj, events, target, method, callback); }; Ember.beforeObserversFor = function(obj, path) { return Ember.listenersFor(obj, beforeEvent(path)); }; /** @method removeBeforeObserver @param obj @param {String} path @param {Object|Function} targetOrMethod @param {Function|String} [method] */ Ember.removeBeforeObserver = function(obj, path, target, method) { Ember.unwatch(obj, path); Ember.removeListener(obj, beforeEvent(path), target, method); return this; }; Ember.notifyObservers = function(obj, keyName) { if (obj.isDestroying) { return; } notifyObservers(obj, changeEvent(keyName), keyName); }; Ember.notifyBeforeObservers = function(obj, keyName) { if (obj.isDestroying) { return; } var guid, set, forceNotification = false; if (deferred) { if (beforeObserverSet.add(obj, keyName)) { forceNotification = true; } else { return; } } notifyObservers(obj, beforeEvent(keyName), keyName, forceNotification); }; })(); (function() { /** @module ember-metal */ var guidFor = Ember.guidFor, // utils.js metaFor = Ember.meta, // utils.js get = Ember.get, // accessors.js set = Ember.set, // accessors.js normalizeTuple = Ember.normalizeTuple, // accessors.js GUID_KEY = Ember.GUID_KEY, // utils.js META_KEY = Ember.META_KEY, // utils.js // circular reference observer depends on Ember.watch // we should move change events to this file or its own property_events.js notifyObservers = Ember.notifyObservers, // observer.js forEach = Ember.ArrayPolyfills.forEach, // array.js FIRST_KEY = /^([^\.\*]+)/, IS_PATH = /[\.\*]/; var MANDATORY_SETTER = Ember.ENV.MANDATORY_SETTER, o_defineProperty = Ember.platform.defineProperty; function firstKey(path) { return path.match(FIRST_KEY)[0]; } // returns true if the passed path is just a keyName function isKeyName(path) { return path==='*' || !IS_PATH.test(path); } // .......................................................... // DEPENDENT KEYS // var DEP_SKIP = { __emberproto__: true }; // skip some keys and toString function iterDeps(method, obj, depKey, seen, meta) { var guid = guidFor(obj); if (!seen[guid]) seen[guid] = {}; if (seen[guid][depKey]) return; seen[guid][depKey] = true; var deps = meta.deps; deps = deps && deps[depKey]; if (deps) { for(var key in deps) { if (DEP_SKIP[key]) continue; var desc = meta.descs[key]; if (desc && desc._suspended === obj) continue; method(obj, key); } } } var WILL_SEEN, DID_SEEN; // called whenever a property is about to change to clear the cache of any dependent keys (and notify those properties of changes, etc...) function dependentKeysWillChange(obj, depKey, meta) { if (obj.isDestroying) { return; } var seen = WILL_SEEN, top = !seen; if (top) { seen = WILL_SEEN = {}; } iterDeps(propertyWillChange, obj, depKey, seen, meta); if (top) { WILL_SEEN = null; } } // called whenever a property has just changed to update dependent keys function dependentKeysDidChange(obj, depKey, meta) { if (obj.isDestroying) { return; } var seen = DID_SEEN, top = !seen; if (top) { seen = DID_SEEN = {}; } iterDeps(propertyDidChange, obj, depKey, seen, meta); if (top) { DID_SEEN = null; } } // .......................................................... // CHAIN // function addChainWatcher(obj, keyName, node) { if (!obj || ('object' !== typeof obj)) return; // nothing to do var m = metaFor(obj); var nodes = m.chainWatchers; if (!nodes || nodes.__emberproto__ !== obj) { nodes = m.chainWatchers = { __emberproto__: obj }; } if (!nodes[keyName]) { nodes[keyName] = {}; } nodes[keyName][guidFor(node)] = node; Ember.watch(obj, keyName); } function removeChainWatcher(obj, keyName, node) { if (!obj || 'object' !== typeof obj) { return; } // nothing to do var m = metaFor(obj, false), nodes = m.chainWatchers; if (!nodes || nodes.__emberproto__ !== obj) { return; } //nothing to do if (nodes[keyName]) { delete nodes[keyName][guidFor(node)]; } Ember.unwatch(obj, keyName); } var pendingQueue = []; // attempts to add the pendingQueue chains again. If some of them end up // back in the queue and reschedule is true, schedules a timeout to try // again. function flushPendingChains() { if (pendingQueue.length === 0) { return; } // nothing to do var queue = pendingQueue; pendingQueue = []; forEach.call(queue, function(q) { q[0].add(q[1]); }); Ember.warn('Watching an undefined global, Ember expects watched globals to be setup by the time the run loop is flushed, check for typos', pendingQueue.length === 0); } function isProto(pvalue) { return metaFor(pvalue, false).proto === pvalue; } // A ChainNode watches a single key on an object. If you provide a starting // value for the key then the node won't actually watch it. For a root node // pass null for parent and key and object for value. var ChainNode = function(parent, key, value, separator) { var obj; this._parent = parent; this._key = key; // _watching is true when calling get(this._parent, this._key) will // return the value of this node. // // It is false for the root of a chain (because we have no parent) // and for global paths (because the parent node is the object with // the observer on it) this._watching = value===undefined; this._value = value; this._separator = separator || '.'; this._paths = {}; if (this._watching) { this._object = parent.value(); if (this._object) { addChainWatcher(this._object, this._key, this); } } // Special-case: the EachProxy relies on immediate evaluation to // establish its observers. // // TODO: Replace this with an efficient callback that the EachProxy // can implement. if (this._parent && this._parent._key === '@each') { this.value(); } }; var ChainNodePrototype = ChainNode.prototype; ChainNodePrototype.value = function() { if (this._value === undefined && this._watching) { var obj = this._parent.value(); this._value = (obj && !isProto(obj)) ? get(obj, this._key) : undefined; } return this._value; }; ChainNodePrototype.destroy = function() { if (this._watching) { var obj = this._object; if (obj) { removeChainWatcher(obj, this._key, this); } this._watching = false; // so future calls do nothing } }; // copies a top level object only ChainNodePrototype.copy = function(obj) { var ret = new ChainNode(null, null, obj, this._separator), paths = this._paths, path; for (path in paths) { if (paths[path] <= 0) { continue; } // this check will also catch non-number vals. ret.add(path); } return ret; }; // called on the root node of a chain to setup watchers on the specified // path. ChainNodePrototype.add = function(path) { var obj, tuple, key, src, separator, paths; paths = this._paths; paths[path] = (paths[path] || 0) + 1; obj = this.value(); tuple = normalizeTuple(obj, path); // the path was a local path if (tuple[0] && tuple[0] === obj) { path = tuple[1]; key = firstKey(path); path = path.slice(key.length+1); // global path, but object does not exist yet. // put into a queue and try to connect later. } else if (!tuple[0]) { pendingQueue.push([this, path]); tuple.length = 0; return; // global path, and object already exists } else { src = tuple[0]; key = path.slice(0, 0-(tuple[1].length+1)); separator = path.slice(key.length, key.length+1); path = tuple[1]; } tuple.length = 0; this.chain(key, path, src, separator); }; // called on the root node of a chain to teardown watcher on the specified // path ChainNodePrototype.remove = function(path) { var obj, tuple, key, src, paths; paths = this._paths; if (paths[path] > 0) { paths[path]--; } obj = this.value(); tuple = normalizeTuple(obj, path); if (tuple[0] === obj) { path = tuple[1]; key = firstKey(path); path = path.slice(key.length+1); } else { src = tuple[0]; key = path.slice(0, 0-(tuple[1].length+1)); path = tuple[1]; } tuple.length = 0; this.unchain(key, path); }; ChainNodePrototype.count = 0; ChainNodePrototype.chain = function(key, path, src, separator) { var chains = this._chains, node; if (!chains) { chains = this._chains = {}; } node = chains[key]; if (!node) { node = chains[key] = new ChainNode(this, key, src, separator); } node.count++; // count chains... // chain rest of path if there is one if (path && path.length>0) { key = firstKey(path); path = path.slice(key.length+1); node.chain(key, path); // NOTE: no src means it will observe changes... } }; ChainNodePrototype.unchain = function(key, path) { var chains = this._chains, node = chains[key]; // unchain rest of path first... if (path && path.length>1) { key = firstKey(path); path = path.slice(key.length+1); node.unchain(key, path); } // delete node if needed. node.count--; if (node.count<=0) { delete chains[node._key]; node.destroy(); } }; ChainNodePrototype.willChange = function() { var chains = this._chains; if (chains) { for(var key in chains) { if (!chains.hasOwnProperty(key)) { continue; } chains[key].willChange(); } } if (this._parent) { this._parent.chainWillChange(this, this._key, 1); } }; ChainNodePrototype.chainWillChange = function(chain, path, depth) { if (this._key) { path = this._key + this._separator + path; } if (this._parent) { this._parent.chainWillChange(this, path, depth+1); } else { if (depth > 1) { Ember.propertyWillChange(this.value(), path); } path = 'this.' + path; if (this._paths[path] > 0) { Ember.propertyWillChange(this.value(), path); } } }; ChainNodePrototype.chainDidChange = function(chain, path, depth) { if (this._key) { path = this._key + this._separator + path; } if (this._parent) { this._parent.chainDidChange(this, path, depth+1); } else { if (depth > 1) { Ember.propertyDidChange(this.value(), path); } path = 'this.' + path; if (this._paths[path] > 0) { Ember.propertyDidChange(this.value(), path); } } }; ChainNodePrototype.didChange = function(suppressEvent) { // invalidate my own value first. if (this._watching) { var obj = this._parent.value(); if (obj !== this._object) { removeChainWatcher(this._object, this._key, this); this._object = obj; addChainWatcher(obj, this._key, this); } this._value = undefined; // Special-case: the EachProxy relies on immediate evaluation to // establish its observers. if (this._parent && this._parent._key === '@each') this.value(); } // then notify chains... var chains = this._chains; if (chains) { for(var key in chains) { if (!chains.hasOwnProperty(key)) { continue; } chains[key].didChange(suppressEvent); } } if (suppressEvent) { return; } // and finally tell parent about my path changing... if (this._parent) { this._parent.chainDidChange(this, this._key, 1); } }; // get the chains for the current object. If the current object has // chains inherited from the proto they will be cloned and reconfigured for // the current object. function chainsFor(obj) { var m = metaFor(obj), ret = m.chains; if (!ret) { ret = m.chains = new ChainNode(null, null, obj); } else if (ret.value() !== obj) { ret = m.chains = ret.copy(obj); } return ret; } function notifyChains(obj, m, keyName, methodName, arg) { var nodes = m.chainWatchers; if (!nodes || nodes.__emberproto__ !== obj) { return; } // nothing to do nodes = nodes[keyName]; if (!nodes) { return; } for(var key in nodes) { if (!nodes.hasOwnProperty(key)) { continue; } nodes[key][methodName](arg); } } Ember.overrideChains = function(obj, keyName, m) { notifyChains(obj, m, keyName, 'didChange', true); }; function chainsWillChange(obj, keyName, m) { notifyChains(obj, m, keyName, 'willChange'); } function chainsDidChange(obj, keyName, m) { notifyChains(obj, m, keyName, 'didChange'); } // .......................................................... // WATCH // /** @private Starts watching a property on an object. Whenever the property changes, invokes Ember.propertyWillChange and Ember.propertyDidChange. This is the primitive used by observers and dependent keys; usually you will never call this method directly but instead use higher level methods like Ember.addObserver(). @method watch @for Ember @param obj @param {String} keyName */ Ember.watch = function(obj, keyName) { // can't watch length on Array - it is special... if (keyName === 'length' && Ember.typeOf(obj) === 'array') { return this; } var m = metaFor(obj), watching = m.watching, desc; // activate watching first time if (!watching[keyName]) { watching[keyName] = 1; if (isKeyName(keyName)) { desc = m.descs[keyName]; if (desc && desc.willWatch) { desc.willWatch(obj, keyName); } if ('function' === typeof obj.willWatchProperty) { obj.willWatchProperty(keyName); } if (MANDATORY_SETTER && keyName in obj) { m.values[keyName] = obj[keyName]; o_defineProperty(obj, keyName, { configurable: true, enumerable: true, set: function() { Ember.assert('Must use Ember.set() to access this property', false); }, get: function() { var meta = this[META_KEY]; return meta && meta.values[keyName]; } }); } } else { chainsFor(obj).add(keyName); } } else { watching[keyName] = (watching[keyName] || 0) + 1; } return this; }; Ember.isWatching = function isWatching(obj, key) { var meta = obj[META_KEY]; return (meta && meta.watching[key]) > 0; }; Ember.watch.flushPending = flushPendingChains; Ember.unwatch = function(obj, keyName) { // can't watch length on Array - it is special... if (keyName === 'length' && Ember.typeOf(obj) === 'array') { return this; } var m = metaFor(obj), watching = m.watching, desc; if (watching[keyName] === 1) { watching[keyName] = 0; if (isKeyName(keyName)) { desc = m.descs[keyName]; if (desc && desc.didUnwatch) { desc.didUnwatch(obj, keyName); } if ('function' === typeof obj.didUnwatchProperty) { obj.didUnwatchProperty(keyName); } if (MANDATORY_SETTER && keyName in obj) { o_defineProperty(obj, keyName, { configurable: true, enumerable: true, writable: true, value: m.values[keyName] }); delete m.values[keyName]; } } else { chainsFor(obj).remove(keyName); } } else if (watching[keyName]>1) { watching[keyName]--; } return this; }; /** @private Call on an object when you first beget it from another object. This will setup any chained watchers on the object instance as needed. This method is safe to call multiple times. @method rewatch @for Ember @param obj */ Ember.rewatch = function(obj) { var m = metaFor(obj, false), chains = m.chains; // make sure the object has its own guid. if (GUID_KEY in obj && !obj.hasOwnProperty(GUID_KEY)) { Ember.generateGuid(obj, 'ember'); } // make sure any chained watchers update. if (chains && chains.value() !== obj) { m.chains = chains.copy(obj); } return this; }; Ember.finishChains = function(obj) { var m = metaFor(obj, false), chains = m.chains; if (chains) { if (chains.value() !== obj) { m.chains = chains = chains.copy(obj); } chains.didChange(true); } }; // .......................................................... // PROPERTY CHANGES // /** This function is called just before an object property is about to change. It will notify any before observers and prepare caches among other things. Normally you will not need to call this method directly but if for some reason you can't directly watch a property you can invoke this method manually along with `Ember.propertyDidChange()` which you should call just after the property value changes. @method propertyWillChange @for Ember @param {Object} obj The object with the property that will change @param {String} keyName The property key (or path) that will change. @return {void} */ function propertyWillChange(obj, keyName, value) { var m = metaFor(obj, false), watching = m.watching[keyName] > 0 || keyName === 'length', proto = m.proto, desc = m.descs[keyName]; if (!watching) { return; } if (proto === obj) { return; } if (desc && desc.willChange) { desc.willChange(obj, keyName); } dependentKeysWillChange(obj, keyName, m); chainsWillChange(obj, keyName, m); Ember.notifyBeforeObservers(obj, keyName); } Ember.propertyWillChange = propertyWillChange; /** This function is called just after an object property has changed. It will notify any observers and clear caches among other things. Normally you will not need to call this method directly but if for some reason you can't directly watch a property you can invoke this method manually along with `Ember.propertyWilLChange()` which you should call just before the property value changes. @method propertyDidChange @for Ember @param {Object} obj The object with the property that will change @param {String} keyName The property key (or path) that will change. @return {void} */ function propertyDidChange(obj, keyName) { var m = metaFor(obj, false), watching = m.watching[keyName] > 0 || keyName === 'length', proto = m.proto, desc = m.descs[keyName]; if (proto === obj) { return; } // shouldn't this mean that we're watching this key? if (desc && desc.didChange) { desc.didChange(obj, keyName); } if (!watching && keyName !== 'length') { return; } dependentKeysDidChange(obj, keyName, m); chainsDidChange(obj, keyName, m); Ember.notifyObservers(obj, keyName); } Ember.propertyDidChange = propertyDidChange; var NODE_STACK = []; /** Tears down the meta on an object so that it can be garbage collected. Multiple calls will have no effect. @method destroy @for Ember @param {Object} obj the object to destroy @return {void} */ Ember.destroy = function (obj) { var meta = obj[META_KEY], node, nodes, key, nodeObject; if (meta) { obj[META_KEY] = null; // remove chainWatchers to remove circular references that would prevent GC node = meta.chains; if (node) { NODE_STACK.push(node); // process tree while (NODE_STACK.length > 0) { node = NODE_STACK.pop(); // push children nodes = node._chains; if (nodes) { for (key in nodes) { if (nodes.hasOwnProperty(key)) { NODE_STACK.push(nodes[key]); } } } // remove chainWatcher in node object if (node._watching) { nodeObject = node._object; if (nodeObject) { removeChainWatcher(nodeObject, node._key, node); } } } } } }; })(); (function() { /** @module ember-metal */ Ember.warn("The CP_DEFAULT_CACHEABLE flag has been removed and computed properties are always cached by default. Use `volatile` if you don't want caching.", Ember.ENV.CP_DEFAULT_CACHEABLE !== false); var get = Ember.get, metaFor = Ember.meta, guidFor = Ember.guidFor, a_slice = [].slice, o_create = Ember.create, META_KEY = Ember.META_KEY, watch = Ember.watch, unwatch = Ember.unwatch; // .......................................................... // DEPENDENT KEYS // // data structure: // meta.deps = { // 'depKey': { // 'keyName': count, // __emberproto__: SRC_OBJ [to detect clones] // }, // __emberproto__: SRC_OBJ // } /* This function returns a map of unique dependencies for a given object and key. */ function keysForDep(obj, depsMeta, depKey) { var keys = depsMeta[depKey]; if (!keys) { // if there are no dependencies yet for a the given key // create a new empty list of dependencies for the key keys = depsMeta[depKey] = { __emberproto__: obj }; } else if (keys.__emberproto__ !== obj) { // otherwise if the dependency list is inherited from // a superclass, clone the hash keys = depsMeta[depKey] = o_create(keys); keys.__emberproto__ = obj; } return keys; } /* return obj[META_KEY].deps */ function metaForDeps(obj, meta) { var deps = meta.deps; // If the current object has no dependencies... if (!deps) { // initialize the dependencies with a pointer back to // the current object deps = meta.deps = { __emberproto__: obj }; } else if (deps.__emberproto__ !== obj) { // otherwise if the dependencies are inherited from the // object's superclass, clone the deps deps = meta.deps = o_create(deps); deps.__emberproto__ = obj; } return deps; } function addDependentKeys(desc, obj, keyName, meta) { // the descriptor has a list of dependent keys, so // add all of its dependent keys. var depKeys = desc._dependentKeys, depsMeta, idx, len, depKey, keys; if (!depKeys) return; depsMeta = metaForDeps(obj, meta); for(idx = 0, len = depKeys.length; idx < len; idx++) { depKey = depKeys[idx]; // Lookup keys meta for depKey keys = keysForDep(obj, depsMeta, depKey); // Increment the number of times depKey depends on keyName. keys[keyName] = (keys[keyName] || 0) + 1; // Watch the depKey watch(obj, depKey); } } function removeDependentKeys(desc, obj, keyName, meta) { // the descriptor has a list of dependent keys, so // add all of its dependent keys. var depKeys = desc._dependentKeys, depsMeta, idx, len, depKey, keys; if (!depKeys) return; depsMeta = metaForDeps(obj, meta); for(idx = 0, len = depKeys.length; idx < len; idx++) { depKey = depKeys[idx]; // Lookup keys meta for depKey keys = keysForDep(obj, depsMeta, depKey); // Increment the number of times depKey depends on keyName. keys[keyName] = (keys[keyName] || 0) - 1; // Watch the depKey unwatch(obj, depKey); } } // .......................................................... // COMPUTED PROPERTY // /** @class ComputedProperty @namespace Ember @extends Ember.Descriptor @constructor */ function ComputedProperty(func, opts) { this.func = func; this._cacheable = (opts && opts.cacheable !== undefined) ? opts.cacheable : true; this._dependentKeys = opts && opts.dependentKeys; } Ember.ComputedProperty = ComputedProperty; ComputedProperty.prototype = new Ember.Descriptor(); var ComputedPropertyPrototype = ComputedProperty.prototype; /** Call on a computed property to set it into cacheable mode. When in this mode the computed property will automatically cache the return value of your function until one of the dependent keys changes. MyApp.president = Ember.Object.create({ fullName: function() { return this.get('firstName') + ' ' + this.get('lastName'); // After calculating the value of this function, Ember.js will // return that value without re-executing this function until // one of the dependent properties change. }.property('firstName', 'lastName') }); Properties are cacheable by default. @method cacheable @param {Boolean} aFlag optional set to false to disable caching @chainable */ ComputedPropertyPrototype.cacheable = function(aFlag) { this._cacheable = aFlag !== false; return this; }; /** Call on a computed property to set it into non-cached mode. When in this mode the computed property will not automatically cache the return value. MyApp.outsideService = Ember.Object.create({ value: function() { return OutsideService.getValue(); }.property().volatile() }); @method volatile @chainable */ ComputedPropertyPrototype.volatile = function() { return this.cacheable(false); }; /** Sets the dependent keys on this computed property. Pass any number of arguments containing key paths that this computed property depends on. MyApp.president = Ember.Object.create({ fullName: Ember.computed(function() { return this.get('firstName') + ' ' + this.get('lastName'); // Tell Ember.js that this computed property depends on firstName // and lastName }).property('firstName', 'lastName') }); @method property @param {String} path* zero or more property paths @chainable */ ComputedPropertyPrototype.property = function() { var args = []; for (var i = 0, l = arguments.length; i < l; i++) { args.push(arguments[i]); } this._dependentKeys = args; return this; }; /** In some cases, you may want to annotate computed properties with additional metadata about how they function or what values they operate on. For example, computed property functions may close over variables that are then no longer available for introspection. You can pass a hash of these values to a computed property like this: person: function() { var personId = this.get('personId'); return App.Person.create({ id: personId }); }.property().meta({ type: App.Person }) The hash that you pass to the `meta()` function will be saved on the computed property descriptor under the `_meta` key. Ember runtime exposes a public API for retrieving these values from classes, via the `metaForProperty()` function. @method meta @param {Hash} meta @chainable */ ComputedPropertyPrototype.meta = function(meta) { if (arguments.length === 0) { return this._meta || {}; } else { this._meta = meta; return this; } }; /* impl descriptor API */ ComputedPropertyPrototype.willWatch = function(obj, keyName) { // watch already creates meta for this instance var meta = obj[META_KEY]; Ember.assert('watch should have setup meta to be writable', meta.source === obj); if (!(keyName in meta.cache)) { addDependentKeys(this, obj, keyName, meta); } }; ComputedPropertyPrototype.didUnwatch = function(obj, keyName) { var meta = obj[META_KEY]; Ember.assert('unwatch should have setup meta to be writable', meta.source === obj); if (!(keyName in meta.cache)) { // unwatch already creates meta for this instance removeDependentKeys(this, obj, keyName, meta); } }; /* impl descriptor API */ ComputedPropertyPrototype.didChange = function(obj, keyName) { // _suspended is set via a CP.set to ensure we don't clear // the cached value set by the setter if (this._cacheable && this._suspended !== obj) { var meta = metaFor(obj); if (keyName in meta.cache) { delete meta.cache[keyName]; if (!meta.watching[keyName]) { removeDependentKeys(this, obj, keyName, meta); } } } }; /* impl descriptor API */ ComputedPropertyPrototype.get = function(obj, keyName) { var ret, cache, meta; if (this._cacheable) { meta = metaFor(obj); cache = meta.cache; if (keyName in cache) { return cache[keyName]; } ret = cache[keyName] = this.func.call(obj, keyName); if (!meta.watching[keyName]) { addDependentKeys(this, obj, keyName, meta); } } else { ret = this.func.call(obj, keyName); } return ret; }; /* impl descriptor API */ ComputedPropertyPrototype.set = function(obj, keyName, value) { var cacheable = this._cacheable, meta = metaFor(obj, cacheable), watched = meta.watching[keyName], oldSuspended = this._suspended, hadCachedValue = false, ret; this._suspended = obj; try { ret = this.func.call(obj, keyName, value); if (cacheable && keyName in meta.cache) { if (meta.cache[keyName] === ret) { return; } hadCachedValue = true; } if (watched) { Ember.propertyWillChange(obj, keyName); } if (cacheable && hadCachedValue) { delete meta.cache[keyName]; } if (cacheable) { if (!watched && !hadCachedValue) { addDependentKeys(this, obj, keyName, meta); } meta.cache[keyName] = ret; } if (watched) { Ember.propertyDidChange(obj, keyName); } } finally { this._suspended = oldSuspended; } return ret; }; /* called when property is defined */ ComputedPropertyPrototype.setup = function(obj, keyName) { var meta = obj[META_KEY]; if (meta && meta.watching[keyName]) { addDependentKeys(this, obj, keyName, metaFor(obj)); } }; /* called before property is overridden */ ComputedPropertyPrototype.teardown = function(obj, keyName) { var meta = metaFor(obj); if (meta.watching[keyName] || keyName in meta.cache) { removeDependentKeys(this, obj, keyName, meta); } if (this._cacheable) { delete meta.cache[keyName]; } return null; // no value to restore }; /** This helper returns a new property descriptor that wraps the passed computed property function. You can use this helper to define properties with mixins or via Ember.defineProperty(). The function you pass will be used to both get and set property values. The function should accept two parameters, key and value. If value is not undefined you should set the value first. In either case return the current value of the property. @method computed @for Ember @param {Function} func The computed property function. @return {Ember.ComputedProperty} property descriptor instance */ Ember.computed = function(func) { var args; if (arguments.length > 1) { args = a_slice.call(arguments, 0, -1); func = a_slice.call(arguments, -1)[0]; } var cp = new ComputedProperty(func); if (args) { cp.property.apply(cp, args); } return cp; }; /** Returns the cached value for a property, if one exists. This can be useful for peeking at the value of a computed property that is generated lazily, without accidentally causing it to be created. @method cacheFor @for Ember @param {Object} obj the object whose property you want to check @param {String} key the name of the property whose cached value you want to return */ Ember.cacheFor = function cacheFor(obj, key) { var cache = metaFor(obj, false).cache; if (cache && key in cache) { return cache[key]; } }; /** @method computed.not @for Ember @param {String} dependentKey */ Ember.computed.not = function(dependentKey) { return Ember.computed(dependentKey, function(key) { return !get(this, dependentKey); }); }; /** @method computed.empty @for Ember @param {String} dependentKey */ Ember.computed.empty = function(dependentKey) { return Ember.computed(dependentKey, function(key) { var val = get(this, dependentKey); return val === undefined || val === null || val === '' || (Ember.isArray(val) && get(val, 'length') === 0); }); }; /** @method computed.bool @for Ember @param {String} dependentKey */ Ember.computed.bool = function(dependentKey) { return Ember.computed(dependentKey, function(key) { return !!get(this, dependentKey); }); }; })(); (function() { /** @module ember-metal */ var o_create = Ember.create, meta = Ember.meta, metaPath = Ember.metaPath, guidFor = Ember.guidFor, a_slice = [].slice; /* The event system uses a series of nested hashes to store listeners on an object. When a listener is registered, or when an event arrives, these hashes are consulted to determine which target and action pair to invoke. The hashes are stored in the object's meta hash, and look like this: // Object's meta hash { listeners: { // variable name: `listenerSet` "foo:changed": { // variable name: `targetSet` [targetGuid]: { // variable name: `actionSet` [methodGuid]: { // variable name: `action` target: [Object object], method: [Function function] } } } } } */ // Gets the set of all actions, keyed on the guid of each action's // method property. function actionSetFor(obj, eventName, target, writable) { return metaPath(obj, ['listeners', eventName, guidFor(target)], writable); } // Gets the set of all targets, keyed on the guid of each action's // target property. function targetSetFor(obj, eventName) { var listenerSet = meta(obj, false).listeners; if (!listenerSet) { return false; } return listenerSet[eventName] || false; } // TODO: This knowledge should really be a part of the // meta system. var SKIP_PROPERTIES = { __ember_source__: true }; function iterateSet(obj, eventName, callback, params) { var targetSet = targetSetFor(obj, eventName); if (!targetSet) { return false; } // Iterate through all elements of the target set for(var targetGuid in targetSet) { if (SKIP_PROPERTIES[targetGuid]) { continue; } var actionSet = targetSet[targetGuid]; if (actionSet) { // Iterate through the elements of the action set for(var methodGuid in actionSet) { if (SKIP_PROPERTIES[methodGuid]) { continue; } var action = actionSet[methodGuid]; if (action) { if (callback(action, params, obj) === true) { return true; } } } } } return false; } function invokeAction(action, params, sender) { var method = action.method, target = action.target; // If there is no target, the target is the object // on which the event was fired. if (!target) { target = sender; } if ('string' === typeof method) { method = target[method]; } if (params) { method.apply(target, params); } else { method.apply(target); } } /** Add an event listener @method addListener @for Ember @param obj @param {String} eventName @param {Object|Function} targetOrMethod A target object or a function @param {Function|String} method A function or the name of a function to be called on `target` */ function addListener(obj, eventName, target, method, guid) { Ember.assert("You must pass at least an object and event name to Ember.addListener", !!obj && !!eventName); if (!method && 'function' === typeof target) { method = target; target = null; } var actionSet = actionSetFor(obj, eventName, target, true), // guid is used in case we wrapp given method to register // listener with method guid instead of the wrapper guid methodGuid = guid || guidFor(method); if (!actionSet[methodGuid]) { actionSet[methodGuid] = { target: target, method: method }; } if ('function' === typeof obj.didAddListener) { obj.didAddListener(eventName, target, method); } } /** Remove an event listener Arguments should match those passed to {{#crossLink "Ember/addListener"}}{{/crossLink}} @method removeListener @for Ember @param obj @param {String} eventName @param {Object|Function} targetOrMethod A target object or a function @param {Function|String} method A function or the name of a function to be called on `target` */ function removeListener(obj, eventName, target, method) { Ember.assert("You must pass at least an object and event name to Ember.removeListener", !!obj && !!eventName); if (!method && 'function' === typeof target) { method = target; target = null; } function _removeListener(target, method) { var actionSet = actionSetFor(obj, eventName, target, true), methodGuid = guidFor(method); // we can't simply delete this parameter, because if we do, we might // re-expose the property from the prototype chain. if (actionSet && actionSet[methodGuid]) { actionSet[methodGuid] = null; } if ('function' === typeof obj.didRemoveListener) { obj.didRemoveListener(eventName, target, method); } } if (method) { _removeListener(target, method); } else { iterateSet(obj, eventName, function(action) { _removeListener(action.target, action.method); }); } } /** @private Suspend listener during callback. This should only be used by the target of the event listener when it is taking an action that would cause the event, e.g. an object might suspend its property change listener while it is setting that property. @method suspendListener @for Ember @param obj @param {String} eventName @param {Object|Function} targetOrMethod A target object or a function @param {Function|String} method A function or the name of a function to be called on `target` @param {Function} callback */ function suspendListener(obj, eventName, target, method, callback) { if (!method && 'function' === typeof target) { method = target; target = null; } var actionSet = actionSetFor(obj, eventName, target, true), methodGuid = guidFor(method), action = actionSet && actionSet[methodGuid]; actionSet[methodGuid] = null; try { return callback.call(target); } finally { actionSet[methodGuid] = action; } } /** @private Suspend listener during callback. This should only be used by the target of the event listener when it is taking an action that would cause the event, e.g. an object might suspend its property change listener while it is setting that property. @method suspendListener @for Ember @param obj @param {Array} eventName Array of event names @param {Object|Function} targetOrMethod A target object or a function @param {Function|String} method A function or the name of a function to be called on `target` @param {Function} callback */ function suspendListeners(obj, eventNames, target, method, callback) { if (!method && 'function' === typeof target) { method = target; target = null; } var oldActions = [], actionSets = [], eventName, actionSet, methodGuid, action, i, l; for (i=0, l=eventNames.length; i 0) { args = args.length > ignore ? slice.call(args, ignore) : null; } return Ember.handleErrors(function() { // IE8's Function.prototype.apply doesn't accept undefined/null arguments. return method.apply(target || this, args || []); }, this); } // .......................................................... // RUNLOOP // var timerMark; // used by timers... /** Ember RunLoop (Private) @class RunLoop @namespace Ember @private @constructor */ var RunLoop = function(prev) { this._prev = prev || null; this.onceTimers = {}; }; RunLoop.prototype = { /** @method end */ end: function() { this.flush(); }, /** @method prev */ prev: function() { return this._prev; }, // .......................................................... // Delayed Actions // /** @method schedule @param {String} queueName @param target @param method */ schedule: function(queueName, target, method) { var queues = this._queues, queue; if (!queues) { queues = this._queues = {}; } queue = queues[queueName]; if (!queue) { queue = queues[queueName] = []; } var args = arguments.length > 3 ? slice.call(arguments, 3) : null; queue.push({ target: target, method: method, args: args }); return this; }, /** @method flush @param {String} queueName */ flush: function(queueName) { var queueNames, idx, len, queue, log; if (!this._queues) { return this; } // nothing to do function iter(item) { invoke(item.target, item.method, item.args); } Ember.watch.flushPending(); // make sure all chained watchers are setup if (queueName) { while (this._queues && (queue = this._queues[queueName])) { this._queues[queueName] = null; // the sync phase is to allow property changes to propagate. don't // invoke observers until that is finished. if (queueName === 'sync') { log = Ember.LOG_BINDINGS; if (log) { Ember.Logger.log('Begin: Flush Sync Queue'); } Ember.beginPropertyChanges(); try { forEach.call(queue, iter); } finally { Ember.endPropertyChanges(); } if (log) { Ember.Logger.log('End: Flush Sync Queue'); } } else { forEach.call(queue, iter); } } } else { queueNames = Ember.run.queues; len = queueNames.length; idx = 0; outerloop: while (idx < len) { queueName = queueNames[idx]; queue = this._queues && this._queues[queueName]; delete this._queues[queueName]; if (queue) { // the sync phase is to allow property changes to propagate. don't // invoke observers until that is finished. if (queueName === 'sync') { log = Ember.LOG_BINDINGS; if (log) { Ember.Logger.log('Begin: Flush Sync Queue'); } Ember.beginPropertyChanges(); try { forEach.call(queue, iter); } finally { Ember.endPropertyChanges(); } if (log) { Ember.Logger.log('End: Flush Sync Queue'); } } else { forEach.call(queue, iter); } } // Loop through prior queues for (var i = 0; i <= idx; i++) { if (this._queues && this._queues[queueNames[i]]) { // Start over at the first queue with contents idx = i; continue outerloop; } } idx++; } } timerMark = null; return this; } }; Ember.RunLoop = RunLoop; // .......................................................... // Ember.run - this is ideally the only public API the dev sees // /** Runs the passed target and method inside of a RunLoop, ensuring any deferred actions including bindings and views updates are flushed at the end. Normally you should not need to invoke this method yourself. However if you are implementing raw event handlers when interfacing with other libraries or plugins, you should probably wrap all of your code inside this call. Ember.run(function(){ // code to be execute within a RunLoop }); @class run @namespace Ember @static @constructor @param {Object} [target] target of method to call @param {Function|String} method Method to invoke. May be a function or a string. If you pass a string then it will be looked up on the passed target. @param {Object} [args*] Any additional arguments you wish to pass to the method. @return {Object} return value from invoking the passed function. */ Ember.run = function(target, method) { var ret, loop; run.begin(); try { if (target || method) { ret = invoke(target, method, arguments, 2); } } finally { run.end(); } return ret; }; var run = Ember.run; /** Begins a new RunLoop. Any deferred actions invoked after the begin will be buffered until you invoke a matching call to Ember.run.end(). This is an lower-level way to use a RunLoop instead of using Ember.run(). Ember.run.begin(); // code to be execute within a RunLoop Ember.run.end(); @method begin @return {void} */ Ember.run.begin = function() { run.currentRunLoop = new RunLoop(run.currentRunLoop); }; /** Ends a RunLoop. This must be called sometime after you call Ember.run.begin() to flush any deferred actions. This is a lower-level way to use a RunLoop instead of using Ember.run(). Ember.run.begin(); // code to be execute within a RunLoop Ember.run.end(); @method end @return {void} */ Ember.run.end = function() { Ember.assert('must have a current run loop', run.currentRunLoop); try { run.currentRunLoop.end(); } finally { run.currentRunLoop = run.currentRunLoop.prev(); } }; /** Array of named queues. This array determines the order in which queues are flushed at the end of the RunLoop. You can define your own queues by simply adding the queue name to this array. Normally you should not need to inspect or modify this property. @property queues @type Array @default ['sync', 'actions', 'destroy', 'timers'] */ Ember.run.queues = ['sync', 'actions', 'destroy', 'timers']; /** Adds the passed target/method and any optional arguments to the named queue to be executed at the end of the RunLoop. If you have not already started a RunLoop when calling this method one will be started for you automatically. At the end of a RunLoop, any methods scheduled in this way will be invoked. Methods will be invoked in an order matching the named queues defined in the run.queues property. Ember.run.schedule('timers', this, function(){ // this will be executed at the end of the RunLoop, when timers are run console.log("scheduled on timers queue"); }); Ember.run.schedule('sync', this, function(){ // this will be executed at the end of the RunLoop, when bindings are synced console.log("scheduled on sync queue"); }); // Note the functions will be run in order based on the run queues order. Output would be: // scheduled on sync queue // scheduled on timers queue @method schedule @param {String} queue The name of the queue to schedule against. Default queues are 'sync' and 'actions' @param {Object} [target] target object to use as the context when invoking a method. @param {String|Function} method The method to invoke. If you pass a string it will be resolved on the target object at the time the scheduled item is invoked allowing you to change the target function. @param {Object} [arguments*] Optional arguments to be passed to the queued method. @return {void} */ Ember.run.schedule = function(queue, target, method) { var loop = run.autorun(); loop.schedule.apply(loop, arguments); }; var scheduledAutorun; function autorun() { scheduledAutorun = null; if (run.currentRunLoop) { run.end(); } } // Used by global test teardown Ember.run.hasScheduledTimers = function() { return !!(scheduledAutorun || scheduledLater || scheduledNext); }; // Used by global test teardown Ember.run.cancelTimers = function () { if (scheduledAutorun) { clearTimeout(scheduledAutorun); scheduledAutorun = null; } if (scheduledLater) { clearTimeout(scheduledLater); scheduledLater = null; } if (scheduledNext) { clearTimeout(scheduledNext); scheduledNext = null; } timers = {}; }; /** Begins a new RunLoop if necessary and schedules a timer to flush the RunLoop at a later time. This method is used by parts of Ember to ensure the RunLoop always finishes. You normally do not need to call this method directly. Instead use Ember.run(). @method autorun @example Ember.run.autorun(); @return {Ember.RunLoop} the new current RunLoop */ Ember.run.autorun = function() { if (!run.currentRunLoop) { Ember.assert("You have turned on testing mode, which disabled the run-loop's autorun. You will need to wrap any code with asynchronous side-effects in an Ember.run", !Ember.testing); run.begin(); if (!scheduledAutorun) { scheduledAutorun = setTimeout(autorun, 1); } } return run.currentRunLoop; }; /** Immediately flushes any events scheduled in the 'sync' queue. Bindings use this queue so this method is a useful way to immediately force all bindings in the application to sync. You should call this method anytime you need any changed state to propagate throughout the app immediately without repainting the UI. Ember.run.sync(); @method sync @return {void} */ Ember.run.sync = function() { run.autorun(); run.currentRunLoop.flush('sync'); }; // .......................................................... // TIMERS // var timers = {}; // active timers... var scheduledLater; function invokeLaterTimers() { scheduledLater = null; var now = (+ new Date()), earliest = -1; for (var key in timers) { if (!timers.hasOwnProperty(key)) { continue; } var timer = timers[key]; if (timer && timer.expires) { if (now >= timer.expires) { delete timers[key]; invoke(timer.target, timer.method, timer.args, 2); } else { if (earliest<0 || (timer.expires < earliest)) earliest=timer.expires; } } } // schedule next timeout to fire... if (earliest > 0) { scheduledLater = setTimeout(invokeLaterTimers, earliest-(+ new Date())); } } /** Invokes the passed target/method and optional arguments after a specified period if time. The last parameter of this method must always be a number of milliseconds. You should use this method whenever you need to run some action after a period of time instead of using setTimeout(). This method will ensure that items that expire during the same script execution cycle all execute together, which is often more efficient than using a real setTimeout. Ember.run.later(myContext, function(){ // code here will execute within a RunLoop in about 500ms with this == myContext }, 500); @method later @param {Object} [target] target of method to invoke @param {Function|String} method The method to invoke. If you pass a string it will be resolved on the target at the time the method is invoked. @param {Object} [args*] Optional arguments to pass to the timeout. @param {Number} wait Number of milliseconds to wait. @return {String} a string you can use to cancel the timer in {{#crossLink "Ember/run.cancel"}}{{/crossLink}} later. */ Ember.run.later = function(target, method) { var args, expires, timer, guid, wait; // setTimeout compatibility... if (arguments.length===2 && 'function' === typeof target) { wait = method; method = target; target = undefined; args = [target, method]; } else { args = slice.call(arguments); wait = args.pop(); } expires = (+ new Date()) + wait; timer = { target: target, method: method, expires: expires, args: args }; guid = Ember.guidFor(timer); timers[guid] = timer; run.once(timers, invokeLaterTimers); return guid; }; function invokeOnceTimer(guid, onceTimers) { if (onceTimers[this.tguid]) { delete onceTimers[this.tguid][this.mguid]; } if (timers[guid]) { invoke(this.target, this.method, this.args); } delete timers[guid]; } function scheduleOnce(queue, target, method, args) { var tguid = Ember.guidFor(target), mguid = Ember.guidFor(method), onceTimers = run.autorun().onceTimers, guid = onceTimers[tguid] && onceTimers[tguid][mguid], timer; if (guid && timers[guid]) { timers[guid].args = args; // replace args } else { timer = { target: target, method: method, args: args, tguid: tguid, mguid: mguid }; guid = Ember.guidFor(timer); timers[guid] = timer; if (!onceTimers[tguid]) { onceTimers[tguid] = {}; } onceTimers[tguid][mguid] = guid; // so it isn't scheduled more than once run.schedule(queue, timer, invokeOnceTimer, guid, onceTimers); } return guid; } /** Schedules an item to run one time during the current RunLoop. Calling this method with the same target/method combination will have no effect. Note that although you can pass optional arguments these will not be considered when looking for duplicates. New arguments will replace previous calls. Ember.run(function(){ var doFoo = function() { foo(); } Ember.run.once(myContext, doFoo); Ember.run.once(myContext, doFoo); // doFoo will only be executed once at the end of the RunLoop }); @method once @param {Object} [target] target of method to invoke @param {Function|String} method The method to invoke. If you pass a string it will be resolved on the target at the time the method is invoked. @param {Object} [args*] Optional arguments to pass to the timeout. @return {Object} timer */ Ember.run.once = function(target, method) { return scheduleOnce('actions', target, method, slice.call(arguments, 2)); }; Ember.run.scheduleOnce = function(queue, target, method, args) { return scheduleOnce(queue, target, method, slice.call(arguments, 3)); }; var scheduledNext; function invokeNextTimers() { scheduledNext = null; for(var key in timers) { if (!timers.hasOwnProperty(key)) { continue; } var timer = timers[key]; if (timer.next) { delete timers[key]; invoke(timer.target, timer.method, timer.args, 2); } } } /** Schedules an item to run after control has been returned to the system. This is often equivalent to calling setTimeout(function...,1). Ember.run.next(myContext, function(){ // code to be executed in the next RunLoop, which will be scheduled after the current one }); @method next @param {Object} [target] target of method to invoke @param {Function|String} method The method to invoke. If you pass a string it will be resolved on the target at the time the method is invoked. @param {Object} [args*] Optional arguments to pass to the timeout. @return {Object} timer */ Ember.run.next = function(target, method) { var guid, timer = { target: target, method: method, args: slice.call(arguments), next: true }; guid = Ember.guidFor(timer); timers[guid] = timer; if (!scheduledNext) { scheduledNext = setTimeout(invokeNextTimers, 1); } return guid; }; /** Cancels a scheduled item. Must be a value returned by `Ember.run.later()`, `Ember.run.once()`, or `Ember.run.next()`. var runNext = Ember.run.next(myContext, function(){ // will not be executed }); Ember.run.cancel(runNext); var runLater = Ember.run.later(myContext, function(){ // will not be executed }, 500); Ember.run.cancel(runLater); var runOnce = Ember.run.once(myContext, function(){ // will not be executed }); Ember.run.cancel(runOnce); @method cancel @param {Object} timer Timer object to cancel @return {void} */ Ember.run.cancel = function(timer) { delete timers[timer]; }; })(); (function() { // Ember.Logger // get, set, trySet // guidFor, isArray, meta // addObserver, removeObserver // Ember.run.schedule /** @module ember-metal */ // .......................................................... // CONSTANTS // /** Debug parameter you can turn on. This will log all bindings that fire to the console. This should be disabled in production code. Note that you can also enable this from the console or temporarily. @property LOG_BINDINGS @for Ember @type Boolean @default false */ Ember.LOG_BINDINGS = false || !!Ember.ENV.LOG_BINDINGS; var get = Ember.get, set = Ember.set, guidFor = Ember.guidFor, isGlobalPath = Ember.isGlobalPath; function getWithGlobals(obj, path) { return get(isGlobalPath(path) ? Ember.lookup : obj, path); } // .......................................................... // BINDING // var Binding = function(toPath, fromPath) { this._direction = 'fwd'; this._from = fromPath; this._to = toPath; this._directionMap = Ember.Map.create(); }; /** @class Binding @namespace Ember */ Binding.prototype = { /** This copies the Binding so it can be connected to another object. @method copy @return {Ember.Binding} */ copy: function () { var copy = new Binding(this._to, this._from); if (this._oneWay) { copy._oneWay = true; } return copy; }, // .......................................................... // CONFIG // /** This will set "from" property path to the specified value. It will not attempt to resolve this property path to an actual object until you connect the binding. The binding will search for the property path starting at the root object you pass when you connect() the binding. It follows the same rules as `get()` - see that method for more information. @method from @param {String} propertyPath the property path to connect to @return {Ember.Binding} receiver */ from: function(path) { this._from = path; return this; }, /** This will set the "to" property path to the specified value. It will not attempt to resolve this property path to an actual object until you connect the binding. The binding will search for the property path starting at the root object you pass when you connect() the binding. It follows the same rules as `get()` - see that method for more information. @method to @param {String|Tuple} propertyPath A property path or tuple @return {Ember.Binding} this */ to: function(path) { this._to = path; return this; }, /** Configures the binding as one way. A one-way binding will relay changes on the "from" side to the "to" side, but not the other way around. This means that if you change the "to" side directly, the "from" side may have a different value. @method oneWay @return {Ember.Binding} receiver */ oneWay: function() { this._oneWay = true; return this; }, toString: function() { var oneWay = this._oneWay ? '[oneWay]' : ''; return "Ember.Binding<" + guidFor(this) + ">(" + this._from + " -> " + this._to + ")" + oneWay; }, // .......................................................... // CONNECT AND SYNC // /** Attempts to connect this binding instance so that it can receive and relay changes. This method will raise an exception if you have not set the from/to properties yet. @method connect @param {Object} obj The root object for this binding. @return {Ember.Binding} this */ connect: function(obj) { Ember.assert('Must pass a valid object to Ember.Binding.connect()', !!obj); var fromPath = this._from, toPath = this._to; Ember.trySet(obj, toPath, getWithGlobals(obj, fromPath)); // add an observer on the object to be notified when the binding should be updated Ember.addObserver(obj, fromPath, this, this.fromDidChange); // if the binding is a two-way binding, also set up an observer on the target if (!this._oneWay) { Ember.addObserver(obj, toPath, this, this.toDidChange); } this._readyToSync = true; return this; }, /** Disconnects the binding instance. Changes will no longer be relayed. You will not usually need to call this method. @method disconnect @param {Object} obj The root object you passed when connecting the binding. @return {Ember.Binding} this */ disconnect: function(obj) { Ember.assert('Must pass a valid object to Ember.Binding.disconnect()', !!obj); var twoWay = !this._oneWay; // remove an observer on the object so we're no longer notified of // changes that should update bindings. Ember.removeObserver(obj, this._from, this, this.fromDidChange); // if the binding is two-way, remove the observer from the target as well if (twoWay) { Ember.removeObserver(obj, this._to, this, this.toDidChange); } this._readyToSync = false; // disable scheduled syncs... return this; }, // .......................................................... // PRIVATE // /* called when the from side changes */ fromDidChange: function(target) { this._scheduleSync(target, 'fwd'); }, /* called when the to side changes */ toDidChange: function(target) { this._scheduleSync(target, 'back'); }, _scheduleSync: function(obj, dir) { var directionMap = this._directionMap; var existingDir = directionMap.get(obj); // if we haven't scheduled the binding yet, schedule it if (!existingDir) { Ember.run.schedule('sync', this, this._sync, obj); directionMap.set(obj, dir); } // If both a 'back' and 'fwd' sync have been scheduled on the same object, // default to a 'fwd' sync so that it remains deterministic. if (existingDir === 'back' && dir === 'fwd') { directionMap.set(obj, 'fwd'); } }, _sync: function(obj) { var log = Ember.LOG_BINDINGS; // don't synchronize destroyed objects or disconnected bindings if (obj.isDestroyed || !this._readyToSync) { return; } // get the direction of the binding for the object we are // synchronizing from var directionMap = this._directionMap; var direction = directionMap.get(obj); var fromPath = this._from, toPath = this._to; directionMap.remove(obj); // if we're synchronizing from the remote object... if (direction === 'fwd') { var fromValue = getWithGlobals(obj, this._from); if (log) { Ember.Logger.log(' ', this.toString(), '->', fromValue, obj); } if (this._oneWay) { Ember.trySet(obj, toPath, fromValue); } else { Ember._suspendObserver(obj, toPath, this, this.toDidChange, function () { Ember.trySet(obj, toPath, fromValue); }); } // if we're synchronizing *to* the remote object } else if (direction === 'back') { var toValue = get(obj, this._to); if (log) { Ember.Logger.log(' ', this.toString(), '<-', toValue, obj); } Ember._suspendObserver(obj, fromPath, this, this.fromDidChange, function () { Ember.trySet(Ember.isGlobalPath(fromPath) ? Ember.lookup : obj, fromPath, toValue); }); } } }; function mixinProperties(to, from) { for (var key in from) { if (from.hasOwnProperty(key)) { to[key] = from[key]; } } } mixinProperties(Binding, { /** See {{#crossLink "Ember.Binding/from"}}{{/crossLink}} @method from @static */ from: function() { var C = this, binding = new C(); return binding.from.apply(binding, arguments); }, /** See {{#crossLink "Ember.Binding/to"}}{{/crossLink}} @method to @static */ to: function() { var C = this, binding = new C(); return binding.to.apply(binding, arguments); }, /** Creates a new Binding instance and makes it apply in a single direction. A one-way binding will relay changes on the "from" side object (supplied as the `from` argument) the "to" side, but not the other way around. This means that if you change the "to" side directly, the "from" side may have a different value. See {{#crossLink "Binding/oneWay"}}{{/crossLink}} @method oneWay @param {String} from from path. @param {Boolean} [flag] (Optional) passing nothing here will make the binding oneWay. You can instead pass false to disable oneWay, making the binding two way again. */ oneWay: function(from, flag) { var C = this, binding = new C(null, from); return binding.oneWay(flag); } }); /** An Ember.Binding connects the properties of two objects so that whenever the value of one property changes, the other property will be changed also. ## Automatic Creation of Bindings with `/^*Binding/`-named Properties You do not usually create Binding objects directly but instead describe bindings in your class or object definition using automatic binding detection. Properties ending in a `Binding` suffix will be converted to Ember.Binding instances. The value of this property should be a string representing a path to another object or a custom binding instanced created using Binding helpers (see "Customizing Your Bindings"): valueBinding: "MyApp.someController.title" This will create a binding from `MyApp.someController.title` to the `value` property of your object instance automatically. Now the two values will be kept in sync. ## One Way Bindings One especially useful binding customization you can use is the `oneWay()` helper. This helper tells Ember that you are only interested in receiving changes on the object you are binding from. For example, if you are binding to a preference and you want to be notified if the preference has changed, but your object will not be changing the preference itself, you could do: bigTitlesBinding: Ember.Binding.oneWay("MyApp.preferencesController.bigTitles") This way if the value of MyApp.preferencesController.bigTitles changes the "bigTitles" property of your object will change also. However, if you change the value of your "bigTitles" property, it will not update the preferencesController. One way bindings are almost twice as fast to setup and twice as fast to execute because the binding only has to worry about changes to one side. You should consider using one way bindings anytime you have an object that may be created frequently and you do not intend to change a property; only to monitor it for changes. (such as in the example above). ## Adding Bindings Manually All of the examples above show you how to configure a custom binding, but the result of these customizations will be a binding template, not a fully active Binding instance. The binding will actually become active only when you instantiate the object the binding belongs to. It is useful however, to understand what actually happens when the binding is activated. For a binding to function it must have at least a "from" property and a "to" property. The from property path points to the object/key that you want to bind from while the to path points to the object/key you want to bind to. When you define a custom binding, you are usually describing the property you want to bind from (such as "MyApp.someController.value" in the examples above). When your object is created, it will automatically assign the value you want to bind "to" based on the name of your binding key. In the examples above, during init, Ember objects will effectively call something like this on your binding: binding = Ember.Binding.from(this.valueBinding).to("value"); This creates a new binding instance based on the template you provide, and sets the to path to the "value" property of the new object. Now that the binding is fully configured with a "from" and a "to", it simply needs to be connected to become active. This is done through the connect() method: binding.connect(this); Note that when you connect a binding you pass the object you want it to be connected to. This object will be used as the root for both the from and to side of the binding when inspecting relative paths. This allows the binding to be automatically inherited by subclassed objects as well. Now that the binding is connected, it will observe both the from and to side and relay changes. If you ever needed to do so (you almost never will, but it is useful to understand this anyway), you could manually create an active binding by using the Ember.bind() helper method. (This is the same method used by to setup your bindings on objects): Ember.bind(MyApp.anotherObject, "value", "MyApp.someController.value"); Both of these code fragments have the same effect as doing the most friendly form of binding creation like so: MyApp.anotherObject = Ember.Object.create({ valueBinding: "MyApp.someController.value", // OTHER CODE FOR THIS OBJECT... }); Ember's built in binding creation method makes it easy to automatically create bindings for you. You should always use the highest-level APIs available, even if you understand how it works underneath. @class Binding @namespace Ember @since Ember 0.9 */ Ember.Binding = Binding; /** Global helper method to create a new binding. Just pass the root object along with a to and from path to create and connect the binding. @method bind @for Ember @param {Object} obj The root object of the transform. @param {String} to The path to the 'to' side of the binding. Must be relative to obj. @param {String} from The path to the 'from' side of the binding. Must be relative to obj or a global path. @return {Ember.Binding} binding instance */ Ember.bind = function(obj, to, from) { return new Ember.Binding(to, from).connect(obj); }; /** @method oneWay @for Ember @param {Object} obj The root object of the transform. @param {String} to The path to the 'to' side of the binding. Must be relative to obj. @param {String} from The path to the 'from' side of the binding. Must be relative to obj or a global path. @return {Ember.Binding} binding instance */ Ember.oneWay = function(obj, to, from) { return new Ember.Binding(to, from).oneWay().connect(obj); }; })(); (function() { /** @module ember-metal */ var Mixin, REQUIRED, Alias, classToString, superClassString, a_map = Ember.ArrayPolyfills.map, a_indexOf = Ember.ArrayPolyfills.indexOf, a_forEach = Ember.ArrayPolyfills.forEach, a_slice = [].slice, EMPTY_META = {}, // dummy for non-writable meta META_SKIP = { __emberproto__: true, __ember_count__: true }, o_create = Ember.create, defineProperty = Ember.defineProperty, guidFor = Ember.guidFor; function mixinsMeta(obj) { var m = Ember.meta(obj, true), ret = m.mixins; if (!ret) { ret = m.mixins = { __emberproto__: obj }; } else if (ret.__emberproto__ !== obj) { ret = m.mixins = o_create(ret); ret.__emberproto__ = obj; } return ret; } function initMixin(mixin, args) { if (args && args.length > 0) { mixin.mixins = a_map.call(args, function(x) { if (x instanceof Mixin) { return x; } // Note: Manually setup a primitive mixin here. This is the only // way to actually get a primitive mixin. This way normal creation // of mixins will give you combined mixins... var mixin = new Mixin(); mixin.properties = x; return mixin; }); } return mixin; } function isMethod(obj) { return 'function' === typeof obj && obj.isMethod !== false && obj !== Boolean && obj !== Object && obj !== Number && obj !== Array && obj !== Date && obj !== String; } function mergeMixins(mixins, m, descs, values, base) { var len = mixins.length, idx, mixin, guid, props, value, key, ovalue, concats; function removeKeys(keyName) { delete descs[keyName]; delete values[keyName]; } for(idx=0; idx < len; idx++) { mixin = mixins[idx]; Ember.assert('Expected hash or Mixin instance, got ' + Object.prototype.toString.call(mixin), typeof mixin === 'object' && mixin !== null && Object.prototype.toString.call(mixin) !== '[object Array]'); if (mixin instanceof Mixin) { guid = guidFor(mixin); if (m[guid]) { continue; } m[guid] = mixin; props = mixin.properties; } else { props = mixin; // apply anonymous mixin properties } if (props) { // reset before adding each new mixin to pickup concats from previous concats = values.concatenatedProperties || base.concatenatedProperties; if (props.concatenatedProperties) { concats = concats ? concats.concat(props.concatenatedProperties) : props.concatenatedProperties; } for (key in props) { if (!props.hasOwnProperty(key)) { continue; } value = props[key]; if (value instanceof Ember.Descriptor) { if (value === REQUIRED && descs[key]) { continue; } descs[key] = value; values[key] = undefined; } else { // impl super if needed... if (isMethod(value)) { ovalue = descs[key] === undefined && values[key]; if (!ovalue) { ovalue = base[key]; } if ('function' !== typeof ovalue) { ovalue = null; } if (ovalue) { var o = value.__ember_observes__, ob = value.__ember_observesBefore__; value = Ember.wrap(value, ovalue); value.__ember_observes__ = o; value.__ember_observesBefore__ = ob; } } else if ((concats && a_indexOf.call(concats, key) >= 0) || key === 'concatenatedProperties') { var baseValue = values[key] || base[key]; if (baseValue) { if ('function' === typeof baseValue.concat) { value = baseValue.concat(value); } else { value = Ember.makeArray(baseValue).concat(value); } } else { value = Ember.makeArray(value); } } descs[key] = undefined; values[key] = value; } } // manually copy toString() because some JS engines do not enumerate it if (props.hasOwnProperty('toString')) { base.toString = props.toString; } } else if (mixin.mixins) { mergeMixins(mixin.mixins, m, descs, values, base); if (mixin._without) { a_forEach.call(mixin._without, removeKeys); } } } } function writableReq(obj) { var m = Ember.meta(obj), req = m.required; if (!req || req.__emberproto__ !== obj) { req = m.required = req ? o_create(req) : { __ember_count__: 0 }; req.__emberproto__ = obj; } return req; } var IS_BINDING = Ember.IS_BINDING = /^.+Binding$/; function detectBinding(obj, key, value, m) { if (IS_BINDING.test(key)) { var bindings = m.bindings; if (!bindings) { bindings = m.bindings = { __emberproto__: obj }; } else if (bindings.__emberproto__ !== obj) { bindings = m.bindings = o_create(m.bindings); bindings.__emberproto__ = obj; } bindings[key] = value; } } function connectBindings(obj, m) { // TODO Mixin.apply(instance) should disconnect binding if exists var bindings = m.bindings, key, binding, to; if (bindings) { for (key in bindings) { binding = key !== '__emberproto__' && bindings[key]; if (binding) { to = key.slice(0, -7); // strip Binding off end if (binding instanceof Ember.Binding) { binding = binding.copy(); // copy prototypes' instance binding.to(to); } else { // binding is string path binding = new Ember.Binding(to, binding); } binding.connect(obj); obj[key] = binding; } } // mark as applied m.bindings = { __emberproto__: obj }; } } function finishPartial(obj, m) { connectBindings(obj, m || Ember.meta(obj)); return obj; } function applyMixin(obj, mixins, partial) { var descs = {}, values = {}, m = Ember.meta(obj), req = m.required, key, value, desc, prevValue, paths, len, idx; // Go through all mixins and hashes passed in, and: // // * Handle concatenated properties // * Set up _super wrapping if necessary // * Set up computed property descriptors // * Copying `toString` in broken browsers mergeMixins(mixins, mixinsMeta(obj), descs, values, obj); for(key in values) { if (key === 'contructor') { continue; } if (!values.hasOwnProperty(key)) { continue; } desc = descs[key]; value = values[key]; if (desc === REQUIRED) { if (!(key in obj)) { Ember.assert('Required property not defined: '+key, !!partial); // for partial applies add to hash of required keys req = writableReq(obj); req.__ember_count__++; req[key] = true; } } else { while (desc && desc instanceof Alias) { var altKey = desc.methodName; if (descs[altKey] || values[altKey]) { value = values[altKey]; desc = descs[altKey]; } else if (m.descs[altKey]) { desc = m.descs[altKey]; value = undefined; } else { desc = undefined; value = obj[altKey]; } } if (desc === undefined && value === undefined) { continue; } prevValue = obj[key]; if ('function' === typeof prevValue) { if ((paths = prevValue.__ember_observesBefore__)) { len = paths.length; for (idx=0; idx < len; idx++) { Ember.removeBeforeObserver(obj, paths[idx], null, key); } } else if ((paths = prevValue.__ember_observes__)) { len = paths.length; for (idx=0; idx < len; idx++) { Ember.removeObserver(obj, paths[idx], null, key); } } } detectBinding(obj, key, value, m); defineProperty(obj, key, desc, value, m); if ('function' === typeof value) { if (paths = value.__ember_observesBefore__) { len = paths.length; for (idx=0; idx < len; idx++) { Ember.addBeforeObserver(obj, paths[idx], null, key); } } else if (paths = value.__ember_observes__) { len = paths.length; for (idx=0; idx < len; idx++) { Ember.addObserver(obj, paths[idx], null, key); } } } if (req && req[key]) { req = writableReq(obj); req.__ember_count__--; req[key] = false; } } } if (!partial) { // don't apply to prototype finishPartial(obj, m); } // Make sure no required attrs remain if (!partial && req && req.__ember_count__>0) { var keys = []; for (key in req) { if (META_SKIP[key]) { continue; } keys.push(key); } // TODO: Remove surrounding if clause from production build Ember.assert('Required properties not defined: '+keys.join(',')); } return obj; } /** @method mixin @for Ember @param obj @param mixins* @return obj */ Ember.mixin = function(obj) { var args = a_slice.call(arguments, 1); applyMixin(obj, args, false); return obj; }; /** The `Ember.Mixin` class allows you to create mixins, whose properties can be added to other classes. For instance, App.Editable = Ember.Mixin.create({ edit: function() { console.log('starting to edit'); this.set('isEditing', true); }, isEditing: false }); // Mix mixins into classes by passing them as the first arguments to // .extend or .create. App.CommentView = Ember.View.extend(App.Editable, { template: Ember.Handlebars.compile('{{#if isEditing}}...{{else}}...{{/if}}') }); commentView = App.CommentView.create(); commentView.edit(); // => outputs 'starting to edit' Note that Mixins are created with `Ember.Mixin.create`, not `Ember.Mixin.extend`. @class Mixin @namespace Ember */ Ember.Mixin = function() { return initMixin(this, arguments); }; Mixin = Ember.Mixin; Mixin._apply = applyMixin; Mixin.applyPartial = function(obj) { var args = a_slice.call(arguments, 1); return applyMixin(obj, args, true); }; Mixin.finishPartial = finishPartial; /** @method create @static @param arguments* */ Mixin.create = function() { classToString.processed = false; var M = this; return initMixin(new M(), arguments); }; var MixinPrototype = Mixin.prototype; /** @method reopen @param arguments* */ MixinPrototype.reopen = function() { var mixin, tmp; if (this.properties) { mixin = Mixin.create(); mixin.properties = this.properties; delete this.properties; this.mixins = [mixin]; } else if (!this.mixins) { this.mixins = []; } var len = arguments.length, mixins = this.mixins, idx; for(idx=0; idx < len; idx++) { mixin = arguments[idx]; Ember.assert('Expected hash or Mixin instance, got ' + Object.prototype.toString.call(mixin), typeof mixin === 'object' && mixin !== null && Object.prototype.toString.call(mixin) !== '[object Array]'); if (mixin instanceof Mixin) { mixins.push(mixin); } else { tmp = Mixin.create(); tmp.properties = mixin; mixins.push(tmp); } } return this; }; /** @method apply @param obj @return applied object */ MixinPrototype.apply = function(obj) { return applyMixin(obj, [this], false); }; MixinPrototype.applyPartial = function(obj) { return applyMixin(obj, [this], true); }; function _detect(curMixin, targetMixin, seen) { var guid = guidFor(curMixin); if (seen[guid]) { return false; } seen[guid] = true; if (curMixin === targetMixin) { return true; } var mixins = curMixin.mixins, loc = mixins ? mixins.length : 0; while (--loc >= 0) { if (_detect(mixins[loc], targetMixin, seen)) { return true; } } return false; } /** @method detect @param obj @return {Boolean} */ MixinPrototype.detect = function(obj) { if (!obj) { return false; } if (obj instanceof Mixin) { return _detect(obj, this, {}); } var mixins = Ember.meta(obj, false).mixins; if (mixins) { return !!mixins[guidFor(this)]; } return false; }; MixinPrototype.without = function() { var ret = new Mixin(this); ret._without = a_slice.call(arguments); return ret; }; function _keys(ret, mixin, seen) { if (seen[guidFor(mixin)]) { return; } seen[guidFor(mixin)] = true; if (mixin.properties) { var props = mixin.properties; for (var key in props) { if (props.hasOwnProperty(key)) { ret[key] = true; } } } else if (mixin.mixins) { a_forEach.call(mixin.mixins, function(x) { _keys(ret, x, seen); }); } } MixinPrototype.keys = function() { var keys = {}, seen = {}, ret = []; _keys(keys, this, seen); for(var key in keys) { if (keys.hasOwnProperty(key)) { ret.push(key); } } return ret; }; /* make Mixins have nice displayNames */ var NAME_KEY = Ember.GUID_KEY+'_name'; var get = Ember.get; function processNames(paths, root, seen) { var idx = paths.length; for(var key in root) { if (!root.hasOwnProperty || !root.hasOwnProperty(key)) { continue; } var obj = root[key]; paths[idx] = key; if (obj && obj.toString === classToString) { obj[NAME_KEY] = paths.join('.'); } else if (obj && get(obj, 'isNamespace')) { if (seen[guidFor(obj)]) { continue; } seen[guidFor(obj)] = true; processNames(paths, obj, seen); } } paths.length = idx; // cut out last item } function findNamespaces() { var Namespace = Ember.Namespace, lookup = Ember.lookup, obj, isNamespace; if (Namespace.PROCESSED) { return; } for (var prop in lookup) { // get(window.globalStorage, 'isNamespace') would try to read the storage for domain isNamespace and cause exception in Firefox. // globalStorage is a storage obsoleted by the WhatWG storage specification. See https://developer.mozilla.org/en/DOM/Storage#globalStorage if (prop === "globalStorage" && lookup.StorageList && lookup.globalStorage instanceof lookup.StorageList) { continue; } // Unfortunately, some versions of IE don't support window.hasOwnProperty if (lookup.hasOwnProperty && !lookup.hasOwnProperty(prop)) { continue; } // At times we are not allowed to access certain properties for security reasons. // There are also times where even if we can access them, we are not allowed to access their properties. try { obj = Ember.lookup[prop]; isNamespace = obj && get(obj, 'isNamespace'); } catch (e) { continue; } if (isNamespace) { Ember.deprecate("Namespaces should not begin with lowercase.", /^[A-Z]/.test(prop)); obj[NAME_KEY] = prop; } } } /** @private @method identifyNamespaces @for Ember */ Ember.identifyNamespaces = findNamespaces; superClassString = function(mixin) { var superclass = mixin.superclass; if (superclass) { if (superclass[NAME_KEY]) { return superclass[NAME_KEY]; } else { return superClassString(superclass); } } else { return; } }; classToString = function() { var Namespace = Ember.Namespace, namespace; // TODO: Namespace should really be in Metal if (Namespace) { if (!this[NAME_KEY] && !classToString.processed) { if (!Namespace.PROCESSED) { findNamespaces(); Namespace.PROCESSED = true; } classToString.processed = true; var namespaces = Namespace.NAMESPACES; for (var i=0, l=namespaces.length; i 'red' paintSample.moniker(); //=> 'Zed' @method alias @for Ember @param {String} methodName name of the method or property to alias @return {Ember.Descriptor} */ Ember.alias = function(methodName) { return new Alias(methodName); }; // .......................................................... // OBSERVER HELPER // /** @method observer @for Ember @param {Function} func @param {String} propertyNames* @return func */ Ember.observer = function(func) { var paths = a_slice.call(arguments, 1); func.__ember_observes__ = paths; return func; }; // If observers ever become asynchronous, Ember.immediateObserver // must remain synchronous. /** @method immediateObserver @for Ember @param {Function} func @param {String} propertyNames* @return func */ Ember.immediateObserver = function() { for (var i=0, l=arguments.length; i 'undefined' Ember.typeOf(null); => 'null' Ember.typeOf(undefined); => 'undefined' Ember.typeOf('michael'); => 'string' Ember.typeOf(101); => 'number' Ember.typeOf(true); => 'boolean' Ember.typeOf(Ember.makeArray); => 'function' Ember.typeOf([1,2,90]); => 'array' Ember.typeOf(Ember.Object.extend()); => 'class' Ember.typeOf(Ember.Object.create()); => 'instance' Ember.typeOf(new Error('teamocil')); => 'error' // "normal" JavaScript object Ember.typeOf({a: 'b'}); => 'object' @method typeOf @for Ember @param item {Object} the item to check @return {String} the type */ Ember.typeOf = function(item) { var ret; ret = (item === null || item === undefined) ? String(item) : TYPE_MAP[toString.call(item)] || 'object'; if (ret === 'function') { if (Ember.Object && Ember.Object.detect(item)) ret = 'class'; } else if (ret === 'object') { if (item instanceof Error) ret = 'error'; else if (Ember.Object && item instanceof Ember.Object) ret = 'instance'; else ret = 'object'; } return ret; }; /** Returns true if the passed value is null or undefined. This avoids errors from JSLint complaining about use of ==, which can be technically confusing. Ember.none(); => true Ember.none(null); => true Ember.none(undefined); => true Ember.none(''); => false Ember.none([]); => false Ember.none(function(){}); => false @method none @for Ember @param {Object} obj Value to test @return {Boolean} */ Ember.none = function(obj) { return obj === null || obj === undefined; }; /** Verifies that a value is null or an empty string | array | function. Constrains the rules on `Ember.none` by returning false for empty string and empty arrays. Ember.empty(); => true Ember.empty(null); => true Ember.empty(undefined); => true Ember.empty(''); => true Ember.empty([]); => true Ember.empty('tobias fünke'); => false Ember.empty([0,1,2]); => false @method empty @for Ember @param {Object} obj Value to test @return {Boolean} */ Ember.empty = function(obj) { return obj === null || obj === undefined || (obj.length === 0 && typeof obj !== 'function') || (typeof obj === 'object' && Ember.get(obj, 'length') === 0); }; /** This will compare two javascript values of possibly different types. It will tell you which one is greater than the other by returning: - -1 if the first is smaller than the second, - 0 if both are equal, - 1 if the first is greater than the second. The order is calculated based on Ember.ORDER_DEFINITION, if types are different. In case they have the same type an appropriate comparison for this type is made. Ember.compare('hello', 'hello'); => 0 Ember.compare('abc', 'dfg'); => -1 Ember.compare(2, 1); => 1 @method compare @for Ember @param {Object} v First value to compare @param {Object} w Second value to compare @return {Number} -1 if v < w, 0 if v = w and 1 if v > w. */ Ember.compare = function compare(v, w) { if (v === w) { return 0; } var type1 = Ember.typeOf(v); var type2 = Ember.typeOf(w); var Comparable = Ember.Comparable; if (Comparable) { if (type1==='instance' && Comparable.detect(v.constructor)) { return v.constructor.compare(v, w); } if (type2 === 'instance' && Comparable.detect(w.constructor)) { return 1-w.constructor.compare(w, v); } } // If we haven't yet generated a reverse-mapping of Ember.ORDER_DEFINITION, // do so now. var mapping = Ember.ORDER_DEFINITION_MAPPING; if (!mapping) { var order = Ember.ORDER_DEFINITION; mapping = Ember.ORDER_DEFINITION_MAPPING = {}; var idx, len; for (idx = 0, len = order.length; idx < len; ++idx) { mapping[order[idx]] = idx; } // We no longer need Ember.ORDER_DEFINITION. delete Ember.ORDER_DEFINITION; } var type1Index = mapping[type1]; var type2Index = mapping[type2]; if (type1Index < type2Index) { return -1; } if (type1Index > type2Index) { return 1; } // types are equal - so we have to check values now switch (type1) { case 'boolean': case 'number': if (v < w) { return -1; } if (v > w) { return 1; } return 0; case 'string': var comp = v.localeCompare(w); if (comp < 0) { return -1; } if (comp > 0) { return 1; } return 0; case 'array': var vLen = v.length; var wLen = w.length; var l = Math.min(vLen, wLen); var r = 0; var i = 0; while (r === 0 && i < l) { r = compare(v[i],w[i]); i++; } if (r !== 0) { return r; } // all elements are equal now // shorter array should be ordered first if (vLen < wLen) { return -1; } if (vLen > wLen) { return 1; } // arrays are equal now return 0; case 'instance': if (Ember.Comparable && Ember.Comparable.detect(v)) { return v.compare(v, w); } return 0; case 'date': var vNum = v.getTime(); var wNum = w.getTime(); if (vNum < wNum) { return -1; } if (vNum > wNum) { return 1; } return 0; default: return 0; } }; function _copy(obj, deep, seen, copies) { var ret, loc, key; // primitive data types are immutable, just return them. if ('object' !== typeof obj || obj===null) return obj; // avoid cyclical loops if (deep && (loc=indexOf(seen, obj))>=0) return copies[loc]; Ember.assert('Cannot clone an Ember.Object that does not implement Ember.Copyable', !(obj instanceof Ember.Object) || (Ember.Copyable && Ember.Copyable.detect(obj))); // IMPORTANT: this specific test will detect a native array only. Any other // object will need to implement Copyable. if (Ember.typeOf(obj) === 'array') { ret = obj.slice(); if (deep) { loc = ret.length; while(--loc>=0) ret[loc] = _copy(ret[loc], deep, seen, copies); } } else if (Ember.Copyable && Ember.Copyable.detect(obj)) { ret = obj.copy(deep, seen, copies); } else { ret = {}; for(key in obj) { if (!obj.hasOwnProperty(key)) continue; ret[key] = deep ? _copy(obj[key], deep, seen, copies) : obj[key]; } } if (deep) { seen.push(obj); copies.push(ret); } return ret; } /** Creates a clone of the passed object. This function can take just about any type of object and create a clone of it, including primitive values (which are not actually cloned because they are immutable). If the passed object implements the clone() method, then this function will simply call that method and return the result. @method copy @for Ember @param {Object} object The object to clone @param {Boolean} deep If true, a deep copy of the object is made @return {Object} The cloned object */ Ember.copy = function(obj, deep) { // fast paths if ('object' !== typeof obj || obj===null) return obj; // can't copy primitives if (Ember.Copyable && Ember.Copyable.detect(obj)) return obj.copy(deep); return _copy(obj, deep, deep ? [] : null, deep ? [] : null); }; /** Convenience method to inspect an object. This method will attempt to convert the object into a useful string description. @method inspect @for Ember @param {Object} obj The object you want to inspect. @return {String} A description of the object */ Ember.inspect = function(obj) { var v, ret = []; for(var key in obj) { if (obj.hasOwnProperty(key)) { v = obj[key]; if (v === 'toString') { continue; } // ignore useless items if (Ember.typeOf(v) === 'function') { v = "function() { ... }"; } ret.push(key + ": " + v); } } return "{" + ret.join(" , ") + "}"; }; /** Compares two objects, returning true if they are logically equal. This is a deeper comparison than a simple triple equal. For sets it will compare the internal objects. For any other object that implements `isEqual()` it will respect that method. Ember.isEqual('hello', 'hello'); => true Ember.isEqual(1, 2); => false Ember.isEqual([4,2], [4,2]); => false @method isEqual @for Ember @param {Object} a first object to compare @param {Object} b second object to compare @return {Boolean} */ Ember.isEqual = function(a, b) { if (a && 'function'===typeof a.isEqual) return a.isEqual(b); return a === b; }; // Used by Ember.compare Ember.ORDER_DEFINITION = Ember.ENV.ORDER_DEFINITION || [ 'undefined', 'null', 'boolean', 'number', 'string', 'array', 'object', 'instance', 'function', 'class', 'date' ]; /** Returns all of the keys defined on an object or hash. This is useful when inspecting objects for debugging. On browsers that support it, this uses the native Object.keys implementation. @method keys @for Ember @param {Object} obj @return {Array} Array containing keys of obj */ Ember.keys = Object.keys; if (!Ember.keys) { Ember.keys = function(obj) { var ret = []; for(var key in obj) { if (obj.hasOwnProperty(key)) { ret.push(key); } } return ret; }; } // .......................................................... // ERROR // var errorProps = ['description', 'fileName', 'lineNumber', 'message', 'name', 'number', 'stack']; /** A subclass of the JavaScript Error object for use in Ember. @class Error @namespace Ember @extends Error @constructor */ Ember.Error = function() { var tmp = Error.prototype.constructor.apply(this, arguments); // Unfortunately errors are not enumerable in Chrome (at least), so `for prop in tmp` doesn't work. for (var idx = 0; idx < errorProps.length; idx++) { this[errorProps[idx]] = tmp[errorProps[idx]]; } }; Ember.Error.prototype = Ember.create(Error.prototype); })(); (function() { /** @module ember @submodule ember-runtime */ var STRING_DASHERIZE_REGEXP = (/[ _]/g); var STRING_DASHERIZE_CACHE = {}; var STRING_DECAMELIZE_REGEXP = (/([a-z])([A-Z])/g); var STRING_CAMELIZE_REGEXP = (/(\-|_|\s)+(.)?/g); var STRING_UNDERSCORE_REGEXP_1 = (/([a-z\d])([A-Z]+)/g); var STRING_UNDERSCORE_REGEXP_2 = (/\-|\s+/g); /** Defines the hash of localized strings for the current language. Used by the `Ember.String.loc()` helper. To localize, add string values to this hash. @property STRINGS @for Ember @type Hash */ Ember.STRINGS = {}; /** Defines string helper methods including string formatting and localization. Unless Ember.EXTEND_PROTOTYPES.String is false these methods will also be added to the String.prototype as well. @class String @namespace Ember @static */ Ember.String = { /** Apply formatting options to the string. This will look for occurrences of %@ in your string and substitute them with the arguments you pass into this method. If you want to control the specific order of replacement, you can add a number after the key as well to indicate which argument you want to insert. Ordered insertions are most useful when building loc strings where values you need to insert may appear in different orders. "Hello %@ %@".fmt('John', 'Doe') => "Hello John Doe" "Hello %@2, %@1".fmt('John', 'Doe') => "Hello Doe, John" @method fmt @param {Object...} [args] @return {String} formatted string */ fmt: function(str, formats) { // first, replace any ORDERED replacements. var idx = 0; // the current index for non-numerical replacements return str.replace(/%@([0-9]+)?/g, function(s, argIndex) { argIndex = (argIndex) ? parseInt(argIndex,0) - 1 : idx++ ; s = formats[argIndex]; return ((s === null) ? '(null)' : (s === undefined) ? '' : s).toString(); }) ; }, /** Formats the passed string, but first looks up the string in the localized strings hash. This is a convenient way to localize text. See `Ember.String.fmt()` for more information on formatting. Note that it is traditional but not required to prefix localized string keys with an underscore or other character so you can easily identify localized strings. Ember.STRINGS = { '_Hello World': 'Bonjour le monde', '_Hello %@ %@': 'Bonjour %@ %@' }; Ember.String.loc("_Hello World"); => 'Bonjour le monde'; Ember.String.loc("_Hello %@ %@", ["John", "Smith"]); => "Bonjour John Smith"; @method loc @param {String} str The string to format @param {Array} formats Optional array of parameters to interpolate into string. @return {String} formatted string */ loc: function(str, formats) { str = Ember.STRINGS[str] || str; return Ember.String.fmt(str, formats) ; }, /** Splits a string into separate units separated by spaces, eliminating any empty strings in the process. This is a convenience method for split that is mostly useful when applied to the String.prototype. Ember.String.w("alpha beta gamma").forEach(function(key) { console.log(key); }); > alpha > beta > gamma @method w @param {String} str The string to split @return {String} split string */ w: function(str) { return str.split(/\s+/); }, /** Converts a camelized string into all lower case separated by underscores. 'innerHTML'.decamelize() => 'inner_html' 'action_name'.decamelize() => 'action_name' 'css-class-name'.decamelize() => 'css-class-name' 'my favorite items'.decamelize() => 'my favorite items' @method decamelize @param {String} str The string to decamelize. @return {String} the decamelized string. */ decamelize: function(str) { return str.replace(STRING_DECAMELIZE_REGEXP, '$1_$2').toLowerCase(); }, /** Replaces underscores or spaces with dashes. 'innerHTML'.dasherize() => 'inner-html' 'action_name'.dasherize() => 'action-name' 'css-class-name'.dasherize() => 'css-class-name' 'my favorite items'.dasherize() => 'my-favorite-items' @method dasherize @param {String} str The string to dasherize. @return {String} the dasherized string. */ dasherize: function(str) { var cache = STRING_DASHERIZE_CACHE, ret = cache[str]; if (ret) { return ret; } else { ret = Ember.String.decamelize(str).replace(STRING_DASHERIZE_REGEXP,'-'); cache[str] = ret; } return ret; }, /** Returns the lowerCaseCamel form of a string. 'innerHTML'.camelize() => 'innerHTML' 'action_name'.camelize() => 'actionName' 'css-class-name'.camelize() => 'cssClassName' 'my favorite items'.camelize() => 'myFavoriteItems' @method camelize @param {String} str The string to camelize. @return {String} the camelized string. */ camelize: function(str) { return str.replace(STRING_CAMELIZE_REGEXP, function(match, separator, chr) { return chr ? chr.toUpperCase() : ''; }); }, /** Returns the UpperCamelCase form of a string. 'innerHTML'.classify() => 'InnerHTML' 'action_name'.classify() => 'ActionName' 'css-class-name'.classify() => 'CssClassName' 'my favorite items'.classify() => 'MyFavoriteItems' @method classify @param {String} str the string to classify @return {String} the classified string */ classify: function(str) { var camelized = Ember.String.camelize(str); return camelized.charAt(0).toUpperCase() + camelized.substr(1); }, /** More general than decamelize. Returns the lower_case_and_underscored form of a string. 'innerHTML'.underscore() => 'inner_html' 'action_name'.underscore() => 'action_name' 'css-class-name'.underscore() => 'css_class_name' 'my favorite items'.underscore() => 'my_favorite_items' @property underscore @param {String} str The string to underscore. @return {String} the underscored string. */ underscore: function(str) { return str.replace(STRING_UNDERSCORE_REGEXP_1, '$1_$2'). replace(STRING_UNDERSCORE_REGEXP_2, '_').toLowerCase(); } }; })(); (function() { /** @module ember @submodule ember-runtime */ var fmt = Ember.String.fmt, w = Ember.String.w, loc = Ember.String.loc, camelize = Ember.String.camelize, decamelize = Ember.String.decamelize, dasherize = Ember.String.dasherize, underscore = Ember.String.underscore, classify = Ember.String.classify; if (Ember.EXTEND_PROTOTYPES === true || Ember.EXTEND_PROTOTYPES.String) { /** See {{#crossLink "Ember.String/fmt"}}{{/crossLink}} @method fmt @for String */ String.prototype.fmt = function() { return fmt(this, arguments); }; /** See {{#crossLink "Ember.String/w"}}{{/crossLink}} @method w @for String */ String.prototype.w = function() { return w(this); }; /** See {{#crossLink "Ember.String/loc"}}{{/crossLink}} @method loc @for String */ String.prototype.loc = function() { return loc(this, arguments); }; /** See {{#crossLink "Ember.String/camelize"}}{{/crossLink}} @method camelize @for String */ String.prototype.camelize = function() { return camelize(this); }; /** See {{#crossLink "Ember.String/decamelize"}}{{/crossLink}} @method decamelize @for String */ String.prototype.decamelize = function() { return decamelize(this); }; /** See {{#crossLink "Ember.String/dasherize"}}{{/crossLink}} @method dasherize @for String */ String.prototype.dasherize = function() { return dasherize(this); }; /** See {{#crossLink "Ember.String/underscore"}}{{/crossLink}} @method underscore @for String */ String.prototype.underscore = function() { return underscore(this); }; /** See {{#crossLink "Ember.String/classify"}}{{/crossLink}} @method classify @for String */ String.prototype.classify = function() { return classify(this); }; } })(); (function() { /** @module ember @submodule ember-runtime */ var a_slice = Array.prototype.slice; if (Ember.EXTEND_PROTOTYPES === true || Ember.EXTEND_PROTOTYPES.Function) { /** The `property` extension of Javascript's Function prototype is available when Ember.EXTEND_PROTOTYPES or Ember.EXTEND_PROTOTYPES.Function is true, which is the default. Computed properties allow you to treat a function like a property: MyApp.president = Ember.Object.create({ firstName: "Barack", lastName: "Obama", fullName: function() { return this.get('firstName') + ' ' + this.get('lastName'); // Call this flag to mark the function as a property }.property() }); MyApp.president.get('fullName'); => "Barack Obama" Treating a function like a property is useful because they can work with bindings, just like any other property. Many computed properties have dependencies on other properties. For example, in the above example, the `fullName` property depends on `firstName` and `lastName` to determine its value. You can tell Ember.js about these dependencies like this: MyApp.president = Ember.Object.create({ firstName: "Barack", lastName: "Obama", fullName: function() { return this.get('firstName') + ' ' + this.get('lastName'); // Tell Ember.js that this computed property depends on firstName // and lastName }.property('firstName', 'lastName') }); Make sure you list these dependencies so Ember.js knows when to update bindings that connect to a computed property. Changing a dependency will not immediately trigger an update of the computed property, but will instead clear the cache so that it is updated when the next `get` is called on the property. See {{#crossLink "Ember.ComputedProperty"}}{{/crossLink}}, {{#crossLink "Ember/computed"}}{{/crossLink}} @method property @for Function */ Function.prototype.property = function() { var ret = Ember.computed(this); return ret.property.apply(ret, arguments); }; /** The `observes` extension of Javascript's Function prototype is available when Ember.EXTEND_PROTOTYPES or Ember.EXTEND_PROTOTYPES.Function is true, which is the default. You can observe property changes simply by adding the `observes` call to the end of your method declarations in classes that you write. For example: Ember.Object.create({ valueObserver: function() { // Executes whenever the "value" property changes }.observes('value') }); See {{#crossLink "Ember.Observable/observes"}}{{/crossLink}} @method observes @for Function */ Function.prototype.observes = function() { this.__ember_observes__ = a_slice.call(arguments); return this; }; /** The `observesBefore` extension of Javascript's Function prototype is available when Ember.EXTEND_PROTOTYPES or Ember.EXTEND_PROTOTYPES.Function is true, which is the default. You can get notified when a property changes is about to happen by by adding the `observesBefore` call to the end of your method declarations in classes that you write. For example: Ember.Object.create({ valueObserver: function() { // Executes whenever the "value" property is about to change }.observesBefore('value') }); See {{#crossLink "Ember.Observable/observesBefore"}}{{/crossLink}} @method observesBefore @for Function */ Function.prototype.observesBefore = function() { this.__ember_observesBefore__ = a_slice.call(arguments); return this; }; } })(); (function() { })(); (function() { /** @module ember @submodule ember-runtime */ // .......................................................... // HELPERS // var get = Ember.get, set = Ember.set; var a_slice = Array.prototype.slice; var a_indexOf = Ember.EnumerableUtils.indexOf; var contexts = []; function popCtx() { return contexts.length===0 ? {} : contexts.pop(); } function pushCtx(ctx) { contexts.push(ctx); return null; } function iter(key, value) { var valueProvided = arguments.length === 2; function i(item) { var cur = get(item, key); return valueProvided ? value===cur : !!cur; } return i ; } /** This mixin defines the common interface implemented by enumerable objects in Ember. Most of these methods follow the standard Array iteration API defined up to JavaScript 1.8 (excluding language-specific features that cannot be emulated in older versions of JavaScript). This mixin is applied automatically to the Array class on page load, so you can use any of these methods on simple arrays. If Array already implements one of these methods, the mixin will not override them. h3. Writing Your Own Enumerable To make your own custom class enumerable, you need two items: 1. You must have a length property. This property should change whenever the number of items in your enumerable object changes. If you using this with an Ember.Object subclass, you should be sure to change the length property using set(). 2. If you must implement nextObject(). See documentation. Once you have these two methods implement, apply the Ember.Enumerable mixin to your class and you will be able to enumerate the contents of your object like any other collection. h3. Using Ember Enumeration with Other Libraries Many other libraries provide some kind of iterator or enumeration like facility. This is often where the most common API conflicts occur. Ember's API is designed to be as friendly as possible with other libraries by implementing only methods that mostly correspond to the JavaScript 1.8 API. @class Enumerable @namespace Ember @extends Ember.Mixin @since Ember 0.9 */ Ember.Enumerable = Ember.Mixin.create( /** @scope Ember.Enumerable.prototype */ { // compatibility isEnumerable: true, /** Implement this method to make your class enumerable. This method will be call repeatedly during enumeration. The index value will always begin with 0 and increment monotonically. You don't have to rely on the index value to determine what object to return, but you should always check the value and start from the beginning when you see the requested index is 0. The previousObject is the object that was returned from the last call to nextObject for the current iteration. This is a useful way to manage iteration if you are tracing a linked list, for example. Finally the context parameter will always contain a hash you can use as a "scratchpad" to maintain any other state you need in order to iterate properly. The context object is reused and is not reset between iterations so make sure you setup the context with a fresh state whenever the index parameter is 0. Generally iterators will continue to call nextObject until the index reaches the your current length-1. If you run out of data before this time for some reason, you should simply return undefined. The default implementation of this method simply looks up the index. This works great on any Array-like objects. @method nextObject @param {Number} index the current index of the iteration @param {Object} previousObject the value returned by the last call to nextObject. @param {Object} context a context object you can use to maintain state. @return {Object} the next object in the iteration or undefined */ nextObject: Ember.required(Function), /** Helper method returns the first object from a collection. This is usually used by bindings and other parts of the framework to extract a single object if the enumerable contains only one item. If you override this method, you should implement it so that it will always return the same value each time it is called. If your enumerable contains only one object, this method should always return that object. If your enumerable is empty, this method should return undefined. var arr = ["a", "b", "c"]; arr.firstObject(); => "a" var arr = []; arr.firstObject(); => undefined @property firstObject @return {Object} the object or undefined */ firstObject: Ember.computed(function() { if (get(this, 'length')===0) return undefined ; // handle generic enumerables var context = popCtx(), ret; ret = this.nextObject(0, null, context); pushCtx(context); return ret ; }).property('[]'), /** Helper method returns the last object from a collection. If your enumerable contains only one object, this method should always return that object. If your enumerable is empty, this method should return undefined. var arr = ["a", "b", "c"]; arr.lastObject(); => "c" var arr = []; arr.lastObject(); => undefined @property lastObject @return {Object} the last object or undefined */ lastObject: Ember.computed(function() { var len = get(this, 'length'); if (len===0) return undefined ; var context = popCtx(), idx=0, cur, last = null; do { last = cur; cur = this.nextObject(idx++, last, context); } while (cur !== undefined); pushCtx(context); return last; }).property('[]'), /** Returns true if the passed object can be found in the receiver. The default version will iterate through the enumerable until the object is found. You may want to override this with a more efficient version. var arr = ["a", "b", "c"]; arr.contains("a"); => true arr.contains("z"); => false @method contains @param {Object} obj The object to search for. @return {Boolean} true if object is found in enumerable. */ contains: function(obj) { return this.find(function(item) { return item===obj; }) !== undefined; }, /** Iterates through the enumerable, calling the passed function on each item. This method corresponds to the forEach() method defined in JavaScript 1.6. The callback method you provide should have the following signature (all parameters are optional): function(item, index, enumerable); - *item* is the current item in the iteration. - *index* is the current index in the iteration - *enumerable* is the enumerable object itself. Note that in addition to a callback, you can also pass an optional target object that will be set as "this" on the context. This is a good way to give your iterator function access to the current object. @method forEach @param {Function} callback The callback to execute @param {Object} [target] The target object to use @return {Object} receiver */ forEach: function(callback, target) { if (typeof callback !== "function") throw new TypeError() ; var len = get(this, 'length'), last = null, context = popCtx(); if (target === undefined) target = null; for(var idx=0;idx1) args = a_slice.call(arguments, 1); this.forEach(function(x, idx) { var method = x && x[methodName]; if ('function' === typeof method) { ret[idx] = args ? method.apply(x, args) : method.call(x); } }, this); return ret; }, /** Simply converts the enumerable into a genuine array. The order is not guaranteed. Corresponds to the method implemented by Prototype. @method toArray @return {Array} the enumerable as an array. */ toArray: function() { var ret = []; this.forEach(function(o, idx) { ret[idx] = o; }); return ret ; }, /** Returns a copy of the array with all null elements removed. var arr = ["a", null, "c", null]; arr.compact(); => ["a", "c"] @method compact @return {Array} the array without null elements. */ compact: function() { return this.without(null); }, /** Returns a new enumerable that excludes the passed value. The default implementation returns an array regardless of the receiver type unless the receiver does not contain the value. var arr = ["a", "b", "a", "c"]; arr.without("a"); => ["b", "c"] @method without @param {Object} value @return {Ember.Enumerable} */ without: function(value) { if (!this.contains(value)) return this; // nothing to do var ret = [] ; this.forEach(function(k) { if (k !== value) ret[ret.length] = k; }) ; return ret ; }, /** Returns a new enumerable that contains only unique values. The default implementation returns an array regardless of the receiver type. var arr = ["a", "a", "b", "b"]; arr.uniq(); => ["a", "b"] @method uniq @return {Ember.Enumerable} */ uniq: function() { var ret = []; this.forEach(function(k){ if (a_indexOf(ret, k)<0) ret.push(k); }); return ret; }, /** This property will trigger anytime the enumerable's content changes. You can observe this property to be notified of changes to the enumerables content. For plain enumerables, this property is read only. Ember.Array overrides this method. @property [] @type Ember.Array */ '[]': Ember.computed(function(key, value) { return this; }).property(), // .......................................................... // ENUMERABLE OBSERVERS // /** Registers an enumerable observer. Must implement Ember.EnumerableObserver mixin. @method addEnumerableObserver @param target {Object} @param opts {Hash} */ addEnumerableObserver: function(target, opts) { var willChange = (opts && opts.willChange) || 'enumerableWillChange', didChange = (opts && opts.didChange) || 'enumerableDidChange'; var hasObservers = get(this, 'hasEnumerableObservers'); if (!hasObservers) Ember.propertyWillChange(this, 'hasEnumerableObservers'); Ember.addListener(this, '@enumerable:before', target, willChange); Ember.addListener(this, '@enumerable:change', target, didChange); if (!hasObservers) Ember.propertyDidChange(this, 'hasEnumerableObservers'); return this; }, /** Removes a registered enumerable observer. @method removeEnumerableObserver @param target {Object} @param [opts] {Hash} */ removeEnumerableObserver: function(target, opts) { var willChange = (opts && opts.willChange) || 'enumerableWillChange', didChange = (opts && opts.didChange) || 'enumerableDidChange'; var hasObservers = get(this, 'hasEnumerableObservers'); if (hasObservers) Ember.propertyWillChange(this, 'hasEnumerableObservers'); Ember.removeListener(this, '@enumerable:before', target, willChange); Ember.removeListener(this, '@enumerable:change', target, didChange); if (hasObservers) Ember.propertyDidChange(this, 'hasEnumerableObservers'); return this; }, /** Becomes true whenever the array currently has observers watching changes on the array. @property hasEnumerableObservers @type Boolean */ hasEnumerableObservers: Ember.computed(function() { return Ember.hasListeners(this, '@enumerable:change') || Ember.hasListeners(this, '@enumerable:before'); }).property(), /** Invoke this method just before the contents of your enumerable will change. You can either omit the parameters completely or pass the objects to be removed or added if available or just a count. @method enumerableContentWillChange @param {Ember.Enumerable|Number} removing An enumerable of the objects to be removed or the number of items to be removed. @param {Ember.Enumerable|Number} adding An enumerable of the objects to be added or the number of items to be added. @chainable */ enumerableContentWillChange: function(removing, adding) { var removeCnt, addCnt, hasDelta; if ('number' === typeof removing) removeCnt = removing; else if (removing) removeCnt = get(removing, 'length'); else removeCnt = removing = -1; if ('number' === typeof adding) addCnt = adding; else if (adding) addCnt = get(adding,'length'); else addCnt = adding = -1; hasDelta = addCnt<0 || removeCnt<0 || addCnt-removeCnt!==0; if (removing === -1) removing = null; if (adding === -1) adding = null; Ember.propertyWillChange(this, '[]'); if (hasDelta) Ember.propertyWillChange(this, 'length'); Ember.sendEvent(this, '@enumerable:before', [this, removing, adding]); return this; }, /** Invoke this method when the contents of your enumerable has changed. This will notify any observers watching for content changes. If your are implementing an ordered enumerable (such as an array), also pass the start and end values where the content changed so that it can be used to notify range observers. @method enumerableContentDidChange @param {Number} [start] optional start offset for the content change. For unordered enumerables, you should always pass -1. @param {Ember.Enumerable|Number} removing An enumerable of the objects to be removed or the number of items to be removed. @param {Ember.Enumerable|Number} adding An enumerable of the objects to be added or the number of items to be added. @chainable */ enumerableContentDidChange: function(removing, adding) { var notify = this.propertyDidChange, removeCnt, addCnt, hasDelta; if ('number' === typeof removing) removeCnt = removing; else if (removing) removeCnt = get(removing, 'length'); else removeCnt = removing = -1; if ('number' === typeof adding) addCnt = adding; else if (adding) addCnt = get(adding, 'length'); else addCnt = adding = -1; hasDelta = addCnt<0 || removeCnt<0 || addCnt-removeCnt!==0; if (removing === -1) removing = null; if (adding === -1) adding = null; Ember.sendEvent(this, '@enumerable:change', [this, removing, adding]); if (hasDelta) Ember.propertyDidChange(this, 'length'); Ember.propertyDidChange(this, '[]'); return this ; } }) ; })(); (function() { /** @module ember @submodule ember-runtime */ // .......................................................... // HELPERS // var get = Ember.get, set = Ember.set, meta = Ember.meta, map = Ember.EnumerableUtils.map, cacheFor = Ember.cacheFor; function none(obj) { return obj===null || obj===undefined; } // .......................................................... // ARRAY // /** This module implements Observer-friendly Array-like behavior. This mixin is picked up by the Array class as well as other controllers, etc. that want to appear to be arrays. Unlike Ember.Enumerable, this mixin defines methods specifically for collections that provide index-ordered access to their contents. When you are designing code that needs to accept any kind of Array-like object, you should use these methods instead of Array primitives because these will properly notify observers of changes to the array. Although these methods are efficient, they do add a layer of indirection to your application so it is a good idea to use them only when you need the flexibility of using both true JavaScript arrays and "virtual" arrays such as controllers and collections. You can use the methods defined in this module to access and modify array contents in a KVO-friendly way. You can also be notified whenever the membership if an array changes by changing the syntax of the property to .observes('*myProperty.[]') . To support Ember.Array in your own class, you must override two primitives to use it: replace() and objectAt(). Note that the Ember.Array mixin also incorporates the Ember.Enumerable mixin. All Ember.Array-like objects are also enumerable. @class Array @namespace Ember @extends Ember.Mixin @uses Ember.Enumerable @since Ember 0.9.0 */ Ember.Array = Ember.Mixin.create(Ember.Enumerable, /** @scope Ember.Array.prototype */ { // compatibility isSCArray: true, /** Your array must support the length property. Your replace methods should set this property whenever it changes. @property {Number} length */ length: Ember.required(), /** Returns the object at the given index. If the given index is negative or is greater or equal than the array length, returns `undefined`. This is one of the primitives you must implement to support `Ember.Array`. If your object supports retrieving the value of an array item using `get()` (i.e. `myArray.get(0)`), then you do not need to implement this method yourself. var arr = ['a', 'b', 'c', 'd']; arr.objectAt(0); => "a" arr.objectAt(3); => "d" arr.objectAt(-1); => undefined arr.objectAt(4); => undefined arr.objectAt(5); => undefined @method objectAt @param {Number} idx The index of the item to return. */ objectAt: function(idx) { if ((idx < 0) || (idx>=get(this, 'length'))) return undefined ; return get(this, idx); }, /** This returns the objects at the specified indexes, using `objectAt`. var arr = ['a', 'b', 'c', 'd']; arr.objectsAt([0, 1, 2]) => ["a", "b", "c"] arr.objectsAt([2, 3, 4]) => ["c", "d", undefined] @method objectsAt @param {Array} indexes An array of indexes of items to return. */ objectsAt: function(indexes) { var self = this; return map(indexes, function(idx){ return self.objectAt(idx); }); }, // overrides Ember.Enumerable version nextObject: function(idx) { return this.objectAt(idx); }, /** This is the handler for the special array content property. If you get this property, it will return this. If you set this property it a new array, it will replace the current content. This property overrides the default property defined in Ember.Enumerable. @property [] */ '[]': Ember.computed(function(key, value) { if (value !== undefined) this.replace(0, get(this, 'length'), value) ; return this ; }).property(), firstObject: Ember.computed(function() { return this.objectAt(0); }).property(), lastObject: Ember.computed(function() { return this.objectAt(get(this, 'length')-1); }).property(), // optimized version from Enumerable contains: function(obj){ return this.indexOf(obj) >= 0; }, // Add any extra methods to Ember.Array that are native to the built-in Array. /** Returns a new array that is a slice of the receiver. This implementation uses the observable array methods to retrieve the objects for the new slice. var arr = ['red', 'green', 'blue']; arr.slice(0); => ['red', 'green', 'blue'] arr.slice(0, 2); => ['red', 'green'] arr.slice(1, 100); => ['green', 'blue'] @method slice @param beginIndex {Integer} (Optional) index to begin slicing from. @param endIndex {Integer} (Optional) index to end the slice at. @return {Array} New array with specified slice */ slice: function(beginIndex, endIndex) { var ret = []; var length = get(this, 'length') ; if (none(beginIndex)) beginIndex = 0 ; if (none(endIndex) || (endIndex > length)) endIndex = length ; while(beginIndex < endIndex) { ret[ret.length] = this.objectAt(beginIndex++) ; } return ret ; }, /** Returns the index of the given object's first occurrence. If no startAt argument is given, the starting location to search is 0. If it's negative, will count backward from the end of the array. Returns -1 if no match is found. var arr = ["a", "b", "c", "d", "a"]; arr.indexOf("a"); => 0 arr.indexOf("z"); => -1 arr.indexOf("a", 2); => 4 arr.indexOf("a", -1); => 4 arr.indexOf("b", 3); => -1 arr.indexOf("a", 100); => -1 @method indexOf @param {Object} object the item to search for @param {Number} startAt optional starting location to search, default 0 @return {Number} index or -1 if not found */ indexOf: function(object, startAt) { var idx, len = get(this, 'length'); if (startAt === undefined) startAt = 0; if (startAt < 0) startAt += len; for(idx=startAt;idx 4 arr.lastIndexOf("z"); => -1 arr.lastIndexOf("a", 2); => 0 arr.lastIndexOf("a", -1); => 4 arr.lastIndexOf("b", 3); => 1 arr.lastIndexOf("a", 100); => 4 @method lastIndexOf @param {Object} object the item to search for @param {Number} startAt optional starting location to search, default 0 @return {Number} index or -1 if not found */ lastIndexOf: function(object, startAt) { var idx, len = get(this, 'length'); if (startAt === undefined || startAt >= len) startAt = len-1; if (startAt < 0) startAt += len; for(idx=startAt;idx>=0;idx--) { if (this.objectAt(idx) === object) return idx ; } return -1; }, // .......................................................... // ARRAY OBSERVERS // /** Adds an array observer to the receiving array. The array observer object normally must implement two methods: * `arrayWillChange(start, removeCount, addCount)` - This method will be called just before the array is modified. * `arrayDidChange(start, removeCount, addCount)` - This method will be called just after the array is modified. Both callbacks will be passed the starting index of the change as well a a count of the items to be removed and added. You can use these callbacks to optionally inspect the array during the change, clear caches, or do any other bookkeeping necessary. In addition to passing a target, you can also include an options hash which you can use to override the method names that will be invoked on the target. @method addArrayObserver @param {Object} target The observer object. @param {Hash} opts Optional hash of configuration options including willChange, didChange, and a context option. @return {Ember.Array} receiver */ addArrayObserver: function(target, opts) { var willChange = (opts && opts.willChange) || 'arrayWillChange', didChange = (opts && opts.didChange) || 'arrayDidChange'; var hasObservers = get(this, 'hasArrayObservers'); if (!hasObservers) Ember.propertyWillChange(this, 'hasArrayObservers'); Ember.addListener(this, '@array:before', target, willChange); Ember.addListener(this, '@array:change', target, didChange); if (!hasObservers) Ember.propertyDidChange(this, 'hasArrayObservers'); return this; }, /** Removes an array observer from the object if the observer is current registered. Calling this method multiple times with the same object will have no effect. @method removeArrayObserver @param {Object} target The object observing the array. @return {Ember.Array} receiver */ removeArrayObserver: function(target, opts) { var willChange = (opts && opts.willChange) || 'arrayWillChange', didChange = (opts && opts.didChange) || 'arrayDidChange'; var hasObservers = get(this, 'hasArrayObservers'); if (hasObservers) Ember.propertyWillChange(this, 'hasArrayObservers'); Ember.removeListener(this, '@array:before', target, willChange); Ember.removeListener(this, '@array:change', target, didChange); if (hasObservers) Ember.propertyDidChange(this, 'hasArrayObservers'); return this; }, /** Becomes true whenever the array currently has observers watching changes on the array. @property Boolean */ hasArrayObservers: Ember.computed(function() { return Ember.hasListeners(this, '@array:change') || Ember.hasListeners(this, '@array:before'); }).property(), /** If you are implementing an object that supports Ember.Array, call this method just before the array content changes to notify any observers and invalidate any related properties. Pass the starting index of the change as well as a delta of the amounts to change. @method arrayContentWillChange @param {Number} startIdx The starting index in the array that will change. @param {Number} removeAmt The number of items that will be removed. If you pass null assumes 0 @param {Number} addAmt The number of items that will be added. If you pass null assumes 0. @return {Ember.Array} receiver */ arrayContentWillChange: function(startIdx, removeAmt, addAmt) { // if no args are passed assume everything changes if (startIdx===undefined) { startIdx = 0; removeAmt = addAmt = -1; } else { if (removeAmt === undefined) removeAmt=-1; if (addAmt === undefined) addAmt=-1; } // Make sure the @each proxy is set up if anyone is observing @each if (Ember.isWatching(this, '@each')) { get(this, '@each'); } Ember.sendEvent(this, '@array:before', [this, startIdx, removeAmt, addAmt]); var removing, lim; if (startIdx>=0 && removeAmt>=0 && get(this, 'hasEnumerableObservers')) { removing = []; lim = startIdx+removeAmt; for(var idx=startIdx;idx=0 && addAmt>=0 && get(this, 'hasEnumerableObservers')) { adding = []; lim = startIdx+addAmt; for(var idx=startIdx;idx b` Default implementation raises an exception. @method compare @param a {Object} the first object to compare @param b {Object} the second object to compare @return {Integer} the result of the comparison */ compare: Ember.required(Function) }); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set; /** Implements some standard methods for copying an object. Add this mixin to any object you create that can create a copy of itself. This mixin is added automatically to the built-in array. You should generally implement the copy() method to return a copy of the receiver. Note that frozenCopy() will only work if you also implement Ember.Freezable. @class Copyable @namespace Ember @extends Ember.Mixin @since Ember 0.9 */ Ember.Copyable = Ember.Mixin.create( /** @scope Ember.Copyable.prototype */ { /** Override to return a copy of the receiver. Default implementation raises an exception. @method copy @param deep {Boolean} if true, a deep copy of the object should be made @return {Object} copy of receiver */ copy: Ember.required(Function), /** If the object implements Ember.Freezable, then this will return a new copy if the object is not frozen and the receiver if the object is frozen. Raises an exception if you try to call this method on a object that does not support freezing. You should use this method whenever you want a copy of a freezable object since a freezable object can simply return itself without actually consuming more memory. @method frozenCopy @return {Object} copy of receiver or receiver */ frozenCopy: function() { if (Ember.Freezable && Ember.Freezable.detect(this)) { return get(this, 'isFrozen') ? this : this.copy().freeze(); } else { throw new Error(Ember.String.fmt("%@ does not support freezing", [this])); } } }); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set; /** The Ember.Freezable mixin implements some basic methods for marking an object as frozen. Once an object is frozen it should be read only. No changes may be made the internal state of the object. ## Enforcement To fully support freezing in your subclass, you must include this mixin and override any method that might alter any property on the object to instead raise an exception. You can check the state of an object by checking the isFrozen property. Although future versions of JavaScript may support language-level freezing object objects, that is not the case today. Even if an object is freezable, it is still technically possible to modify the object, even though it could break other parts of your application that do not expect a frozen object to change. It is, therefore, very important that you always respect the isFrozen property on all freezable objects. ## Example Usage The example below shows a simple object that implement the Ember.Freezable protocol. Contact = Ember.Object.extend(Ember.Freezable, { firstName: null, lastName: null, // swaps the names swapNames: function() { if (this.get('isFrozen')) throw Ember.FROZEN_ERROR; var tmp = this.get('firstName'); this.set('firstName', this.get('lastName')); this.set('lastName', tmp); return this; } }); c = Context.create({ firstName: "John", lastName: "Doe" }); c.swapNames(); => returns c c.freeze(); c.swapNames(); => EXCEPTION ## Copying Usually the Ember.Freezable protocol is implemented in cooperation with the Ember.Copyable protocol, which defines a frozenCopy() method that will return a frozen object, if the object implements this method as well. @class Freezable @namespace Ember @extends Ember.Mixin @since Ember 0.9 */ Ember.Freezable = Ember.Mixin.create( /** @scope Ember.Freezable.prototype */ { /** Set to true when the object is frozen. Use this property to detect whether your object is frozen or not. @property isFrozen @type Boolean */ isFrozen: false, /** Freezes the object. Once this method has been called the object should no longer allow any properties to be edited. @method freeze @return {Object} receiver */ freeze: function() { if (get(this, 'isFrozen')) return this; set(this, 'isFrozen', true); return this; } }); Ember.FROZEN_ERROR = "Frozen object cannot be modified."; })(); (function() { /** @module ember @submodule ember-runtime */ var forEach = Ember.EnumerableUtils.forEach; /** This mixin defines the API for modifying generic enumerables. These methods can be applied to an object regardless of whether it is ordered or unordered. Note that an Enumerable can change even if it does not implement this mixin. For example, a MappedEnumerable cannot be directly modified but if its underlying enumerable changes, it will change also. ## Adding Objects To add an object to an enumerable, use the addObject() method. This method will only add the object to the enumerable if the object is not already present and the object if of a type supported by the enumerable. set.addObject(contact); ## Removing Objects To remove an object form an enumerable, use the removeObject() method. This will only remove the object if it is already in the enumerable, otherwise this method has no effect. set.removeObject(contact); ## Implementing In Your Own Code If you are implementing an object and want to support this API, just include this mixin in your class and implement the required methods. In your unit tests, be sure to apply the Ember.MutableEnumerableTests to your object. @class MutableEnumerable @namespace Ember @extends Ember.Mixin @uses Ember.Enumerable */ Ember.MutableEnumerable = Ember.Mixin.create(Ember.Enumerable, /** @scope Ember.MutableEnumerable.prototype */ { /** __Required.__ You must implement this method to apply this mixin. Attempts to add the passed object to the receiver if the object is not already present in the collection. If the object is present, this method has no effect. If the passed object is of a type not supported by the receiver then this method should raise an exception. @method addObject @param {Object} object The object to add to the enumerable. @return {Object} the passed object */ addObject: Ember.required(Function), /** Adds each object in the passed enumerable to the receiver. @method addObjects @param {Ember.Enumerable} objects the objects to add. @return {Object} receiver */ addObjects: function(objects) { Ember.beginPropertyChanges(this); forEach(objects, function(obj) { this.addObject(obj); }, this); Ember.endPropertyChanges(this); return this; }, /** __Required.__ You must implement this method to apply this mixin. Attempts to remove the passed object from the receiver collection if the object is in present in the collection. If the object is not present, this method has no effect. If the passed object is of a type not supported by the receiver then this method should raise an exception. @method removeObject @param {Object} object The object to remove from the enumerable. @return {Object} the passed object */ removeObject: Ember.required(Function), /** Removes each objects in the passed enumerable from the receiver. @method removeObjects @param {Ember.Enumerable} objects the objects to remove @return {Object} receiver */ removeObjects: function(objects) { Ember.beginPropertyChanges(this); forEach(objects, function(obj) { this.removeObject(obj); }, this); Ember.endPropertyChanges(this); return this; } }); })(); (function() { /** @module ember @submodule ember-runtime */ // .......................................................... // CONSTANTS // var OUT_OF_RANGE_EXCEPTION = "Index out of range" ; var EMPTY = []; // .......................................................... // HELPERS // var get = Ember.get, set = Ember.set, forEach = Ember.EnumerableUtils.forEach; /** This mixin defines the API for modifying array-like objects. These methods can be applied only to a collection that keeps its items in an ordered set. Note that an Array can change even if it does not implement this mixin. For example, one might implement a SparseArray that cannot be directly modified, but if its underlying enumerable changes, it will change also. @class MutableArray @namespace Ember @extends Ember.Mixin @uses Ember.Array @uses Ember.MutableEnumerable */ Ember.MutableArray = Ember.Mixin.create(Ember.Array, Ember.MutableEnumerable, /** @scope Ember.MutableArray.prototype */ { /** __Required.__ You must implement this method to apply this mixin. This is one of the primitives you must implement to support Ember.Array. You should replace amt objects started at idx with the objects in the passed array. You should also call this.enumerableContentDidChange() ; @method replace @param {Number} idx Starting index in the array to replace. If idx >= length, then append to the end of the array. @param {Number} amt Number of elements that should be removed from the array, starting at *idx*. @param {Array} objects An array of zero or more objects that should be inserted into the array at *idx* */ replace: Ember.required(), /** Remove all elements from self. This is useful if you want to reuse an existing array without having to recreate it. var colors = ["red", "green", "blue"]; color.length(); => 3 colors.clear(); => [] colors.length(); => 0 @method clear @return {Ember.Array} An empty Array. */ clear: function () { var len = get(this, 'length'); if (len === 0) return this; this.replace(0, len, EMPTY); return this; }, /** This will use the primitive replace() method to insert an object at the specified index. var colors = ["red", "green", "blue"]; colors.insertAt(2, "yellow"); => ["red", "green", "yellow", "blue"] colors.insertAt(5, "orange"); => Error: Index out of range @method insertAt @param {Number} idx index of insert the object at. @param {Object} object object to insert */ insertAt: function(idx, object) { if (idx > get(this, 'length')) throw new Error(OUT_OF_RANGE_EXCEPTION) ; this.replace(idx, 0, [object]) ; return this ; }, /** Remove an object at the specified index using the replace() primitive method. You can pass either a single index, or a start and a length. If you pass a start and length that is beyond the length this method will throw an Ember.OUT_OF_RANGE_EXCEPTION var colors = ["red", "green", "blue", "yellow", "orange"]; colors.removeAt(0); => ["green", "blue", "yellow", "orange"] colors.removeAt(2, 2); => ["green", "blue"] colors.removeAt(4, 2); => Error: Index out of range @method removeAt @param {Number} start index, start of range @param {Number} len length of passing range @return {Object} receiver */ removeAt: function(start, len) { if ('number' === typeof start) { if ((start < 0) || (start >= get(this, 'length'))) { throw new Error(OUT_OF_RANGE_EXCEPTION); } // fast case if (len === undefined) len = 1; this.replace(start, len, EMPTY); } return this ; }, /** Push the object onto the end of the array. Works just like push() but it is KVO-compliant. var colors = ["red", "green", "blue"]; colors.pushObject("black"); => ["red", "green", "blue", "black"] colors.pushObject(["yellow", "orange"]); => ["red", "green", "blue", "black", ["yellow", "orange"]] @method pushObject @param {anything} obj object to push */ pushObject: function(obj) { this.insertAt(get(this, 'length'), obj) ; return obj ; }, /** Add the objects in the passed numerable to the end of the array. Defers notifying observers of the change until all objects are added. var colors = ["red", "green", "blue"]; colors.pushObjects("black"); => ["red", "green", "blue", "black"] colors.pushObjects(["yellow", "orange"]); => ["red", "green", "blue", "black", "yellow", "orange"] @method pushObjects @param {Ember.Enumerable} objects the objects to add @return {Ember.Array} receiver */ pushObjects: function(objects) { this.replace(get(this, 'length'), 0, objects); return this; }, /** Pop object from array or nil if none are left. Works just like pop() but it is KVO-compliant. var colors = ["red", "green", "blue"]; colors.popObject(); => "blue" console.log(colors); => ["red", "green"] @method popObject @return object */ popObject: function() { var len = get(this, 'length') ; if (len === 0) return null ; var ret = this.objectAt(len-1) ; this.removeAt(len-1, 1) ; return ret ; }, /** Shift an object from start of array or nil if none are left. Works just like shift() but it is KVO-compliant. var colors = ["red", "green", "blue"]; colors.shiftObject(); => "red" console.log(colors); => ["green", "blue"] @method shiftObject @return object */ shiftObject: function() { if (get(this, 'length') === 0) return null ; var ret = this.objectAt(0) ; this.removeAt(0) ; return ret ; }, /** Unshift an object to start of array. Works just like unshift() but it is KVO-compliant. var colors = ["red", "green", "blue"]; colors.unshiftObject("yellow"); => ["yellow", "red", "green", "blue"] colors.unshiftObject(["black", "white"]); => [["black", "white"], "yellow", "red", "green", "blue"] @method unshiftObject @param {anything} obj object to unshift */ unshiftObject: function(obj) { this.insertAt(0, obj) ; return obj ; }, /** Adds the named objects to the beginning of the array. Defers notifying observers until all objects have been added. var colors = ["red", "green", "blue"]; colors.unshiftObjects(["black", "white"]); => ["black", "white", "red", "green", "blue"] colors.unshiftObjects("yellow"); => Type Error: 'undefined' is not a function @method unshiftObjects @param {Ember.Enumerable} objects the objects to add @return {Ember.Array} receiver */ unshiftObjects: function(objects) { this.replace(0, 0, objects); return this; }, /** Reverse objects in the array. Works just like reverse() but it is KVO-compliant. @method reverseObjects @return {Ember.Array} receiver */ reverseObjects: function() { var len = get(this, 'length'); if (len === 0) return this; var objects = this.toArray().reverse(); this.replace(0, len, objects); return this; }, /** Replace all the the receiver's content with content of the argument. If argument is an empty array receiver will be cleared. var colors = ["red", "green", "blue"]; colors.setObjects(["black", "white"]); => ["black", "white"] colors.setObjects([]); => [] @method setObjects @param {Ember.Array} objects array whose content will be used for replacing the content of the receiver @return {Ember.Array} receiver with the new content */ setObjects: function(objects) { if (objects.length === 0) return this.clear(); var len = get(this, 'length'); this.replace(0, len, objects); return this; }, // .......................................................... // IMPLEMENT Ember.MutableEnumerable // removeObject: function(obj) { var loc = get(this, 'length') || 0; while(--loc >= 0) { var curObject = this.objectAt(loc) ; if (curObject === obj) this.removeAt(loc) ; } return this ; }, addObject: function(obj) { if (!this.contains(obj)) this.pushObject(obj); return this ; } }); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set, defineProperty = Ember.defineProperty; /** ## Overview This mixin provides properties and property observing functionality, core features of the Ember object model. Properties and observers allow one object to observe changes to a property on another object. This is one of the fundamental ways that models, controllers and views communicate with each other in an Ember application. Any object that has this mixin applied can be used in observer operations. That includes Ember.Object and most objects you will interact with as you write your Ember application. Note that you will not generally apply this mixin to classes yourself, but you will use the features provided by this module frequently, so it is important to understand how to use it. ## Using get() and set() Because of Ember's support for bindings and observers, you will always access properties using the get method, and set properties using the set method. This allows the observing objects to be notified and computed properties to be handled properly. More documentation about `get` and `set` are below. ## Observing Property Changes You typically observe property changes simply by adding the `observes` call to the end of your method declarations in classes that you write. For example: Ember.Object.create({ valueObserver: function() { // Executes whenever the "value" property changes }.observes('value') }); Although this is the most common way to add an observer, this capability is actually built into the Ember.Object class on top of two methods defined in this mixin: `addObserver` and `removeObserver`. You can use these two methods to add and remove observers yourself if you need to do so at runtime. To add an observer for a property, call: object.addObserver('propertyKey', targetObject, targetAction) This will call the `targetAction` method on the `targetObject` to be called whenever the value of the `propertyKey` changes. Note that if `propertyKey` is a computed property, the observer will be called when any of the property dependencies are changed, even if the resulting value of the computed property is unchanged. This is necessary because computed properties are not computed until `get` is called. @class Observable @namespace Ember @extends Ember.Mixin */ Ember.Observable = Ember.Mixin.create(/** @scope Ember.Observable.prototype */ { // compatibility isObserverable: true, /** Retrieves the value of a property from the object. This method is usually similar to using object[keyName] or object.keyName, however it supports both computed properties and the unknownProperty handler. Because `get` unifies the syntax for accessing all these kinds of properties, it can make many refactorings easier, such as replacing a simple property with a computed property, or vice versa. ### Computed Properties Computed properties are methods defined with the `property` modifier declared at the end, such as: fullName: function() { return this.getEach('firstName', 'lastName').compact().join(' '); }.property('firstName', 'lastName') When you call `get` on a computed property, the function will be called and the return value will be returned instead of the function itself. ### Unknown Properties Likewise, if you try to call `get` on a property whose value is undefined, the unknownProperty() method will be called on the object. If this method returns any value other than undefined, it will be returned instead. This allows you to implement "virtual" properties that are not defined upfront. @method get @param {String} key The property to retrieve @return {Object} The property value or undefined. */ get: function(keyName) { return get(this, keyName); }, /** To get multiple properties at once, call getProperties with a list of strings or an array: record.getProperties('firstName', 'lastName', 'zipCode'); // => { firstName: 'John', lastName: 'Doe', zipCode: '10011' } is equivalent to: record.getProperties(['firstName', 'lastName', 'zipCode']); // => { firstName: 'John', lastName: 'Doe', zipCode: '10011' } @method getProperties @param {String...|Array} list of keys to get @return {Hash} */ getProperties: function() { var ret = {}; var propertyNames = arguments; if (arguments.length === 1 && Ember.typeOf(arguments[0]) === 'array') { propertyNames = arguments[0]; } for(var i = 0; i < propertyNames.length; i++) { ret[propertyNames[i]] = get(this, propertyNames[i]); } return ret; }, /** Sets the provided key or path to the value. This method is generally very similar to calling object[key] = value or object.key = value, except that it provides support for computed properties, the unknownProperty() method and property observers. ### Computed Properties If you try to set a value on a key that has a computed property handler defined (see the get() method for an example), then set() will call that method, passing both the value and key instead of simply changing the value itself. This is useful for those times when you need to implement a property that is composed of one or more member properties. ### Unknown Properties If you try to set a value on a key that is undefined in the target object, then the unknownProperty() handler will be called instead. This gives you an opportunity to implement complex "virtual" properties that are not predefined on the object. If unknownProperty() returns undefined, then set() will simply set the value on the object. ### Property Observers In addition to changing the property, set() will also register a property change with the object. Unless you have placed this call inside of a beginPropertyChanges() and endPropertyChanges(), any "local" observers (i.e. observer methods declared on the same object), will be called immediately. Any "remote" observers (i.e. observer methods declared on another object) will be placed in a queue and called at a later time in a coalesced manner. ### Chaining In addition to property changes, set() returns the value of the object itself so you can do chaining like this: record.set('firstName', 'Charles').set('lastName', 'Jolley'); @method set @param {String} key The property to set @param {Object} value The value to set or null. @return {Ember.Observable} */ set: function(keyName, value) { set(this, keyName, value); return this; }, /** To set multiple properties at once, call setProperties with a Hash: record.setProperties({ firstName: 'Charles', lastName: 'Jolley' }); @method setProperties @param {Hash} hash the hash of keys and values to set @return {Ember.Observable} */ setProperties: function(hash) { return Ember.setProperties(this, hash); }, /** Begins a grouping of property changes. You can use this method to group property changes so that notifications will not be sent until the changes are finished. If you plan to make a large number of changes to an object at one time, you should call this method at the beginning of the changes to begin deferring change notifications. When you are done making changes, call endPropertyChanges() to deliver the deferred change notifications and end deferring. @method beginPropertyChanges @return {Ember.Observable} */ beginPropertyChanges: function() { Ember.beginPropertyChanges(); return this; }, /** Ends a grouping of property changes. You can use this method to group property changes so that notifications will not be sent until the changes are finished. If you plan to make a large number of changes to an object at one time, you should call beginPropertyChanges() at the beginning of the changes to defer change notifications. When you are done making changes, call this method to deliver the deferred change notifications and end deferring. @method endPropertyChanges @return {Ember.Observable} */ endPropertyChanges: function() { Ember.endPropertyChanges(); return this; }, /** Notify the observer system that a property is about to change. Sometimes you need to change a value directly or indirectly without actually calling get() or set() on it. In this case, you can use this method and propertyDidChange() instead. Calling these two methods together will notify all observers that the property has potentially changed value. Note that you must always call propertyWillChange and propertyDidChange as a pair. If you do not, it may get the property change groups out of order and cause notifications to be delivered more often than you would like. @method propertyWillChange @param {String} key The property key that is about to change. @return {Ember.Observable} */ propertyWillChange: function(keyName){ Ember.propertyWillChange(this, keyName); return this; }, /** Notify the observer system that a property has just changed. Sometimes you need to change a value directly or indirectly without actually calling get() or set() on it. In this case, you can use this method and propertyWillChange() instead. Calling these two methods together will notify all observers that the property has potentially changed value. Note that you must always call propertyWillChange and propertyDidChange as a pair. If you do not, it may get the property change groups out of order and cause notifications to be delivered more often than you would like. @method propertyDidChange @param {String} keyName The property key that has just changed. @return {Ember.Observable} */ propertyDidChange: function(keyName) { Ember.propertyDidChange(this, keyName); return this; }, /** Convenience method to call `propertyWillChange` and `propertyDidChange` in succession. @method notifyPropertyChange @param {String} keyName The property key to be notified about. @return {Ember.Observable} */ notifyPropertyChange: function(keyName) { this.propertyWillChange(keyName); this.propertyDidChange(keyName); return this; }, addBeforeObserver: function(key, target, method) { Ember.addBeforeObserver(this, key, target, method); }, /** Adds an observer on a property. This is the core method used to register an observer for a property. Once you call this method, anytime the key's value is set, your observer will be notified. Note that the observers are triggered anytime the value is set, regardless of whether it has actually changed. Your observer should be prepared to handle that. You can also pass an optional context parameter to this method. The context will be passed to your observer method whenever it is triggered. Note that if you add the same target/method pair on a key multiple times with different context parameters, your observer will only be called once with the last context you passed. ### Observer Methods Observer methods you pass should generally have the following signature if you do not pass a "context" parameter: fooDidChange: function(sender, key, value, rev); The sender is the object that changed. The key is the property that changes. The value property is currently reserved and unused. The rev is the last property revision of the object when it changed, which you can use to detect if the key value has really changed or not. If you pass a "context" parameter, the context will be passed before the revision like so: fooDidChange: function(sender, key, value, context, rev); Usually you will not need the value, context or revision parameters at the end. In this case, it is common to write observer methods that take only a sender and key value as parameters or, if you aren't interested in any of these values, to write an observer that has no parameters at all. @method addObserver @param {String} key The key to observer @param {Object} target The target object to invoke @param {String|Function} method The method to invoke. @return {Ember.Object} self */ addObserver: function(key, target, method) { Ember.addObserver(this, key, target, method); }, /** Remove an observer you have previously registered on this object. Pass the same key, target, and method you passed to addObserver() and your target will no longer receive notifications. @method removeObserver @param {String} key The key to observer @param {Object} target The target object to invoke @param {String|Function} method The method to invoke. @return {Ember.Observable} receiver */ removeObserver: function(key, target, method) { Ember.removeObserver(this, key, target, method); }, /** Returns true if the object currently has observers registered for a particular key. You can use this method to potentially defer performing an expensive action until someone begins observing a particular property on the object. @method hasObserverFor @param {String} key Key to check @return {Boolean} */ hasObserverFor: function(key) { return Ember.hasListeners(this, key+':change'); }, /** This method will be called when a client attempts to get the value of a property that has not been defined in one of the typical ways. Override this method to create "virtual" properties. @method unknownProperty @param {String} key The name of the unknown property that was requested. @return {Object} The property value or undefined. Default is undefined. */ unknownProperty: function(key) { return undefined; }, /** This method will be called when a client attempts to set the value of a property that has not been defined in one of the typical ways. Override this method to create "virtual" properties. @method setUnknownProperty @param {String} key The name of the unknown property to be set. @param {Object} value The value the unknown property is to be set to. */ setUnknownProperty: function(key, value) { defineProperty(this, key); set(this, key, value); }, /** @deprecated @method getPath @param {String} path The property path to retrieve @return {Object} The property value or undefined. */ getPath: function(path) { Ember.deprecate("getPath is deprecated since get now supports paths"); return this.get(path); }, /** @deprecated @method setPath @param {String} path The path to the property that will be set @param {Object} value The value to set or null. @return {Ember.Observable} */ setPath: function(path, value) { Ember.deprecate("setPath is deprecated since set now supports paths"); return this.set(path, value); }, /** Retrieves the value of a property, or a default value in the case that the property returns undefined. person.getWithDefault('lastName', 'Doe'); @method getWithDefault @param {String} keyName The name of the property to retrieve @param {Object} defaultValue The value to return if the property value is undefined @return {Object} The property value or the defaultValue. */ getWithDefault: function(keyName, defaultValue) { return Ember.getWithDefault(this, keyName, defaultValue); }, /** Set the value of a property to the current value plus some amount. person.incrementProperty('age'); team.incrementProperty('score', 2); @method incrementProperty @param {String} keyName The name of the property to increment @param {Object} increment The amount to increment by. Defaults to 1 @return {Object} The new property value */ incrementProperty: function(keyName, increment) { if (!increment) { increment = 1; } set(this, keyName, (get(this, keyName) || 0)+increment); return get(this, keyName); }, /** Set the value of a property to the current value minus some amount. player.decrementProperty('lives'); orc.decrementProperty('health', 5); @method decrementProperty @param {String} keyName The name of the property to decrement @param {Object} increment The amount to decrement by. Defaults to 1 @return {Object} The new property value */ decrementProperty: function(keyName, increment) { if (!increment) { increment = 1; } set(this, keyName, (get(this, keyName) || 0)-increment); return get(this, keyName); }, /** Set the value of a boolean property to the opposite of it's current value. starship.toggleProperty('warpDriveEnaged'); @method toggleProperty @param {String} keyName The name of the property to toggle @return {Object} The new property value */ toggleProperty: function(keyName) { set(this, keyName, !get(this, keyName)); return get(this, keyName); }, /** Returns the cached value of a computed property, if it exists. This allows you to inspect the value of a computed property without accidentally invoking it if it is intended to be generated lazily. @method cacheFor @param {String} keyName @return {Object} The cached value of the computed property, if any */ cacheFor: function(keyName) { return Ember.cacheFor(this, keyName); }, // intended for debugging purposes observersForKey: function(keyName) { return Ember.observersFor(this, keyName); } }); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set; /** @class TargetActionSupport @namespace Ember @extends Ember.Mixin */ Ember.TargetActionSupport = Ember.Mixin.create({ target: null, action: null, targetObject: Ember.computed(function() { var target = get(this, 'target'); if (Ember.typeOf(target) === "string") { var value = get(this, target); if (value === undefined) { value = get(Ember.lookup, target); } return value; } else { return target; } }).property('target'), triggerAction: function() { var action = get(this, 'action'), target = get(this, 'targetObject'); if (target && action) { var ret; if (typeof target.send === 'function') { ret = target.send(action, this); } else { if (typeof action === 'string') { action = target[action]; } ret = action.call(target, this); } if (ret !== false) ret = true; return ret; } else { return false; } } }); })(); (function() { /** @module ember @submodule ember-runtime */ /** @class Evented @namespace Ember @extends Ember.Mixin */ Ember.Evented = Ember.Mixin.create({ on: function(name, target, method) { Ember.addListener(this, name, target, method); }, one: function(name, target, method) { if (!method) { method = target; target = null; } var self = this; var wrapped = function() { Ember.removeListener(self, name, target, method); if ('string' === typeof method) { method = this[method]; } // Internally, a `null` target means that the target is // the first parameter to addListener. That means that // the `this` passed into this function is the target // determined by the event system. method.apply(this, arguments); }; Ember.addListener(this, name, target, wrapped, Ember.guidFor(method)); }, trigger: function(name) { var args = [], i, l; for (i = 1, l = arguments.length; i < l; i++) { args.push(arguments[i]); } Ember.sendEvent(this, name, args); }, fire: function(name) { Ember.deprecate("Ember.Evented#fire() has been deprecated in favor of trigger() for compatibility with jQuery. It will be removed in 1.0. Please update your code to call trigger() instead."); this.trigger.apply(this, arguments); }, off: function(name, target, method) { Ember.removeListener(this, name, target, method); }, has: function(name) { return Ember.hasListeners(this, name); } }); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, slice = Array.prototype.slice; /** @class Deferred @namespace Ember @extends Ember.Mixin */ Ember.Deferred = Ember.Mixin.create({ /** Add handlers to be called when the Deferred object is resolved or rejected. @method then @param {Function} doneCallback a callback function to be called when done @param {Function} failCallback a callback function to be called when failed */ then: function(doneCallback, failCallback) { return get(this, 'promise').then(doneCallback, failCallback); }, /** Resolve a Deferred object and call any doneCallbacks with the given args. @method resolve */ resolve: function(value) { get(this, 'promise').resolve(value); }, /** Reject a Deferred object and call any failCallbacks with the given args. @method reject */ reject: function(value) { get(this, 'promise').reject(value); }, promise: Ember.computed(function() { return new RSVP.Promise(); }) }); })(); (function() { })(); (function() { /** @module ember @submodule ember-runtime */ // NOTE: this object should never be included directly. Instead use Ember. // Ember.Object. We only define this separately so that Ember.Set can depend on it var set = Ember.set, get = Ember.get, o_create = Ember.create, o_defineProperty = Ember.platform.defineProperty, a_slice = Array.prototype.slice, GUID_KEY = Ember.GUID_KEY, guidFor = Ember.guidFor, generateGuid = Ember.generateGuid, meta = Ember.meta, rewatch = Ember.rewatch, finishChains = Ember.finishChains, destroy = Ember.destroy, schedule = Ember.run.schedule, Mixin = Ember.Mixin, applyMixin = Mixin._apply, finishPartial = Mixin.finishPartial, reopen = Mixin.prototype.reopen, classToString = Mixin.prototype.toString; var undefinedDescriptor = { configurable: true, writable: true, enumerable: false, value: undefined }; function makeCtor() { // Note: avoid accessing any properties on the object since it makes the // method a lot faster. This is glue code so we want it to be as fast as // possible. var wasApplied = false, initMixins; var Class = function() { if (!wasApplied) { Class.proto(); // prepare prototype... } o_defineProperty(this, GUID_KEY, undefinedDescriptor); o_defineProperty(this, '_super', undefinedDescriptor); var m = meta(this); m.proto = this; if (initMixins) { this.reopen.apply(this, initMixins); initMixins = null; } finishPartial(this, m); delete m.proto; finishChains(this); this.init.apply(this, arguments); }; Class.toString = classToString; Class.willReopen = function() { if (wasApplied) { Class.PrototypeMixin = Mixin.create(Class.PrototypeMixin); } wasApplied = false; }; Class._initMixins = function(args) { initMixins = args; }; Class.proto = function() { var superclass = Class.superclass; if (superclass) { superclass.proto(); } if (!wasApplied) { wasApplied = true; Class.PrototypeMixin.applyPartial(Class.prototype); rewatch(Class.prototype); } return this.prototype; }; return Class; } var CoreObject = makeCtor(); CoreObject.PrototypeMixin = Mixin.create({ reopen: function() { applyMixin(this, arguments, true); return this; }, isInstance: true, init: function() {}, /** @property isDestroyed @default false */ isDestroyed: false, /** @property isDestroying @default false */ isDestroying: false, /** Destroys an object by setting the isDestroyed flag and removing its metadata, which effectively destroys observers and bindings. If you try to set a property on a destroyed object, an exception will be raised. Note that destruction is scheduled for the end of the run loop and does not happen immediately. @method destroy @return {Ember.Object} receiver */ destroy: function() { if (this.isDestroying) { return; } this.isDestroying = true; if (this.willDestroy) { this.willDestroy(); } set(this, 'isDestroyed', true); schedule('destroy', this, this._scheduledDestroy); return this; }, /** @private Invoked by the run loop to actually destroy the object. This is scheduled for execution by the `destroy` method. @method _scheduledDestroy */ _scheduledDestroy: function() { destroy(this); if (this.didDestroy) { this.didDestroy(); } }, bind: function(to, from) { if (!(from instanceof Ember.Binding)) { from = Ember.Binding.from(from); } from.to(to).connect(this); return from; }, toString: function() { return '<'+this.constructor.toString()+':'+guidFor(this)+'>'; } }); if (Ember.config.overridePrototypeMixin) { Ember.config.overridePrototypeMixin(CoreObject.PrototypeMixin); } CoreObject.__super__ = null; var ClassMixin = Mixin.create({ ClassMixin: Ember.required(), PrototypeMixin: Ember.required(), isClass: true, isMethod: false, extend: function() { var Class = makeCtor(), proto; Class.ClassMixin = Mixin.create(this.ClassMixin); Class.PrototypeMixin = Mixin.create(this.PrototypeMixin); Class.ClassMixin.ownerConstructor = Class; Class.PrototypeMixin.ownerConstructor = Class; reopen.apply(Class.PrototypeMixin, arguments); Class.superclass = this; Class.__super__ = this.prototype; proto = Class.prototype = o_create(this.prototype); proto.constructor = Class; generateGuid(proto, 'ember'); meta(proto).proto = proto; // this will disable observers on prototype Class.ClassMixin.apply(Class); return Class; }, create: function() { var C = this; if (arguments.length>0) { this._initMixins(arguments); } return new C(); }, reopen: function() { this.willReopen(); reopen.apply(this.PrototypeMixin, arguments); return this; }, reopenClass: function() { reopen.apply(this.ClassMixin, arguments); applyMixin(this, arguments, false); return this; }, detect: function(obj) { if ('function' !== typeof obj) { return false; } while(obj) { if (obj===this) { return true; } obj = obj.superclass; } return false; }, detectInstance: function(obj) { return obj instanceof this; }, /** In some cases, you may want to annotate computed properties with additional metadata about how they function or what values they operate on. For example, computed property functions may close over variables that are then no longer available for introspection. You can pass a hash of these values to a computed property like this: person: function() { var personId = this.get('personId'); return App.Person.create({ id: personId }); }.property().meta({ type: App.Person }) Once you've done this, you can retrieve the values saved to the computed property from your class like this: MyClass.metaForProperty('person'); This will return the original hash that was passed to `meta()`. @method metaForProperty @param key {String} property name */ metaForProperty: function(key) { var desc = meta(this.proto(), false).descs[key]; Ember.assert("metaForProperty() could not find a computed property with key '"+key+"'.", !!desc && desc instanceof Ember.ComputedProperty); return desc._meta || {}; }, /** Iterate over each computed property for the class, passing its name and any associated metadata (see `metaForProperty`) to the callback. @method eachComputedProperty @param {Function} callback @param {Object} binding */ eachComputedProperty: function(callback, binding) { var proto = this.proto(), descs = meta(proto).descs, empty = {}, property; for (var name in descs) { property = descs[name]; if (property instanceof Ember.ComputedProperty) { callback.call(binding || this, name, property._meta || empty); } } } }); if (Ember.config.overrideClassMixin) { Ember.config.overrideClassMixin(ClassMixin); } CoreObject.ClassMixin = ClassMixin; ClassMixin.apply(CoreObject); /** @class CoreObject @namespace Ember */ Ember.CoreObject = CoreObject; })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set, guidFor = Ember.guidFor, none = Ember.none; /** An unordered collection of objects. A Set works a bit like an array except that its items are not ordered. You can create a set to efficiently test for membership for an object. You can also iterate through a set just like an array, even accessing objects by index, however there is no guarantee as to their order. All Sets are observable via the Enumerable Observer API - which works on any enumerable object including both Sets and Arrays. ## Creating a Set You can create a set like you would most objects using `new Ember.Set()`. Most new sets you create will be empty, but you can also initialize the set with some content by passing an array or other enumerable of objects to the constructor. Finally, you can pass in an existing set and the set will be copied. You can also create a copy of a set by calling `Ember.Set#copy()`. #js // creates a new empty set var foundNames = new Ember.Set(); // creates a set with four names in it. var names = new Ember.Set(["Charles", "Tom", "Juan", "Alex"]); // :P // creates a copy of the names set. var namesCopy = new Ember.Set(names); // same as above. var anotherNamesCopy = names.copy(); ## Adding/Removing Objects You generally add or remove objects from a set using `add()` or `remove()`. You can add any type of object including primitives such as numbers, strings, and booleans. Unlike arrays, objects can only exist one time in a set. If you call `add()` on a set with the same object multiple times, the object will only be added once. Likewise, calling `remove()` with the same object multiple times will remove the object the first time and have no effect on future calls until you add the object to the set again. NOTE: You cannot add/remove null or undefined to a set. Any attempt to do so will be ignored. In addition to add/remove you can also call `push()`/`pop()`. Push behaves just like `add()` but `pop()`, unlike `remove()` will pick an arbitrary object, remove it and return it. This is a good way to use a set as a job queue when you don't care which order the jobs are executed in. ## Testing for an Object To test for an object's presence in a set you simply call `Ember.Set#contains()`. ## Observing changes When using `Ember.Set`, you can observe the `"[]"` property to be alerted whenever the content changes. You can also add an enumerable observer to the set to be notified of specific objects that are added and removed from the set. See `Ember.Enumerable` for more information on enumerables. This is often unhelpful. If you are filtering sets of objects, for instance, it is very inefficient to re-filter all of the items each time the set changes. It would be better if you could just adjust the filtered set based on what was changed on the original set. The same issue applies to merging sets, as well. ## Other Methods `Ember.Set` primary implements other mixin APIs. For a complete reference on the methods you will use with `Ember.Set`, please consult these mixins. The most useful ones will be `Ember.Enumerable` and `Ember.MutableEnumerable` which implement most of the common iterator methods you are used to on Array. Note that you can also use the `Ember.Copyable` and `Ember.Freezable` APIs on `Ember.Set` as well. Once a set is frozen it can no longer be modified. The benefit of this is that when you call frozenCopy() on it, Ember will avoid making copies of the set. This allows you to write code that can know with certainty when the underlying set data will or will not be modified. @class Set @namespace Ember @extends Ember.CoreObject @uses Ember.MutableEnumerable @uses Ember.Copyable @uses Ember.Freezable @since Ember 0.9 */ Ember.Set = Ember.CoreObject.extend(Ember.MutableEnumerable, Ember.Copyable, Ember.Freezable, /** @scope Ember.Set.prototype */ { // .......................................................... // IMPLEMENT ENUMERABLE APIS // /** This property will change as the number of objects in the set changes. @property length @type number @default 0 */ length: 0, /** Clears the set. This is useful if you want to reuse an existing set without having to recreate it. var colors = new Ember.Set(["red", "green", "blue"]); colors.length; => 3 colors.clear(); colors.length; => 0 @method clear @return {Ember.Set} An empty Set */ clear: function() { if (this.isFrozen) { throw new Error(Ember.FROZEN_ERROR); } var len = get(this, 'length'); if (len === 0) { return this; } var guid; this.enumerableContentWillChange(len, 0); Ember.propertyWillChange(this, 'firstObject'); Ember.propertyWillChange(this, 'lastObject'); for (var i=0; i < len; i++){ guid = guidFor(this[i]); delete this[guid]; delete this[i]; } set(this, 'length', 0); Ember.propertyDidChange(this, 'firstObject'); Ember.propertyDidChange(this, 'lastObject'); this.enumerableContentDidChange(len, 0); return this; }, /** Returns true if the passed object is also an enumerable that contains the same objects as the receiver. var colors = ["red", "green", "blue"], same_colors = new Ember.Set(colors); same_colors.isEqual(colors); => true same_colors.isEqual(["purple", "brown"]); => false @method isEqual @param {Ember.Set} obj the other object. @return {Boolean} */ isEqual: function(obj) { // fail fast if (!Ember.Enumerable.detect(obj)) return false; var loc = get(this, 'length'); if (get(obj, 'length') !== loc) return false; while(--loc >= 0) { if (!obj.contains(this[loc])) return false; } return true; }, /** Adds an object to the set. Only non-null objects can be added to a set and those can only be added once. If the object is already in the set or the passed value is null this method will have no effect. This is an alias for `Ember.MutableEnumerable.addObject()`. var colors = new Ember.Set(); colors.add("blue"); => ["blue"] colors.add("blue"); => ["blue"] colors.add("red"); => ["blue", "red"] colors.add(null); => ["blue", "red"] colors.add(undefined); => ["blue", "red"] @method add @param {Object} obj The object to add. @return {Ember.Set} The set itself. */ add: Ember.alias('addObject'), /** Removes the object from the set if it is found. If you pass a null value or an object that is already not in the set, this method will have no effect. This is an alias for `Ember.MutableEnumerable.removeObject()`. var colors = new Ember.Set(["red", "green", "blue"]); colors.remove("red"); => ["blue", "green"] colors.remove("purple"); => ["blue", "green"] colors.remove(null); => ["blue", "green"] @method remove @param {Object} obj The object to remove @return {Ember.Set} The set itself. */ remove: Ember.alias('removeObject'), /** Removes the last element from the set and returns it, or null if it's empty. var colors = new Ember.Set(["green", "blue"]); colors.pop(); => "blue" colors.pop(); => "green" colors.pop(); => null @method pop @return {Object} The removed object from the set or null. */ pop: function() { if (get(this, 'isFrozen')) throw new Error(Ember.FROZEN_ERROR); var obj = this.length > 0 ? this[this.length-1] : null; this.remove(obj); return obj; }, /** Inserts the given object on to the end of the set. It returns the set itself. This is an alias for `Ember.MutableEnumerable.addObject()`. var colors = new Ember.Set(); colors.push("red"); => ["red"] colors.push("green"); => ["red", "green"] colors.push("blue"); => ["red", "green", "blue"] @method push @return {Ember.Set} The set itself. */ push: Ember.alias('addObject'), /** Removes the last element from the set and returns it, or null if it's empty. This is an alias for `Ember.Set.pop()`. var colors = new Ember.Set(["green", "blue"]); colors.shift(); => "blue" colors.shift(); => "green" colors.shift(); => null @method shift @return {Object} The removed object from the set or null. */ shift: Ember.alias('pop'), /** Inserts the given object on to the end of the set. It returns the set itself. This is an alias of `Ember.Set.push()` var colors = new Ember.Set(); colors.unshift("red"); => ["red"] colors.unshift("green"); => ["red", "green"] colors.unshift("blue"); => ["red", "green", "blue"] @method unshift @return {Ember.Set} The set itself. */ unshift: Ember.alias('push'), /** Adds each object in the passed enumerable to the set. This is an alias of `Ember.MutableEnumerable.addObjects()` var colors = new Ember.Set(); colors.addEach(["red", "green", "blue"]); => ["red", "green", "blue"] @method addEach @param {Ember.Enumerable} objects the objects to add. @return {Ember.Set} The set itself. */ addEach: Ember.alias('addObjects'), /** Removes each object in the passed enumerable to the set. This is an alias of `Ember.MutableEnumerable.removeObjects()` var colors = new Ember.Set(["red", "green", "blue"]); colors.removeEach(["red", "blue"]); => ["green"] @method removeEach @param {Ember.Enumerable} objects the objects to remove. @return {Ember.Set} The set itself. */ removeEach: Ember.alias('removeObjects'), // .......................................................... // PRIVATE ENUMERABLE SUPPORT // init: function(items) { this._super(); if (items) this.addObjects(items); }, // implement Ember.Enumerable nextObject: function(idx) { return this[idx]; }, // more optimized version firstObject: Ember.computed(function() { return this.length > 0 ? this[0] : undefined; }).property(), // more optimized version lastObject: Ember.computed(function() { return this.length > 0 ? this[this.length-1] : undefined; }).property(), // implements Ember.MutableEnumerable addObject: function(obj) { if (get(this, 'isFrozen')) throw new Error(Ember.FROZEN_ERROR); if (none(obj)) return this; // nothing to do var guid = guidFor(obj), idx = this[guid], len = get(this, 'length'), added ; if (idx>=0 && idx=0 && idx=0; }, copy: function() { var C = this.constructor, ret = new C(), loc = get(this, 'length'); set(ret, 'length', loc); while(--loc>=0) { ret[loc] = this[loc]; ret[guidFor(this[loc])] = loc; } return ret; }, toString: function() { var len = this.length, idx, array = []; for(idx = 0; idx < len; idx++) { array[idx] = this[idx]; } return "Ember.Set<%@>".fmt(array.join(',')); } }); })(); (function() { /** @module ember @submodule ember-runtime */ /** `Ember.Object` is the main base class for all Ember objects. It is a subclass of `Ember.CoreObject` with the `Ember.Observable` mixin applied. For details, see the documentation for each of these. @class Object @namespace Ember @extends Ember.CoreObject @uses Ember.Observable */ Ember.Object = Ember.CoreObject.extend(Ember.Observable); })(); (function() { /** @module ember @submodule ember-runtime */ var indexOf = Ember.ArrayPolyfills.indexOf; /** A Namespace is an object usually used to contain other objects or methods such as an application or framework. Create a namespace anytime you want to define one of these new containers. # Example Usage MyFramework = Ember.Namespace.create({ VERSION: '1.0.0' }); @class Namespace @namespace Ember @extends Ember.Object */ Ember.Namespace = Ember.Object.extend({ isNamespace: true, init: function() { Ember.Namespace.NAMESPACES.push(this); Ember.Namespace.PROCESSED = false; }, toString: function() { Ember.identifyNamespaces(); return this[Ember.GUID_KEY+'_name']; }, destroy: function() { var namespaces = Ember.Namespace.NAMESPACES; Ember.lookup[this.toString()] = undefined; namespaces.splice(indexOf.call(namespaces, this), 1); this._super(); } }); Ember.Namespace.NAMESPACES = [Ember]; Ember.Namespace.PROCESSED = false; })(); (function() { /** @module ember @submodule ember-runtime */ /** Defines a namespace that will contain an executable application. This is very similar to a normal namespace except that it is expected to include at least a 'ready' function which can be run to initialize the application. Currently Ember.Application is very similar to Ember.Namespace. However, this class may be augmented by additional frameworks so it is important to use this instance when building new applications. # Example Usage MyApp = Ember.Application.create({ VERSION: '1.0.0', store: Ember.Store.create().from(Ember.fixtures) }); MyApp.ready = function() { //..init code goes here... } @class Application @namespace Ember @extends Ember.Namespace */ Ember.Application = Ember.Namespace.extend(); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set; /** An ArrayProxy wraps any other object that implements Ember.Array and/or Ember.MutableArray, forwarding all requests. This makes it very useful for a number of binding use cases or other cases where being able to swap out the underlying array is useful. A simple example of usage: var pets = ['dog', 'cat', 'fish']; var ap = Ember.ArrayProxy.create({ content: Ember.A(pets) }); ap.get('firstObject'); // => 'dog' ap.set('content', ['amoeba', 'paramecium']); ap.get('firstObject'); // => 'amoeba' This class can also be useful as a layer to transform the contents of an array, as they are accessed. This can be done by overriding `objectAtContent`: var pets = ['dog', 'cat', 'fish']; var ap = Ember.ArrayProxy.create({ content: Ember.A(pets), objectAtContent: function(idx) { return this.get('content').objectAt(idx).toUpperCase(); } }); ap.get('firstObject'); // => 'DOG' @class ArrayProxy @namespace Ember @extends Ember.Object @uses Ember.MutableArray */ Ember.ArrayProxy = Ember.Object.extend(Ember.MutableArray, /** @scope Ember.ArrayProxy.prototype */ { /** The content array. Must be an object that implements Ember.Array and/or Ember.MutableArray. @property content @type Ember.Array */ content: null, /** The array that the proxy pretends to be. In the default `ArrayProxy` implementation, this and `content` are the same. Subclasses of `ArrayProxy` can override this property to provide things like sorting and filtering. @property arrangedContent */ arrangedContent: Ember.computed('content', function() { return get(this, 'content'); }), /** Should actually retrieve the object at the specified index from the content. You can override this method in subclasses to transform the content item to something new. This method will only be called if content is non-null. @method objectAtContent @param {Number} idx The index to retrieve. @return {Object} the value or undefined if none found */ objectAtContent: function(idx) { return get(this, 'arrangedContent').objectAt(idx); }, /** Should actually replace the specified objects on the content array. You can override this method in subclasses to transform the content item into something new. This method will only be called if content is non-null. @method replaceContent @param {Number} idx The starting index @param {Number} amt The number of items to remove from the content. @param {Array} objects Optional array of objects to insert or null if no objects. @return {void} */ replaceContent: function(idx, amt, objects) { get(this, 'arrangedContent').replace(idx, amt, objects); }, /** @private Invoked when the content property is about to change. Notifies observers that the entire array content will change. @method _contentWillChange */ _contentWillChange: Ember.beforeObserver(function() { this._teardownContent(); }, 'content'), _teardownContent: function() { var content = get(this, 'content'); if (content) { content.removeArrayObserver(this, { willChange: 'contentArrayWillChange', didChange: 'contentArrayDidChange' }); } }, contentArrayWillChange: Ember.K, contentArrayDidChange: Ember.K, /** @private Invoked when the content property changes. Notifies observers that the entire array content has changed. @method _contentDidChange */ _contentDidChange: Ember.observer(function() { var content = get(this, 'content'); Ember.assert("Can't set ArrayProxy's content to itself", content !== this); this._setupContent(); }, 'content'), _setupContent: function() { var content = get(this, 'content'); if (content) { content.addArrayObserver(this, { willChange: 'contentArrayWillChange', didChange: 'contentArrayDidChange' }); } }, _arrangedContentWillChange: Ember.beforeObserver(function() { var arrangedContent = get(this, 'arrangedContent'), len = arrangedContent ? get(arrangedContent, 'length') : 0; this.arrangedContentArrayWillChange(this, 0, len, undefined); this.arrangedContentWillChange(this); this._teardownArrangedContent(arrangedContent); }, 'arrangedContent'), _arrangedContentDidChange: Ember.observer(function() { var arrangedContent = get(this, 'arrangedContent'), len = arrangedContent ? get(arrangedContent, 'length') : 0; Ember.assert("Can't set ArrayProxy's content to itself", arrangedContent !== this); this._setupArrangedContent(); this.arrangedContentDidChange(this); this.arrangedContentArrayDidChange(this, 0, undefined, len); }, 'arrangedContent'), _setupArrangedContent: function() { var arrangedContent = get(this, 'arrangedContent'); if (arrangedContent) { arrangedContent.addArrayObserver(this, { willChange: 'arrangedContentArrayWillChange', didChange: 'arrangedContentArrayDidChange' }); } }, _teardownArrangedContent: function() { var arrangedContent = get(this, 'arrangedContent'); if (arrangedContent) { arrangedContent.removeArrayObserver(this, { willChange: 'arrangedContentArrayWillChange', didChange: 'arrangedContentArrayDidChange' }); } }, arrangedContentWillChange: Ember.K, arrangedContentDidChange: Ember.K, objectAt: function(idx) { return get(this, 'content') && this.objectAtContent(idx); }, length: Ember.computed(function() { var arrangedContent = get(this, 'arrangedContent'); return arrangedContent ? get(arrangedContent, 'length') : 0; // No dependencies since Enumerable notifies length of change }).property(), replace: function(idx, amt, objects) { Ember.assert('The content property of '+ this.constructor + ' should be set before modifying it', this.get('content')); if (get(this, 'content')) this.replaceContent(idx, amt, objects); return this; }, arrangedContentArrayWillChange: function(item, idx, removedCnt, addedCnt) { this.arrayContentWillChange(idx, removedCnt, addedCnt); }, arrangedContentArrayDidChange: function(item, idx, removedCnt, addedCnt) { this.arrayContentDidChange(idx, removedCnt, addedCnt); }, init: function() { this._super(); this._setupContent(); this._setupArrangedContent(); }, willDestroy: function() { this._teardownArrangedContent(); this._teardownContent(); } }); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt, addBeforeObserver = Ember.addBeforeObserver, addObserver = Ember.addObserver, removeBeforeObserver = Ember.removeBeforeObserver, removeObserver = Ember.removeObserver, propertyWillChange = Ember.propertyWillChange, propertyDidChange = Ember.propertyDidChange; function contentPropertyWillChange(content, contentKey) { var key = contentKey.slice(8); // remove "content." if (key in this) { return; } // if shadowed in proxy propertyWillChange(this, key); } function contentPropertyDidChange(content, contentKey) { var key = contentKey.slice(8); // remove "content." if (key in this) { return; } // if shadowed in proxy propertyDidChange(this, key); } /** `Ember.ObjectProxy` forwards all properties not defined by the proxy itself to a proxied `content` object. object = Ember.Object.create({ name: 'Foo' }); proxy = Ember.ObjectProxy.create({ content: object }); // Access and change existing properties proxy.get('name') // => 'Foo' proxy.set('name', 'Bar'); object.get('name') // => 'Bar' // Create new 'description' property on `object` proxy.set('description', 'Foo is a whizboo baz'); object.get('description') // => 'Foo is a whizboo baz' While `content` is unset, setting a property to be delegated will throw an Error. proxy = Ember.ObjectProxy.create({ content: null, flag: null }); proxy.set('flag', true); proxy.get('flag'); // => true proxy.get('foo'); // => undefined proxy.set('foo', 'data'); // throws Error Delegated properties can be bound to and will change when content is updated. Computed properties on the proxy itself can depend on delegated properties. ProxyWithComputedProperty = Ember.ObjectProxy.extend({ fullName: function () { var firstName = this.get('firstName'), lastName = this.get('lastName'); if (firstName && lastName) { return firstName + ' ' + lastName; } return firstName || lastName; }.property('firstName', 'lastName') }); proxy = ProxyWithComputedProperty.create(); proxy.get('fullName'); => undefined proxy.set('content', { firstName: 'Tom', lastName: 'Dale' }); // triggers property change for fullName on proxy proxy.get('fullName'); => 'Tom Dale' @class ObjectProxy @namespace Ember @extends Ember.Object */ Ember.ObjectProxy = Ember.Object.extend( /** @scope Ember.ObjectProxy.prototype */ { /** The object whose properties will be forwarded. @property content @type Ember.Object @default null */ content: null, _contentDidChange: Ember.observer(function() { Ember.assert("Can't set ObjectProxy's content to itself", this.get('content') !== this); }, 'content'), willWatchProperty: function (key) { var contentKey = 'content.' + key; addBeforeObserver(this, contentKey, null, contentPropertyWillChange); addObserver(this, contentKey, null, contentPropertyDidChange); }, didUnwatchProperty: function (key) { var contentKey = 'content.' + key; removeBeforeObserver(this, contentKey, null, contentPropertyWillChange); removeObserver(this, contentKey, null, contentPropertyDidChange); }, unknownProperty: function (key) { var content = get(this, 'content'); if (content) { return get(content, key); } }, setUnknownProperty: function (key, value) { var content = get(this, 'content'); Ember.assert(fmt("Cannot delegate set('%@', %@) to the 'content' property of object proxy %@: its 'content' is undefined.", [key, value, this]), content); return set(content, key, value); } }); })(); (function() { /** @module ember @submodule ember-runtime */ var set = Ember.set, get = Ember.get, guidFor = Ember.guidFor; var forEach = Ember.EnumerableUtils.forEach; var EachArray = Ember.Object.extend(Ember.Array, { init: function(content, keyName, owner) { this._super(); this._keyName = keyName; this._owner = owner; this._content = content; }, objectAt: function(idx) { var item = this._content.objectAt(idx); return item && get(item, this._keyName); }, length: Ember.computed(function() { var content = this._content; return content ? get(content, 'length') : 0; }).property() }); var IS_OBSERVER = /^.+:(before|change)$/; function addObserverForContentKey(content, keyName, proxy, idx, loc) { var objects = proxy._objects, guid; if (!objects) objects = proxy._objects = {}; while(--loc>=idx) { var item = content.objectAt(loc); if (item) { Ember.addBeforeObserver(item, keyName, proxy, 'contentKeyWillChange'); Ember.addObserver(item, keyName, proxy, 'contentKeyDidChange'); // keep track of the indicies each item was found at so we can map // it back when the obj changes. guid = guidFor(item); if (!objects[guid]) objects[guid] = []; objects[guid].push(loc); } } } function removeObserverForContentKey(content, keyName, proxy, idx, loc) { var objects = proxy._objects; if (!objects) objects = proxy._objects = {}; var indicies, guid; while(--loc>=idx) { var item = content.objectAt(loc); if (item) { Ember.removeBeforeObserver(item, keyName, proxy, 'contentKeyWillChange'); Ember.removeObserver(item, keyName, proxy, 'contentKeyDidChange'); guid = guidFor(item); indicies = objects[guid]; indicies[indicies.indexOf(loc)] = null; } } } /** This is the object instance returned when you get the @each property on an array. It uses the unknownProperty handler to automatically create EachArray instances for property names. @private @class EachProxy @namespace Ember @extends Ember.Object */ Ember.EachProxy = Ember.Object.extend({ init: function(content) { this._super(); this._content = content; content.addArrayObserver(this); // in case someone is already observing some keys make sure they are // added forEach(Ember.watchedEvents(this), function(eventName) { this.didAddListener(eventName); }, this); }, /** You can directly access mapped properties by simply requesting them. The unknownProperty handler will generate an EachArray of each item. @method unknownProperty @param keyName {String} @param value {anything} */ unknownProperty: function(keyName, value) { var ret; ret = new EachArray(this._content, keyName, this); Ember.defineProperty(this, keyName, null, ret); this.beginObservingContentKey(keyName); return ret; }, // .......................................................... // ARRAY CHANGES // Invokes whenever the content array itself changes. arrayWillChange: function(content, idx, removedCnt, addedCnt) { var keys = this._keys, key, array, lim; lim = removedCnt>0 ? idx+removedCnt : -1; Ember.beginPropertyChanges(this); for(key in keys) { if (!keys.hasOwnProperty(key)) { continue; } if (lim>0) removeObserverForContentKey(content, key, this, idx, lim); Ember.propertyWillChange(this, key); } Ember.propertyWillChange(this._content, '@each'); Ember.endPropertyChanges(this); }, arrayDidChange: function(content, idx, removedCnt, addedCnt) { var keys = this._keys, key, array, lim; lim = addedCnt>0 ? idx+addedCnt : -1; Ember.beginPropertyChanges(this); for(key in keys) { if (!keys.hasOwnProperty(key)) { continue; } if (lim>0) addObserverForContentKey(content, key, this, idx, lim); Ember.propertyDidChange(this, key); } Ember.propertyDidChange(this._content, '@each'); Ember.endPropertyChanges(this); }, // .......................................................... // LISTEN FOR NEW OBSERVERS AND OTHER EVENT LISTENERS // Start monitoring keys based on who is listening... didAddListener: function(eventName) { if (IS_OBSERVER.test(eventName)) { this.beginObservingContentKey(eventName.slice(0, -7)); } }, didRemoveListener: function(eventName) { if (IS_OBSERVER.test(eventName)) { this.stopObservingContentKey(eventName.slice(0, -7)); } }, // .......................................................... // CONTENT KEY OBSERVING // Actual watch keys on the source content. beginObservingContentKey: function(keyName) { var keys = this._keys; if (!keys) keys = this._keys = {}; if (!keys[keyName]) { keys[keyName] = 1; var content = this._content, len = get(content, 'length'); addObserverForContentKey(content, keyName, this, 0, len); } else { keys[keyName]++; } }, stopObservingContentKey: function(keyName) { var keys = this._keys; if (keys && (keys[keyName]>0) && (--keys[keyName]<=0)) { var content = this._content, len = get(content, 'length'); removeObserverForContentKey(content, keyName, this, 0, len); } }, contentKeyWillChange: function(obj, keyName) { Ember.propertyWillChange(this, keyName); }, contentKeyDidChange: function(obj, keyName) { Ember.propertyDidChange(this, keyName); } }); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set; // Add Ember.Array to Array.prototype. Remove methods with native // implementations and supply some more optimized versions of generic methods // because they are so common. var NativeArray = Ember.Mixin.create(Ember.MutableArray, Ember.Observable, Ember.Copyable, { // because length is a built-in property we need to know to just get the // original property. get: function(key) { if (key==='length') return this.length; else if ('number' === typeof key) return this[key]; else return this._super(key); }, objectAt: function(idx) { return this[idx]; }, // primitive for array support. replace: function(idx, amt, objects) { if (this.isFrozen) throw Ember.FROZEN_ERROR ; // if we replaced exactly the same number of items, then pass only the // replaced range. Otherwise, pass the full remaining array length // since everything has shifted var len = objects ? get(objects, 'length') : 0; this.arrayContentWillChange(idx, amt, len); if (!objects || objects.length === 0) { this.splice(idx, amt) ; } else { var args = [idx, amt].concat(objects) ; this.splice.apply(this,args) ; } this.arrayContentDidChange(idx, amt, len); return this ; }, // If you ask for an unknown property, then try to collect the value // from member items. unknownProperty: function(key, value) { var ret;// = this.reducedProperty(key, value) ; if ((value !== undefined) && ret === undefined) { ret = this[key] = value; } return ret ; }, // If browser did not implement indexOf natively, then override with // specialized version indexOf: function(object, startAt) { var idx, len = this.length; if (startAt === undefined) startAt = 0; else startAt = (startAt < 0) ? Math.ceil(startAt) : Math.floor(startAt); if (startAt < 0) startAt += len; for(idx=startAt;idx=0;idx--) { if (this[idx] === object) return idx ; } return -1; }, copy: function() { return this.slice(); } }); // Remove any methods implemented natively so we don't override them var ignore = ['length']; Ember.EnumerableUtils.forEach(NativeArray.keys(), function(methodName) { if (Array.prototype[methodName]) ignore.push(methodName); }); if (ignore.length>0) { NativeArray = NativeArray.without.apply(NativeArray, ignore); } /** The NativeArray mixin contains the properties needed to to make the native Array support Ember.MutableArray and all of its dependent APIs. Unless you have Ember.EXTEND_PROTOTYPES or Ember.EXTEND_PROTOTYPES.Array set to false, this will be applied automatically. Otherwise you can apply the mixin at anytime by calling `Ember.NativeArray.activate`. @class NativeArray @namespace Ember @extends Ember.Mixin @uses Ember.MutableArray @uses Ember.MutableEnumerable @uses Ember.Copyable @uses Ember.Freezable */ Ember.NativeArray = NativeArray; /** Creates an Ember.NativeArray from an Array like object. Does not modify the original object. @method A @for Ember @return {Ember.NativeArray} */ Ember.A = function(arr){ if (arr === undefined) { arr = []; } return Ember.NativeArray.apply(arr); }; /** Activates the mixin on the Array.prototype if not already applied. Calling this method more than once is safe. @method activate @for Ember.NativeArray @static @return {void} */ Ember.NativeArray.activate = function() { NativeArray.apply(Array.prototype); Ember.A = function(arr) { return arr || []; }; }; if (Ember.EXTEND_PROTOTYPES === true || Ember.EXTEND_PROTOTYPES.Array) { Ember.NativeArray.activate(); } })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set; Ember._PromiseChain = Ember.Object.extend({ promises: null, failureCallback: Ember.K, successCallback: Ember.K, abortCallback: Ember.K, promiseSuccessCallback: Ember.K, runNextPromise: function() { if (get(this, 'isDestroyed')) { return; } var item = get(this, 'promises').shiftObject(); if (item) { var promise = get(item, 'promise') || item; Ember.assert("Cannot find promise to invoke", Ember.canInvoke(promise, 'then')); var self = this; var successCallback = function() { self.promiseSuccessCallback.call(this, item, arguments); self.runNextPromise(); }; var failureCallback = get(self, 'failureCallback'); promise.then(successCallback, failureCallback); } else { this.successCallback(); } }, start: function() { this.runNextPromise(); return this; }, abort: function() { this.abortCallback(); this.destroy(); }, init: function() { set(this, 'promises', Ember.A(get(this, 'promises'))); this._super(); } }); })(); (function() { /** @module ember @submodule ember-runtime */ var loadHooks = {}; var loaded = {}; /** @method onLoad @for Ember @param name {String} name of hook @param callback {Function} callback to be called */ Ember.onLoad = function(name, callback) { var object; loadHooks[name] = loadHooks[name] || Ember.A(); loadHooks[name].pushObject(callback); if (object = loaded[name]) { callback(object); } }; /** @method runLoadHooks @for Ember @param name {String} name of hook @param object {Object} object to pass to callbacks */ Ember.runLoadHooks = function(name, object) { var hooks; loaded[name] = object; if (hooks = loadHooks[name]) { loadHooks[name].forEach(function(callback) { callback(object); }); } }; })(); (function() { })(); (function() { /** @module ember @submodule ember-runtime */ /** Ember.ControllerMixin provides a standard interface for all classes that compose Ember's controller layer: Ember.Controller, Ember.ArrayController, and Ember.ObjectController. Within an Ember.Router-managed application single shared instaces of every Controller object in your application's namespace will be added to the application's Ember.Router instance. See `Ember.Application#initialize` for additional information. ## Views By default a controller instance will be the rendering context for its associated Ember.View. This connection is made during calls to `Ember.ControllerMixin#connectOutlet`. Within the view's template, the Ember.View instance can be accessed through the controller with `{{view}}`. ## Target Forwarding By default a controller will target your application's Ember.Router instance. Calls to `{{action}}` within the template of a controller's view are forwarded to the router. See `Ember.Handlebars.helpers.action` for additional information. @class ControllerMixin @namespace Ember @extends Ember.Mixin */ Ember.ControllerMixin = Ember.Mixin.create({ /** The object to which events from the view should be sent. For example, when a Handlebars template uses the `{{action}}` helper, it will attempt to send the event to the view's controller's `target`. By default, a controller's `target` is set to the router after it is instantiated by `Ember.Application#initialize`. @property target @default null */ target: null, store: null }); /** @class Controller @namespace Ember @extends Ember.Object @uses Ember.ControllerMixin */ Ember.Controller = Ember.Object.extend(Ember.ControllerMixin); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set, forEach = Ember.EnumerableUtils.forEach; /** Ember.SortableMixin provides a standard interface for array proxies to specify a sort order and maintain this sorting when objects are added, removed, or updated without changing the implicit order of their underlying content array: songs = [ {trackNumber: 4, title: 'Ob-La-Di, Ob-La-Da'}, {trackNumber: 2, title: 'Back in the U.S.S.R.'}, {trackNumber: 3, title: 'Glass Onion'}, ]; songsController = Ember.ArrayController.create({ content: songs, sortProperties: ['trackNumber'] }); songsController.get('firstObject'); // {trackNumber: 2, title: 'Back in the U.S.S.R.'} songsController.addObject({trackNumber: 1, title: 'Dear Prudence'}); songsController.get('firstObject'); // {trackNumber: 1, title: 'Dear Prudence'} @class SortableMixin @namespace Ember @extends Ember.Mixin @uses Ember.MutableEnumerable */ Ember.SortableMixin = Ember.Mixin.create(Ember.MutableEnumerable, { sortProperties: null, sortAscending: true, addObject: function(obj) { var content = get(this, 'content'); content.pushObject(obj); }, removeObject: function(obj) { var content = get(this, 'content'); content.removeObject(obj); }, orderBy: function(item1, item2) { var result = 0, sortProperties = get(this, 'sortProperties'), sortAscending = get(this, 'sortAscending'); Ember.assert("you need to define `sortProperties`", !!sortProperties); forEach(sortProperties, function(propertyName) { if (result === 0) { result = Ember.compare(get(item1, propertyName), get(item2, propertyName)); if ((result !== 0) && !sortAscending) { result = (-1) * result; } } }); return result; }, destroy: function() { var content = get(this, 'content'), sortProperties = get(this, 'sortProperties'); if (content && sortProperties) { forEach(content, function(item) { forEach(sortProperties, function(sortProperty) { Ember.removeObserver(item, sortProperty, this, 'contentItemSortPropertyDidChange'); }, this); }, this); } return this._super(); }, isSorted: Ember.computed('sortProperties', function() { return !!get(this, 'sortProperties'); }), arrangedContent: Ember.computed('content', 'sortProperties.@each', function(key, value) { var content = get(this, 'content'), isSorted = get(this, 'isSorted'), sortProperties = get(this, 'sortProperties'), self = this; if (content && isSorted) { content = content.slice(); content.sort(function(item1, item2) { return self.orderBy(item1, item2); }); forEach(content, function(item) { forEach(sortProperties, function(sortProperty) { Ember.addObserver(item, sortProperty, this, 'contentItemSortPropertyDidChange'); }, this); }, this); return Ember.A(content); } return content; }), _contentWillChange: Ember.beforeObserver(function() { var content = get(this, 'content'), sortProperties = get(this, 'sortProperties'); if (content && sortProperties) { forEach(content, function(item) { forEach(sortProperties, function(sortProperty) { Ember.removeObserver(item, sortProperty, this, 'contentItemSortPropertyDidChange'); }, this); }, this); } this._super(); }, 'content'), sortAscendingWillChange: Ember.beforeObserver(function() { this._lastSortAscending = get(this, 'sortAscending'); }, 'sortAscending'), sortAscendingDidChange: Ember.observer(function() { if (get(this, 'sortAscending') !== this._lastSortAscending) { var arrangedContent = get(this, 'arrangedContent'); arrangedContent.reverseObjects(); } }, 'sortAscending'), contentArrayWillChange: function(array, idx, removedCount, addedCount) { var isSorted = get(this, 'isSorted'); if (isSorted) { var arrangedContent = get(this, 'arrangedContent'); var removedObjects = array.slice(idx, idx+removedCount); var sortProperties = get(this, 'sortProperties'); forEach(removedObjects, function(item) { arrangedContent.removeObject(item); forEach(sortProperties, function(sortProperty) { Ember.removeObserver(item, sortProperty, this, 'contentItemSortPropertyDidChange'); }, this); }); } return this._super(array, idx, removedCount, addedCount); }, contentArrayDidChange: function(array, idx, removedCount, addedCount) { var isSorted = get(this, 'isSorted'), sortProperties = get(this, 'sortProperties'); if (isSorted) { var addedObjects = array.slice(idx, idx+addedCount); var arrangedContent = get(this, 'arrangedContent'); forEach(addedObjects, function(item) { this.insertItemSorted(item); forEach(sortProperties, function(sortProperty) { Ember.addObserver(item, sortProperty, this, 'contentItemSortPropertyDidChange'); }, this); }, this); } return this._super(array, idx, removedCount, addedCount); }, insertItemSorted: function(item) { var arrangedContent = get(this, 'arrangedContent'); var length = get(arrangedContent, 'length'); var idx = this._binarySearch(item, 0, length); arrangedContent.insertAt(idx, item); }, contentItemSortPropertyDidChange: function(item) { var arrangedContent = get(this, 'arrangedContent'), oldIndex = arrangedContent.indexOf(item), newIndex = this._binarySearch(item, 0, get(arrangedContent, 'length')); if (newIndex !== oldIndex) { arrangedContent.removeObject(item); this.insertItemSorted(item); } }, _binarySearch: function(item, low, high) { var mid, midItem, res, arrangedContent; if (low === high) { return low; } arrangedContent = get(this, 'arrangedContent'); mid = low + Math.floor((high - low) / 2); midItem = arrangedContent.objectAt(mid); res = this.orderBy(midItem, item); if (res < 0) { return this._binarySearch(item, mid+1, high); } else if (res > 0) { return this._binarySearch(item, low, mid); } return mid; } }); })(); (function() { /** @module ember @submodule ember-runtime */ var get = Ember.get, set = Ember.set; /** Ember.ArrayController provides a way for you to publish a collection of objects so that you can easily bind to the collection from a Handlebars #each helper, an Ember.CollectionView, or other controllers. The advantage of using an ArrayController is that you only have to set up your view bindings once; to change what's displayed, simply swap out the `content` property on the controller. For example, imagine you wanted to display a list of items fetched via an XHR request. Create an Ember.ArrayController and set its `content` property: ``` javascript MyApp.listController = Ember.ArrayController.create(); $.get('people.json', function(data) { MyApp.listController.set('content', data); }); ``` Then, create a view that binds to your new controller: ``` handlebars {{#each MyApp.listController}} {{firstName}} {{lastName}} {{/each}} ``` Although you are binding to the controller, the behavior of this controller is to pass through any methods or properties to the underlying array. This capability comes from `Ember.ArrayProxy`, which this class inherits from. Note: As of this writing, `ArrayController` does not add any functionality to its superclass, `ArrayProxy`. The Ember team plans to add additional controller-specific functionality in the future, e.g. single or multiple selection support. If you are creating something that is conceptually a controller, use this class. @class ArrayController @namespace Ember @extends Ember.ArrayProxy @uses Ember.SortableMixin @uses Ember.ControllerMixin */ Ember.ArrayController = Ember.ArrayProxy.extend(Ember.ControllerMixin, Ember.SortableMixin); })(); (function() { /** @module ember @submodule ember-runtime */ /** Ember.ObjectController is part of Ember's Controller layer. A single shared instance of each Ember.ObjectController subclass in your application's namespace will be created at application initialization and be stored on your application's Ember.Router instance. Ember.ObjectController derives its functionality from its superclass Ember.ObjectProxy and the Ember.ControllerMixin mixin. @class ObjectController @namespace Ember @extends Ember.ObjectProxy @uses Ember.ControllerMixin **/ Ember.ObjectController = Ember.ObjectProxy.extend(Ember.ControllerMixin); })(); (function() { })(); (function() { /** Ember Runtime @module ember @submodule ember-runtime @requires ember-metal */ })(); (function() { function visit(vertex, fn, visited, path) { var name = vertex.name, vertices = vertex.incoming, names = vertex.incomingNames, len = names.length, i; if (!visited) { visited = {}; } if (!path) { path = []; } if (visited.hasOwnProperty(name)) { return; } path.push(name); visited[name] = true; for (i = 0; i < len; i++) { visit(vertices[names[i]], fn, visited, path); } fn(vertex, path); path.pop(); } function DAG() { this.names = []; this.vertices = {}; } DAG.prototype.add = function(name) { if (!name) { return; } if (this.vertices.hasOwnProperty(name)) { return this.vertices[name]; } var vertex = { name: name, incoming: {}, incomingNames: [], hasOutgoing: false, value: null }; this.vertices[name] = vertex; this.names.push(name); return vertex; }; DAG.prototype.map = function(name, value) { this.add(name).value = value; }; DAG.prototype.addEdge = function(fromName, toName) { if (!fromName || !toName || fromName === toName) { return; } var from = this.add(fromName), to = this.add(toName); if (to.incoming.hasOwnProperty(fromName)) { return; } function checkCycle(vertex, path) { if (vertex.name === toName) { throw new Error("cycle detected: " + toName + " <- " + path.join(" <- ")); } } visit(from, checkCycle); from.hasOutgoing = true; to.incoming[fromName] = from; to.incomingNames.push(fromName); }; DAG.prototype.topsort = function(fn) { var visited = {}, vertices = this.vertices, names = this.names, len = names.length, i, vertex; for (i = 0; i < len; i++) { vertex = vertices[names[i]]; if (!vertex.hasOutgoing) { visit(vertex, fn, visited); } } }; DAG.prototype.addEdges = function(name, value, before, after) { var i; this.map(name, value); if (before) { if (typeof before === 'string') { this.addEdge(name, before); } else { for (i = 0; i < before.length; i++) { this.addEdge(name, before[i]); } } } if (after) { if (typeof after === 'string') { this.addEdge(after, name); } else { for (i = 0; i < after.length; i++) { this.addEdge(after[i], name); } } } }; Ember.DAG = DAG; })(); (function() { /** @module ember @submodule ember-application */ var get = Ember.get, set = Ember.set; /** An instance of `Ember.Application` is the starting point for every Ember.js application. It helps to instantiate, initialize and coordinate the many objects that make up your app. Each Ember.js app has one and only one `Ember.Application` object. In fact, the very first thing you should do in your application is create the instance: ```javascript window.App = Ember.Application.create(); ``` Typically, the application object is the only global variable. All other classes in your app should be properties on the `Ember.Application` instance, which highlights its first role: a global namespace. For example, if you define a view class, it might look like this: ```javascript App.MyView = Ember.View.extend(); ``` After all of your classes are defined, call `App.initialize()` to start the application. Because `Ember.Application` inherits from `Ember.Namespace`, any classes you create will have useful string representations when calling `toString()`; see the `Ember.Namespace` documentation for more information. While you can think of your `Ember.Application` as a container that holds the other classes in your application, there are several other responsibilities going on under-the-hood that you may want to understand. ### Event Delegation Ember.js uses a technique called _event delegation_. This allows the framework to set up a global, shared event listener instead of requiring each view to do it manually. For example, instead of each view registering its own `mousedown` listener on its associated element, Ember.js sets up a `mousedown` listener on the `body`. If a `mousedown` event occurs, Ember.js will look at the target of the event and start walking up the DOM node tree, finding corresponding views and invoking their `mouseDown` method as it goes. `Ember.Application` has a number of default events that it listens for, as well as a mapping from lowercase events to camel-cased view method names. For example, the `keypress` event causes the `keyPress` method on the view to be called, the `dblclick` event causes `doubleClick` to be called, and so on. If there is a browser event that Ember.js does not listen for by default, you can specify custom events and their corresponding view method names by setting the application's `customEvents` property: ```javascript App = Ember.Application.create({ customEvents: { // add support for the loadedmetadata media // player event 'loadedmetadata': "loadedMetadata" } }); ``` By default, the application sets up these event listeners on the document body. However, in cases where you are embedding an Ember.js application inside an existing page, you may want it to set up the listeners on an element inside the body. For example, if only events inside a DOM element with the ID of `ember-app` should be delegated, set your application's `rootElement` property: ```javascript window.App = Ember.Application.create({ rootElement: '#ember-app' }); ``` The `rootElement` can be either a DOM element or a jQuery-compatible selector string. Note that *views appended to the DOM outside the root element will not receive events.* If you specify a custom root element, make sure you only append views inside it! To learn more about the advantages of event delegation and the Ember.js view layer, and a list of the event listeners that are setup by default, visit the [Ember.js View Layer guide](http://emberjs.com/guides/view_layer#toc_event-delegation). ### Dependency Injection One thing you may have noticed while using Ember.js is that you define *classes*, not *instances*. When your application loads, all of the instances are created for you. Creating these instances is the responsibility of `Ember.Application`. When the `Ember.Application` initializes, it will look for an `Ember.Router` class defined on the applications's `Router` property, like this: ```javascript App.Router = Ember.Router.extend({ // ... }); ``` If found, the router is instantiated and saved on the application's `router` property (note the lowercase 'r'). While you should *not* reference this router instance directly from your application code, having access to `App.router` from the console can be useful during debugging. After the router is created, the application loops through all of the registered _injections_ and invokes them once for each property on the `Ember.Application` object. An injection is a function that is responsible for instantiating objects from classes defined on the application. By default, the only injection registered instantiates controllers and makes them available on the router. For example, if you define a controller class: ```javascript App.MyController = Ember.Controller.extend({ // ... }); ``` Your router will receive an instance of `App.MyController` saved on its `myController` property. Libraries on top of Ember.js can register additional injections. For example, if your application is using Ember Data, it registers an injection that instantiates `DS.Store`: ```javascript Ember.Application.registerInjection({ name: 'store', before: 'controllers', injection: function(app, router, property) { if (property === 'Store') { set(router, 'store', app[property].create()); } } }); ``` ### Routing In addition to creating your application's router, `Ember.Application` is also responsible for telling the router when to start routing. By default, the router will begin trying to translate the current URL into application state once the browser emits the `DOMContentReady` event. If you need to defer routing, you can call the application's `deferReadiness()` method. Once routing can begin, call the `advanceReadiness()` method. If there is any setup required before routing begins, you can implement a `ready()` method on your app that will be invoked immediately before routing begins: ```javascript window.App = Ember.Application.create({ ready: function() { this.set('router.enableLogging', true); } }); To begin routing, you must have at a minimum a top-level controller and view. You define these as `App.ApplicationController` and `App.ApplicationView`, respectively. Your application will not work if you do not define these two mandatory classes. For example: ```javascript App.ApplicationView = Ember.View.extend({ templateName: 'application' }); App.ApplicationController = Ember.Controller.extend(); ``` @class Application @namespace Ember @extends Ember.Namespace */ Ember.Application = Ember.Namespace.extend( /** @scope Ember.Application.prototype */{ /** The root DOM element of the Application. This can be specified as an element or a [jQuery-compatible selector string](http://api.jquery.com/category/selectors/). This is the element that will be passed to the Application's, `eventDispatcher`, which sets up the listeners for event delegation. Every view in your application should be a child of the element you specify here. @property rootElement @type DOMElement @default 'body' */ rootElement: 'body', /** The `Ember.EventDispatcher` responsible for delegating events to this application's views. The event dispatcher is created by the application at initialization time and sets up event listeners on the DOM element described by the application's `rootElement` property. See the documentation for `Ember.EventDispatcher` for more information. @property eventDispatcher @type Ember.EventDispatcher @default null */ eventDispatcher: null, /** The DOM events for which the event dispatcher should listen. By default, the application's `Ember.EventDispatcher` listens for a set of standard DOM events, such as `mousedown` and `keyup`, and delegates them to your application's `Ember.View` instances. If you would like additional events to be delegated to your views, set your `Ember.Application`'s `customEvents` property to a hash containing the DOM event name as the key and the corresponding view method name as the value. For example: App = Ember.Application.create({ customEvents: { // add support for the loadedmetadata media // player event 'loadedmetadata': "loadedMetadata" } }); @property customEvents @type Object @default null */ customEvents: null, autoinit: !Ember.testing, isInitialized: false, init: function() { if (!this.$) { this.$ = Ember.$; } this._super(); this.createEventDispatcher(); // Start off the number of deferrals at 1. This will be // decremented by the Application's own `initialize` method. this._readinessDeferrals = 1; this.waitForDOMContentLoaded(); if (this.autoinit) { var self = this; this.$().ready(function() { if (self.isDestroyed || self.isInitialized) return; self.initialize(); }); } }, /** @private */ createEventDispatcher: function() { var rootElement = get(this, 'rootElement'), eventDispatcher = Ember.EventDispatcher.create({ rootElement: rootElement }); set(this, 'eventDispatcher', eventDispatcher); }, waitForDOMContentLoaded: function() { this.deferReadiness(); var self = this; this.$().ready(function() { self.advanceReadiness(); }); }, deferReadiness: function() { Ember.assert("You cannot defer readiness since the `ready()` hook has already been called.", this._readinessDeferrals > 0); this._readinessDeferrals++; }, advanceReadiness: function() { this._readinessDeferrals--; if (this._readinessDeferrals === 0) { Ember.run.once(this, this.didBecomeReady); } }, /** Instantiate all controllers currently available on the namespace and inject them onto a router. Example: App.PostsController = Ember.ArrayController.extend(); App.CommentsController = Ember.ArrayController.extend(); var router = Ember.Router.create({ ... }); App.initialize(router); router.get('postsController') // router.get('commentsController') // @method initialize @param router {Ember.Router} */ initialize: function(router) { Ember.assert("Application initialize may only be call once", !this.isInitialized); Ember.assert("Application not destroyed", !this.isDestroyed); router = this.setupRouter(router); this.runInjections(router); Ember.runLoadHooks('application', this); this.isInitialized = true; // At this point, any injections or load hooks that would have wanted // to defer readiness have fired. this.advanceReadiness(); return this; }, /** @private */ runInjections: function(router) { var injections = get(this.constructor, 'injections'), graph = new Ember.DAG(), namespace = this, properties, i, injection; for (i=0; i'; } var childBuffers = this.childBuffers; Ember.ArrayPolyfills.forEach.call(childBuffers, function(buffer) { var stringy = typeof buffer === 'string'; content += (stringy ? buffer : buffer.string()); }); if (tag) { return openTag + content + ""; } else { return content; } }, _escapeAttribute: function(value) { // Stolen shamelessly from Handlebars var escape = { "<": "<", ">": ">", '"': """, "'": "'", "`": "`" }; var badChars = /&(?!\w+;)|[<>"'`]/g; var possible = /[&<>"'`]/; var escapeChar = function(chr) { return escape[chr] || "&"; }; var string = value.toString(); if(!possible.test(string)) { return string; } return string.replace(badChars, escapeChar); } }; })(); (function() { /** @module ember @submodule ember-views */ var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt; /** Ember.EventDispatcher handles delegating browser events to their corresponding Ember.Views. For example, when you click on a view, Ember.EventDispatcher ensures that that view's `mouseDown` method gets called. @class EventDispatcher @namespace Ember @private @extends Ember.Object */ Ember.EventDispatcher = Ember.Object.extend( /** @scope Ember.EventDispatcher.prototype */{ /** @private The root DOM element to which event listeners should be attached. Event listeners will be attached to the document unless this is overridden. Can be specified as a DOMElement or a selector string. The default body is a string since this may be evaluated before document.body exists in the DOM. @property rootElement @type DOMElement @default 'body' */ rootElement: 'body', /** @private Sets up event listeners for standard browser events. This will be called after the browser sends a DOMContentReady event. By default, it will set up all of the listeners on the document body. If you would like to register the listeners on a different element, set the event dispatcher's `root` property. @method setup @param addedEvents {Hash} */ setup: function(addedEvents) { var event, events = { touchstart : 'touchStart', touchmove : 'touchMove', touchend : 'touchEnd', touchcancel : 'touchCancel', keydown : 'keyDown', keyup : 'keyUp', keypress : 'keyPress', mousedown : 'mouseDown', mouseup : 'mouseUp', contextmenu : 'contextMenu', click : 'click', dblclick : 'doubleClick', mousemove : 'mouseMove', focusin : 'focusIn', focusout : 'focusOut', mouseenter : 'mouseEnter', mouseleave : 'mouseLeave', submit : 'submit', input : 'input', change : 'change', dragstart : 'dragStart', drag : 'drag', dragenter : 'dragEnter', dragleave : 'dragLeave', dragover : 'dragOver', drop : 'drop', dragend : 'dragEnd' }; Ember.$.extend(events, addedEvents || {}); var rootElement = Ember.$(get(this, 'rootElement')); Ember.assert(fmt('You cannot use the same root element (%@) multiple times in an Ember.Application', [rootElement.selector || rootElement[0].tagName]), !rootElement.is('.ember-application')); Ember.assert('You cannot make a new Ember.Application using a root element that is a descendent of an existing Ember.Application', !rootElement.closest('.ember-application').length); Ember.assert('You cannot make a new Ember.Application using a root element that is an ancestor of an existing Ember.Application', !rootElement.find('.ember-application').length); rootElement.addClass('ember-application'); Ember.assert('Unable to add "ember-application" class to rootElement. Make sure you set rootElement to the body or an element in the body.', rootElement.is('.ember-application')); for (event in events) { if (events.hasOwnProperty(event)) { this.setupHandler(rootElement, event, events[event]); } } }, /** @private Registers an event listener on the document. If the given event is triggered, the provided event handler will be triggered on the target view. If the target view does not implement the event handler, or if the handler returns false, the parent view will be called. The event will continue to bubble to each successive parent view until it reaches the top. For example, to have the `mouseDown` method called on the target view when a `mousedown` event is received from the browser, do the following: setupHandler('mousedown', 'mouseDown'); @method setupHandler @param {Element} rootElement @param {String} event the browser-originated event to listen to @param {String} eventName the name of the method to call on the view */ setupHandler: function(rootElement, event, eventName) { var self = this; rootElement.delegate('.ember-view', event + '.ember', function(evt, triggeringManager) { return Ember.handleErrors(function() { var view = Ember.View.views[this.id], result = true, manager = null; manager = self._findNearestEventManager(view,eventName); if (manager && manager !== triggeringManager) { result = self._dispatchEvent(manager, evt, eventName, view); } else if (view) { result = self._bubbleEvent(view,evt,eventName); } else { evt.stopPropagation(); } return result; }, this); }); rootElement.delegate('[data-ember-action]', event + '.ember', function(evt) { return Ember.handleErrors(function() { var actionId = Ember.$(evt.currentTarget).attr('data-ember-action'), action = Ember.Handlebars.ActionHelper.registeredActions[actionId], handler = action.handler; if (action.eventName === eventName) { return handler(evt); } }, this); }); }, _findNearestEventManager: function(view, eventName) { var manager = null; while (view) { manager = get(view, 'eventManager'); if (manager && manager[eventName]) { break; } view = get(view, 'parentView'); } return manager; }, _dispatchEvent: function(object, evt, eventName, view) { var result = true; var handler = object[eventName]; if (Ember.typeOf(handler) === 'function') { result = handler.call(object, evt, view); // Do not preventDefault in eventManagers. evt.stopPropagation(); } else { result = this._bubbleEvent(view, evt, eventName); } return result; }, _bubbleEvent: function(view, evt, eventName) { return Ember.run(function() { return view.handleEvent(eventName, evt); }); }, destroy: function() { var rootElement = get(this, 'rootElement'); Ember.$(rootElement).undelegate('.ember').removeClass('ember-application'); return this._super(); } }); })(); (function() { /** @module ember @submodule ember-views */ // Add a new named queue for rendering views that happens // after bindings have synced. var queues = Ember.run.queues; queues.splice(Ember.$.inArray('actions', queues)+1, 0, 'render'); })(); (function() { /** @module ember @submodule ember-views */ var get = Ember.get, set = Ember.set; // Original class declaration and documentation in runtime/lib/controllers/controller.js // NOTE: It may be possible with YUIDoc to combine docs in two locations /** Additional methods for the ControllerMixin @class ControllerMixin @namespace Ember */ Ember.ControllerMixin.reopen({ target: null, controllers: null, namespace: null, view: null, /** `connectOutlet` creates a new instance of a provided view class, wires it up to its associated controller, and assigns the new view to a property on the current controller. The purpose of this method is to enable views that use outlets to quickly assign new views for a given outlet. For example, an application view's template may look like this: ``` handlebars

My Blog

{{outlet}} ``` The view for this outlet is specified by assigning a `view` property to the application's controller. The following code will assign a new `App.PostsView` to that outlet: ``` javascript applicationController.connectOutlet('posts'); ``` In general, you will also want to assign a controller to the newly created view. By convention, a controller named `postsController` will be assigned as the view's controller. In an application initialized using `app.initialize(router)`, `connectOutlet` will look for `postsController` on the router. The initialization process will automatically create an instance of `App.PostsController` called `postsController`, so you don't need to do anything beyond `connectOutlet` to assign your view and wire it up to its associated controller. You can supply a `content` for the controller by supplying a final argument after the view class: ``` javascript applicationController.connectOutlet('posts', App.Post.find()); ``` You can specify a particular outlet to use. For example, if your main template looks like: ``` handlebars

My Blog

{{outlet masterView}} {{outlet detailView}} ``` You can assign an `App.PostsView` to the masterView outlet: ``` javascript applicationController.connectOutlet({ outletName: 'masterView', name: 'posts', context: App.Post.find() }); ``` You can write this as: ``` javascript applicationController.connectOutlet('masterView', 'posts', App.Post.find()); ``` @method connectOutlet @param {String} outletName a name for the outlet to set @param {String} name a view/controller pair name @param {Object} context a context object to assign to the controller's `content` property, if a controller can be found (optional) */ connectOutlet: function(name, context) { // Normalize arguments. Supported arguments: // // name // name, context // outletName, name // outletName, name, context // options // // The options hash has the following keys: // // name: the name of the controller and view // to use. If this is passed, the name // determines the view and controller. // outletName: the name of the outlet to // fill in. default: 'view' // viewClass: the class of the view to instantiate // controller: the controller instance to pass // to the view // context: an object that should become the // controller's `content` and thus the // template's context. var outletName, viewClass, view, controller, options; if (Ember.typeOf(context) === 'string') { outletName = name; name = context; context = arguments[2]; } if (arguments.length === 1) { if (Ember.typeOf(name) === 'object') { options = name; outletName = options.outletName; name = options.name; viewClass = options.viewClass; controller = options.controller; context = options.context; } } else { options = {}; } outletName = outletName || 'view'; Ember.assert("The viewClass is either missing or the one provided did not resolve to a view", !!name || (!name && !!viewClass)); Ember.assert("You must supply a name or a viewClass to connectOutlet, but not both", (!!name && !viewClass && !controller) || (!name && !!viewClass)); if (name) { var namespace = get(this, 'namespace'), controllers = get(this, 'controllers'); var viewClassName = name.charAt(0).toUpperCase() + name.substr(1) + "View"; viewClass = get(namespace, viewClassName); controller = get(controllers, name + 'Controller'); Ember.assert("The name you supplied " + name + " did not resolve to a view " + viewClassName, !!viewClass); Ember.assert("The name you supplied " + name + " did not resolve to a controller " + name + 'Controller', (!!controller && !!context) || !context); } if (controller && context) { set(controller, 'content', context); } view = this.createOutletView(outletName, viewClass); if (controller) { set(view, 'controller', controller); } set(this, outletName, view); return view; }, /** Convenience method to connect controllers. This method makes other controllers available on the controller the method was invoked on. For example, to make the `personController` and the `postController` available on the `overviewController`, you would call: overviewController.connectControllers('person', 'post'); @method connectControllers @param {String...} controllerNames the controllers to make available */ connectControllers: function() { var controllers = get(this, 'controllers'), controllerNames = Array.prototype.slice.apply(arguments), controllerName; for (var i=0, l=controllerNames.length; i ``` ## HTML `class` Attribute The HTML `class` attribute of a view's tag can be set by providing a `classNames` property that is set to an array of strings: ``` javascript MyView = Ember.View.extend({ classNames: ['my-class', 'my-other-class'] }); ``` Will result in view instances with an HTML representation of: ``` html
``` `class` attribute values can also be set by providing a `classNameBindings` property set to an array of properties names for the view. The return value of these properties will be added as part of the value for the view's `class` attribute. These properties can be computed properties: ``` javascript MyView = Ember.View.extend({ classNameBindings: ['propertyA', 'propertyB'], propertyA: 'from-a', propertyB: function(){ if(someLogic){ return 'from-b'; } }.property() }); ``` Will result in view instances with an HTML representation of: ``` html
``` If the value of a class name binding returns a boolean the property name itself will be used as the class name if the property is true. The class name will not be added if the value is `false` or `undefined`. ``` javascript MyView = Ember.View.extend({ classNameBindings: ['hovered'], hovered: true }); ``` Will result in view instances with an HTML representation of: ``` html
``` When using boolean class name bindings you can supply a string value other than the property name for use as the `class` HTML attribute by appending the preferred value after a ":" character when defining the binding: ``` javascript MyView = Ember.View.extend({ classNameBindings: ['awesome:so-very-cool'], awesome: true }); ``` Will result in view instances with an HTML representation of: ``` html
``` Boolean value class name bindings whose property names are in a camelCase-style format will be converted to a dasherized format: ``` javascript MyView = Ember.View.extend({ classNameBindings: ['isUrgent'], isUrgent: true }); ``` Will result in view instances with an HTML representation of: ``` html
``` Class name bindings can also refer to object values that are found by traversing a path relative to the view itself: ``` javascript MyView = Ember.View.extend({ classNameBindings: ['messages.empty'] messages: Ember.Object.create({ empty: true }) }); ``` Will result in view instances with an HTML representation of: ``` html
``` If you want to add a class name for a property which evaluates to true and and a different class name if it evaluates to false, you can pass a binding like this: ``` // Applies 'enabled' class when isEnabled is true and 'disabled' when isEnabled is false Ember.View.create({ classNameBindings: ['isEnabled:enabled:disabled'] isEnabled: true }); ``` Will result in view instances with an HTML representation of: ``` html
``` When isEnabled is `false`, the resulting HTML reprensentation looks like this: ``` html
``` This syntax offers the convenience to add a class if a property is `false`: ``` javascript // Applies no class when isEnabled is true and class 'disabled' when isEnabled is false Ember.View.create({ classNameBindings: ['isEnabled::disabled'] isEnabled: true }); ``` Will result in view instances with an HTML representation of: ``` html
``` When the `isEnabled` property on the view is set to `false`, it will result in view instances with an HTML representation of: ``` html
``` Updates to the the value of a class name binding will result in automatic update of the HTML `class` attribute in the view's rendered HTML representation. If the value becomes `false` or `undefined` the class name will be removed. Both `classNames` and `classNameBindings` are concatenated properties. See `Ember.Object` documentation for more information about concatenated properties. ## HTML Attributes The HTML attribute section of a view's tag can be set by providing an `attributeBindings` property set to an array of property names on the view. The return value of these properties will be used as the value of the view's HTML associated attribute: ``` javascript AnchorView = Ember.View.extend({ tagName: 'a', attributeBindings: ['href'], href: 'http://google.com' }); ``` Will result in view instances with an HTML representation of: ``` html ``` If the return value of an `attributeBindings` monitored property is a boolean the property will follow HTML's pattern of repeating the attribute's name as its value: ``` javascript MyTextInput = Ember.View.extend({ tagName: 'input', attributeBindings: ['disabled'], disabled: true }); ``` Will result in view instances with an HTML representation of: ``` html ``` `attributeBindings` can refer to computed properties: ``` javascript MyTextInput = Ember.View.extend({ tagName: 'input', attributeBindings: ['disabled'], disabled: function(){ if (someLogic) { return true; } else { return false; } }.property() }); ``` Updates to the the property of an attribute binding will result in automatic update of the HTML attribute in the view's rendered HTML representation. `attributeBindings` is a concatenated property. See `Ember.Object` documentation for more information about concatenated properties. ## Templates The HTML contents of a view's rendered representation are determined by its template. Templates can be any function that accepts an optional context parameter and returns a string of HTML that will be inserted within the view's tag. Most typically in Ember this function will be a compiled Ember.Handlebars template. ``` javascript AView = Ember.View.extend({ template: Ember.Handlebars.compile('I am the template') }); ``` Will result in view instances with an HTML representation of: ``` html
I am the template
``` The default context of the compiled template will be the view instance itself: ``` javascript AView = Ember.View.extend({ template: Ember.Handlebars.compile('Hello {{excitedGreeting}}') }); aView = AView.create({ content: Ember.Object.create({ firstName: 'Barry' }) excitedGreeting: function(){ return this.get("content.firstName") + "!!!" } }); ``` Will result in an HTML representation of: ``` html
Hello Barry!!!
``` Within an Ember application is more common to define a Handlebars templates as part of a page: ``` handlebars ``` And associate it by name using a view's `templateName` property: ``` javascript AView = Ember.View.extend({ templateName: 'some-template' }); ``` Using a value for `templateName` that does not have a Handlebars template with a matching `data-template-name` attribute will throw an error. Assigning a value to both `template` and `templateName` properties will throw an error. For views classes that may have a template later defined (e.g. as the block portion of a `{{view}}` Handlebars helper call in another template or in a subclass), you can provide a `defaultTemplate` property set to compiled template function. If a template is not later provided for the view instance the `defaultTemplate` value will be used: ``` javascript AView = Ember.View.extend({ defaultTemplate: Ember.Handlebars.compile('I was the default'), template: null, templateName: null }); ``` Will result in instances with an HTML representation of: ``` html
I was the default
``` If a `template` or `templateName` is provided it will take precedence over `defaultTemplate`: ``` javascript AView = Ember.View.extend({ defaultTemplate: Ember.Handlebars.compile('I was the default') }); aView = AView.create({ template: Ember.Handlebars.compile('I was the template, not default') }); ``` Will result in the following HTML representation when rendered: ``` html
I was the template, not default
``` ## Layouts Views can have a secondary template that wraps their main template. Like primary templates, layouts can be any function that accepts an optional context parameter and returns a string of HTML that will be inserted inside view's tag. Views whose HTML element is self closing (e.g. ``) cannot have a layout and this property will be ignored. Most typically in Ember a layout will be a compiled Ember.Handlebars template. A view's layout can be set directly with the `layout` property or reference an existing Handlebars template by name with the `layoutName` property. A template used as a layout must contain a single use of the Handlebars `{{yield}}` helper. The HTML contents of a view's rendered `template` will be inserted at this location: ``` javascript AViewWithLayout = Ember.View.extend({ layout: Ember.Handlebars.compile("
{{yield}}
") template: Ember.Handlebars.compile("I got wrapped"), }); ``` Will result in view instances with an HTML representation of: ``` html
I got wrapped
``` See `Handlebars.helpers.yield` for more information. ## Responding to Browser Events Views can respond to user-initiated events in one of three ways: method implementation, through an event manager, and through `{{action}}` helper use in their template or layout. ### Method Implementation Views can respond to user-initiated events by implementing a method that matches the event name. A `jQuery.Event` object will be passed as the argument to this method. ``` javascript AView = Ember.View.extend({ click: function(event){ // will be called when when an instance's // rendered element is clicked } }); ``` ### Event Managers Views can define an object as their `eventManager` property. This object can then implement methods that match the desired event names. Matching events that occur on the view's rendered HTML or the rendered HTML of any of its DOM descendants will trigger this method. A `jQuery.Event` object will be passed as the first argument to the method and an `Ember.View` object as the second. The `Ember.View` will be the view whose rendered HTML was interacted with. This may be the view with the `eventManager` property or one of its descendent views. ``` javascript AView = Ember.View.extend({ eventManager: Ember.Object.create({ doubleClick: function(event, view){ // will be called when when an instance's // rendered element or any rendering // of this views's descendent // elements is clicked } }) }); ``` An event defined for an event manager takes precedence over events of the same name handled through methods on the view. ``` javascript AView = Ember.View.extend({ mouseEnter: function(event){ // will never trigger. }, eventManager: Ember.Object.create({ mouseEnter: function(event, view){ // takes presedence over AView#mouseEnter } }) }); ``` Similarly a view's event manager will take precedence for events of any views rendered as a descendent. A method name that matches an event name will not be called if the view instance was rendered inside the HTML representation of a view that has an `eventManager` property defined that handles events of the name. Events not handled by the event manager will still trigger method calls on the descendent. ``` javascript OuterView = Ember.View.extend({ template: Ember.Handlebars.compile("outer {{#view InnerView}}inner{{/view}} outer"), eventManager: Ember.Object.create({ mouseEnter: function(event, view){ // view might be instance of either // OutsideView or InnerView depending on // where on the page the user interaction occured } }) }); InnerView = Ember.View.extend({ click: function(event){ // will be called if rendered inside // an OuterView because OuterView's // eventManager doesn't handle click events }, mouseEnter: function(event){ // will never be called if rendered inside // an OuterView. } }); ``` ### Handlebars `{{action}}` Helper See `Handlebars.helpers.action`. ### Event Names Possible events names for any of the responding approaches described above are: Touch events: 'touchStart', 'touchMove', 'touchEnd', 'touchCancel' Keyboard events: 'keyDown', 'keyUp', 'keyPress' Mouse events: 'mouseDown', 'mouseUp', 'contextMenu', 'click', 'doubleClick', 'mouseMove', 'focusIn', 'focusOut', 'mouseEnter', 'mouseLeave' Form events: 'submit', 'change', 'focusIn', 'focusOut', 'input' HTML5 drag and drop events: 'dragStart', 'drag', 'dragEnter', 'dragLeave', 'drop', 'dragEnd' ## Handlebars `{{view}}` Helper Other `Ember.View` instances can be included as part of a view's template by using the `{{view}}` Handlebars helper. See `Handlebars.helpers.view` for additional information. @class View @namespace Ember @extends Ember.Object @uses Ember.Evented */ Ember.View = Ember.CoreView.extend( /** @scope Ember.View.prototype */ { concatenatedProperties: ['classNames', 'classNameBindings', 'attributeBindings'], /** @property isView @type Boolean @default true @final */ isView: true, // .......................................................... // TEMPLATE SUPPORT // /** The name of the template to lookup if no template is provided. Ember.View will look for a template with this name in this view's `templates` object. By default, this will be a global object shared in `Ember.TEMPLATES`. @property templateName @type String @default null */ templateName: null, /** The name of the layout to lookup if no layout is provided. Ember.View will look for a template with this name in this view's `templates` object. By default, this will be a global object shared in `Ember.TEMPLATES`. @property layoutName @type String @default null */ layoutName: null, /** The hash in which to look for `templateName`. @property templates @type Ember.Object @default Ember.TEMPLATES */ templates: Ember.TEMPLATES, /** The template used to render the view. This should be a function that accepts an optional context parameter and returns a string of HTML that will be inserted into the DOM relative to its parent view. In general, you should set the `templateName` property instead of setting the template yourself. @property template @type Function */ template: Ember.computed(function(key, value) { if (value !== undefined) { return value; } var templateName = get(this, 'templateName'), template = this.templateForName(templateName, 'template'); return template || get(this, 'defaultTemplate'); }).property('templateName'), /** The controller managing this view. If this property is set, it will be made available for use by the template. @property controller @type Object */ controller: Ember.computed(function(key, value) { var parentView; if (arguments.length === 2) { return value; } else { parentView = get(this, 'parentView'); return parentView ? get(parentView, 'controller') : null; } }).property(), /** A view may contain a layout. A layout is a regular template but supersedes the `template` property during rendering. It is the responsibility of the layout template to retrieve the `template` property from the view (or alternatively, call `Handlebars.helpers.yield`, `{{yield}}`) to render it in the correct location. This is useful for a view that has a shared wrapper, but which delegates the rendering of the contents of the wrapper to the `template` property on a subclass. @property layout @type Function */ layout: Ember.computed(function(key, value) { if (arguments.length === 2) { return value; } var layoutName = get(this, 'layoutName'), layout = this.templateForName(layoutName, 'layout'); return layout || get(this, 'defaultLayout'); }).property('layoutName'), templateForName: function(name, type) { if (!name) { return; } var templates = get(this, 'templates'), template = get(templates, name); if (!template) { throw new Ember.Error(fmt('%@ - Unable to find %@ "%@".', [this, type, name])); } return template; }, /** The object from which templates should access properties. This object will be passed to the template function each time the render method is called, but it is up to the individual function to decide what to do with it. By default, this will be the view itself. @property context @type Object */ context: Ember.computed(function(key, value) { if (arguments.length === 2) { set(this, '_context', value); return value; } else { return get(this, '_context'); } }).volatile(), /** @private Private copy of the view's template context. This can be set directly by Handlebars without triggering the observer that causes the view to be re-rendered. The context of a view is looked up as follows: 1. Supplied context (usually by Handlebars) 2. Specified controller 3. `parentView`'s context (for a child of a ContainerView) The code in Handlebars that overrides the `_context` property first checks to see whether the view has a specified controller. This is something of a hack and should be revisited. @property _context */ _context: Ember.computed(function(key, value) { var parentView, controller; if (arguments.length === 2) { return value; } if (controller = get(this, 'controller')) { return controller; } parentView = get(this, '_parentView'); if (parentView) { return get(parentView, '_context'); } return this; }), /** @private If a value that affects template rendering changes, the view should be re-rendered to reflect the new value. @method _displayPropertyDidChange */ _displayPropertyDidChange: Ember.observer(function() { this.rerender(); }, 'context', 'controller'), /** If false, the view will appear hidden in DOM. @property isVisible @type Boolean @default null */ isVisible: true, /** @private Array of child views. You should never edit this array directly. Instead, use appendChild and removeFromParent. @property childViews @type Array @default [] */ childViews: childViewsProperty, _childViews: [], // When it's a virtual view, we need to notify the parent that their // childViews will change. _childViewsWillChange: Ember.beforeObserver(function() { if (this.isVirtual) { var parentView = get(this, 'parentView'); if (parentView) { Ember.propertyWillChange(parentView, 'childViews'); } } }, 'childViews'), // When it's a virtual view, we need to notify the parent that their // childViews did change. _childViewsDidChange: Ember.observer(function() { if (this.isVirtual) { var parentView = get(this, 'parentView'); if (parentView) { Ember.propertyDidChange(parentView, 'childViews'); } } }, 'childViews'), /** Return the nearest ancestor that is an instance of the provided class. @property nearestInstanceOf @param {Class} klass Subclass of Ember.View (or Ember.View itself) @return Ember.View @deprecated */ nearestInstanceOf: function(klass) { Ember.deprecate("nearestInstanceOf is deprecated and will be removed from future releases. Use nearestOfType."); var view = get(this, 'parentView'); while (view) { if(view instanceof klass) { return view; } view = get(view, 'parentView'); } }, /** Return the nearest ancestor that is an instance of the provided class or mixin. @proprty nearestOfType @param {Class,Mixin} klass Subclass of Ember.View (or Ember.View itself), or an instance of Ember.Mixin. @return Ember.View */ nearestOfType: function(klass) { var view = get(this, 'parentView'), isOfType = klass instanceof Ember.Mixin ? function(view) { return klass.detect(view); } : function(view) { return klass.detect(view.constructor); }; while (view) { if( isOfType(view) ) { return view; } view = get(view, 'parentView'); } }, /** Return the nearest ancestor that has a given property. @property nearestWithProperty @param {String} property A property name @return Ember.View */ nearestWithProperty: function(property) { var view = get(this, 'parentView'); while (view) { if (property in view) { return view; } view = get(view, 'parentView'); } }, /** Return the nearest ancestor whose parent is an instance of `klass`. @property nearestChildOf @param {Class} klass Subclass of Ember.View (or Ember.View itself) @return Ember.View */ nearestChildOf: function(klass) { var view = get(this, 'parentView'); while (view) { if(get(view, 'parentView') instanceof klass) { return view; } view = get(view, 'parentView'); } }, /** Return the nearest ancestor that is an Ember.CollectionView @property collectionView @return Ember.CollectionView */ collectionView: Ember.computed(function() { return this.nearestOfType(Ember.CollectionView); }), /** Return the nearest ancestor that is a direct child of an Ember.CollectionView @property itemView @return Ember.View */ itemView: Ember.computed(function() { return this.nearestChildOf(Ember.CollectionView); }), /** Return the nearest ancestor that has the property `content`. @property contentView @return Ember.View */ contentView: Ember.computed(function() { return this.nearestWithProperty('content'); }), /** @private When the parent view changes, recursively invalidate collectionView, itemView, and contentView @method _parentViewDidChange */ _parentViewDidChange: Ember.observer(function() { if (this.isDestroying) { return; } this.invokeRecursively(function(view) { view.propertyDidChange('collectionView'); view.propertyDidChange('itemView'); view.propertyDidChange('contentView'); }); if (get(this, 'parentView.controller') && !get(this, 'controller')) { this.notifyPropertyChange('controller'); } }, '_parentView'), _controllerDidChange: Ember.observer(function() { if (this.isDestroying) { return; } this.forEachChildView(function(view) { view.propertyDidChange('controller'); }); }, 'controller'), cloneKeywords: function() { var templateData = get(this, 'templateData'); var keywords = templateData ? Ember.copy(templateData.keywords) : {}; set(keywords, 'view', get(this, 'concreteView')); set(keywords, 'controller', get(this, 'controller')); return keywords; }, /** Called on your view when it should push strings of HTML into a Ember.RenderBuffer. Most users will want to override the `template` or `templateName` properties instead of this method. By default, Ember.View will look for a function in the `template` property and invoke it with the value of `context`. The value of `context` will be the view's controller unless you override it. @method render @param {Ember.RenderBuffer} buffer The render buffer */ render: function(buffer) { // If this view has a layout, it is the responsibility of the // the layout to render the view's template. Otherwise, render the template // directly. var template = get(this, 'layout') || get(this, 'template'); if (template) { var context = get(this, 'context'); var keywords = this.cloneKeywords(); var data = { view: this, buffer: buffer, isRenderData: true, keywords: keywords }; // Invoke the template with the provided template context, which // is the view by default. A hash of data is also passed that provides // the template with access to the view and render buffer. Ember.assert('template must be a function. Did you mean to call Ember.Handlebars.compile("...") or specify templateName instead?', typeof template === 'function'); // The template should write directly to the render buffer instead // of returning a string. var output = template(context, { data: data }); // If the template returned a string instead of writing to the buffer, // push the string onto the buffer. if (output !== undefined) { buffer.push(output); } } }, invokeForState: function(name) { var stateName = this.state, args, fn; // try to find the function for the state in the cache if (fn = invokeForState[stateName][name]) { args = a_slice.call(arguments); args[0] = this; return fn.apply(this, args); } // otherwise, find and cache the function for this state var parent = this, states = parent.states, state; while (states) { state = states[stateName]; while (state) { fn = state[name]; if (fn) { invokeForState[stateName][name] = fn; args = a_slice.call(arguments, 1); args.unshift(this); return fn.apply(this, args); } state = state.parentState; } states = states.parent; } }, /** Renders the view again. This will work regardless of whether the view is already in the DOM or not. If the view is in the DOM, the rendering process will be deferred to give bindings a chance to synchronize. If children were added during the rendering process using `appendChild`, `rerender` will remove them, because they will be added again if needed by the next `render`. In general, if the display of your view changes, you should modify the DOM element directly instead of manually calling `rerender`, which can be slow. @method rerender */ rerender: function() { return this.invokeForState('rerender'); }, clearRenderedChildren: function() { var lengthBefore = this.lengthBeforeRender, lengthAfter = this.lengthAfterRender; // If there were child views created during the last call to render(), // remove them under the assumption that they will be re-created when // we re-render. // VIEW-TODO: Unit test this path. var childViews = this._childViews; for (var i=lengthAfter-1; i>=lengthBefore; i--) { if (childViews[i]) { childViews[i].destroy(); } } }, /** @private Iterates over the view's `classNameBindings` array, inserts the value of the specified property into the `classNames` array, then creates an observer to update the view's element if the bound property ever changes in the future. @method _applyClassNameBindings */ _applyClassNameBindings: function() { var classBindings = get(this, 'classNameBindings'), classNames = get(this, 'classNames'), elem, newClass, dasherizedClass; if (!classBindings) { return; } // Loop through all of the configured bindings. These will be either // property names ('isUrgent') or property paths relative to the view // ('content.isUrgent') a_forEach(classBindings, function(binding) { // Variable in which the old class value is saved. The observer function // closes over this variable, so it knows which string to remove when // the property changes. var oldClass; // Extract just the property name from bindings like 'foo:bar' var parsedPath = Ember.View._parsePropertyPath(binding); // Set up an observer on the context. If the property changes, toggle the // class name. var observer = function() { // Get the current value of the property newClass = this._classStringForProperty(binding); elem = this.$(); if (!elem) { removeObserver(this, parsedPath.path, observer); return; } // If we had previously added a class to the element, remove it. if (oldClass) { elem.removeClass(oldClass); // Also remove from classNames so that if the view gets rerendered, // the class doesn't get added back to the DOM. classNames.removeObject(oldClass); } // If necessary, add a new class. Make sure we keep track of it so // it can be removed in the future. if (newClass) { elem.addClass(newClass); oldClass = newClass; } else { oldClass = null; } }; // Get the class name for the property at its current value dasherizedClass = this._classStringForProperty(binding); if (dasherizedClass) { // Ensure that it gets into the classNames array // so it is displayed when we render. classNames.push(dasherizedClass); // Save a reference to the class name so we can remove it // if the observer fires. Remember that this variable has // been closed over by the observer. oldClass = dasherizedClass; } addObserver(this, parsedPath.path, observer); this.one('willClearRender', function() { removeObserver(this, parsedPath.path, observer); }); }, this); }, /** @private Iterates through the view's attribute bindings, sets up observers for each, then applies the current value of the attributes to the passed render buffer. @method _applyAttributeBindings @param {Ember.RenderBuffer} buffer */ _applyAttributeBindings: function(buffer) { var attributeBindings = get(this, 'attributeBindings'), attributeValue, elem, type; if (!attributeBindings) { return; } a_forEach(attributeBindings, function(binding) { var split = binding.split(':'), property = split[0], attributeName = split[1] || property; // Create an observer to add/remove/change the attribute if the // JavaScript property changes. var observer = function() { elem = this.$(); if (!elem) { return; } attributeValue = get(this, property); Ember.View.applyAttributeBindings(elem, attributeName, attributeValue); }; addObserver(this, property, observer); this.one('willClearRender', function() { removeObserver(this, property, observer); }); // Determine the current value and add it to the render buffer // if necessary. attributeValue = get(this, property); Ember.View.applyAttributeBindings(buffer, attributeName, attributeValue); }, this); }, /** @private Given a property name, returns a dasherized version of that property name if the property evaluates to a non-falsy value. For example, if the view has property `isUrgent` that evaluates to true, passing `isUrgent` to this method will return `"is-urgent"`. @method _classStringForProperty @param property */ _classStringForProperty: function(property) { var parsedPath = Ember.View._parsePropertyPath(property); var path = parsedPath.path; var val = get(this, path); if (val === undefined && Ember.isGlobalPath(path)) { val = get(Ember.lookup, path); } return Ember.View._classStringForValue(path, val, parsedPath.className, parsedPath.falsyClassName); }, // .......................................................... // ELEMENT SUPPORT // /** Returns the current DOM element for the view. @property element @type DOMElement */ element: Ember.computed(function(key, value) { if (value !== undefined) { return this.invokeForState('setElement', value); } else { return this.invokeForState('getElement'); } }).property('_parentView'), /** Returns a jQuery object for this view's element. If you pass in a selector string, this method will return a jQuery object, using the current element as its buffer. For example, calling `view.$('li')` will return a jQuery object containing all of the `li` elements inside the DOM element of this view. @property $ @param {String} [selector] a jQuery-compatible selector string @return {jQuery} the CoreQuery object for the DOM node */ $: function(sel) { return this.invokeForState('$', sel); }, mutateChildViews: function(callback) { var childViews = this._childViews, idx = childViews.length, view; while(--idx >= 0) { view = childViews[idx]; callback.call(this, view, idx); } return this; }, forEachChildView: function(callback) { var childViews = this._childViews; if (!childViews) { return this; } var len = childViews.length, view, idx; for(idx = 0; idx < len; idx++) { view = childViews[idx]; callback.call(this, view); } return this; }, /** Appends the view's element to the specified parent element. If the view does not have an HTML representation yet, `createElement()` will be called automatically. Note that this method just schedules the view to be appended; the DOM element will not be appended to the given element until all bindings have finished synchronizing. This is not typically a function that you will need to call directly when building your application. You might consider using Ember.ContainerView instead. If you do need to use appendTo, be sure that the target element you are providing is associated with an Ember.Application and does not have an ancestor element that is associated with an Ember view. @method appendTo @param {String|DOMElement|jQuery} A selector, element, HTML string, or jQuery object @return {Ember.View} receiver */ appendTo: function(target) { // Schedule the DOM element to be created and appended to the given // element after bindings have synchronized. this._insertElementLater(function() { Ember.assert("You cannot append to an existing Ember.View. Consider using Ember.ContainerView instead.", !Ember.$(target).is('.ember-view') && !Ember.$(target).parents().is('.ember-view')); this.$().appendTo(target); }); return this; }, /** Replaces the content of the specified parent element with this view's element. If the view does not have an HTML representation yet, `createElement()` will be called automatically. Note that this method just schedules the view to be appended; the DOM element will not be appended to the given element until all bindings have finished synchronizing @method replaceIn @param {String|DOMElement|jQuery} A selector, element, HTML string, or jQuery object @return {Ember.View} received */ replaceIn: function(target) { Ember.assert("You cannot replace an existing Ember.View. Consider using Ember.ContainerView instead.", !Ember.$(target).is('.ember-view') && !Ember.$(target).parents().is('.ember-view')); this._insertElementLater(function() { Ember.$(target).empty(); this.$().appendTo(target); }); return this; }, /** @private Schedules a DOM operation to occur during the next render phase. This ensures that all bindings have finished synchronizing before the view is rendered. To use, pass a function that performs a DOM operation.. Before your function is called, this view and all child views will receive the `willInsertElement` event. After your function is invoked, this view and all of its child views will receive the `didInsertElement` event. view._insertElementLater(function() { this.createElement(); this.$().appendTo('body'); }); @method _insertElementLater @param {Function} fn the function that inserts the element into the DOM */ _insertElementLater: function(fn) { this._scheduledInsert = Ember.run.scheduleOnce('render', this, '_insertElement', fn); }, /** @private */ _insertElement: function (fn) { this._scheduledInsert = null; this.invokeForState('insertElement', fn); }, /** Appends the view's element to the document body. If the view does not have an HTML representation yet, `createElement()` will be called automatically. Note that this method just schedules the view to be appended; the DOM element will not be appended to the document body until all bindings have finished synchronizing. @method append @return {Ember.View} receiver */ append: function() { return this.appendTo(document.body); }, /** Removes the view's element from the element to which it is attached. @method remove @return {Ember.View} receiver */ remove: function() { // What we should really do here is wait until the end of the run loop // to determine if the element has been re-appended to a different // element. // In the interim, we will just re-render if that happens. It is more // important than elements get garbage collected. this.destroyElement(); this.invokeRecursively(function(view) { view.clearRenderedChildren(); }); }, /** The ID to use when trying to locate the element in the DOM. If you do not set the elementId explicitly, then the view's GUID will be used instead. This ID must be set at the time the view is created. @property elementId @type String */ elementId: Ember.computed(function(key, value) { return value !== undefined ? value : Ember.guidFor(this); }), // TODO: Perhaps this should be removed from the production build somehow. _elementIdDidChange: Ember.beforeObserver(function() { throw "Changing a view's elementId after creation is not allowed."; }, 'elementId'), /** Attempts to discover the element in the parent element. The default implementation looks for an element with an ID of elementId (or the view's guid if elementId is null). You can override this method to provide your own form of lookup. For example, if you want to discover your element using a CSS class name instead of an ID. @method findElementInParentElement @param {DOMElement} parentElement The parent's DOM element @return {DOMElement} The discovered element */ findElementInParentElement: function(parentElem) { var id = "#" + get(this, 'elementId'); return Ember.$(id)[0] || Ember.$(id, parentElem)[0]; }, /** Creates a DOM representation of the view and all of its child views by recursively calling the `render()` method. After the element has been created, `didInsertElement` will be called on this view and all of its child views. @method createElement @return {Ember.View} receiver */ createElement: function() { if (get(this, 'element')) { return this; } var buffer = this.renderToBuffer(); set(this, 'element', buffer.element()); return this; }, /** Called when a view is going to insert an element into the DOM. @event willInsertElement */ willInsertElement: Ember.K, /** Called when the element of the view has been inserted into the DOM. Override this function to do any set up that requires an element in the document body. @event didInsertElement */ didInsertElement: Ember.K, /** Called when the view is about to rerender, but before anything has been torn down. This is a good opportunity to tear down any manual observers you have installed based on the DOM state @event willClearRender */ willClearRender: Ember.K, /** @private Run this callback on the current view and recursively on child views. @method invokeRecursively @param fn {Function} */ invokeRecursively: function(fn) { fn.call(this, this); this.forEachChildView(function(view) { view.invokeRecursively(fn); }); }, /** Invalidates the cache for a property on all child views. @method invalidateRecursively */ invalidateRecursively: function(key) { this.forEachChildView(function(view) { view.propertyDidChange(key); }); }, /** @private Invokes the receiver's willInsertElement() method if it exists and then invokes the same on all child views. NOTE: In some cases this was called when the element existed. This no longer works so we let people know. We can remove this warning code later. @method _notifyWillInsertElement */ _notifyWillInsertElement: function() { this.invokeRecursively(function(view) { view.trigger('willInsertElement'); }); }, /** @private Invokes the receiver's didInsertElement() method if it exists and then invokes the same on all child views. @method _notifyDidInsertElement */ _notifyDidInsertElement: function() { this.invokeRecursively(function(view) { view.trigger('didInsertElement'); }); }, /** @private Triggers the `willClearRender` event (which invokes the `willClearRender()` method if it exists) on this view and all child views. @method _notifyWillClearRender */ _notifyWillClearRender: function() { this.invokeRecursively(function(view) { view.trigger('willClearRender'); }); }, /** Destroys any existing element along with the element for any child views as well. If the view does not currently have a element, then this method will do nothing. If you implement willDestroyElement() on your view, then this method will be invoked on your view before your element is destroyed to give you a chance to clean up any event handlers, etc. If you write a willDestroyElement() handler, you can assume that your didInsertElement() handler was called earlier for the same element. Normally you will not call or override this method yourself, but you may want to implement the above callbacks when it is run. @method destroyElement @return {Ember.View} receiver */ destroyElement: function() { return this.invokeForState('destroyElement'); }, /** Called when the element of the view is going to be destroyed. Override this function to do any teardown that requires an element, like removing event listeners. @event willDestroyElement */ willDestroyElement: function() {}, /** @private Triggers the `willDestroyElement` event (which invokes the `willDestroyElement()` method if it exists) on this view and all child views. Before triggering `willDestroyElement`, it first triggers the `willClearRender` event recursively. @method _notifyWillDestroyElement */ _notifyWillDestroyElement: function() { this._notifyWillClearRender(); this.invokeRecursively(function(view) { view.trigger('willDestroyElement'); }); }, _elementWillChange: Ember.beforeObserver(function() { this.forEachChildView(function(view) { Ember.propertyWillChange(view, 'element'); }); }, 'element'), /** @private If this view's element changes, we need to invalidate the caches of our child views so that we do not retain references to DOM elements that are no longer needed. @method _elementDidChange */ _elementDidChange: Ember.observer(function() { this.forEachChildView(function(view) { Ember.propertyDidChange(view, 'element'); }); }, 'element'), /** Called when the parentView property has changed. @event parentViewDidChange */ parentViewDidChange: Ember.K, instrumentName: 'render.view', instrumentDetails: function(hash) { hash.template = get(this, 'templateName'); this._super(hash); }, _renderToBuffer: function(parentBuffer, bufferOperation) { this.lengthBeforeRender = this._childViews.length; var buffer = this._super(parentBuffer, bufferOperation); this.lengthAfterRender = this._childViews.length; return buffer; }, renderToBufferIfNeeded: function () { return this.invokeForState('renderToBufferIfNeeded', this); }, beforeRender: function(buffer) { this.applyAttributesToBuffer(buffer); }, afterRender: Ember.K, applyAttributesToBuffer: function(buffer) { // Creates observers for all registered class name and attribute bindings, // then adds them to the element. this._applyClassNameBindings(); // Pass the render buffer so the method can apply attributes directly. // This isn't needed for class name bindings because they use the // existing classNames infrastructure. this._applyAttributeBindings(buffer); a_forEach(get(this, 'classNames'), function(name){ buffer.addClass(name); }); buffer.id(get(this, 'elementId')); var role = get(this, 'ariaRole'); if (role) { buffer.attr('role', role); } if (get(this, 'isVisible') === false) { buffer.style('display', 'none'); } }, // .......................................................... // STANDARD RENDER PROPERTIES // /** Tag name for the view's outer element. The tag name is only used when an element is first created. If you change the tagName for an element, you must destroy and recreate the view element. By default, the render buffer will use a `
` tag for views. @property tagName @type String @default null */ // We leave this null by default so we can tell the difference between // the default case and a user-specified tag. tagName: null, /** The WAI-ARIA role of the control represented by this view. For example, a button may have a role of type 'button', or a pane may have a role of type 'alertdialog'. This property is used by assistive software to help visually challenged users navigate rich web applications. The full list of valid WAI-ARIA roles is available at: http://www.w3.org/TR/wai-aria/roles#roles_categorization @property ariaRole @type String @default null */ ariaRole: null, /** Standard CSS class names to apply to the view's outer element. This property automatically inherits any class names defined by the view's superclasses as well. @property classNames @type Array @default ['ember-view'] */ classNames: ['ember-view'], /** A list of properties of the view to apply as class names. If the property is a string value, the value of that string will be applied as a class name. // Applies the 'high' class to the view element Ember.View.create({ classNameBindings: ['priority'] priority: 'high' }); If the value of the property is a Boolean, the name of that property is added as a dasherized class name. // Applies the 'is-urgent' class to the view element Ember.View.create({ classNameBindings: ['isUrgent'] isUrgent: true }); If you would prefer to use a custom value instead of the dasherized property name, you can pass a binding like this: // Applies the 'urgent' class to the view element Ember.View.create({ classNameBindings: ['isUrgent:urgent'] isUrgent: true }); This list of properties is inherited from the view's superclasses as well. @property classNameBindings @type Array @default [] */ classNameBindings: [], /** A list of properties of the view to apply as attributes. If the property is a string value, the value of that string will be applied as the attribute. // Applies the type attribute to the element // with the value "button", like
Ember.View.create({ attributeBindings: ['type'], type: 'button' }); If the value of the property is a Boolean, the name of that property is added as an attribute. // Renders something like
Ember.View.create({ attributeBindings: ['enabled'], enabled: true }); @property attributeBindings */ attributeBindings: [], // ....................................................... // CORE DISPLAY METHODS // /** @private Setup a view, but do not finish waking it up. - configure childViews - register the view with the global views hash, which is used for event dispatch @method init */ init: function() { this._super(); // setup child views. be sure to clone the child views array first this._childViews = this._childViews.slice(); Ember.assert("Only arrays are allowed for 'classNameBindings'", Ember.typeOf(this.classNameBindings) === 'array'); this.classNameBindings = Ember.A(this.classNameBindings.slice()); Ember.assert("Only arrays are allowed for 'classNames'", Ember.typeOf(this.classNames) === 'array'); this.classNames = Ember.A(this.classNames.slice()); var viewController = get(this, 'viewController'); if (viewController) { viewController = get(viewController); if (viewController) { set(viewController, 'view', this); } } }, appendChild: function(view, options) { return this.invokeForState('appendChild', view, options); }, /** Removes the child view from the parent view. @method removeChild @param {Ember.View} view @return {Ember.View} receiver */ removeChild: function(view) { // If we're destroying, the entire subtree will be // freed, and the DOM will be handled separately, // so no need to mess with childViews. if (this.isDestroying) { return; } // update parent node set(view, '_parentView', null); // remove view from childViews array. var childViews = this._childViews; Ember.EnumerableUtils.removeObject(childViews, view); this.propertyDidChange('childViews'); // HUH?! what happened to will change? return this; }, /** Removes all children from the parentView. @method removeAllChildren @return {Ember.View} receiver */ removeAllChildren: function() { return this.mutateChildViews(function(view) { this.removeChild(view); }); }, destroyAllChildren: function() { return this.mutateChildViews(function(view) { view.destroy(); }); }, /** Removes the view from its parentView, if one is found. Otherwise does nothing. @method removeFromParent @return {Ember.View} receiver */ removeFromParent: function() { var parent = get(this, '_parentView'); // Remove DOM element from parent this.remove(); if (parent) { parent.removeChild(this); } return this; }, /** You must call `destroy` on a view to destroy the view (and all of its child views). This will remove the view from any parent node, then make sure that the DOM element managed by the view can be released by the memory manager. @method willDestroy */ willDestroy: function() { // calling this._super() will nuke computed properties and observers, // so collect any information we need before calling super. var childViews = this._childViews, parent = get(this, '_parentView'), childLen; // destroy the element -- this will avoid each child view destroying // the element over and over again... if (!this.removedFromDOM) { this.destroyElement(); } // remove from non-virtual parent view if viewName was specified if (this.viewName) { var nonVirtualParentView = get(this, 'parentView'); if (nonVirtualParentView) { set(nonVirtualParentView, this.viewName, null); } } // remove from parent if found. Don't call removeFromParent, // as removeFromParent will try to remove the element from // the DOM again. if (parent) { parent.removeChild(this); } this.state = 'destroyed'; childLen = childViews.length; for (var i=childLen-1; i>=0; i--) { childViews[i].removedFromDOM = true; childViews[i].destroy(); } // next remove view from global hash if (!this.isVirtual) delete Ember.View.views[get(this, 'elementId')]; }, /** Instantiates a view to be added to the childViews array during view initialization. You generally will not call this method directly unless you are overriding createChildViews(). Note that this method will automatically configure the correct settings on the new view instance to act as a child of the parent. @method createChildView @param {Class} viewClass @param {Hash} [attrs] Attributes to add @return {Ember.View} new instance */ createChildView: function(view, attrs) { if (Ember.CoreView.detect(view)) { attrs = attrs || {}; attrs._parentView = this; attrs.templateData = attrs.templateData || get(this, 'templateData'); view = view.create(attrs); // don't set the property on a virtual view, as they are invisible to // consumers of the view API if (view.viewName) { set(get(this, 'concreteView'), view.viewName, view); } } else { Ember.assert('You must pass instance or subclass of View', view instanceof Ember.CoreView); Ember.assert("You can only pass attributes when a class is provided", !attrs); if (!get(view, 'templateData')) { set(view, 'templateData', get(this, 'templateData')); } set(view, '_parentView', this); } return view; }, becameVisible: Ember.K, becameHidden: Ember.K, /** @private When the view's `isVisible` property changes, toggle the visibility element of the actual DOM element. @method _isVisibleDidChange */ _isVisibleDidChange: Ember.observer(function() { var $el = this.$(); if (!$el) { return; } var isVisible = get(this, 'isVisible'); $el.toggle(isVisible); if (this._isAncestorHidden()) { return; } if (isVisible) { this._notifyBecameVisible(); } else { this._notifyBecameHidden(); } }, 'isVisible'), _notifyBecameVisible: function() { this.trigger('becameVisible'); this.forEachChildView(function(view) { var isVisible = get(view, 'isVisible'); if (isVisible || isVisible === null) { view._notifyBecameVisible(); } }); }, _notifyBecameHidden: function() { this.trigger('becameHidden'); this.forEachChildView(function(view) { var isVisible = get(view, 'isVisible'); if (isVisible || isVisible === null) { view._notifyBecameHidden(); } }); }, _isAncestorHidden: function() { var parent = get(this, 'parentView'); while (parent) { if (get(parent, 'isVisible') === false) { return true; } parent = get(parent, 'parentView'); } return false; }, clearBuffer: function() { this.invokeRecursively(function(view) { this.buffer = null; }); }, transitionTo: function(state, children) { this.state = state; if (children !== false) { this.forEachChildView(function(view) { view.transitionTo(state); }); } }, // ....................................................... // EVENT HANDLING // /** @private Handle events from `Ember.EventDispatcher` @method handleEvent @param eventName {String} @param evt {Event} */ handleEvent: function(eventName, evt) { return this.invokeForState('handleEvent', eventName, evt); } }); /* Describe how the specified actions should behave in the various states that a view can exist in. Possible states: * preRender: when a view is first instantiated, and after its element was destroyed, it is in the preRender state * inBuffer: once a view has been rendered, but before it has been inserted into the DOM, it is in the inBuffer state * inDOM: once a view has been inserted into the DOM it is in the inDOM state. A view spends the vast majority of its existence in this state. * destroyed: once a view has been destroyed (using the destroy method), it is in this state. No further actions can be invoked on a destroyed view. */ // in the destroyed state, everything is illegal // before rendering has begun, all legal manipulations are noops. // inside the buffer, legal manipulations are done on the buffer // once the view has been inserted into the DOM, legal manipulations // are done on the DOM element. var DOMManager = { prepend: function(view, html) { view.$().prepend(html); }, after: function(view, html) { view.$().after(html); }, html: function(view, html) { view.$().html(html); }, replace: function(view) { var element = get(view, 'element'); set(view, 'element', null); view._insertElementLater(function() { Ember.$(element).replaceWith(get(view, 'element')); }); }, remove: function(view) { view.$().remove(); }, empty: function(view) { view.$().empty(); } }; Ember.View.reopen({ states: Ember.View.states, domManager: DOMManager }); Ember.View.reopenClass({ /** @private Parse a path and return an object which holds the parsed properties. For example a path like "content.isEnabled:enabled:disabled" wil return the following object: { path: "content.isEnabled", className: "enabled", falsyClassName: "disabled", classNames: ":enabled:disabled" } @method _parsePropertyPath @static */ _parsePropertyPath: function(path) { var split = path.split(':'), propertyPath = split[0], classNames = "", className, falsyClassName; // check if the property is defined as prop:class or prop:trueClass:falseClass if (split.length > 1) { className = split[1]; if (split.length === 3) { falsyClassName = split[2]; } classNames = ':' + className; if (falsyClassName) { classNames += ":" + falsyClassName; } } return { path: propertyPath, classNames: classNames, className: (className === '') ? undefined : className, falsyClassName: falsyClassName }; }, /** @private Get the class name for a given value, based on the path, optional className and optional falsyClassName. - if a className or falsyClassName has been specified: - if the value is truthy and className has been specified, className is returned - if the value is falsy and falsyClassName has been specified, falsyClassName is returned - otherwise null is returned - if the value is true, the dasherized last part of the supplied path is returned - if the value is not false, undefined or null, the value is returned - if none of the above rules apply, null is returned @method _classStringForValue @param path @param val @param className @param falsyClassName @static */ _classStringForValue: function(path, val, className, falsyClassName) { // When using the colon syntax, evaluate the truthiness or falsiness // of the value to determine which className to return if (className || falsyClassName) { if (className && !!val) { return className; } else if (falsyClassName && !val) { return falsyClassName; } else { return null; } // If value is a Boolean and true, return the dasherized property // name. } else if (val === true) { // Normalize property path to be suitable for use // as a class name. For exaple, content.foo.barBaz // becomes bar-baz. var parts = path.split('.'); return Ember.String.dasherize(parts[parts.length-1]); // If the value is not false, undefined, or null, return the current // value of the property. } else if (val !== false && val !== undefined && val !== null) { return val; // Nothing to display. Return null so that the old class is removed // but no new class is added. } else { return null; } } }); /** Global views hash @property views @static @type Hash */ Ember.View.views = {}; // If someone overrides the child views computed property when // defining their class, we want to be able to process the user's // supplied childViews and then restore the original computed property // at view initialization time. This happens in Ember.ContainerView's init // method. Ember.View.childViewsProperty = childViewsProperty; Ember.View.applyAttributeBindings = function(elem, name, value) { var type = Ember.typeOf(value); var currentValue = elem.attr(name); // if this changes, also change the logic in ember-handlebars/lib/helpers/binding.js if ((type === 'string' || (type === 'number' && !isNaN(value))) && value !== currentValue) { elem.attr(name, value); } else if (value && type === 'boolean') { elem.attr(name, name); } else if (!value) { elem.removeAttr(name); } }; })(); (function() { /** @module ember @submodule ember-views */ var get = Ember.get, set = Ember.set; Ember.View.states = { _default: { // appendChild is only legal while rendering the buffer. appendChild: function() { throw "You can't use appendChild outside of the rendering process"; }, $: function() { return undefined; }, getElement: function() { return null; }, // Handle events from `Ember.EventDispatcher` handleEvent: function() { return true; // continue event propagation }, destroyElement: function(view) { set(view, 'element', null); if (view._scheduledInsert) { Ember.run.cancel(view._scheduledInsert); view._scheduledInsert = null; } return view; }, renderToBufferIfNeeded: function () { return false; } } }; Ember.View.reopen({ states: Ember.View.states }); })(); (function() { /** @module ember @submodule ember-views */ Ember.View.states.preRender = { parentState: Ember.View.states._default, // a view leaves the preRender state once its element has been // created (createElement). insertElement: function(view, fn) { view.createElement(); view._notifyWillInsertElement(); // after createElement, the view will be in the hasElement state. fn.call(view); view.transitionTo('inDOM'); view._notifyDidInsertElement(); }, renderToBufferIfNeeded: function(view) { return view.renderToBuffer(); }, empty: Ember.K, setElement: function(view, value) { if (value !== null) { view.transitionTo('hasElement'); } return value; } }; })(); (function() { /** @module ember @submodule ember-views */ var get = Ember.get, set = Ember.set, meta = Ember.meta; Ember.View.states.inBuffer = { parentState: Ember.View.states._default, $: function(view, sel) { // if we don't have an element yet, someone calling this.$() is // trying to update an element that isn't in the DOM. Instead, // rerender the view to allow the render method to reflect the // changes. view.rerender(); return Ember.$(); }, // when a view is rendered in a buffer, rerendering it simply // replaces the existing buffer with a new one rerender: function(view) { Ember.deprecate("Something you did caused a view to re-render after it rendered but before it was inserted into the DOM. Because this is avoidable and the cause of significant performance issues in applications, this behavior is deprecated. If you want to use the debugger to find out what caused this, you can set ENV.RAISE_ON_DEPRECATION to true."); view._notifyWillClearRender(); view.clearRenderedChildren(); view.renderToBuffer(view.buffer, 'replaceWith'); }, // when a view is rendered in a buffer, appending a child // view will render that view and append the resulting // buffer into its buffer. appendChild: function(view, childView, options) { var buffer = view.buffer; childView = this.createChildView(childView, options); view._childViews.push(childView); childView.renderToBuffer(buffer); view.propertyDidChange('childViews'); return childView; }, // when a view is rendered in a buffer, destroying the // element will simply destroy the buffer and put the // state back into the preRender state. destroyElement: function(view) { view.clearBuffer(); view._notifyWillDestroyElement(); view.transitionTo('preRender'); return view; }, empty: function() { Ember.assert("Emptying a view in the inBuffer state is not allowed and should not happen under normal circumstances. Most likely there is a bug in your application. This may be due to excessive property change notifications."); }, renderToBufferIfNeeded: function (view) { return view.buffer; }, // It should be impossible for a rendered view to be scheduled for // insertion. insertElement: function() { throw "You can't insert an element that has already been rendered"; }, setElement: function(view, value) { if (value === null) { view.transitionTo('preRender'); } else { view.clearBuffer(); view.transitionTo('hasElement'); } return value; } }; })(); (function() { /** @module ember @submodule ember-views */ var get = Ember.get, set = Ember.set, meta = Ember.meta; Ember.View.states.hasElement = { parentState: Ember.View.states._default, $: function(view, sel) { var elem = get(view, 'element'); return sel ? Ember.$(sel, elem) : Ember.$(elem); }, getElement: function(view) { var parent = get(view, 'parentView'); if (parent) { parent = get(parent, 'element'); } if (parent) { return view.findElementInParentElement(parent); } return Ember.$("#" + get(view, 'elementId'))[0]; }, setElement: function(view, value) { if (value === null) { view.transitionTo('preRender'); } else { throw "You cannot set an element to a non-null value when the element is already in the DOM."; } return value; }, // once the view has been inserted into the DOM, rerendering is // deferred to allow bindings to synchronize. rerender: function(view) { view._notifyWillClearRender(); view.clearRenderedChildren(); view.domManager.replace(view); return view; }, // once the view is already in the DOM, destroying it removes it // from the DOM, nukes its element, and puts it back into the // preRender state if inDOM. destroyElement: function(view) { view._notifyWillDestroyElement(); view.domManager.remove(view); set(view, 'element', null); if (view._scheduledInsert) { Ember.run.cancel(view._scheduledInsert); view._scheduledInsert = null; } return view; }, empty: function(view) { var _childViews = view._childViews, len, idx; if (_childViews) { len = _childViews.length; for (idx = 0; idx < len; idx++) { _childViews[idx]._notifyWillDestroyElement(); } } view.domManager.empty(view); }, // Handle events from `Ember.EventDispatcher` handleEvent: function(view, eventName, evt) { if (view.has(eventName)) { // Handler should be able to re-dispatch events, so we don't // preventDefault or stopPropagation. return view.trigger(eventName, evt); } else { return true; // continue event propagation } } }; Ember.View.states.inDOM = { parentState: Ember.View.states.hasElement, insertElement: function(view, fn) { throw "You can't insert an element into the DOM that has already been inserted"; } }; })(); (function() { /** @module ember @submodule ember-views */ var destroyedError = "You can't call %@ on a destroyed view", fmt = Ember.String.fmt; Ember.View.states.destroyed = { parentState: Ember.View.states._default, appendChild: function() { throw fmt(destroyedError, ['appendChild']); }, rerender: function() { throw fmt(destroyedError, ['rerender']); }, destroyElement: function() { throw fmt(destroyedError, ['destroyElement']); }, empty: function() { throw fmt(destroyedError, ['empty']); }, setElement: function() { throw fmt(destroyedError, ["set('element', ...)"]); }, renderToBufferIfNeeded: function() { throw fmt(destroyedError, ["renderToBufferIfNeeded"]); }, // Since element insertion is scheduled, don't do anything if // the view has been destroyed between scheduling and execution insertElement: Ember.K }; })(); (function() { })(); (function() { /** @module ember @submodule ember-views */ var get = Ember.get, set = Ember.set, meta = Ember.meta; var forEach = Ember.EnumerableUtils.forEach; var childViewsProperty = Ember.computed(function() { return get(this, '_childViews'); }).property('_childViews'); /** A `ContainerView` is an `Ember.View` subclass that allows for manual or programatic management of a view's `childViews` array that will correctly update the `ContainerView` instance's rendered DOM representation. ## Setting Initial Child Views The initial array of child views can be set in one of two ways. You can provide a `childViews` property at creation time that contains instance of `Ember.View`: ``` javascript aContainer = Ember.ContainerView.create({ childViews: [Ember.View.create(), Ember.View.create()] }); ``` You can also provide a list of property names whose values are instances of `Ember.View`: ``` javascript aContainer = Ember.ContainerView.create({ childViews: ['aView', 'bView', 'cView'], aView: Ember.View.create(), bView: Ember.View.create() cView: Ember.View.create() }); ``` The two strategies can be combined: ``` javascript aContainer = Ember.ContainerView.create({ childViews: ['aView', Ember.View.create()], aView: Ember.View.create() }); ``` Each child view's rendering will be inserted into the container's rendered HTML in the same order as its position in the `childViews` property. ## Adding and Removing Child Views The views in a container's `childViews` array should be added and removed by manipulating the `childViews` property directly. To remove a view pass that view into a `removeObject` call on the container's `childViews` property. Given an empty `` the following code ``` javascript aContainer = Ember.ContainerView.create({ classNames: ['the-container'], childViews: ['aView', 'bView'], aView: Ember.View.create({ template: Ember.Handlebars.compile("A") }), bView: Ember.View.create({ template: Ember.Handlebars.compile("B") }) }); aContainer.appendTo('body'); ``` Results in the HTML ``` html
A
B
``` Removing a view ``` javascript aContainer.get('childViews'); // [aContainer.aView, aContainer.bView] aContainer.get('childViews').removeObject(aContainer.get('bView')); aContainer.get('childViews'); // [aContainer.aView] ``` Will result in the following HTML ``` html
A
``` Similarly, adding a child view is accomplished by adding `Ember.View` instances to the container's `childViews` property. Given an empty `` the following code ``` javascript aContainer = Ember.ContainerView.create({ classNames: ['the-container'], childViews: ['aView', 'bView'], aView: Ember.View.create({ template: Ember.Handlebars.compile("A") }), bView: Ember.View.create({ template: Ember.Handlebars.compile("B") }) }); aContainer.appendTo('body'); ``` Results in the HTML ``` html
A
B
``` Adding a view ``` javascript AnotherViewClass = Ember.View.extend({ template: Ember.Handlebars.compile("Another view") }); aContainer.get('childViews'); // [aContainer.aView, aContainer.bView] aContainer.get('childViews').pushObject(AnotherViewClass.create()); aContainer.get('childViews'); // [aContainer.aView, aContainer.bView, ] ``` Will result in the following HTML ``` html
A
B
Another view
``` Direct manipulation of childViews presence or absence in the DOM via calls to `remove` or `removeFromParent` or calls to a container's `removeChild` may not behave correctly. Calling `remove()` on a child view will remove the view's HTML, but it will remain as part of its container's `childView`s property. Calling `removeChild()` on the container will remove the passed view instance from the container's `childView`s but keep its HTML within the container's rendered view. Calling `removeFromParent()` behaves as expected but should be avoided in favor of direct manipulation of a container's `childViews` property. ``` javascript aContainer = Ember.ContainerView.create({ classNames: ['the-container'], childViews: ['aView', 'bView'], aView: Ember.View.create({ template: Ember.Handlebars.compile("A") }), bView: Ember.View.create({ template: Ember.Handlebars.compile("B") }) }); aContainer.appendTo('body'); ``` Results in the HTML ``` html
A
B
``` Calling `aContainer.get('aView').removeFromParent()` will result in the following HTML ``` html
B
``` And the `Ember.View` instance stored in `aContainer.aView` will be removed from `aContainer`'s `childViews` array. ## Templates and Layout A `template`, `templateName`, `defaultTemplate`, `layout`, `layoutName` or `defaultLayout` property on a container view will not result in the template or layout being rendered. The HTML contents of a `Ember.ContainerView`'s DOM representation will only be the rendered HTML of its child views. ## Binding a View to Display If you would like to display a single view in your ContainerView, you can set its `currentView` property. When the `currentView` property is set to a view instance, it will be added to the ContainerView's `childViews` array. If the `currentView` property is later changed to a different view, the new view will replace the old view. If `currentView` is set to `null`, the last `currentView` will be removed. This functionality is useful for cases where you want to bind the display of a ContainerView to a controller or state manager. For example, you can bind the `currentView` of a container to a controller like this: ``` javascript App.appController = Ember.Object.create({ view: Ember.View.create({ templateName: 'person_template' }) }); ``` ``` handlebars {{view Ember.ContainerView currentViewBinding="App.appController.view"}} ``` ## Use lifecycle hooks This is an example of how you could implement reusable currentView view. ``` javascript App.ContainerView = Ember.ContainerView.extend({ appendCurrentView: function(currentView, callback) { currentView.set('isVisible', true); if (!this.get('childViews').contains(currentView)) { this._super(currentView, callback); } else { callback(); } }, removeCurrentView: function(currentView, callback) { if (currentView.get('isShared')) { currentView.set('isVisible', false); callback(); } else { this._super(currentView, callback); } } }); ```` This is an example of how you could implement animations. ```` javascript App.ContainerView = Ember.ContainerView.extend({ presentCurrentView: function(currentView, callback) { currentView.$().animate({top: '0px'}, callback); }, dismissCurrentView: function(currentView, callback) { currentView.$().animate({top: '-100px'}, callback); } }); ```` @class ContainerView @namespace Ember @extends Ember.View */ Ember.ContainerView = Ember.View.extend({ init: function() { this._super(); var childViews = get(this, 'childViews'); Ember.defineProperty(this, 'childViews', childViewsProperty); var _childViews = this._childViews; forEach(childViews, function(viewName, idx) { var view; if ('string' === typeof viewName) { view = get(this, viewName); view = this.createChildView(view); set(this, viewName, view); } else { view = this.createChildView(viewName); } _childViews[idx] = view; }, this); // Make the _childViews array observable Ember.A(_childViews); // Sets up an array observer on the child views array. This // observer will detect when child views are added or removed // and update the DOM to reflect the mutation. get(this, 'childViews').addArrayObserver(this, { willChange: 'childViewsWillChange', didChange: 'childViewsDidChange' }); // Make sure we initialize with currentView if it is present var currentView = get(this, 'currentView'); if (currentView) { this._currentViewDidChange(); } }, /** @private Instructs each child view to render to the passed render buffer. @method render @param {Ember.RenderBuffer} buffer the buffer to render to */ render: function(buffer) { this.forEachChildView(function(view) { view.renderToBuffer(buffer); }); }, instrumentName: 'render.container', /** @private When the container view is destroyed, tear down the child views array observer. @method willDestroy */ willDestroy: function() { get(this, 'childViews').removeArrayObserver(this, { willChange: 'childViewsWillChange', didChange: 'childViewsDidChange' }); this._super(); }, /** @private When a child view is removed, destroy its element so that it is removed from the DOM. The array observer that triggers this action is set up in the `renderToBuffer` method. @method childViewsWillChange @param {Ember.Array} views the child views array before mutation @param {Number} start the start position of the mutation @param {Number} removed the number of child views removed **/ childViewsWillChange: function(views, start, removed) { if (removed === 0) { return; } var changedViews = views.slice(start, start+removed); this.initializeViews(changedViews, null, null); this.invokeForState('childViewsWillChange', views, start, removed); }, /** @private When a child view is added, make sure the DOM gets updated appropriately. If the view has already rendered an element, we tell the child view to create an element and insert it into the DOM. If the enclosing container view has already written to a buffer, but not yet converted that buffer into an element, we insert the string representation of the child into the appropriate place in the buffer. @method childViewsDidChange @param {Ember.Array} views the array of child views afte the mutation has occurred @param {Number} start the start position of the mutation @param {Number} removed the number of child views removed @param {Number} the number of child views added */ childViewsDidChange: function(views, start, removed, added) { var len = get(views, 'length'); // No new child views were added; bail out. if (added === 0) return; var changedViews = views.slice(start, start+added); this.initializeViews(changedViews, this, get(this, 'templateData')); // Let the current state handle the changes this.invokeForState('childViewsDidChange', views, start, added); }, initializeViews: function(views, parentView, templateData) { forEach(views, function(view) { set(view, '_parentView', parentView); if (!get(view, 'templateData')) { set(view, 'templateData', templateData); } }); }, currentView: null, /** This method is responsible for presenting a new view. Default implementation will simply call the callback. You can override this method if you want to add an animation for example. @method presentCurrentView @param {Ember.View} currentView a view to present @param {Function} callback the callback called once operation is terminated */ presentCurrentView: function(currentView, callback) { callback(); }, /** This method is responsible for adding view to containerView @method appendCurrentView @param {Ember.View} currentView a view to present @param {Function} callback the callback called once view is appended */ appendCurrentView: function(currentView, callback) { var childViews = get(this, 'childViews'); currentView.one('didInsertElement', callback); childViews.pushObject(currentView); }, /** This method is responsible for dismissing a view. Default implementation will simply call the callback. You can override this method if you want to add an animation for example. @method dismissCurrentView @param {Ember.View} currentView a view to dismiss @param {Function} callback the callback called once operation is terminated */ dismissCurrentView: function(currentView, callback) { callback(); }, /** This method is responsible for removing a view from the containerView You may want to override it in case you implementing views sharing for example @method removeCurrentView @param {Ember.View} currentView a view to present @param {Function} callback the callback called once view is removed */ removeCurrentView: function(currentView, callback) { var childViews = get(this, 'childViews'); currentView.one('didDisappear', function() { currentView.destroy(); }); childViews.removeObject(currentView); callback(); }, _currentViewWillChange: Ember.beforeObserver(function() { var currentView = get(this, 'currentView'), containerView = this; if (currentView) { set(currentView, 'isBeingDismissed', true); currentView.trigger('willDisappear', currentView); this.dismissCurrentView(currentView, function() { containerView.removeCurrentView(currentView, function() { set(currentView, 'isBeingDismissed', false); currentView.trigger('didDisappear', currentView); }); }); } }, 'currentView'), _currentViewDidChange: Ember.observer(function() { var currentView = get(this, 'currentView'), containerView = this; if (currentView) { set(currentView, 'isBeingPresented', true); currentView.trigger('willAppear', currentView); this.appendCurrentView(currentView, function() { containerView.presentCurrentView(currentView, function() { set(currentView, 'isBeingPresented', false); currentView.trigger('didAppear', currentView); }); }); } }, 'currentView'), _ensureChildrenAreInDOM: function () { this.invokeForState('ensureChildrenAreInDOM', this); } }); // Ember.ContainerView extends the default view states to provide different // behavior for childViewsWillChange and childViewsDidChange. Ember.ContainerView.states = { parent: Ember.View.states, inBuffer: { childViewsDidChange: function(parentView, views, start, added) { var buffer = parentView.buffer, startWith, prev, prevBuffer, view; // Determine where to begin inserting the child view(s) in the // render buffer. if (start === 0) { // If views were inserted at the beginning, prepend the first // view to the render buffer, then begin inserting any // additional views at the beginning. view = views[start]; startWith = start + 1; view.renderToBuffer(buffer, 'prepend'); } else { // Otherwise, just insert them at the same place as the child // views mutation. view = views[start - 1]; startWith = start; } for (var i=startWith; i` and the following code: ``` javascript someItemsView = Ember.CollectionView.create({ classNames: ['a-collection'], content: ['A','B','C'], itemViewClass: Ember.View.extend({ template: Ember.Handlebars.compile("the letter: {{view.content}}") }) }); someItemsView.appendTo('body'); ``` Will result in the following HTML structure ``` html
the letter: A
the letter: B
the letter: C
``` ## Automatic matching of parent/child tagNames Setting the `tagName` property of a `CollectionView` to any of "ul", "ol", "table", "thead", "tbody", "tfoot", "tr", or "select" will result in the item views receiving an appropriately matched `tagName` property. Given an empty `` and the following code: ``` javascript anUndorderedListView = Ember.CollectionView.create({ tagName: 'ul', content: ['A','B','C'], itemViewClass: Ember.View.extend({ template: Ember.Handlebars.compile("the letter: {{view.content}}") }) }); anUndorderedListView.appendTo('body'); ``` Will result in the following HTML structure ``` html
  • the letter: A
  • the letter: B
  • the letter: C
``` Additional tagName pairs can be provided by adding to `Ember.CollectionView.CONTAINER_MAP ` ``` javascript Ember.CollectionView.CONTAINER_MAP['article'] = 'section' ``` ## Empty View You can provide an `Ember.View` subclass to the `Ember.CollectionView` instance as its `emptyView` property. If the `content` property of a `CollectionView` is set to `null` or an empty array, an instance of this view will be the `CollectionView`s only child. ``` javascript aListWithNothing = Ember.CollectionView.create({ classNames: ['nothing'] content: null, emptyView: Ember.View.extend({ template: Ember.Handlebars.compile("The collection is empty") }) }); aListWithNothing.appendTo('body'); ``` Will result in the following HTML structure ``` html
The collection is empty
``` ## Adding and Removing items The `childViews` property of a `CollectionView` should not be directly manipulated. Instead, add, remove, replace items from its `content` property. This will trigger appropriate changes to its rendered HTML. ## Use in templates via the `{{collection}}` Ember.Handlebars helper Ember.Handlebars provides a helper specifically for adding `CollectionView`s to templates. See `Ember.Handlebars.collection` for more details @class CollectionView @namespace Ember @extends Ember.ContainerView @since Ember 0.9 */ Ember.CollectionView = Ember.ContainerView.extend( /** @scope Ember.CollectionView.prototype */ { /** A list of items to be displayed by the Ember.CollectionView. @property content @type Ember.Array @default null */ content: null, /** @private This provides metadata about what kind of empty view class this collection would like if it is being instantiated from another system (like Handlebars) @property emptyViewClass */ emptyViewClass: Ember.View, /** An optional view to display if content is set to an empty array. @property emptyView @type Ember.View @default null */ emptyView: null, /** @property itemViewClass @type Ember.View @default Ember.View */ itemViewClass: Ember.View, init: function() { var ret = this._super(); this._contentDidChange(); return ret; }, _contentWillChange: Ember.beforeObserver(function() { var content = this.get('content'); if (content) { content.removeArrayObserver(this); } var len = content ? get(content, 'length') : 0; this.arrayWillChange(content, 0, len); }, 'content'), /** @private Check to make sure that the content has changed, and if so, update the children directly. This is always scheduled asynchronously, to allow the element to be created before bindings have synchronized and vice versa. @method _contentDidChange */ _contentDidChange: Ember.observer(function() { var content = get(this, 'content'); if (content) { Ember.assert(fmt("an Ember.CollectionView's content must implement Ember.Array. You passed %@", [content]), Ember.Array.detect(content)); content.addArrayObserver(this); } var len = content ? get(content, 'length') : 0; this.arrayDidChange(content, 0, null, len); }, 'content'), willDestroy: function() { var content = get(this, 'content'); if (content) { content.removeArrayObserver(this); } this._super(); }, arrayWillChange: function(content, start, removedCount) { // If the contents were empty before and this template collection has an // empty view remove it now. var emptyView = get(this, 'emptyView'); if (emptyView && emptyView instanceof Ember.View) { emptyView.removeFromParent(); } // Loop through child views that correspond with the removed items. // Note that we loop from the end of the array to the beginning because // we are mutating it as we go. var childViews = get(this, 'childViews'), childView, idx, len; len = get(childViews, 'length'); var removingAll = removedCount === len; if (removingAll) { this.invokeForState('empty'); } for (idx = start + removedCount - 1; idx >= start; idx--) { childView = childViews[idx]; if (removingAll) { childView.removedFromDOM = true; } childView.destroy(); } }, /** Called when a mutation to the underlying content array occurs. This method will replay that mutation against the views that compose the Ember.CollectionView, ensuring that the view reflects the model. This array observer is added in contentDidChange. @method arrayDidChange @param {Array} addedObjects the objects that were added to the content @param {Array} removedObjects the objects that were removed from the content @param {Number} changeIndex the index at which the changes occurred */ arrayDidChange: function(content, start, removed, added) { var itemViewClass = get(this, 'itemViewClass'), childViews = get(this, 'childViews'), addedViews = [], view, item, idx, len, itemTagName; if ('string' === typeof itemViewClass) { itemViewClass = get(itemViewClass); } Ember.assert(fmt("itemViewClass must be a subclass of Ember.View, not %@", [itemViewClass]), Ember.View.detect(itemViewClass)); len = content ? get(content, 'length') : 0; if (len) { for (idx = start; idx < start+added; idx++) { item = content.objectAt(idx); view = this.createChildView(itemViewClass, { content: item, contentIndex: idx }); addedViews.push(view); } } else { var emptyView = get(this, 'emptyView'); if (!emptyView) { return; } emptyView = this.createChildView(emptyView); addedViews.push(emptyView); set(this, 'emptyView', emptyView); } childViews.replace(start, 0, addedViews); }, createChildView: function(view, attrs) { view = this._super(view, attrs); var itemTagName = get(view, 'tagName'); var tagName = (itemTagName === null || itemTagName === undefined) ? Ember.CollectionView.CONTAINER_MAP[get(this, 'tagName')] : itemTagName; set(view, 'tagName', tagName); return view; } }); /** A map of parent tags to their default child tags. You can add additional parent tags if you want collection views that use a particular parent tag to default to a child tag. @property CONTAINER_MAP @type Hash @static @final */ Ember.CollectionView.CONTAINER_MAP = { ul: 'li', ol: 'li', table: 'tr', thead: 'tr', tbody: 'tr', tfoot: 'tr', tr: 'td', select: 'option' }; })(); (function() { })(); (function() { /*globals jQuery*/ /** Ember Views @module ember @submodule ember-views @require ember-runtime @main ember-views */ })(); (function() { var get = Ember.get, set = Ember.set; /** @module ember @submodule ember-states */ /** @class State @namespace Ember @extends Ember.Object @uses Ember.Evented */ Ember.State = Ember.Object.extend(Ember.Evented, /** @scope Ember.State.prototype */{ isState: true, /** A reference to the parent state. @property parentState @type Ember.State */ parentState: null, start: null, /** The name of this state. @property name @type String */ name: null, /** The full path to this state. @property path @type String */ path: Ember.computed(function() { var parentPath = get(this, 'parentState.path'), path = get(this, 'name'); if (parentPath) { path = parentPath + '.' + path; } return path; }).property(), /** @private Override the default event firing from Ember.Evented to also call methods with the given name. @method trigger @param name */ trigger: function(name) { if (this[name]) { this[name].apply(this, [].slice.call(arguments, 1)); } this._super.apply(this, arguments); }, init: function() { var states = get(this, 'states'), foundStates; set(this, 'childStates', Ember.A()); set(this, 'eventTransitions', get(this, 'eventTransitions') || {}); var name, value, transitionTarget; // As a convenience, loop over the properties // of this state and look for any that are other // Ember.State instances or classes, and move them // to the `states` hash. This avoids having to // create an explicit separate hash. if (!states) { states = {}; for (name in this) { if (name === "constructor") { continue; } if (value = this[name]) { if (transitionTarget = value.transitionTarget) { this.eventTransitions[name] = transitionTarget; } this.setupChild(states, name, value); } } set(this, 'states', states); } else { for (name in states) { this.setupChild(states, name, states[name]); } } set(this, 'pathsCache', {}); set(this, 'pathsCacheNoContext', {}); }, setupChild: function(states, name, value) { if (!value) { return false; } if (value.isState) { set(value, 'name', name); } else if (Ember.State.detect(value)) { value = value.create({ name: name }); } if (value.isState) { set(value, 'parentState', this); get(this, 'childStates').pushObject(value); states[name] = value; return value; } }, lookupEventTransition: function(name) { var path, state = this; while(state && !path) { path = state.eventTransitions[name]; state = state.get('parentState'); } return path; }, /** A Boolean value indicating whether the state is a leaf state in the state hierarchy. This is false if the state has child states; otherwise it is true. @property isLeaf @type Boolean */ isLeaf: Ember.computed(function() { return !get(this, 'childStates').length; }), /** A boolean value indicating whether the state takes a context. By default we assume all states take contexts. @property hasContext @default true */ hasContext: true, /** This is the default transition event. @event setup @param {Ember.StateManager} manager @param context @see Ember.StateManager#transitionEvent */ setup: Ember.K, /** This event fires when the state is entered. @event enter @param {Ember.StateManager} manager */ enter: Ember.K, /** This event fires when the state is exited. @event exit @param {Ember.StateManager} manager */ exit: Ember.K }); Ember.State.reopenClass({ /** Creates an action function for transitioning to the named state while preserving context. The following example StateManagers are equivalent: aManager = Ember.StateManager.create({ stateOne: Ember.State.create({ changeToStateTwo: Ember.State.transitionTo('stateTwo') }), stateTwo: Ember.State.create({}) }) bManager = Ember.StateManager.create({ stateOne: Ember.State.create({ changeToStateTwo: function(manager, context){ manager.transitionTo('stateTwo', context) } }), stateTwo: Ember.State.create({}) }) @method transitionTo @static @param {String} target */ transitionTo: function(target) { var transitionFunction = function(stateManager, contextOrEvent) { var contexts = [], transitionArgs, Event = Ember.$ && Ember.$.Event; if (contextOrEvent && (Event && contextOrEvent instanceof Event)) { if (contextOrEvent.hasOwnProperty('contexts')) { contexts = contextOrEvent.contexts.slice(); } } else { contexts = [].slice.call(arguments, 1); } contexts.unshift(target); stateManager.transitionTo.apply(stateManager, contexts); }; transitionFunction.transitionTarget = target; return transitionFunction; } }); })(); (function() { /** @module ember @submodule ember-states */ var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt; var arrayForEach = Ember.ArrayPolyfills.forEach; /** A Transition takes the enter, exit and resolve states and normalizes them: * takes any passed in contexts into consideration * adds in `initialState`s @class Transition @private */ var Transition = function(raw) { this.enterStates = raw.enterStates.slice(); this.exitStates = raw.exitStates.slice(); this.resolveState = raw.resolveState; this.finalState = raw.enterStates[raw.enterStates.length - 1] || raw.resolveState; }; Transition.prototype = { /** Normalize the passed in enter, exit and resolve states. This process also adds `finalState` and `contexts` to the Transition object. @method normalize @param {Ember.StateManager} manager the state manager running the transition @param {Array} contexts a list of contexts passed into `transitionTo` */ normalize: function(manager, contexts) { this.matchContextsToStates(contexts); this.addInitialStates(); this.removeUnchangedContexts(manager); return this; }, /** Match each of the contexts passed to `transitionTo` to a state. This process may also require adding additional enter and exit states if there are more contexts than enter states. @method matchContextsToStates @param {Array} contexts a list of contexts passed into `transitionTo` */ matchContextsToStates: function(contexts) { var stateIdx = this.enterStates.length - 1, matchedContexts = [], state, context; // Next, we will match the passed in contexts to the states they // represent. // // First, assign a context to each enter state in reverse order. If // any contexts are left, add a parent state to the list of states // to enter and exit, and assign a context to the parent state. // // If there are still contexts left when the state manager is // reached, raise an exception. // // This allows the following: // // |- root // | |- post // | | |- comments // | |- about (* current state) // // For `transitionTo('post.comments', post, post.get('comments')`, // the first context (`post`) will be assigned to `root.post`, and // the second context (`post.get('comments')`) will be assigned // to `root.post.comments`. // // For the following: // // |- root // | |- post // | | |- index (* current state) // | | |- comments // // For `transitionTo('post.comments', otherPost, otherPost.get('comments')`, // the `` state will be added to the list of enter and exit // states because its context has changed. while (contexts.length > 0) { if (stateIdx >= 0) { state = this.enterStates[stateIdx--]; } else { if (this.enterStates.length) { state = get(this.enterStates[0], 'parentState'); if (!state) { throw "Cannot match all contexts to states"; } } else { // If re-entering the current state with a context, the resolve // state will be the current state. state = this.resolveState; } this.enterStates.unshift(state); this.exitStates.unshift(state); } // in routers, only states with dynamic segments have a context if (get(state, 'hasContext')) { context = contexts.pop(); } else { context = null; } matchedContexts.unshift(context); } this.contexts = matchedContexts; }, /** Add any `initialState`s to the list of enter states. @method addInitialStates */ addInitialStates: function() { var finalState = this.finalState, initialState; while(true) { initialState = get(finalState, 'initialState') || 'start'; finalState = get(finalState, 'states.' + initialState); if (!finalState) { break; } this.finalState = finalState; this.enterStates.push(finalState); this.contexts.push(undefined); } }, /** Remove any states that were added because the number of contexts exceeded the number of explicit enter states, but the context has not changed since the last time the state was entered. @method removeUnchangedContexts @param {Ember.StateManager} manager passed in to look up the last context for a states */ removeUnchangedContexts: function(manager) { // Start from the beginning of the enter states. If the state was added // to the list during the context matching phase, make sure the context // has actually changed since the last time the state was entered. while (this.enterStates.length > 0) { if (this.enterStates[0] !== this.exitStates[0]) { break; } if (this.enterStates.length === this.contexts.length) { if (manager.getStateMeta(this.enterStates[0], 'context') !== this.contexts[0]) { break; } this.contexts.shift(); } this.resolveState = this.enterStates.shift(); this.exitStates.shift(); } } }; /** StateManager is part of Ember's implementation of a finite state machine. A StateManager instance manages a number of properties that are instances of `Ember.State`, tracks the current active state, and triggers callbacks when states have changed. ## Defining States The states of StateManager can be declared in one of two ways. First, you can define a `states` property that contains all the states: managerA = Ember.StateManager.create({ states: { stateOne: Ember.State.create(), stateTwo: Ember.State.create() } }) managerA.get('states') // { // stateOne: Ember.State.create(), // stateTwo: Ember.State.create() // } You can also add instances of `Ember.State` (or an `Ember.State` subclass) directly as properties of a StateManager. These states will be collected into the `states` property for you. managerA = Ember.StateManager.create({ stateOne: Ember.State.create(), stateTwo: Ember.State.create() }) managerA.get('states') // { // stateOne: Ember.State.create(), // stateTwo: Ember.State.create() // } ## The Initial State When created a StateManager instance will immediately enter into the state defined as its `start` property or the state referenced by name in its `initialState` property: managerA = Ember.StateManager.create({ start: Ember.State.create({}) }) managerA.get('currentState.name') // 'start' managerB = Ember.StateManager.create({ initialState: 'beginHere', beginHere: Ember.State.create({}) }) managerB.get('currentState.name') // 'beginHere' Because it is a property you may also provide a computed function if you wish to derive an `initialState` programmatically: managerC = Ember.StateManager.create({ initialState: function(){ if (someLogic) { return 'active'; } else { return 'passive'; } }.property(), active: Ember.State.create({}), passive: Ember.State.create({}) }) ## Moving Between States A StateManager can have any number of Ember.State objects as properties and can have a single one of these states as its current state. Calling `transitionTo` transitions between states: robotManager = Ember.StateManager.create({ initialState: 'poweredDown', poweredDown: Ember.State.create({}), poweredUp: Ember.State.create({}) }) robotManager.get('currentState.name') // 'poweredDown' robotManager.transitionTo('poweredUp') robotManager.get('currentState.name') // 'poweredUp' Before transitioning into a new state the existing `currentState` will have its `exit` method called with the StateManager instance as its first argument and an object representing the transition as its second argument. After transitioning into a new state the new `currentState` will have its `enter` method called with the StateManager instance as its first argument and an object representing the transition as its second argument. robotManager = Ember.StateManager.create({ initialState: 'poweredDown', poweredDown: Ember.State.create({ exit: function(stateManager){ console.log("exiting the poweredDown state") } }), poweredUp: Ember.State.create({ enter: function(stateManager){ console.log("entering the poweredUp state. Destroy all humans.") } }) }) robotManager.get('currentState.name') // 'poweredDown' robotManager.transitionTo('poweredUp') // will log // 'exiting the poweredDown state' // 'entering the poweredUp state. Destroy all humans.' Once a StateManager is already in a state, subsequent attempts to enter that state will not trigger enter or exit method calls. Attempts to transition into a state that the manager does not have will result in no changes in the StateManager's current state: robotManager = Ember.StateManager.create({ initialState: 'poweredDown', poweredDown: Ember.State.create({ exit: function(stateManager){ console.log("exiting the poweredDown state") } }), poweredUp: Ember.State.create({ enter: function(stateManager){ console.log("entering the poweredUp state. Destroy all humans.") } }) }) robotManager.get('currentState.name') // 'poweredDown' robotManager.transitionTo('poweredUp') // will log // 'exiting the poweredDown state' // 'entering the poweredUp state. Destroy all humans.' robotManager.transitionTo('poweredUp') // no logging, no state change robotManager.transitionTo('someUnknownState') // silently fails robotManager.get('currentState.name') // 'poweredUp' Each state property may itself contain properties that are instances of Ember.State. The StateManager can transition to specific sub-states in a series of transitionTo method calls or via a single transitionTo with the full path to the specific state. The StateManager will also keep track of the full path to its currentState robotManager = Ember.StateManager.create({ initialState: 'poweredDown', poweredDown: Ember.State.create({ charging: Ember.State.create(), charged: Ember.State.create() }), poweredUp: Ember.State.create({ mobile: Ember.State.create(), stationary: Ember.State.create() }) }) robotManager.get('currentState.name') // 'poweredDown' robotManager.transitionTo('poweredUp') robotManager.get('currentState.name') // 'poweredUp' robotManager.transitionTo('mobile') robotManager.get('currentState.name') // 'mobile' // transition via a state path robotManager.transitionTo('poweredDown.charging') robotManager.get('currentState.name') // 'charging' robotManager.get('currentState.path') // 'poweredDown.charging' Enter transition methods will be called for each state and nested child state in their hierarchical order. Exit methods will be called for each state and its nested states in reverse hierarchical order. Exit transitions for a parent state are not called when entering into one of its child states, only when transitioning to a new section of possible states in the hierarchy. robotManager = Ember.StateManager.create({ initialState: 'poweredDown', poweredDown: Ember.State.create({ enter: function(){}, exit: function(){ console.log("exited poweredDown state") }, charging: Ember.State.create({ enter: function(){}, exit: function(){} }), charged: Ember.State.create({ enter: function(){ console.log("entered charged state") }, exit: function(){ console.log("exited charged state") } }) }), poweredUp: Ember.State.create({ enter: function(){ console.log("entered poweredUp state") }, exit: function(){}, mobile: Ember.State.create({ enter: function(){ console.log("entered mobile state") }, exit: function(){} }), stationary: Ember.State.create({ enter: function(){}, exit: function(){} }) }) }) robotManager.get('currentState.path') // 'poweredDown' robotManager.transitionTo('charged') // logs 'entered charged state' // but does *not* log 'exited poweredDown state' robotManager.get('currentState.name') // 'charged robotManager.transitionTo('poweredUp.mobile') // logs // 'exited charged state' // 'exited poweredDown state' // 'entered poweredUp state' // 'entered mobile state' During development you can set a StateManager's `enableLogging` property to `true` to receive console messages of state transitions. robotManager = Ember.StateManager.create({ enableLogging: true }) ## Managing currentState with Actions To control which transitions between states are possible for a given state, StateManager can receive and route action messages to its states via the `send` method. Calling to `send` with an action name will begin searching for a method with the same name starting at the current state and moving up through the parent states in a state hierarchy until an appropriate method is found or the StateManager instance itself is reached. If an appropriately named method is found it will be called with the state manager as the first argument and an optional `context` object as the second argument. managerA = Ember.StateManager.create({ initialState: 'stateOne.substateOne.subsubstateOne', stateOne: Ember.State.create({ substateOne: Ember.State.create({ anAction: function(manager, context){ console.log("an action was called") }, subsubstateOne: Ember.State.create({}) }) }) }) managerA.get('currentState.name') // 'subsubstateOne' managerA.send('anAction') // 'stateOne.substateOne.subsubstateOne' has no anAction method // so the 'anAction' method of 'stateOne.substateOne' is called // and logs "an action was called" // with managerA as the first argument // and no second argument someObject = {} managerA.send('anAction', someObject) // the 'anAction' method of 'stateOne.substateOne' is called again // with managerA as the first argument and // someObject as the second argument. If the StateManager attempts to send an action but does not find an appropriately named method in the current state or while moving upwards through the state hierarchy it will throw a new Ember.Error. Action detection only moves upwards through the state hierarchy from the current state. It does not search in other portions of the hierarchy. managerB = Ember.StateManager.create({ initialState: 'stateOne.substateOne.subsubstateOne', stateOne: Ember.State.create({ substateOne: Ember.State.create({ subsubstateOne: Ember.State.create({}) }) }), stateTwo: Ember.State.create({ anAction: function(manager, context){ // will not be called below because it is // not a parent of the current state } }) }) managerB.get('currentState.name') // 'subsubstateOne' managerB.send('anAction') // Error: could not // respond to event anAction in state stateOne.substateOne.subsubstateOne. Inside of an action method the given state should delegate `transitionTo` calls on its StateManager. robotManager = Ember.StateManager.create({ initialState: 'poweredDown.charging', poweredDown: Ember.State.create({ charging: Ember.State.create({ chargeComplete: function(manager, context){ manager.transitionTo('charged') } }), charged: Ember.State.create({ boot: function(manager, context){ manager.transitionTo('poweredUp') } }) }), poweredUp: Ember.State.create({ beginExtermination: function(manager, context){ manager.transitionTo('rampaging') }, rampaging: Ember.State.create() }) }) robotManager.get('currentState.name') // 'charging' robotManager.send('boot') // throws error, no boot action // in current hierarchy robotManager.get('currentState.name') // remains 'charging' robotManager.send('beginExtermination') // throws error, no beginExtermination // action in current hierarchy robotManager.get('currentState.name') // remains 'charging' robotManager.send('chargeComplete') robotManager.get('currentState.name') // 'charged' robotManager.send('boot') robotManager.get('currentState.name') // 'poweredUp' robotManager.send('beginExtermination', allHumans) robotManager.get('currentState.name') // 'rampaging' Transition actions can also be created using the `transitionTo` method of the Ember.State class. The following example StateManagers are equivalent: aManager = Ember.StateManager.create({ stateOne: Ember.State.create({ changeToStateTwo: Ember.State.transitionTo('stateTwo') }), stateTwo: Ember.State.create({}) }) bManager = Ember.StateManager.create({ stateOne: Ember.State.create({ changeToStateTwo: function(manager, context){ manager.transitionTo('stateTwo', context) } }), stateTwo: Ember.State.create({}) }) @class StateManager @namespace Ember @extends Ember.State **/ Ember.StateManager = Ember.State.extend({ /** @private When creating a new statemanager, look for a default state to transition into. This state can either be named `start`, or can be specified using the `initialState` property. @method init */ init: function() { this._super(); set(this, 'stateMeta', Ember.Map.create()); var initialState = get(this, 'initialState'); if (!initialState && get(this, 'states.start')) { initialState = 'start'; } if (initialState) { this.transitionTo(initialState); Ember.assert('Failed to transition to initial state "' + initialState + '"', !!get(this, 'currentState')); } }, stateMetaFor: function(state) { var meta = get(this, 'stateMeta'), stateMeta = meta.get(state); if (!stateMeta) { stateMeta = {}; meta.set(state, stateMeta); } return stateMeta; }, setStateMeta: function(state, key, value) { return set(this.stateMetaFor(state), key, value); }, getStateMeta: function(state, key) { return get(this.stateMetaFor(state), key); }, /** The current state from among the manager's possible states. This property should not be set directly. Use `transitionTo` to move between states by name. @property currentState @type Ember.State */ currentState: null, /** The path of the current state. Returns a string representation of the current state. @property currentPath @type String */ currentPath: Ember.computed('currentState', function() { return get(this, 'currentState.path'); }), /** The name of transitionEvent that this stateManager will dispatch @property transitionEvent @type String @default 'setup' */ transitionEvent: 'setup', /** If set to true, `errorOnUnhandledEvents` will cause an exception to be raised if you attempt to send an event to a state manager that is not handled by the current state or any of its parent states. @property errorOnUnhandledEvents @type Boolean @default true */ errorOnUnhandledEvent: true, send: function(event) { var contexts, sendRecursiveArguments; Ember.assert('Cannot send event "' + event + '" while currentState is ' + get(this, 'currentState'), get(this, 'currentState')); contexts = [].slice.call(arguments, 1); sendRecursiveArguments = contexts; sendRecursiveArguments.unshift(event, get(this, 'currentState')); return this.sendRecursively.apply(this, sendRecursiveArguments); }, sendRecursively: function(event, currentState) { var log = this.enableLogging, action = currentState[event], contexts, sendRecursiveArguments, actionArguments; contexts = [].slice.call(arguments, 2); // Test to see if the action is a method that // can be invoked. Don't blindly check just for // existence, because it is possible the state // manager has a child state of the given name, // and we should still raise an exception in that // case. if (typeof action === 'function') { if (log) { Ember.Logger.log(fmt("STATEMANAGER: Sending event '%@' to state %@.", [event, get(currentState, 'path')])); } actionArguments = contexts; actionArguments.unshift(this); return action.apply(currentState, actionArguments); } else { var parentState = get(currentState, 'parentState'); if (parentState) { sendRecursiveArguments = contexts; sendRecursiveArguments.unshift(event, parentState); return this.sendRecursively.apply(this, sendRecursiveArguments); } else if (get(this, 'errorOnUnhandledEvent')) { throw new Ember.Error(this.toString() + " could not respond to event " + event + " in state " + get(this, 'currentState.path') + "."); } } }, /** Finds a state by its state path. Example: manager = Ember.StateManager.create({ root: Ember.State.create({ dashboard: Ember.State.create() }) }); manager.getStateByPath(manager, "root.dashboard") // returns the dashboard state @method getStateByPath @param {Ember.State} root the state to start searching from @param {String} path the state path to follow @return {Ember.State} the state at the end of the path */ getStateByPath: function(root, path) { var parts = path.split('.'), state = root; for (var i=0, len=parts.length; i`, an attempt to // transition to `comments.show` will match ``. // // First, this code will look for root.posts.show.comments.show. // Next, it will look for root.posts.comments.show. Finally, // it will look for `root.comments.show`, and find the state. // // After this process, the following variables will exist: // // * resolveState: a common parent state between the current // and target state. In the above example, `` is the // `resolveState`. // * enterStates: a list of all of the states represented // by the path from the `resolveState`. For example, for // the path `root.comments.show`, `enterStates` would have // `[, ]` // * exitStates: a list of all of the states from the // `resolveState` to the `currentState`. In the above // example, `exitStates` would have // `[`, `]`. while (resolveState && !enterStates) { exitStates.unshift(resolveState); resolveState = get(resolveState, 'parentState'); if (!resolveState) { enterStates = this.getStatesInPath(this, path); if (!enterStates) { Ember.assert('Could not find state for path: "'+path+'"'); return; } } enterStates = this.getStatesInPath(resolveState, path); } // If the path contains some states that are parents of both the // current state and the target state, remove them. // // For example, in the following hierarchy: // // |- root // | |- post // | | |- index (* current) // | | |- show // // If the `path` is `root.post.show`, the three variables will // be: // // * resolveState: `` // * enterStates: `[, , ]` // * exitStates: `[, , ]` // // The goal of this code is to remove the common states, so we // have: // // * resolveState: `` // * enterStates: `[]` // * exitStates: `[]` // // This avoid unnecessary calls to the enter and exit transitions. while (enterStates.length > 0 && enterStates[0] === exitStates[0]) { resolveState = enterStates.shift(); exitStates.shift(); } // Cache the enterStates, exitStates, and resolveState for the // current state and the `path`. var transitions = currentState.pathsCache[path] = { exitStates: exitStates, enterStates: enterStates, resolveState: resolveState }; return transitions; }, triggerSetupContext: function(transitions) { var contexts = transitions.contexts, offset = transitions.enterStates.length - contexts.length, enterStates = transitions.enterStates, transitionEvent = get(this, 'transitionEvent'); Ember.assert("More contexts provided than states", offset >= 0); arrayForEach.call(enterStates, function(state, idx) { state.trigger(transitionEvent, this, contexts[idx-offset]); }, this); }, getState: function(name) { var state = get(this, name), parentState = get(this, 'parentState'); if (state) { return state; } else if (parentState) { return parentState.getState(name); } }, enterState: function(transition) { var log = this.enableLogging; var exitStates = transition.exitStates.slice(0).reverse(); arrayForEach.call(exitStates, function(state) { state.trigger('exit', this); }, this); arrayForEach.call(transition.enterStates, function(state) { if (log) { Ember.Logger.log("STATEMANAGER: Entering " + get(state, 'path')); } state.trigger('enter', this); }, this); set(this, 'currentState', transition.finalState); } }); })(); (function() { /** Ember States @module ember @submodule ember-states @requires ember-runtime */ })(); (function() { var get = Ember.get; Ember._ResolvedState = Ember.Object.extend({ manager: null, state: null, match: null, object: Ember.computed(function(key, value) { if (arguments.length === 2) { this._object = value; return value; } else { if (this._object) { return this._object; } else { var state = get(this, 'state'), match = get(this, 'match'), manager = get(this, 'manager'); return state.deserialize(manager, match.hash); } } }).property(), hasPromise: Ember.computed(function() { return Ember.canInvoke(get(this, 'object'), 'then'); }).property('object'), promise: Ember.computed(function() { var object = get(this, 'object'); if (Ember.canInvoke(object, 'then')) { return object; } else { return { then: function(success) { success(object); } }; } }).property('object'), transition: function() { var manager = get(this, 'manager'), path = get(this, 'state.path'), object = get(this, 'object'); manager.transitionTo(path, object); } }); })(); (function() { /** @module ember @submodule ember-routing */ var get = Ember.get; // The Ember Routable mixin assumes the existance of a simple // routing shim that supports the following three behaviors: // // * .getURL() - this is called when the page loads // * .setURL(newURL) - this is called from within the state // manager when the state changes to a routable state // * .onURLChange(callback) - this happens when the user presses // the back or forward button var paramForClass = function(classObject) { var className = classObject.toString(), parts = className.split("."), last = parts[parts.length - 1]; return Ember.String.underscore(last) + "_id"; }; var merge = function(original, hash) { for (var prop in hash) { if (!hash.hasOwnProperty(prop)) { continue; } if (original.hasOwnProperty(prop)) { continue; } original[prop] = hash[prop]; } }; /** @class Routable @namespace Ember @extends Ember.Mixin */ Ember.Routable = Ember.Mixin.create({ init: function() { var redirection; this.on('setup', this, this.stashContext); if (redirection = get(this, 'redirectsTo')) { Ember.assert("You cannot use `redirectsTo` if you already have a `connectOutlets` method", this.connectOutlets === Ember.K); this.connectOutlets = function(router) { router.transitionTo(redirection); }; } // normalize empty route to '/' var route = get(this, 'route'); if (route === '') { route = '/'; } this._super(); Ember.assert("You cannot use `redirectsTo` on a state that has child states", !redirection || (!!redirection && !!get(this, 'isLeaf'))); }, setup: function() { return this.connectOutlets.apply(this, arguments); }, /** @private Whenever a routable state is entered, the context it was entered with is stashed so that we can regenerate the state's `absoluteURL` on demand. @method stashContext @param manager {Ember.StateManager} @param context */ stashContext: function(manager, context) { this.router = manager; var serialized = this.serialize(manager, context); Ember.assert('serialize must return a hash', !serialized || typeof serialized === 'object'); manager.setStateMeta(this, 'context', context); manager.setStateMeta(this, 'serialized', serialized); if (get(this, 'isRoutable') && !get(manager, 'isRouting')) { this.updateRoute(manager, get(manager, 'location')); } }, /** @private Whenever a routable state is entered, the router's location object is notified to set the URL to the current absolute path. In general, this will update the browser's URL. @method updateRoute @param manager {Ember.StateManager} @param location {Ember.Location} */ updateRoute: function(manager, location) { if (get(this, 'isLeafRoute')) { var path = this.absoluteRoute(manager); location.setURL(path); } }, /** @private Get the absolute route for the current state and a given hash. This method is private, as it expects a serialized hash, not the original context object. @method absoluteRoute @param manager {Ember.StateManager} @param hash {Hash} */ absoluteRoute: function(manager, hash) { var parentState = get(this, 'parentState'); var path = '', generated; // If the parent state is routable, use its current path // as this route's prefix. if (get(parentState, 'isRoutable')) { path = parentState.absoluteRoute(manager, hash); } var matcher = get(this, 'routeMatcher'), serialized = manager.getStateMeta(this, 'serialized'); // merge the existing serialized object in with the passed // in hash. hash = hash || {}; merge(hash, serialized); generated = matcher && matcher.generate(hash); if (generated) { path = path + '/' + generated; } return path; }, /** @private At the moment, a state is routable if it has a string `route` property. This heuristic may change. @property isRoutable @type Boolean */ isRoutable: Ember.computed(function() { return typeof get(this, 'route') === 'string'; }), /** @private Determine if this is the last routeable state @property isLeafRoute @type Boolean */ isLeafRoute: Ember.computed(function() { if (get(this, 'isLeaf')) { return true; } return !get(this, 'childStates').findProperty('isRoutable'); }), /** @private A _RouteMatcher object generated from the current route's `route` string property. @property routeMatcher @type Ember._RouteMatcher */ routeMatcher: Ember.computed(function() { var route = get(this, 'route'); if (route) { return Ember._RouteMatcher.create({ route: route, dynamicSegmentPattern: get(this, 'dynamicSegmentPattern'), dynamicSegmentTerminators: get(this, 'dynamicSegmentTerminators') }); } }), /** @private Check whether the route has dynamic segments and therefore takes a context. @property hasContext @type Boolean */ hasContext: Ember.computed(function() { var routeMatcher = get(this, 'routeMatcher'); if (routeMatcher) { return routeMatcher.identifiers.length > 0; } }), /** @private The model class associated with the current state. This property uses the `modelType` property, in order to allow it to be specified as a String. @property modelClass @type Ember.Object */ modelClass: Ember.computed(function() { var modelType = get(this, 'modelType'); if (typeof modelType === 'string') { return Ember.get(Ember.lookup, modelType); } else { return modelType; } }), /** @private Get the model class for the state. The heuristic is: * The state must have a single dynamic segment * The dynamic segment must end in `_id` * A dynamic segment like `blog_post_id` is converted into `BlogPost` * The name is then looked up on the passed in namespace The process of initializing an application with a router will pass the application's namespace into the router, which will be used here. @method modelClassFor @param namespace {Ember.Namespace} */ modelClassFor: function(namespace) { var modelClass, routeMatcher, identifiers, match, className; // if an explicit modelType was specified, use that if (modelClass = get(this, 'modelClass')) { return modelClass; } // if the router has no lookup namespace, we won't be able to guess // the modelType if (!namespace) { return; } // make sure this state is actually a routable state routeMatcher = get(this, 'routeMatcher'); if (!routeMatcher) { return; } // only guess modelType for states with a single dynamic segment // (no more, no fewer) identifiers = routeMatcher.identifiers; if (identifiers.length !== 2) { return; } // extract the `_id` from the end of the dynamic segment; if the // dynamic segment does not end in `_id`, we can't guess the // modelType match = identifiers[1].match(/^(.*)_id$/); if (!match) { return; } // convert the underscored type into a class form and look it up // on the router's namespace className = Ember.String.classify(match[1]); return get(namespace, className); }, /** The default method that takes a `params` object and converts it into an object. By default, a params hash that looks like `{ post_id: 1 }` will be looked up as `namespace.Post.find(1)`. This is designed to work seamlessly with Ember Data, but will work fine with any class that has a `find` method. @method deserialize @param manager {Ember.StateManager} @param params {Hash} */ deserialize: function(manager, params) { var modelClass, routeMatcher, param; if (modelClass = this.modelClassFor(get(manager, 'namespace'))) { Ember.assert("Expected "+modelClass.toString()+" to implement `find` for use in '"+this.get('path')+"' `deserialize`. Please implement the `find` method or overwrite `deserialize`.", modelClass.find); return modelClass.find(params[paramForClass(modelClass)]); } return params; }, /** The default method that takes an object and converts it into a params hash. By default, if there is a single dynamic segment named `blog_post_id` and the object is a `BlogPost` with an `id` of `12`, the serialize method will produce: { blog_post_id: 12 } @method serialize @param manager {Ember.StateManager} @param context */ serialize: function(manager, context) { var modelClass, routeMatcher, namespace, param, id; if (Ember.empty(context)) { return ''; } if (modelClass = this.modelClassFor(get(manager, 'namespace'))) { param = paramForClass(modelClass); id = get(context, 'id'); context = {}; context[param] = id; } return context; }, /** @private @method resolvePath @param manager {Ember.StateManager} @param path {String} */ resolvePath: function(manager, path) { if (get(this, 'isLeafRoute')) { return Ember.A(); } var childStates = get(this, 'childStates'), match; childStates = Ember.A(childStates.filterProperty('isRoutable')); childStates = childStates.sort(function(a, b) { var aDynamicSegments = get(a, 'routeMatcher.identifiers.length'), bDynamicSegments = get(b, 'routeMatcher.identifiers.length'), aRoute = get(a, 'route'), bRoute = get(b, 'route'), aIndex = a.get('index'), bIndex = b.get('index'); if( (aIndex || aIndex == 0) && (bIndex || bIndex == 0) ) { return aIndex - bIndex } if (aRoute.indexOf(bRoute) === 0) { return -1; } else if (bRoute.indexOf(aRoute) === 0) { return 1; } if (aDynamicSegments !== bDynamicSegments) { return aDynamicSegments - bDynamicSegments; } return get(b, 'route.length') - get(a, 'route.length'); }); var state = childStates.find(function(state) { var matcher = get(state, 'routeMatcher'); if (match = matcher.match(path)) { return true; } }); Ember.assert("Could not find state for path " + path, !!state); var resolvedState = Ember._ResolvedState.create({ manager: manager, state: state, match: match }); var states = state.resolvePath(manager, match.remaining); return Ember.A([resolvedState]).pushObjects(states); }, /** @private Once `unroute` has finished unwinding, `routePath` will be called with the remainder of the route. For example, if you were in the /posts/1/comments state, and you moved into the /posts/2/comments state, `routePath` will be called on the state whose path is `/posts` with the path `/2/comments`. @method routePath @param manager {Ember.StateManager} @param path {String} */ routePath: function(manager, path) { if (get(this, 'isLeafRoute')) { return; } var resolvedStates = this.resolvePath(manager, path), hasPromises = resolvedStates.some(function(s) { return get(s, 'hasPromise'); }); function runTransition() { resolvedStates.forEach(function(rs) { rs.transition(); }); } if (hasPromises) { manager.transitionTo('loading'); Ember.assert('Loading state should be the child of a route', Ember.Routable.detect(get(manager, 'currentState.parentState'))); Ember.assert('Loading state should not be a route', !Ember.Routable.detect(get(manager, 'currentState'))); manager.handleStatePromises(resolvedStates, runTransition); } else { runTransition(); } }, /** @private When you move to a new route by pressing the back or forward button, this method is called first. Its job is to move the state manager into a parent state of the state it will eventually move into. @method unroutePath @param router {Ember.Router} @param path {String} */ unroutePath: function(router, path) { var parentState = get(this, 'parentState'); // If we're at the root state, we're done if (parentState === router) { return; } path = path.replace(/^(?=[^\/])/, "/"); var absolutePath = this.absoluteRoute(router); var route = get(this, 'route'); // If the current path is empty, move up one state, // because the index ('/') state must be a leaf node. if (route !== '/') { // If the current path is a prefix of the path we're trying // to go to, we're done. var index = path.indexOf(absolutePath), next = path.charAt(absolutePath.length); if (index === 0 && (next === "/" || next === "")) { return; } } // Transition to the parent and call unroute again. router.enterState({ exitStates: [this], enterStates: [], finalState: parentState }); router.send('unroutePath', path); }, parentTemplate: Ember.computed(function() { var state = this, parentState, template; while (state = get(state, 'parentState')) { if (template = get(state, 'template')) { return template; } } return 'application'; }), _template: Ember.computed(function(key, value) { if (arguments.length > 1) { return value; } if (value = get(this, 'template')) { return value; } // If no template was explicitly supplied convert // the class name into a template name. For example, // App.PostRoute will return `post`. var className = this.constructor.toString(), baseName; if (/^[^\[].*Route$/.test(className)) { baseName = className.match(/([^\.]+\.)*([^\.]+)/)[2]; baseName = baseName.replace(/Route$/, ''); return baseName.charAt(0).toLowerCase() + baseName.substr(1); } }), render: function(options) { options = options || {}; var template = options.template || get(this, '_template'), parentTemplate = options.into || get(this, 'parentTemplate'), controller = get(this.router, parentTemplate + "Controller"); var viewName = Ember.String.classify(template) + "View", viewClass = get(get(this.router, 'namespace'), viewName); viewClass = (viewClass || Ember.View).extend({ templateName: template }); controller.set('view', viewClass.create()); }, /** The `connectOutlets` event will be triggered once a state has been entered. It will be called with the route's context. @event connectOutlets @param router {Ember.Router} @param [context*] */ connectOutlets: Ember.K, /** The `navigateAway` event will be triggered when the URL changes due to the back/forward button @event navigateAway */ navigateAway: Ember.K }); })(); (function() { /** @module ember @submodule ember-routing */ /** @class Route @namespace Ember @extends Ember.State @uses Ember.Routable */ Ember.Route = Ember.State.extend(Ember.Routable); })(); (function() { var escapeForRegex = function(text) { return text.replace(/[\-\[\]{}()*+?.,\\\^\$|#\s]/g, "\\$&"); }; /** @class _RouteMatcher @namespace Ember @private @extends Ember.Object */ Ember._RouteMatcher = Ember.Object.extend({ state: null, init: function() { var route = this.route, dynamicSegmentPattern = this.dynamicSegmentPattern || "([^/]+)", terminators = this.dynamicSegmentTerminators || [], identifiers = [], count = 1, escaped, segmentRegexp; // Strip off leading slash if present if (route.charAt(0) === '/') { route = this.route = route.substr(1); } escaped = escapeForRegex(route); terminators.push('$|/'); str = ':([a-z_]+)(?=' + terminators.join('|') + ')' segmentRegexp = new RegExp(str, 'gi'); var regex = escaped.replace(segmentRegexp, function(match, id) { identifiers[count++] = id; return dynamicSegmentPattern; }); this.identifiers = identifiers; this.regex = new RegExp("^/?" + regex); }, match: function(path) { var match = path.match(this.regex); if (match) { var identifiers = this.identifiers, hash = {}; for (var i=1, l=identifiers.length; i 0 ? hash : null }; } }, generate: function(hash) { var identifiers = this.identifiers, route = this.route, id; for (var i=1, l=identifiers.length; i

{{title}}

``` Will delegate `click` events on the rendered `h1` to the application's router instance. In this case the `anActionOnTheRouter` method of the state at 'root.aRoute' will be called with the view's controller as the context argument. This context will be passed to the `connectOutlets` as its second argument. Different `context` can be supplied from within the `{{action}}` helper, allowing specific context passing between application states: ``` handlebars ``` See `Handlebars.helpers.action` for additional usage examples. ## Changing View Hierarchy in Response To State Change Changes in application state that change the URL should be accompanied by associated changes in view hierarchy. This can be accomplished by calling 'connectOutlet' on the injected controller singletons from within the 'connectOutlets' event of an Ember.Route: ``` javascript App = Ember.Application.create({ OneController: Ember.ObjectController.extend(), OneView: Ember.View.extend(), AnotherController: Ember.ObjectController.extend(), AnotherView: Ember.View.extend(), Router: Ember.Router.extend({ root: Ember.Route.extend({ aRoute: Ember.Route.extend({ route: '/', connectOutlets: function(router, context) { router.get('oneController').connectOutlet('another'); }, }) }) }) }); App.initialize(); ``` This will detect the '{{outlet}}' portion of `oneController`'s view (an instance of `App.OneView`) and fill it with a rendered instance of `App.AnotherView` whose `context` will be the single instance of `App.AnotherController` stored on the router in the `anotherController` property. For more information about Outlets, see `Ember.Handlebars.helpers.outlet`. For additional information on the `connectOutlet` method, see `Ember.Controller.connectOutlet`. For more information on controller injections, see `Ember.Application#initialize()`. For additional information about view context, see `Ember.View`. @class Router @namespace Ember @extends Ember.StateManager */ Ember.Router = Ember.StateManager.extend( /** @scope Ember.Router.prototype */ { /** @property initialState @type String @default 'root' */ initialState: 'root', /** The `Ember.Location` implementation to be used to manage the application URL state. The following values are supported: * 'hash': Uses URL fragment identifiers (like #/blog/1) for routing. * 'history': Uses the browser's history.pushstate API for routing. Only works in modern browsers with pushstate support. * 'none': Does not read or set the browser URL, but still allows for routing to happen. Useful for testing. @property location @type String @default 'hash' */ location: 'hash', /** This is only used when a history location is used so that applications that don't live at the root of the domain can append paths to their root. @property rootURL @type String @default '/' */ rootURL: '/', transitionTo: function() { this.abortRoutingPromises(); this._super.apply(this, arguments); }, route: function(path) { this.abortRoutingPromises(); set(this, 'isRouting', true); var routableState; try { path = path.replace(get(this, 'rootURL'), ''); path = path.replace(/^(?=[^\/])/, "/"); this.send('navigateAway'); this.send('unroutePath', path); routableState = get(this, 'currentState'); while (routableState && !routableState.get('isRoutable')) { routableState = get(routableState, 'parentState'); } var currentURL = routableState ? routableState.absoluteRoute(this) : ''; var rest = path.substr(currentURL.length); this.send('routePath', rest); } finally { set(this, 'isRouting', false); } routableState = get(this, 'currentState'); while (routableState && !routableState.get('isRoutable')) { routableState = get(routableState, 'parentState'); } if (routableState) { routableState.updateRoute(this, get(this, 'location')); } }, urlFor: function(path, hash) { var currentState = get(this, 'currentState') || this, state = this.findStateByPath(currentState, path); Ember.assert(Ember.String.fmt("Could not find route with path '%@'", [path]), state); Ember.assert(Ember.String.fmt("To get a URL for the state '%@', it must have a `route` property.", [path]), get(state, 'routeMatcher')); var location = get(this, 'location'), absoluteRoute = state.absoluteRoute(this, hash); return location.formatURL(absoluteRoute); }, urlForEvent: function(eventName) { var contexts = Array.prototype.slice.call(arguments, 1); var currentState = get(this, 'currentState'); var targetStateName = currentState.lookupEventTransition(eventName); Ember.assert(Ember.String.fmt("You must specify a target state for event '%@' in order to link to it in the current state '%@'.", [eventName, get(currentState, 'path')]), targetStateName); var targetState = this.findStateByPath(currentState, targetStateName); Ember.assert("Your target state name " + targetStateName + " for event " + eventName + " did not resolve to a state", targetState); var hash = this.serializeRecursively(targetState, contexts, {}); return this.urlFor(targetStateName, hash); }, serializeRecursively: function(state, contexts, hash) { var parentState, context = get(state, 'hasContext') ? contexts.pop() : null; merge(hash, state.serialize(this, context)); parentState = state.get("parentState"); if (parentState && parentState instanceof Ember.Route) { return this.serializeRecursively(parentState, contexts, hash); } else { return hash; } }, abortRoutingPromises: function() { if (this._routingPromises) { this._routingPromises.abort(); this._routingPromises = null; } }, handleStatePromises: function(states, complete) { this.abortRoutingPromises(); this.set('isLocked', true); var manager = this; this._routingPromises = Ember._PromiseChain.create({ promises: states.slice(), successCallback: function() { manager.set('isLocked', false); complete(); }, failureCallback: function() { throw "Unable to load object"; }, promiseSuccessCallback: function(item, args) { set(item, 'object', args[0]); }, abortCallback: function() { manager.set('isLocked', false); } }).start(); }, moveStatesIntoRoot: function() { this.root = Ember.Route.extend(); for (var name in this) { if (name === "constructor") { continue; } var state = this[name]; if (state instanceof Ember.Route || Ember.Route.detect(state)) { this.root[name] = state; delete this[name]; } } }, init: function() { if (!this.root) { this.moveStatesIntoRoot(); } this._super(); var location = get(this, 'location'), rootURL = get(this, 'rootURL'); if ('string' === typeof location) { set(this, 'location', Ember.Location.create({ implementation: location, rootURL: rootURL })); } this.assignRouter(this, this); }, assignRouter: function(state, router) { state.router = router; var childStates = state.states; if (childStates) { for (var stateName in childStates) { if (!childStates.hasOwnProperty(stateName)) { continue; } this.assignRouter(childStates[stateName], router); } } }, willDestroy: function() { get(this, 'location').destroy(); } }); })(); (function() { /** Ember Routing @module ember @submodule ember-routing @requires ember-states */ })(); (function() { // ========================================================================== // Project: metamorph // Copyright: ©2011 My Company Inc. All rights reserved. // ========================================================================== (function(window) { var K = function(){}, guid = 0, document = window.document, // Feature-detect the W3C range API, the extended check is for IE9 which only partially supports ranges supportsRange = ('createRange' in document) && (typeof Range !== 'undefined') && Range.prototype.createContextualFragment, // Internet Explorer prior to 9 does not allow setting innerHTML if the first element // is a "zero-scope" element. This problem can be worked around by making // the first node an invisible text node. We, like Modernizr, use ­ needsShy = (function(){ var testEl = document.createElement('div'); testEl.innerHTML = "
"; testEl.firstChild.innerHTML = ""; return testEl.firstChild.innerHTML === ''; })(); // Constructor that supports either Metamorph('foo') or new // Metamorph('foo'); // // Takes a string of HTML as the argument. var Metamorph = function(html) { var self; if (this instanceof Metamorph) { self = this; } else { self = new K(); } self.innerHTML = html; var myGuid = 'metamorph-'+(guid++); self.start = myGuid + '-start'; self.end = myGuid + '-end'; return self; }; K.prototype = Metamorph.prototype; var rangeFor, htmlFunc, removeFunc, outerHTMLFunc, appendToFunc, afterFunc, prependFunc, startTagFunc, endTagFunc; outerHTMLFunc = function() { return this.startTag() + this.innerHTML + this.endTag(); }; startTagFunc = function() { return ""; }; endTagFunc = function() { return ""; }; // If we have the W3C range API, this process is relatively straight forward. if (supportsRange) { // Get a range for the current morph. Optionally include the starting and // ending placeholders. rangeFor = function(morph, outerToo) { var range = document.createRange(); var before = document.getElementById(morph.start); var after = document.getElementById(morph.end); if (outerToo) { range.setStartBefore(before); range.setEndAfter(after); } else { range.setStartAfter(before); range.setEndBefore(after); } return range; }; htmlFunc = function(html, outerToo) { // get a range for the current metamorph object var range = rangeFor(this, outerToo); // delete the contents of the range, which will be the // nodes between the starting and ending placeholder. range.deleteContents(); // create a new document fragment for the HTML var fragment = range.createContextualFragment(html); // insert the fragment into the range range.insertNode(fragment); }; removeFunc = function() { // get a range for the current metamorph object including // the starting and ending placeholders. var range = rangeFor(this, true); // delete the entire range. range.deleteContents(); }; appendToFunc = function(node) { var range = document.createRange(); range.setStart(node); range.collapse(false); var frag = range.createContextualFragment(this.outerHTML()); node.appendChild(frag); }; afterFunc = function(html) { var range = document.createRange(); var after = document.getElementById(this.end); range.setStartAfter(after); range.setEndAfter(after); var fragment = range.createContextualFragment(html); range.insertNode(fragment); }; prependFunc = function(html) { var range = document.createRange(); var start = document.getElementById(this.start); range.setStartAfter(start); range.setEndAfter(start); var fragment = range.createContextualFragment(html); range.insertNode(fragment); }; } else { /** * This code is mostly taken from jQuery, with one exception. In jQuery's case, we * have some HTML and we need to figure out how to convert it into some nodes. * * In this case, jQuery needs to scan the HTML looking for an opening tag and use * that as the key for the wrap map. In our case, we know the parent node, and * can use its type as the key for the wrap map. **/ var wrapMap = { select: [ 1, "" ], fieldset: [ 1, "
", "
" ], table: [ 1, "
", "
" ], tbody: [ 2, "", "
" ], tr: [ 3, "", "
" ], colgroup: [ 2, "", "
" ], map: [ 1, "", "" ], _default: [ 0, "", "" ] }; /** * Given a parent node and some HTML, generate a set of nodes. Return the first * node, which will allow us to traverse the rest using nextSibling. * * We need to do this because innerHTML in IE does not really parse the nodes. **/ var firstNodeFor = function(parentNode, html) { var arr = wrapMap[parentNode.tagName.toLowerCase()] || wrapMap._default; var depth = arr[0], start = arr[1], end = arr[2]; if (needsShy) { html = '­'+html; } var element = document.createElement('div'); element.innerHTML = start + html + end; for (var i=0; i<=depth; i++) { element = element.firstChild; } // Look for ­ to remove it. if (needsShy) { var shyElement = element; // Sometimes we get nameless elements with the shy inside while (shyElement.nodeType === 1 && !shyElement.nodeName) { shyElement = shyElement.firstChild; } // At this point it's the actual unicode character. if (shyElement.nodeType === 3 && shyElement.nodeValue.charAt(0) === "\u00AD") { shyElement.nodeValue = shyElement.nodeValue.slice(1); } } return element; }; /** * In some cases, Internet Explorer can create an anonymous node in * the hierarchy with no tagName. You can create this scenario via: * * div = document.createElement("div"); * div.innerHTML = "­
hi
"; * div.firstChild.firstChild.tagName //=> "" * * If our script markers are inside such a node, we need to find that * node and use *it* as the marker. **/ var realNode = function(start) { while (start.parentNode.tagName === "") { start = start.parentNode; } return start; }; /** * When automatically adding a tbody, Internet Explorer inserts the * tbody immediately before the first . Other browsers create it * before the first node, no matter what. * * This means the the following code: * * div = document.createElement("div"); * div.innerHTML = "
hi
* * Generates the following DOM in IE: * * + div * + table * - script id='first' * + tbody * + tr * + td * - "hi" * - script id='last' * * Which means that the two script tags, even though they were * inserted at the same point in the hierarchy in the original * HTML, now have different parents. * * This code reparents the first script tag by making it the tbody's * first child. **/ var fixParentage = function(start, end) { if (start.parentNode !== end.parentNode) { end.parentNode.insertBefore(start, end.parentNode.firstChild); } }; htmlFunc = function(html, outerToo) { // get the real starting node. see realNode for details. var start = realNode(document.getElementById(this.start)); var end = document.getElementById(this.end); var parentNode = end.parentNode; var node, nextSibling, last; // make sure that the start and end nodes share the same // parent. If not, fix it. fixParentage(start, end); // remove all of the nodes after the starting placeholder and // before the ending placeholder. node = start.nextSibling; while (node) { nextSibling = node.nextSibling; last = node === end; // if this is the last node, and we want to remove it as well, // set the `end` node to the next sibling. This is because // for the rest of the function, we insert the new nodes // before the end (note that insertBefore(node, null) is // the same as appendChild(node)). // // if we do not want to remove it, just break. if (last) { if (outerToo) { end = node.nextSibling; } else { break; } } node.parentNode.removeChild(node); // if this is the last node and we didn't break before // (because we wanted to remove the outer nodes), break // now. if (last) { break; } node = nextSibling; } // get the first node for the HTML string, even in cases like // tables and lists where a simple innerHTML on a div would // swallow some of the content. node = firstNodeFor(start.parentNode, html); // copy the nodes for the HTML between the starting and ending // placeholder. while (node) { nextSibling = node.nextSibling; parentNode.insertBefore(node, end); node = nextSibling; } }; // remove the nodes in the DOM representing this metamorph. // // this includes the starting and ending placeholders. removeFunc = function() { var start = realNode(document.getElementById(this.start)); var end = document.getElementById(this.end); this.html(''); start.parentNode.removeChild(start); end.parentNode.removeChild(end); }; appendToFunc = function(parentNode) { var node = firstNodeFor(parentNode, this.outerHTML()); while (node) { nextSibling = node.nextSibling; parentNode.appendChild(node); node = nextSibling; } }; afterFunc = function(html) { // get the real starting node. see realNode for details. var end = document.getElementById(this.end); var insertBefore = end.nextSibling; var parentNode = end.parentNode; var nextSibling; var node; // get the first node for the HTML string, even in cases like // tables and lists where a simple innerHTML on a div would // swallow some of the content. node = firstNodeFor(parentNode, html); // copy the nodes for the HTML between the starting and ending // placeholder. while (node) { nextSibling = node.nextSibling; parentNode.insertBefore(node, insertBefore); node = nextSibling; } }; prependFunc = function(html) { var start = document.getElementById(this.start); var parentNode = start.parentNode; var nextSibling; var node; node = firstNodeFor(parentNode, html); var insertBefore = start.nextSibling; while (node) { nextSibling = node.nextSibling; parentNode.insertBefore(node, insertBefore); node = nextSibling; } } } Metamorph.prototype.html = function(html) { this.checkRemoved(); if (html === undefined) { return this.innerHTML; } htmlFunc.call(this, html); this.innerHTML = html; }; Metamorph.prototype.replaceWith = function(html) { this.checkRemoved(); htmlFunc.call(this, html, true); }; Metamorph.prototype.remove = removeFunc; Metamorph.prototype.outerHTML = outerHTMLFunc; Metamorph.prototype.appendTo = appendToFunc; Metamorph.prototype.after = afterFunc; Metamorph.prototype.prepend = prependFunc; Metamorph.prototype.startTag = startTagFunc; Metamorph.prototype.endTag = endTagFunc; Metamorph.prototype.isRemoved = function() { var before = document.getElementById(this.start); var after = document.getElementById(this.end); return !before || !after; }; Metamorph.prototype.checkRemoved = function() { if (this.isRemoved()) { throw new Error("Cannot perform operations on a Metamorph that is not in the DOM."); } }; window.Metamorph = Metamorph; })(this); })(); (function() { /** @module ember @submodule ember-handlebars */ var objectCreate = Ember.create; var Handlebars = Ember.imports.Handlebars; Ember.assert("Ember Handlebars requires Handlebars 1.0.beta.5 or greater", Handlebars && Handlebars.VERSION.match(/^1\.0\.beta\.[56789]$|^1\.0\.rc\.[123456789]+/)); /** Prepares the Handlebars templating library for use inside Ember's view system. The Ember.Handlebars object is the standard Handlebars library, extended to use Ember's get() method instead of direct property access, which allows computed properties to be used inside templates. To create an Ember.Handlebars template, call Ember.Handlebars.compile(). This will return a function that can be used by Ember.View for rendering. @class Handlebars @namespace Ember */ Ember.Handlebars = objectCreate(Handlebars); /** @class helpers @namespace Ember.Handlebars */ Ember.Handlebars.helpers = objectCreate(Handlebars.helpers); /** Override the the opcode compiler and JavaScript compiler for Handlebars. @class Compiler @namespace Ember.Handlebars @private @constructor */ Ember.Handlebars.Compiler = function() {}; // Handlebars.Compiler doesn't exist in runtime-only if (Handlebars.Compiler) { Ember.Handlebars.Compiler.prototype = objectCreate(Handlebars.Compiler.prototype); } Ember.Handlebars.Compiler.prototype.compiler = Ember.Handlebars.Compiler; /** @class JavaScriptCompiler @namespace Ember.Handlebars @private @constructor */ Ember.Handlebars.JavaScriptCompiler = function() {}; // Handlebars.JavaScriptCompiler doesn't exist in runtime-only if (Handlebars.JavaScriptCompiler) { Ember.Handlebars.JavaScriptCompiler.prototype = objectCreate(Handlebars.JavaScriptCompiler.prototype); Ember.Handlebars.JavaScriptCompiler.prototype.compiler = Ember.Handlebars.JavaScriptCompiler; } Ember.Handlebars.JavaScriptCompiler.prototype.namespace = "Ember.Handlebars"; Ember.Handlebars.JavaScriptCompiler.prototype.initializeBuffer = function() { return "''"; }; /** @private Override the default buffer for Ember Handlebars. By default, Handlebars creates an empty String at the beginning of each invocation and appends to it. Ember's Handlebars overrides this to append to a single shared buffer. @method appendToBuffer @param string {String} */ Ember.Handlebars.JavaScriptCompiler.prototype.appendToBuffer = function(string) { return "data.buffer.push("+string+");"; }; /** @private Rewrite simple mustaches from `{{foo}}` to `{{bind "foo"}}`. This means that all simple mustaches in Ember's Handlebars will also set up an observer to keep the DOM up to date when the underlying property changes. @method mustache @for Ember.Handlebars.Compiler @param mustache */ Ember.Handlebars.Compiler.prototype.mustache = function(mustache) { if (mustache.params.length || mustache.hash) { return Handlebars.Compiler.prototype.mustache.call(this, mustache); } else { var id = new Handlebars.AST.IdNode(['_triageMustache']); // Update the mustache node to include a hash value indicating whether the original node // was escaped. This will allow us to properly escape values when the underlying value // changes and we need to re-render the value. if(!mustache.escaped) { mustache.hash = mustache.hash || new Handlebars.AST.HashNode([]); mustache.hash.pairs.push(["unescaped", new Handlebars.AST.StringNode("true")]); } mustache = new Handlebars.AST.MustacheNode([id].concat([mustache.id]), mustache.hash, !mustache.escaped); return Handlebars.Compiler.prototype.mustache.call(this, mustache); } }; /** Used for precompilation of Ember Handlebars templates. This will not be used during normal app execution. @method precompile @for Ember.Handlebars @static @param {String} string The template to precompile */ Ember.Handlebars.precompile = function(string) { var ast = Handlebars.parse(string); var options = { knownHelpers: { action: true, unbound: true, bindAttr: true, template: true, view: true, _triageMustache: true }, data: true, stringParams: true }; var environment = new Ember.Handlebars.Compiler().compile(ast, options); return new Ember.Handlebars.JavaScriptCompiler().compile(environment, options, undefined, true); }; // We don't support this for Handlebars runtime-only if (Handlebars.compile) { /** The entry point for Ember Handlebars. This replaces the default Handlebars.compile and turns on template-local data and String parameters. @method compile @for Ember.Handlebars @static @param {String} string The template to compile @return {Function} */ Ember.Handlebars.compile = function(string) { var ast = Handlebars.parse(string); var options = { data: true, stringParams: true }; var environment = new Ember.Handlebars.Compiler().compile(ast, options); var templateSpec = new Ember.Handlebars.JavaScriptCompiler().compile(environment, options, undefined, true); return Handlebars.template(templateSpec); }; } /** @private If a path starts with a reserved keyword, returns the root that should be used. @method normalizePath @for Ember @param root {Object} @param path {String} @param data {Hash} */ var normalizePath = Ember.Handlebars.normalizePath = function(root, path, data) { var keywords = (data && data.keywords) || {}, keyword, isKeyword; // Get the first segment of the path. For example, if the // path is "foo.bar.baz", returns "foo". keyword = path.split('.', 1)[0]; // Test to see if the first path is a keyword that has been // passed along in the view's data hash. If so, we will treat // that object as the new root. if (keywords.hasOwnProperty(keyword)) { // Look up the value in the template's data hash. root = keywords[keyword]; isKeyword = true; // Handle cases where the entire path is the reserved // word. In that case, return the object itself. if (path === keyword) { path = ''; } else { // Strip the keyword from the path and look up // the remainder from the newly found root. path = path.substr(keyword.length+1); } } return { root: root, path: path, isKeyword: isKeyword }; }; /** Lookup both on root and on window. If the path starts with a keyword, the corresponding object will be looked up in the template's data hash and used to resolve the path. @method getPath @for Ember.Handlebars @param {Object} root The object to look up the property on @param {String} path The path to be lookedup @param {Object} options The template's option hash */ Ember.Handlebars.getPath = function(root, path, options) { var data = options && options.data, normalizedPath = normalizePath(root, path, data), value; // In cases where the path begins with a keyword, change the // root to the value represented by that keyword, and ensure // the path is relative to it. root = normalizedPath.root; path = normalizedPath.path; value = Ember.get(root, path); // If the path starts with a capital letter, look it up on Ember.lookup, // which defaults to the `window` object in browsers. if (value === undefined && root !== Ember.lookup && Ember.isGlobalPath(path)) { value = Ember.get(Ember.lookup, path); } return value; }; /** @private Registers a helper in Handlebars that will be called if no property with the given name can be found on the current context object, and no helper with that name is registered. This throws an exception with a more helpful error message so the user can track down where the problem is happening. @method helperMissing @for Ember.Handlebars.helpers @param {String} path @param {Hash} options */ Ember.Handlebars.registerHelper('helperMissing', function(path, options) { var error, view = ""; error = "%@ Handlebars error: Could not find property '%@' on object %@."; if (options.data){ view = options.data.view; } throw new Ember.Error(Ember.String.fmt(error, [view, path, this])); }); })(); (function() { /** @method htmlSafe @for Ember.String @static */ Ember.String.htmlSafe = function(str) { return new Handlebars.SafeString(str); }; var htmlSafe = Ember.String.htmlSafe; if (Ember.EXTEND_PROTOTYPES === true || Ember.EXTEND_PROTOTYPES.String) { /** See {{#crossLink "Ember.String/htmlSafe"}}{{/crossLink}} @method htmlSafe @for String */ String.prototype.htmlSafe = function() { return htmlSafe(this); }; } })(); (function() { /*jshint newcap:false*/ /** @module ember @submodule ember-handlebars */ var set = Ember.set, get = Ember.get; // DOMManager should just abstract dom manipulation between jquery and metamorph var DOMManager = { remove: function(view) { view.morph.remove(); }, prepend: function(view, html) { view.morph.prepend(html); }, after: function(view, html) { view.morph.after(html); }, html: function(view, html) { view.morph.html(html); }, // This is messed up. replace: function(view) { var morph = view.morph; view.transitionTo('preRender'); view.clearRenderedChildren(); var buffer = view.renderToBuffer(); Ember.run.schedule('render', this, function() { if (get(view, 'isDestroyed')) { return; } view.invalidateRecursively('element'); view._notifyWillInsertElement(); morph.replaceWith(buffer.string()); view.transitionTo('inDOM'); view._notifyDidInsertElement(); }); }, empty: function(view) { view.morph.html(""); } }; // The `morph` and `outerHTML` properties are internal only // and not observable. /** @class _Metamorph @namespace Ember @extends Ember.Mixin @private */ Ember._Metamorph = Ember.Mixin.create({ isVirtual: true, tagName: '', instrumentName: 'render.metamorph', init: function() { this._super(); this.morph = Metamorph(); }, beforeRender: function(buffer) { buffer.push(this.morph.startTag()); }, afterRender: function(buffer) { buffer.push(this.morph.endTag()); }, createElement: function() { var buffer = this.renderToBuffer(); this.outerHTML = buffer.string(); this.clearBuffer(); }, domManager: DOMManager }); /** @class _MetamorphView @namespace Ember @extends Ember.View @uses Ember._Metamorph @private */ Ember._MetamorphView = Ember.View.extend(Ember._Metamorph); /** @class _SimpleMetamorphView @namespace Ember @extends Ember.View @uses Ember._Metamorph @private */ Ember._SimpleMetamorphView = Ember.CoreView.extend(Ember._Metamorph); })(); (function() { /*globals Handlebars */ /** @module ember @submodule ember-handlebars */ var get = Ember.get, set = Ember.set, getPath = Ember.Handlebars.getPath; Ember._SimpleHandlebarsView = Ember._SimpleMetamorphView.extend({ instrumentName: 'render.simpleHandlebars', normalizedValue: Ember.computed(function() { var path = get(this, 'path'), pathRoot = get(this, 'pathRoot'), result, templateData; // Use the pathRoot as the result if no path is provided. This // happens if the path is `this`, which gets normalized into // a `pathRoot` of the current Handlebars context and a path // of `''`. if (path === '') { result = pathRoot; } else { templateData = get(this, 'templateData'); result = getPath(pathRoot, path, { data: templateData }); } return result; }).property('path', 'pathRoot').volatile(), render: function(buffer) { // If not invoked via a triple-mustache ({{{foo}}}), escape // the content of the template. var escape = get(this, 'isEscaped'); var result = get(this, 'normalizedValue'); if (result === null || result === undefined) { result = ""; } else if (!(result instanceof Handlebars.SafeString)) { result = String(result); } if (escape) { result = Handlebars.Utils.escapeExpression(result); } buffer.push(result); return; }, rerender: function() { switch(this.state) { case 'preRender': case 'destroyed': break; case 'inBuffer': throw new Error("Something you did tried to replace an {{expression}} before it was inserted into the DOM."); case 'hasElement': case 'inDOM': this.domManager.replace(this); break; } return this; }, transitionTo: function(state) { this.state = state; } }); /** Ember._HandlebarsBoundView is a private view created by the Handlebars `{{bind}}` helpers that is used to keep track of bound properties. Every time a property is bound using a `{{mustache}}`, an anonymous subclass of Ember._HandlebarsBoundView is created with the appropriate sub-template and context set up. When the associated property changes, just the template for this view will re-render. @class _HandlebarsBoundView @namespace Ember @extends Ember._MetamorphView @private */ Ember._HandlebarsBoundView = Ember._MetamorphView.extend({ instrumentName: 'render.boundHandlebars', /** The function used to determine if the `displayTemplate` or `inverseTemplate` should be rendered. This should be a function that takes a value and returns a Boolean. @property shouldDisplayFunc @type Function @default null */ shouldDisplayFunc: null, /** Whether the template rendered by this view gets passed the context object of its parent template, or gets passed the value of retrieving `path` from the `pathRoot`. For example, this is true when using the `{{#if}}` helper, because the template inside the helper should look up properties relative to the same object as outside the block. This would be false when used with `{{#with foo}}` because the template should receive the object found by evaluating `foo`. @property preserveContext @type Boolean @default false */ preserveContext: false, /** If `preserveContext` is true, this is the object that will be used to render the template. @property previousContext @type Object */ previousContext: null, /** The template to render when `shouldDisplayFunc` evaluates to true. @property displayTemplate @type Function @default null */ displayTemplate: null, /** The template to render when `shouldDisplayFunc` evaluates to false. @property inverseTemplate @type Function @default null */ inverseTemplate: null, /** The path to look up on `pathRoot` that is passed to `shouldDisplayFunc` to determine which template to render. In addition, if `preserveContext` is false, the object at this path will be passed to the template when rendering. @property path @type String @default null */ path: null, /** The object from which the `path` will be looked up. Sometimes this is the same as the `previousContext`, but in cases where this view has been generated for paths that start with a keyword such as `view` or `controller`, the path root will be that resolved object. @property pathRoot @type Object */ pathRoot: null, normalizedValue: Ember.computed(function() { var path = get(this, 'path'), pathRoot = get(this, 'pathRoot'), valueNormalizer = get(this, 'valueNormalizerFunc'), result, templateData; // Use the pathRoot as the result if no path is provided. This // happens if the path is `this`, which gets normalized into // a `pathRoot` of the current Handlebars context and a path // of `''`. if (path === '') { result = pathRoot; } else { templateData = get(this, 'templateData'); result = getPath(pathRoot, path, { data: templateData }); } return valueNormalizer ? valueNormalizer(result) : result; }).property('path', 'pathRoot', 'valueNormalizerFunc').volatile(), rerenderIfNeeded: function() { if (!get(this, 'isDestroyed') && get(this, 'normalizedValue') !== this._lastNormalizedValue) { this.rerender(); } }, /** Determines which template to invoke, sets up the correct state based on that logic, then invokes the default Ember.View `render` implementation. This method will first look up the `path` key on `pathRoot`, then pass that value to the `shouldDisplayFunc` function. If that returns true, the `displayTemplate` function will be rendered to DOM. Otherwise, `inverseTemplate`, if specified, will be rendered. For example, if this Ember._HandlebarsBoundView represented the `{{#with foo}}` helper, it would look up the `foo` property of its context, and `shouldDisplayFunc` would always return true. The object found by looking up `foo` would be passed to `displayTemplate`. @method render @param {Ember.RenderBuffer} buffer */ render: function(buffer) { // If not invoked via a triple-mustache ({{{foo}}}), escape // the content of the template. var escape = get(this, 'isEscaped'); var shouldDisplay = get(this, 'shouldDisplayFunc'), preserveContext = get(this, 'preserveContext'), context = get(this, 'previousContext'); var inverseTemplate = get(this, 'inverseTemplate'), displayTemplate = get(this, 'displayTemplate'); var result = get(this, 'normalizedValue'); this._lastNormalizedValue = result; // First, test the conditional to see if we should // render the template or not. if (shouldDisplay(result)) { set(this, 'template', displayTemplate); // If we are preserving the context (for example, if this // is an #if block, call the template with the same object. if (preserveContext) { set(this, '_context', context); } else { // Otherwise, determine if this is a block bind or not. // If so, pass the specified object to the template if (displayTemplate) { set(this, '_context', result); } else { // This is not a bind block, just push the result of the // expression to the render context and return. if (result === null || result === undefined) { result = ""; } else if (!(result instanceof Handlebars.SafeString)) { result = String(result); } if (escape) { result = Handlebars.Utils.escapeExpression(result); } buffer.push(result); return; } } } else if (inverseTemplate) { set(this, 'template', inverseTemplate); if (preserveContext) { set(this, '_context', context); } else { set(this, '_context', result); } } else { set(this, 'template', function() { return ''; }); } return this._super(buffer); } }); })(); (function() { /** @module ember @submodule ember-handlebars */ var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt; var getPath = Ember.Handlebars.getPath, normalizePath = Ember.Handlebars.normalizePath; var forEach = Ember.ArrayPolyfills.forEach; var EmberHandlebars = Ember.Handlebars, helpers = EmberHandlebars.helpers; // Binds a property into the DOM. This will create a hook in DOM that the // KVO system will look for and update if the property changes. function bind(property, options, preserveContext, shouldDisplay, valueNormalizer) { var data = options.data, fn = options.fn, inverse = options.inverse, view = data.view, currentContext = this, pathRoot, path, normalized; normalized = normalizePath(currentContext, property, data); pathRoot = normalized.root; path = normalized.path; // Set up observers for observable objects if ('object' === typeof this) { // Create the view that will wrap the output of this template/property // and add it to the nearest view's childViews array. // See the documentation of Ember._HandlebarsBoundView for more. var bindView = view.createChildView(Ember._HandlebarsBoundView, { preserveContext: preserveContext, shouldDisplayFunc: shouldDisplay, valueNormalizerFunc: valueNormalizer, displayTemplate: fn, inverseTemplate: inverse, path: path, pathRoot: pathRoot, previousContext: currentContext, isEscaped: !options.hash.unescaped, templateData: options.data }); view.appendChild(bindView); var observer = function() { Ember.run.scheduleOnce('render', bindView, 'rerenderIfNeeded'); }; // Observes the given property on the context and // tells the Ember._HandlebarsBoundView to re-render. If property // is an empty string, we are printing the current context // object ({{this}}) so updating it is not our responsibility. if (path !== '') { Ember.addObserver(pathRoot, path, observer); view.one('willClearRender', function() { Ember.removeObserver(pathRoot, path, observer); }); } } else { // The object is not observable, so just render it out and // be done with it. data.buffer.push(getPath(pathRoot, path, options)); } } function simpleBind(property, options) { var data = options.data, view = data.view, currentContext = this, pathRoot, path, normalized; normalized = normalizePath(currentContext, property, data); pathRoot = normalized.root; path = normalized.path; // Set up observers for observable objects if ('object' === typeof this) { var bindView = Ember._SimpleHandlebarsView.create().setProperties({ path: path, pathRoot: pathRoot, isEscaped: !options.hash.unescaped, previousContext: currentContext, templateData: options.data }); view.createChildView(bindView); view.appendChild(bindView); var observer = function() { Ember.run.scheduleOnce('render', bindView, 'rerender'); }; // Observes the given property on the context and // tells the Ember._HandlebarsBoundView to re-render. If property // is an empty string, we are printing the current context // object ({{this}}) so updating it is not our responsibility. if (path !== '') { Ember.addObserver(pathRoot, path, observer); view.one('willClearRender', function() { Ember.removeObserver(pathRoot, path, observer); }); } } else { // The object is not observable, so just render it out and // be done with it. data.buffer.push(getPath(pathRoot, path, options)); } } /** @private '_triageMustache' is used internally select between a binding and helper for the given context. Until this point, it would be hard to determine if the mustache is a property reference or a regular helper reference. This triage helper resolves that. This would not be typically invoked by directly. @method _triageMustache @for Ember.Handlebars.helpers @param {String} property Property/helperID to triage @param {Function} fn Context to provide for rendering @return {String} HTML string */ EmberHandlebars.registerHelper('_triageMustache', function(property, fn) { Ember.assert("You cannot pass more than one argument to the _triageMustache helper", arguments.length <= 2); if (helpers[property]) { return helpers[property].call(this, fn); } else { return helpers.bind.apply(this, arguments); } }); /** @private `bind` can be used to display a value, then update that value if it changes. For example, if you wanted to print the `title` property of `content`: ``` handlebars {{bind "content.title"}} ``` This will return the `title` property as a string, then create a new observer at the specified path. If it changes, it will update the value in DOM. Note that if you need to support IE7 and IE8 you must modify the model objects properties using Ember.get() and Ember.set() for this to work as it relies on Ember's KVO system. For all other browsers this will be handled for you automatically. @method bind @for Ember.Handlebars.helpers @param {String} property Property to bind @param {Function} fn Context to provide for rendering @return {String} HTML string */ EmberHandlebars.registerHelper('bind', function(property, options) { Ember.assert("You cannot pass more than one argument to the bind helper", arguments.length <= 2); var context = (options.contexts && options.contexts[0]) || this; if (!options.fn) { return simpleBind.call(context, property, options); } return bind.call(context, property, options, false, function(result) { return !Ember.none(result); }); }); /** @private Use the `boundIf` helper to create a conditional that re-evaluates whenever the bound value changes. ``` handlebars {{#boundIf "content.shouldDisplayTitle"}} {{content.title}} {{/boundIf}} ``` @method boundIf @for Ember.Handlebars.helpers @param {String} property Property to bind @param {Function} fn Context to provide for rendering @return {String} HTML string */ EmberHandlebars.registerHelper('boundIf', function(property, fn) { var context = (fn.contexts && fn.contexts[0]) || this; var func = function(result) { if (Ember.typeOf(result) === 'array') { return get(result, 'length') !== 0; } else { return !!result; } }; return bind.call(context, property, fn, true, func, func); }); /** @method with @for Ember.Handlebars.helpers @param {Function} context @param {Hash} options @return {String} HTML string */ EmberHandlebars.registerHelper('with', function(context, options) { if (arguments.length === 4) { var keywordName, path, rootPath, normalized; Ember.assert("If you pass more than one argument to the with helper, it must be in the form #with foo as bar", arguments[1] === "as"); options = arguments[3]; keywordName = arguments[2]; path = arguments[0]; Ember.assert("You must pass a block to the with helper", options.fn && options.fn !== Handlebars.VM.noop); if (Ember.isGlobalPath(path)) { Ember.bind(options.data.keywords, keywordName, path); } else { normalized = normalizePath(this, path, options.data); path = normalized.path; rootPath = normalized.root; // This is a workaround for the fact that you cannot bind separate objects // together. When we implement that functionality, we should use it here. var contextKey = Ember.$.expando + Ember.guidFor(rootPath); options.data.keywords[contextKey] = rootPath; // if the path is '' ("this"), just bind directly to the current context var contextPath = path ? contextKey + '.' + path : contextKey; Ember.bind(options.data.keywords, keywordName, contextPath); } return bind.call(this, path, options, true, function(result) { return !Ember.none(result); }); } else { Ember.assert("You must pass exactly one argument to the with helper", arguments.length === 2); Ember.assert("You must pass a block to the with helper", options.fn && options.fn !== Handlebars.VM.noop); return helpers.bind.call(options.contexts[0], context, options); } }); /** @method if @for Ember.Handlebars.helpers @param {Function} context @param {Hash} options @return {String} HTML string */ EmberHandlebars.registerHelper('if', function(context, options) { Ember.assert("You must pass exactly one argument to the if helper", arguments.length === 2); Ember.assert("You must pass a block to the if helper", options.fn && options.fn !== Handlebars.VM.noop); return helpers.boundIf.call(options.contexts[0], context, options); }); /** @method unless @for Ember.Handlebars.helpers @param {Function} context @param {Hash} options @return {String} HTML string */ EmberHandlebars.registerHelper('unless', function(context, options) { Ember.assert("You must pass exactly one argument to the unless helper", arguments.length === 2); Ember.assert("You must pass a block to the unless helper", options.fn && options.fn !== Handlebars.VM.noop); var fn = options.fn, inverse = options.inverse; options.fn = inverse; options.inverse = fn; return helpers.boundIf.call(options.contexts[0], context, options); }); /** `bindAttr` allows you to create a binding between DOM element attributes and Ember objects. For example: ``` handlebars imageTitle ``` @method bindAttr @for Ember.Handlebars.helpers @param {Hash} options @return {String} HTML string */ EmberHandlebars.registerHelper('bindAttr', function(options) { var attrs = options.hash; Ember.assert("You must specify at least one hash argument to bindAttr", !!Ember.keys(attrs).length); var view = options.data.view; var ret = []; var ctx = this; // Generate a unique id for this element. This will be added as a // data attribute to the element so it can be looked up when // the bound property changes. var dataId = ++Ember.$.uuid; // Handle classes differently, as we can bind multiple classes var classBindings = attrs['class']; if (classBindings !== null && classBindings !== undefined) { var classResults = EmberHandlebars.bindClasses(this, classBindings, view, dataId, options); ret.push('class="' + Handlebars.Utils.escapeExpression(classResults.join(' ')) + '"'); delete attrs['class']; } var attrKeys = Ember.keys(attrs); // For each attribute passed, create an observer and emit the // current value of the property as an attribute. forEach.call(attrKeys, function(attr) { var path = attrs[attr], pathRoot, normalized; Ember.assert(fmt("You must provide a String for a bound attribute, not %@", [path]), typeof path === 'string'); normalized = normalizePath(ctx, path, options.data); pathRoot = normalized.root; path = normalized.path; var value = (path === 'this') ? pathRoot : getPath(pathRoot, path, options), type = Ember.typeOf(value); Ember.assert(fmt("Attributes must be numbers, strings or booleans, not %@", [value]), value === null || value === undefined || type === 'number' || type === 'string' || type === 'boolean'); var observer, invoker; observer = function observer() { var result = getPath(pathRoot, path, options); Ember.assert(fmt("Attributes must be numbers, strings or booleans, not %@", [result]), result === null || result === undefined || typeof result === 'number' || typeof result === 'string' || typeof result === 'boolean'); var elem = view.$("[data-bindattr-" + dataId + "='" + dataId + "']"); // If we aren't able to find the element, it means the element // to which we were bound has been removed from the view. // In that case, we can assume the template has been re-rendered // and we need to clean up the observer. if (!elem || elem.length === 0) { Ember.removeObserver(pathRoot, path, invoker); return; } Ember.View.applyAttributeBindings(elem, attr, result); }; invoker = function() { Ember.run.scheduleOnce('render', observer); }; // Add an observer to the view for when the property changes. // When the observer fires, find the element using the // unique data id and update the attribute to the new value. if (path !== 'this') { Ember.addObserver(pathRoot, path, invoker); view.one('willClearRender', function() { Ember.removeObserver(pathRoot, path, invoker); }); } // if this changes, also change the logic in ember-views/lib/views/view.js if ((type === 'string' || (type === 'number' && !isNaN(value)))) { ret.push(attr + '="' + Handlebars.Utils.escapeExpression(value) + '"'); } else if (value && type === 'boolean') { // The developer controls the attr name, so it should always be safe ret.push(attr + '="' + attr + '"'); } }, this); // Add the unique identifier // NOTE: We use all lower-case since Firefox has problems with mixed case in SVG ret.push('data-bindattr-' + dataId + '="' + dataId + '"'); return new EmberHandlebars.SafeString(ret.join(' ')); }); /** @private Helper that, given a space-separated string of property paths and a context, returns an array of class names. Calling this method also has the side effect of setting up observers at those property paths, such that if they change, the correct class name will be reapplied to the DOM element. For example, if you pass the string "fooBar", it will first look up the "fooBar" value of the context. If that value is true, it will add the "foo-bar" class to the current element (i.e., the dasherized form of "fooBar"). If the value is a string, it will add that string as the class. Otherwise, it will not add any new class name. @method bindClasses @for Ember.Handlebars @param {Ember.Object} context The context from which to lookup properties @param {String} classBindings A string, space-separated, of class bindings to use @param {Ember.View} view The view in which observers should look for the element to update @param {Srting} bindAttrId Optional bindAttr id used to lookup elements @return {Array} An array of class names to add */ EmberHandlebars.bindClasses = function(context, classBindings, view, bindAttrId, options) { var ret = [], newClass, value, elem; // Helper method to retrieve the property from the context and // determine which class string to return, based on whether it is // a Boolean or not. var classStringForPath = function(root, parsedPath, options) { var val, path = parsedPath.path; if (path === 'this') { val = root; } else if (path === '') { val = true; } else { val = getPath(root, path, options); } return Ember.View._classStringForValue(path, val, parsedPath.className, parsedPath.falsyClassName); }; // For each property passed, loop through and setup // an observer. forEach.call(classBindings.split(' '), function(binding) { // Variable in which the old class value is saved. The observer function // closes over this variable, so it knows which string to remove when // the property changes. var oldClass; var observer, invoker; var parsedPath = Ember.View._parsePropertyPath(binding), path = parsedPath.path, pathRoot = context, normalized; if (path !== '' && path !== 'this') { normalized = normalizePath(context, path, options.data); pathRoot = normalized.root; path = normalized.path; } // Set up an observer on the context. If the property changes, toggle the // class name. observer = function() { // Get the current value of the property newClass = classStringForPath(pathRoot, parsedPath, options); elem = bindAttrId ? view.$("[data-bindattr-" + bindAttrId + "='" + bindAttrId + "']") : view.$(); // If we can't find the element anymore, a parent template has been // re-rendered and we've been nuked. Remove the observer. if (!elem || elem.length === 0) { Ember.removeObserver(pathRoot, path, invoker); } else { // If we had previously added a class to the element, remove it. if (oldClass) { elem.removeClass(oldClass); } // If necessary, add a new class. Make sure we keep track of it so // it can be removed in the future. if (newClass) { elem.addClass(newClass); oldClass = newClass; } else { oldClass = null; } } }; invoker = function() { Ember.run.scheduleOnce('render', observer); }; if (path !== '' && path !== 'this') { Ember.addObserver(pathRoot, path, invoker); view.one('willClearRender', function() { Ember.removeObserver(pathRoot, path, invoker); }); } // We've already setup the observer; now we just need to figure out the // correct behavior right now on the first pass through. value = classStringForPath(pathRoot, parsedPath, options); if (value) { ret.push(value); // Make sure we save the current value so that it can be removed if the // observer fires. oldClass = value; } }); return ret; }; })(); (function() { /*globals Handlebars */ // TODO: Don't require the entire module /** @module ember @submodule ember-handlebars */ var get = Ember.get, set = Ember.set; var PARENT_VIEW_PATH = /^parentView\./; var EmberHandlebars = Ember.Handlebars; EmberHandlebars.ViewHelper = Ember.Object.create({ propertiesFromHTMLOptions: function(options, thisContext) { var hash = options.hash, data = options.data; var extensions = {}, classes = hash['class'], dup = false; if (hash.id) { extensions.elementId = hash.id; dup = true; } if (classes) { classes = classes.split(' '); extensions.classNames = classes; dup = true; } if (hash.classBinding) { extensions.classNameBindings = hash.classBinding.split(' '); dup = true; } if (hash.classNameBindings) { if (extensions.classNameBindings === undefined) extensions.classNameBindings = []; extensions.classNameBindings = extensions.classNameBindings.concat(hash.classNameBindings.split(' ')); dup = true; } if (hash.attributeBindings) { Ember.assert("Setting 'attributeBindings' via Handlebars is not allowed. Please subclass Ember.View and set it there instead."); extensions.attributeBindings = null; dup = true; } if (dup) { hash = Ember.$.extend({}, hash); delete hash.id; delete hash['class']; delete hash.classBinding; } // Set the proper context for all bindings passed to the helper. This applies to regular attribute bindings // as well as class name bindings. If the bindings are local, make them relative to the current context // instead of the view. var path; // Evaluate the context of regular attribute bindings: for (var prop in hash) { if (!hash.hasOwnProperty(prop)) { continue; } // Test if the property ends in "Binding" if (Ember.IS_BINDING.test(prop) && typeof hash[prop] === 'string') { path = this.contextualizeBindingPath(hash[prop], data); if (path) { hash[prop] = path; } } } // Evaluate the context of class name bindings: if (extensions.classNameBindings) { for (var b in extensions.classNameBindings) { var full = extensions.classNameBindings[b]; if (typeof full === 'string') { // Contextualize the path of classNameBinding so this: // // classNameBinding="isGreen:green" // // is converted to this: // // classNameBinding="bindingContext.isGreen:green" var parsedPath = Ember.View._parsePropertyPath(full); path = this.contextualizeBindingPath(parsedPath.path, data); if (path) { extensions.classNameBindings[b] = path + parsedPath.classNames; } } } } // Make the current template context available to the view // for the bindings set up above. extensions.bindingContext = thisContext; return Ember.$.extend(hash, extensions); }, // Transform bindings from the current context to a context that can be evaluated within the view. // Returns null if the path shouldn't be changed. // // TODO: consider the addition of a prefix that would allow this method to return `path`. contextualizeBindingPath: function(path, data) { var normalized = Ember.Handlebars.normalizePath(null, path, data); if (normalized.isKeyword) { return 'templateData.keywords.' + path; } else if (Ember.isGlobalPath(path)) { return null; } else if (path === 'this') { return 'bindingContext'; } else { return 'bindingContext.' + path; } }, helper: function(thisContext, path, options) { var inverse = options.inverse, data = options.data, view = data.view, fn = options.fn, hash = options.hash, newView; if ('string' === typeof path) { newView = EmberHandlebars.getPath(thisContext, path, options); Ember.assert("Unable to find view at path '" + path + "'", !!newView); } else { newView = path; } Ember.assert(Ember.String.fmt('You must pass a view class to the #view helper, not %@ (%@)', [path, newView]), Ember.View.detect(newView)); var viewOptions = this.propertiesFromHTMLOptions(options, thisContext); var currentView = data.view; viewOptions.templateData = options.data; if (fn) { Ember.assert("You cannot provide a template block if you also specified a templateName", !get(viewOptions, 'templateName') && !get(newView.proto(), 'templateName')); viewOptions.template = fn; } // We only want to override the `_context` computed property if there is // no specified controller. See View#_context for more information. if (!newView.proto().controller && !newView.proto().controllerBinding && !viewOptions.controller && !viewOptions.controllerBinding) { viewOptions._context = thisContext; } currentView.appendChild(newView, viewOptions); } }); /** `{{view}}` inserts a new instance of `Ember.View` into a template passing its options to the `Ember.View`'s `create` method and using the supplied block as the view's own template. An empty `` and the following template: ``` handlebars ``` Will result in HTML structure: ``` html
A span: Hello.
``` ### parentView setting The `parentView` property of the new `Ember.View` instance created through `{{view}}` will be set to the `Ember.View` instance of the template where `{{view}}` was called. ``` javascript aView = Ember.View.create({ template: Ember.Handlebars.compile("{{#view}} my parent: {{parentView.elementId}} {{/view}}") }); aView.appendTo('body'); ``` Will result in HTML structure: ``` html
my parent: ember1
``` ### Setting CSS id and class attributes The HTML `id` attribute can be set on the `{{view}}`'s resulting element with the `id` option. This option will _not_ be passed to `Ember.View.create`. ``` handlebars ``` Results in the following HTML structure: ``` html
hello.
``` The HTML `class` attribute can be set on the `{{view}}`'s resulting element with the `class` or `classNameBindings` options. The `class` option will directly set the CSS `class` attribute and will not be passed to `Ember.View.create`. `classNameBindings` will be passed to `create` and use `Ember.View`'s class name binding functionality: ``` handlebars ``` Results in the following HTML structure: ``` html
hello.
``` ### Supplying a different view class `{{view}}` can take an optional first argument before its supplied options to specify a path to a custom view class. ``` handlebars ``` The first argument can also be a relative path. Ember will search for the view class starting at the `Ember.View` of the template where `{{view}}` was used as the root object: ``` javascript MyApp = Ember.Application.create({}); MyApp.OuterView = Ember.View.extend({ innerViewClass: Ember.View.extend({ classNames: ['a-custom-view-class-as-property'] }), template: Ember.Handlebars.compile('{{#view "innerViewClass"}} hi {{/view}}') }); MyApp.OuterView.create().appendTo('body'); ``` Will result in the following HTML: ``` html
hi
``` ### Blockless use If you supply a custom `Ember.View` subclass that specifies its own template or provide a `templateName` option to `{{view}}` it can be used without supplying a block. Attempts to use both a `templateName` option and supply a block will throw an error. ``` handlebars ``` ### viewName property You can supply a `viewName` option to `{{view}}`. The `Ember.View` instance will be referenced as a property of its parent view by this name. ``` javascript aView = Ember.View.create({ template: Ember.Handlebars.compile('{{#view viewName="aChildByName"}} hi {{/view}}') }); aView.appendTo('body'); aView.get('aChildByName') // the instance of Ember.View created by {{view}} helper ``` @method view @for Ember.Handlebars.helpers @param {String} path @param {Hash} options @return {String} HTML string */ EmberHandlebars.registerHelper('view', function(path, options) { Ember.assert("The view helper only takes a single argument", arguments.length <= 2); // If no path is provided, treat path param as options. if (path && path.data && path.data.isRenderData) { options = path; path = "Ember.View"; } return EmberHandlebars.ViewHelper.helper(this, path, options); }); })(); (function() { /*globals Handlebars */ // TODO: Don't require all of this module /** @module ember @submodule ember-handlebars */ var get = Ember.get, getPath = Ember.Handlebars.getPath, fmt = Ember.String.fmt; /** `{{collection}}` is a `Ember.Handlebars` helper for adding instances of `Ember.CollectionView` to a template. See `Ember.CollectionView` for additional information on how a `CollectionView` functions. `{{collection}}`'s primary use is as a block helper with a `contentBinding` option pointing towards an `Ember.Array`-compatible object. An `Ember.View` instance will be created for each item in its `content` property. Each view will have its own `content` property set to the appropriate item in the collection. The provided block will be applied as the template for each item's view. Given an empty `` the following template: ``` handlebars ``` And the following application code ``` javascript App = Ember.Application.create() App.items = [ Ember.Object.create({name: 'Dave'}), Ember.Object.create({name: 'Mary'}), Ember.Object.create({name: 'Sara'}) ] ``` Will result in the HTML structure below ``` html
Hi Dave
Hi Mary
Hi Sara
``` ### Blockless Use If you provide an `itemViewClass` option that has its own `template` you can omit the block. The following template: ``` handlebars ``` And application code ``` javascript App = Ember.Application.create(); App.items = [ Ember.Object.create({name: 'Dave'}), Ember.Object.create({name: 'Mary'}), Ember.Object.create({name: 'Sara'}) ]; App.AnItemView = Ember.View.extend({ template: Ember.Handlebars.compile("Greetings {{view.content.name}}") }); ``` Will result in the HTML structure below ``` html
Greetings Dave
Greetings Mary
Greetings Sara
``` ### Specifying a CollectionView subclass By default the `{{collection}}` helper will create an instance of `Ember.CollectionView`. You can supply a `Ember.CollectionView` subclass to the helper by passing it as the first argument: ``` handlebars ``` ### Forwarded `item.*`-named Options As with the `{{view}}`, helper options passed to the `{{collection}}` will be set on the resulting `Ember.CollectionView` as properties. Additionally, options prefixed with `item` will be applied to the views rendered for each item (note the camelcasing): ``` handlebars ``` Will result in the following HTML structure: ``` html

Howdy Dave

Howdy Mary

Howdy Sara

``` @method collection @for Ember.Handlebars.helpers @param {String} path @param {Hash} options @return {String} HTML string */ Ember.Handlebars.registerHelper('collection', function(path, options) { // If no path is provided, treat path param as options. if (path && path.data && path.data.isRenderData) { options = path; path = undefined; Ember.assert("You cannot pass more than one argument to the collection helper", arguments.length === 1); } else { Ember.assert("You cannot pass more than one argument to the collection helper", arguments.length === 2); } var fn = options.fn; var data = options.data; var inverse = options.inverse; // If passed a path string, convert that into an object. // Otherwise, just default to the standard class. var collectionClass; collectionClass = path ? getPath(this, path, options) : Ember.CollectionView; Ember.assert(fmt("%@ #collection: Could not find collection class %@", [data.view, path]), !!collectionClass); var hash = options.hash, itemHash = {}, match; // Extract item view class if provided else default to the standard class var itemViewClass, itemViewPath = hash.itemViewClass; var collectionPrototype = collectionClass.proto(); delete hash.itemViewClass; itemViewClass = itemViewPath ? getPath(collectionPrototype, itemViewPath, options) : collectionPrototype.itemViewClass; Ember.assert(fmt("%@ #collection: Could not find itemViewClass %@", [data.view, itemViewPath]), !!itemViewClass); // Go through options passed to the {{collection}} helper and extract options // that configure item views instead of the collection itself. for (var prop in hash) { if (hash.hasOwnProperty(prop)) { match = prop.match(/^item(.)(.*)$/); if(match) { // Convert itemShouldFoo -> shouldFoo itemHash[match[1].toLowerCase() + match[2]] = hash[prop]; // Delete from hash as this will end up getting passed to the // {{view}} helper method. delete hash[prop]; } } } var tagName = hash.tagName || collectionPrototype.tagName; if (fn) { itemHash.template = fn; delete options.fn; } var emptyViewClass; if (inverse && inverse !== Handlebars.VM.noop) { emptyViewClass = get(collectionPrototype, 'emptyViewClass'); emptyViewClass = emptyViewClass.extend({ template: inverse, tagName: itemHash.tagName }); } else if (hash.emptyViewClass) { emptyViewClass = getPath(this, hash.emptyViewClass, options); } hash.emptyView = emptyViewClass; if (hash.eachHelper === 'each') { itemHash._context = Ember.computed(function() { return get(this, 'content'); }).property('content'); delete hash.eachHelper; } var viewOptions = Ember.Handlebars.ViewHelper.propertiesFromHTMLOptions({ data: data, hash: itemHash }, this); hash.itemViewClass = itemViewClass.extend(viewOptions); return Ember.Handlebars.helpers.view.call(this, collectionClass, options); }); })(); (function() { /*globals Handlebars */ /** @module ember @submodule ember-handlebars */ var getPath = Ember.Handlebars.getPath; /** `unbound` allows you to output a property without binding. *Important:* The output will not be updated if the property changes. Use with caution. ``` handlebars
{{unbound somePropertyThatDoesntChange}}
``` @method unbound @for Ember.Handlebars.helpers @param {String} property @return {String} HTML string */ Ember.Handlebars.registerHelper('unbound', function(property, fn) { var context = (fn.contexts && fn.contexts[0]) || this; return getPath(context, property, fn); }); })(); (function() { /*jshint debug:true*/ /** @module ember @submodule ember-handlebars */ var getPath = Ember.Handlebars.getPath, normalizePath = Ember.Handlebars.normalizePath; /** `log` allows you to output the value of a value in the current rendering context. ``` handlebars {{log myVariable}} ``` @method log @for Ember.Handlebars.helpers @param {String} property */ Ember.Handlebars.registerHelper('log', function(property, options) { var context = (options.contexts && options.contexts[0]) || this, normalized = normalizePath(context, property, options.data), pathRoot = normalized.root, path = normalized.path, value = (path === 'this') ? pathRoot : getPath(pathRoot, path, options); Ember.Logger.log(value); }); /** The `debugger` helper executes the `debugger` statement in the current context. ``` handlebars {{debugger}} ``` @method debugger @for Ember.Handlebars.helpers @param {String} property */ Ember.Handlebars.registerHelper('debugger', function() { debugger; }); })(); (function() { /** @module ember @submodule ember-handlebars */ var get = Ember.get, set = Ember.set; Ember.Handlebars.EachView = Ember.CollectionView.extend(Ember._Metamorph, { itemViewClass: Ember._MetamorphView, emptyViewClass: Ember._MetamorphView, createChildView: function(view, attrs) { view = this._super(view, attrs); // At the moment, if a container view subclass wants // to insert keywords, it is responsible for cloning // the keywords hash. This will be fixed momentarily. var keyword = get(this, 'keyword'); if (keyword) { var data = get(view, 'templateData'); data = Ember.copy(data); data.keywords = view.cloneKeywords(); set(view, 'templateData', data); var content = get(view, 'content'); // In this case, we do not bind, because the `content` of // a #each item cannot change. data.keywords[keyword] = content; } return view; } }); /** The `{{#each}}` helper loops over elements in a collection, rendering its block once for each item: ``` javascript Developers = [{name: 'Yehuda'},{name: 'Tom'}, {name: 'Paul'}]; ``` ``` handlebars {{#each Developers}} {{name}} {{/each}} ``` `{{each}}` supports an alternative syntax with element naming: ``` handlebars {{#each person in Developers}} {{person.name}} {{/each}} ``` When looping over objects that do not have properties, `{{this}}` can be used to render the object: ``` javascript DeveloperNames = ['Yehuda', 'Tom', 'Paul'] ``` ``` handlebars {{#each DeveloperNames}} {{this}} {{/each}} ``` ### Blockless Use If you provide an `itemViewClass` option that has its own `template` you can omit the block in a similar way to how it can be done with the collection helper. The following template: ``` handlebars ``` And application code ``` javascript App = Ember.Application.create({ MyView: Ember.View.extend({ items: [ Ember.Object.create({name: 'Dave'}), Ember.Object.create({name: 'Mary'}), Ember.Object.create({name: 'Sara'}) ] }) }); App.AnItemView = Ember.View.extend({ template: Ember.Handlebars.compile("Greetings {{name}}") }); App.initialize(); ``` Will result in the HTML structure below ``` html
Greetings Dave
Greetings Mary
Greetings Sara
``` @method each @for Ember.Handlebars.helpers @param [name] {String} name for item (used with `in`) @param path {String} path */ Ember.Handlebars.registerHelper('each', function(path, options) { if (arguments.length === 4) { Ember.assert("If you pass more than one argument to the each helper, it must be in the form #each foo in bar", arguments[1] === "in"); var keywordName = arguments[0]; options = arguments[3]; path = arguments[2]; if (path === '') { path = "this"; } options.hash.keyword = keywordName; } else { options.hash.eachHelper = 'each'; } options.hash.contentBinding = path; // Set up emptyView as a metamorph with no tag //options.hash.emptyViewClass = Ember._MetamorphView; return Ember.Handlebars.helpers.collection.call(this, 'Ember.Handlebars.EachView', options); }); })(); (function() { /** @module ember @submodule ember-handlebars */ /** `template` allows you to render a template from inside another template. This allows you to re-use the same template in multiple places. For example: ``` handlebars ``` This helper looks for templates in the global Ember.TEMPLATES hash. If you add <script> tags to your page with the `data-template-name` attribute set, they will be compiled and placed in this hash automatically. You can also manually register templates by adding them to the hash: ``` javascript Ember.TEMPLATES["my_cool_template"] = Ember.Handlebars.compile('{{user}}'); ``` @method template @for Ember.Handlebars.helpers @param {String} templateName the template to render */ Ember.Handlebars.registerHelper('template', function(name, options) { var template = Ember.TEMPLATES[name]; Ember.assert("Unable to find template with name '"+name+"'.", !!template); Ember.TEMPLATES[name](this, { data: options.data }); }); })(); (function() { /** @module ember @submodule ember-handlebars */ var EmberHandlebars = Ember.Handlebars, getPath = EmberHandlebars.getPath, get = Ember.get, a_slice = Array.prototype.slice; var ActionHelper = EmberHandlebars.ActionHelper = { registeredActions: {} }; ActionHelper.registerAction = function(actionName, options) { var actionId = (++Ember.$.uuid).toString(); ActionHelper.registeredActions[actionId] = { eventName: options.eventName, handler: function(event) { var modifier = event.shiftKey || event.metaKey || event.altKey || event.ctrlKey, secondaryClick = event.which > 1, // IE9 may return undefined nonStandard = modifier || secondaryClick; if (options.link && nonStandard) { // Allow the browser to handle special link clicks normally return; } event.preventDefault(); event.view = options.view; if (options.hasOwnProperty('context')) { event.context = options.context; } if (options.hasOwnProperty('contexts')) { event.contexts = options.contexts; } var target = options.target; // Check for StateManager (or compatible object) if (target.isState && typeof target.send === 'function') { return target.send(actionName, event); } else { Ember.assert(Ember.String.fmt('Target %@ does not have action %@', [target, actionName]), target[actionName]); return target[actionName].call(target, event); } } }; options.view.on('willClearRender', function() { delete ActionHelper.registeredActions[actionId]; }); return actionId; }; /** The `{{action}}` helper registers an HTML element within a template for DOM event handling and forwards that interaction to the Application's router, the template's `Ember.View` instance, or supplied `target` option (see 'Specifying a Target'). User interaction with that element will invoke the supplied action name on the appropriate target. Given the following Handlebars template on the page ``` handlebars ``` And application code ``` javascript AView = Ember.View.extend({ templateName; 'a-template', anActionName: function(event){} }); aView = AView.create(); aView.appendTo('body'); ``` Will results in the following rendered HTML ``` html
click me
``` Clicking "click me" will trigger the `anActionName` method of the `aView` object with a `jQuery.Event` object as its argument. The `jQuery.Event` object will be extended to include a `view` property that is set to the original view interacted with (in this case the `aView` object). ### Event Propagation Events triggered through the action helper will automatically have `.preventDefault()` called on them. You do not need to do so in your event handlers. To stop propagation of the event, simply return `false` from your handler. If you need the default handler to trigger you should either register your own event handler, or use event methods on your view class. See Ember.View 'Responding to Browser Events' for more information. ### Specifying DOM event type By default the `{{action}}` helper registers for DOM `click` events. You can supply an `on` option to the helper to specify a different DOM event name: ``` handlebars ``` See Ember.View 'Responding to Browser Events' for a list of acceptable DOM event names. Because `{{action}}` depends on Ember's event dispatch system it will only function if an `Ember.EventDispatcher` instance is available. An `Ember.EventDispatcher` instance will be created when a new `Ember.Application` is created. Having an instance of `Ember.Application` will satisfy this requirement. ### Specifying a Target There are several possible target objects for `{{action}}` helpers: In a typical `Ember.Router`-backed Application where views are managed through use of the `{{outlet}}` helper, actions will be forwarded to the current state of the Applications's Router. See Ember.Router 'Responding to User-initiated Events' for more information. If you manually set the `target` property on the controller of a template's `Ember.View` instance, the specifed `controller.target` will become the target for any actions. Likely custom values for a controller's `target` are the controller itself or a StateManager other than the Application's Router. If the templates's view lacks a controller property the view itself is the target. Finally, a `target` option can be provided to the helper to change which object will receive the method call. This option must be a string representing a path to an object: ``` handlebars ``` Clicking "click me" in the rendered HTML of the above template will trigger the `anActionName` method of the object at `MyApplication.someObject`. The first argument to this method will be a `jQuery.Event` extended to include a `view` property that is set to the original view interacted with. A path relative to the template's `Ember.View` instance can also be used as a target: ``` handlebars ``` Clicking "click me" in the rendered HTML of the above template will trigger the `anActionName` method of the view's parent view. The `{{action}}` helper is `Ember.StateManager` aware. If the target of the action is an `Ember.StateManager` instance `{{action}}` will use the `send` functionality of StateManagers. The documentation for `Ember.StateManager` has additional information about this use. If an action's target does not implement a method that matches the supplied action name an error will be thrown. ``` handlebars ``` With the following application code ``` javascript AView = Ember.View.extend({ templateName; 'a-template', // note: no method 'aMethodNameThatIsMissing' anActionName: function(event){} }); aView = AView.create(); aView.appendTo('body'); ``` Will throw `Uncaught TypeError: Cannot call method 'call' of undefined` when "click me" is clicked. ### Specifying a context By default the `{{action}}` helper passes the current Handlebars context along in the `jQuery.Event` object. You may specify an alternate object to pass as the context by providing a property path: ``` handlebars ``` @method action @for Ember.Handlebars.helpers @param {String} actionName @param {Object...} contexts @param {Hash} options */ EmberHandlebars.registerHelper('action', function(actionName) { var options = arguments[arguments.length - 1], contexts = a_slice.call(arguments, 1, -1); var hash = options.hash, view = options.data.view, target, controller, link; // create a hash to pass along to registerAction var action = { eventName: hash.on || "click" }; action.view = view = get(view, 'concreteView'); if (hash.target) { target = getPath(this, hash.target, options); } else if (controller = options.data.keywords.controller) { target = get(controller, 'target'); } action.target = target = target || view; if (contexts.length) { action.contexts = contexts = Ember.EnumerableUtils.map(contexts, function(context) { return getPath(this, context, options); }, this); action.context = contexts[0]; } var output = [], url; if (hash.href && target.urlForEvent) { url = target.urlForEvent.apply(target, [actionName].concat(contexts)); output.push('href="' + url + '"'); action.link = true; } var actionId = ActionHelper.registerAction(actionName, action); output.push('data-ember-action="' + actionId + '"'); return new EmberHandlebars.SafeString(output.join(" ")); }); })(); (function() { /** @module ember @submodule ember-handlebars */ var get = Ember.get, set = Ember.set; /** When used in a Handlebars template that is assigned to an `Ember.View` instance's `layout` property Ember will render the layout template first, inserting the view's own rendered output at the `{{ yield }}` location. An empty `` and the following application code: ``` javascript AView = Ember.View.extend({ classNames: ['a-view-with-layout'], layout: Ember.Handlebars.compile('
{{ yield }}
'), template: Ember.Handlebars.compile('I am wrapped') }); aView = AView.create(); aView.appendTo('body'); ``` Will result in the following HTML output: ``` html
I am wrapped
``` The yield helper cannot be used outside of a template assigned to an `Ember.View`'s `layout` property and will throw an error if attempted. ``` javascript BView = Ember.View.extend({ classNames: ['a-view-with-layout'], template: Ember.Handlebars.compile('{{yield}}') }); bView = BView.create(); bView.appendTo('body'); // throws // Uncaught Error: assertion failed: You called yield in a template that was not a layout ``` @method yield @for Ember.Handlebars.helpers @param {Hash} options @return {String} HTML string */ Ember.Handlebars.registerHelper('yield', function(options) { var view = options.data.view, template; while (view && !get(view, 'layout')) { view = get(view, 'parentView'); } Ember.assert("You called yield in a template that was not a layout", !!view); template = get(view, 'template'); if (template) { template(this, options); } }); })(); (function() { /** @module ember @submodule ember-handlebars */ Ember.Handlebars.OutletView = Ember.ContainerView.extend(Ember._Metamorph); /** The `outlet` helper allows you to specify that the current view's controller will fill in the view for a given area. ``` handlebars {{outlet}} ``` By default, when the the current controller's `view` property changes, the outlet will replace its current view with the new view. You can set the `view` property directly, but it's normally best to use `connectOutlet`. ``` javascript # Instantiate App.PostsView and assign to `view`, so as to render into outlet. controller.connectOutlet('posts'); ``` You can also specify a particular name other than `view`: ``` handlebars {{outlet masterView}} {{outlet detailView}} ``` Then, you can control several outlets from a single controller. ``` javascript # Instantiate App.PostsView and assign to controller.masterView. controller.connectOutlet('masterView', 'posts'); # Also, instantiate App.PostInfoView and assign to controller.detailView. controller.connectOutlet('detailView', 'postInfo'); ``` @method outlet @for Ember.Handlebars.helpers @param {String} property the property on the controller that holds the view for this outlet */ Ember.Handlebars.registerHelper('outlet', function(property, options) { if (property && property.data && property.data.isRenderData) { options = property; property = 'view'; } options.hash.currentViewBinding = "view.context." + property; return Ember.Handlebars.helpers.view.call(this, Ember.Handlebars.OutletView, options); }); })(); (function() { })(); (function() { })(); (function() { /** @module ember @submodule ember-handlebars */ var set = Ember.set, get = Ember.get; /** The `Ember.Checkbox` view class renders a checkbox [input](https://developer.mozilla.org/en/HTML/Element/Input) element. It allows for binding an Ember property (`checked`) to the status of the checkbox. Example: ``` handlebars {{view Ember.Checkbox checkedBinding="receiveEmail"}} ``` You can add a `label` tag yourself in the template where the Ember.Checkbox is being used. ``` html ``` The `checked` attribute of an Ember.Checkbox object should always be set through the Ember object or by interacting with its rendered element representation via the mouse, keyboard, or touch. Updating the value of the checkbox via jQuery will result in the checked value of the object and its element losing synchronization. ## Layout and LayoutName properties Because HTML `input` elements are self closing `layout` and `layoutName` properties will not be applied. See `Ember.View`'s layout section for more information. @class Checkbox @namespace Ember @extends Ember.View */ Ember.Checkbox = Ember.View.extend({ classNames: ['ember-checkbox'], tagName: 'input', attributeBindings: ['type', 'checked', 'disabled', 'tabindex'], type: "checkbox", checked: false, disabled: false, init: function() { this._super(); this.on("change", this, this._updateElementValue); }, _updateElementValue: function() { set(this, 'checked', this.$().prop('checked')); } }); })(); (function() { /** @module ember @submodule ember-handlebars */ var get = Ember.get, set = Ember.set; /** Shared mixin used by Ember.TextField and Ember.TextArea. @class TextSupport @namespace Ember @extends Ember.Mixin @private */ Ember.TextSupport = Ember.Mixin.create({ value: "", attributeBindings: ['placeholder', 'disabled', 'maxlength', 'tabindex'], placeholder: null, disabled: false, maxlength: null, insertNewline: Ember.K, cancel: Ember.K, init: function() { this._super(); this.on("focusOut", this, this._elementValueDidChange); this.on("change", this, this._elementValueDidChange); this.on("keyUp", this, this.interpretKeyEvents); }, interpretKeyEvents: function(event) { var map = Ember.TextSupport.KEY_EVENTS; var method = map[event.keyCode]; this._elementValueDidChange(); if (method) { return this[method](event); } }, _elementValueDidChange: function() { set(this, 'value', this.$().val()); } }); Ember.TextSupport.KEY_EVENTS = { 13: 'insertNewline', 27: 'cancel' }; })(); (function() { /** @module ember @submodule ember-handlebars */ var get = Ember.get, set = Ember.set; /** The `Ember.TextField` view class renders a text [input](https://developer.mozilla.org/en/HTML/Element/Input) element. It allows for binding Ember properties to the text field contents (`value`), live-updating as the user inputs text. Example: ``` handlebars {{view Ember.TextField valueBinding="firstName"}} ``` ## Layout and LayoutName properties Because HTML `input` elements are self closing `layout` and `layoutName` properties will not be applied. See `Ember.View`'s layout section for more information. ## HTML Attributes By default `Ember.TextField` provides support for `type`, `value`, `size`, `placeholder`, `disabled`, `maxlength` and `tabindex` attributes on a textarea. If you need to support more attributes have a look at the `attributeBindings` property in `Ember.View`'s HTML Attributes section. To globally add support for additional attributes you can reopen `Ember.TextField` or `Ember.TextSupport`. ``` javascript Ember.TextSupport.reopen({ attributeBindings: ["required"] }) ``` @class TextField @namespace Ember @extends Ember.View @uses Ember.TextSupport */ Ember.TextField = Ember.View.extend(Ember.TextSupport, /** @scope Ember.TextField.prototype */ { classNames: ['ember-text-field'], tagName: "input", attributeBindings: ['type', 'value', 'size'], /** The value attribute of the input element. As the user inputs text, this property is updated live. @property value @type String @default "" */ value: "", /** The type attribute of the input element. @property type @type String @default "text" */ type: "text", /** The size of the text field in characters. @property size @type String @default null */ size: null }); })(); (function() { /** @module ember @submodule ember-handlebars */ var get = Ember.get, set = Ember.set; /** @class Button @namespace Ember @extends Ember.View @uses Ember.TargetActionSupport @deprecated */ Ember.Button = Ember.View.extend(Ember.TargetActionSupport, { classNames: ['ember-button'], classNameBindings: ['isActive'], tagName: 'button', propagateEvents: false, attributeBindings: ['type', 'disabled', 'href', 'tabindex'], /** @private Overrides TargetActionSupport's targetObject computed property to use Handlebars-specific path resolution. @property targetObject */ targetObject: Ember.computed(function() { var target = get(this, 'target'), root = get(this, 'context'), data = get(this, 'templateData'); if (typeof target !== 'string') { return target; } return Ember.Handlebars.getPath(root, target, { data: data }); }).property('target'), // Defaults to 'button' if tagName is 'input' or 'button' type: Ember.computed(function(key, value) { var tagName = this.get('tagName'); if (value !== undefined) { this._type = value; } if (this._type !== undefined) { return this._type; } if (tagName === 'input' || tagName === 'button') { return 'button'; } }).property('tagName'), disabled: false, // Allow 'a' tags to act like buttons href: Ember.computed(function() { return this.get('tagName') === 'a' ? '#' : null; }).property('tagName'), mouseDown: function() { if (!get(this, 'disabled')) { set(this, 'isActive', true); this._mouseDown = true; this._mouseEntered = true; } return get(this, 'propagateEvents'); }, mouseLeave: function() { if (this._mouseDown) { set(this, 'isActive', false); this._mouseEntered = false; } }, mouseEnter: function() { if (this._mouseDown) { set(this, 'isActive', true); this._mouseEntered = true; } }, mouseUp: function(event) { if (get(this, 'isActive')) { // Actually invoke the button's target and action. // This method comes from the Ember.TargetActionSupport mixin. this.triggerAction(); set(this, 'isActive', false); } this._mouseDown = false; this._mouseEntered = false; return get(this, 'propagateEvents'); }, keyDown: function(event) { // Handle space or enter if (event.keyCode === 13 || event.keyCode === 32) { this.mouseDown(); } }, keyUp: function(event) { // Handle space or enter if (event.keyCode === 13 || event.keyCode === 32) { this.mouseUp(); } }, // TODO: Handle proper touch behavior. Including should make inactive when // finger moves more than 20x outside of the edge of the button (vs mouse // which goes inactive as soon as mouse goes out of edges.) touchStart: function(touch) { return this.mouseDown(touch); }, touchEnd: function(touch) { return this.mouseUp(touch); }, init: function() { Ember.deprecate("Ember.Button is deprecated and will be removed from future releases. Consider using the `{{action}}` helper."); this._super(); } }); })(); (function() { /** @module ember @submodule ember-handlebars */ var get = Ember.get, set = Ember.set; /** The `Ember.TextArea` view class renders a [textarea](https://developer.mozilla.org/en/HTML/Element/textarea) element. It allows for binding Ember properties to the text area contents (`value`), live-updating as the user inputs text. ## Layout and LayoutName properties Because HTML `textarea` elements do not contain inner HTML the `layout` and `layoutName` properties will not be applied. See `Ember.View`'s layout section for more information. ## HTML Attributes By default `Ember.TextArea` provides support for `rows`, `cols`, `placeholder`, `disabled`, `maxlength` and `tabindex` attributes on a textarea. If you need to support more attributes have a look at the `attributeBindings` property in `Ember.View`'s HTML Attributes section. To globally add support for additional attributes you can reopen `Ember.TextArea` or `Ember.TextSupport`. ``` javascript Ember.TextSupport.reopen({ attributeBindings: ["required"] }) ``` @class TextArea @namespace Ember @extends Ember.View @uses Ember.TextSupport */ Ember.TextArea = Ember.View.extend(Ember.TextSupport, { classNames: ['ember-text-area'], tagName: "textarea", attributeBindings: ['rows', 'cols'], rows: null, cols: null, _updateElementValue: Ember.observer(function() { // We do this check so cursor position doesn't get affected in IE var value = get(this, 'value'), $el = this.$(); if ($el && value !== $el.val()) { $el.val(value); } }, 'value'), init: function() { this._super(); this.on("didInsertElement", this, this._updateElementValue); } }); })(); (function() { /** @module ember @submodule ember-handlebars */ /** @class TabContainerView @namespace Ember @deprecated @extends Ember.View */ Ember.TabContainerView = Ember.View.extend({ init: function() { Ember.deprecate("Ember.TabContainerView is deprecated and will be removed from future releases."); this._super(); } }); })(); (function() { /** @module ember @submodule ember-handlebars */ var get = Ember.get; /** @class TabPaneView @namespace Ember @extends Ember.View @deprecated */ Ember.TabPaneView = Ember.View.extend({ tabsContainer: Ember.computed(function() { return this.nearestOfType(Ember.TabContainerView); }).property().volatile(), isVisible: Ember.computed(function() { return get(this, 'viewName') === get(this, 'tabsContainer.currentView'); }).property('tabsContainer.currentView').volatile(), init: function() { Ember.deprecate("Ember.TabPaneView is deprecated and will be removed from future releases."); this._super(); } }); })(); (function() { /** @module ember @submodule ember-handlebars */ var get = Ember.get, setPath = Ember.setPath; /** @class TabView @namespace Ember @extends Ember.View @deprecated */ Ember.TabView = Ember.View.extend({ tabsContainer: Ember.computed(function() { return this.nearestInstanceOf(Ember.TabContainerView); }).property().volatile(), mouseUp: function() { setPath(this, 'tabsContainer.currentView', get(this, 'value')); }, init: function() { Ember.deprecate("Ember.TabView is deprecated and will be removed from future releases."); this._super(); } }); })(); (function() { })(); (function() { /*jshint eqeqeq:false */ /** @module ember @submodule ember-handlebars */ var set = Ember.set, get = Ember.get, indexOf = Ember.EnumerableUtils.indexOf, indexesOf = Ember.EnumerableUtils.indexesOf, replace = Ember.EnumerableUtils.replace, isArray = Ember.isArray; /** The Ember.Select view class renders a [select](https://developer.mozilla.org/en/HTML/Element/select) HTML element, allowing the user to choose from a list of options. The text and `value` property of each ` ``` The `value` attribute of the selected `{{/if}}{{#each view.content}}{{view Ember.SelectOption contentBinding="this"}}{{/each}}'), attributeBindings: ['multiple', 'tabindex'], /** The `multiple` attribute of the select element. Indicates whether multiple options can be selected. @property multiple @type Boolean @default false */ multiple: false, /** The list of options. If `optionLabelPath` and `optionValuePath` are not overridden, this should be a list of strings, which will serve simultaneously as labels and values. Otherwise, this should be a list of objects. For instance: content: Ember.A([ { id: 1, firstName: 'Yehuda' }, { id: 2, firstName: 'Tom' } ]), optionLabelPath: 'content.firstName', optionValuePath: 'content.id' @property content @type Array @default null */ content: null, /** When `multiple` is false, the element of `content` that is currently selected, if any. When `multiple` is true, an array of such elements. @property selection @type Object or Array @default null */ selection: null, /** In single selection mode (when `multiple` is false), value can be used to get the current selection's value or set the selection by it's value. It is not currently supported in multiple selection mode. @property value @type String @default null */ value: Ember.computed(function(key, value) { if (arguments.length === 2) { return value; } var valuePath = get(this, 'optionValuePath').replace(/^content\.?/, ''); return valuePath ? get(this, 'selection.' + valuePath) : get(this, 'selection'); }).property('selection'), /** If given, a top-most dummy option will be rendered to serve as a user prompt. @property prompt @type String @default null */ prompt: null, /** The path of the option labels. See `content`. @property optionLabelPath @type String @default 'content' */ optionLabelPath: 'content', /** The path of the option values. See `content`. @property optionValuePath @type String @default 'content' */ optionValuePath: 'content', _change: function() { if (get(this, 'multiple')) { this._changeMultiple(); } else { this._changeSingle(); } }, selectionDidChange: Ember.observer(function() { var selection = get(this, 'selection'); if (get(this, 'multiple')) { if (!isArray(selection)) { set(this, 'selection', Ember.A([selection])); return; } this._selectionDidChangeMultiple(); } else { this._selectionDidChangeSingle(); } }, 'selection.@each'), valueDidChange: Ember.observer(function() { var content = get(this, 'content'), value = get(this, 'value'), valuePath = get(this, 'optionValuePath').replace(/^content\.?/, ''), selectedValue = (valuePath ? get(this, 'selection.' + valuePath) : get(this, 'selection')), selection; if (value !== selectedValue) { selection = content.find(function(obj) { return value === (valuePath ? get(obj, valuePath) : obj); }); this.set('selection', selection); } }, 'value'), _triggerChange: function() { var selection = get(this, 'selection'); var value = get(this, 'value'); if (selection) { this.selectionDidChange(); } if (value) { this.valueDidChange(); } this._change(); }, _changeSingle: function() { var selectedIndex = this.$()[0].selectedIndex, content = get(this, 'content'), prompt = get(this, 'prompt'); if (!content) { return; } if (prompt && selectedIndex === 0) { set(this, 'selection', null); return; } if (prompt) { selectedIndex -= 1; } set(this, 'selection', content.objectAt(selectedIndex)); }, _changeMultiple: function() { var options = this.$('option:selected'), prompt = get(this, 'prompt'), offset = prompt ? 1 : 0, content = get(this, 'content'), selection = get(this, 'selection'); if (!content){ return; } if (options) { var selectedIndexes = options.map(function(){ return this.index - offset; }).toArray(); var newSelection = content.objectsAt(selectedIndexes); if (isArray(selection)) { replace(selection, 0, get(selection, 'length'), newSelection); } else { set(this, 'selection', newSelection); } } }, _selectionDidChangeSingle: function() { var el = this.get('element'); if (!el) { return; } var content = get(this, 'content'), selection = get(this, 'selection'), selectionIndex = content ? indexOf(content, selection) : -1, prompt = get(this, 'prompt'); if (prompt) { selectionIndex += 1; } if (el) { el.selectedIndex = selectionIndex; } }, _selectionDidChangeMultiple: function() { var content = get(this, 'content'), selection = get(this, 'selection'), selectedIndexes = content ? indexesOf(content, selection) : [-1], prompt = get(this, 'prompt'), offset = prompt ? 1 : 0, options = this.$('option'), adjusted; if (options) { options.each(function() { adjusted = this.index > -1 ? this.index - offset : -1; this.selected = indexOf(selectedIndexes, adjusted) > -1; }); } }, init: function() { this._super(); this.on("didInsertElement", this, this._triggerChange); this.on("change", this, this._change); } }); Ember.SelectOption = Ember.View.extend({ tagName: 'option', attributeBindings: ['value', 'selected'], defaultTemplate: function(context, options) { options = { data: options.data, hash: {} }; Ember.Handlebars.helpers.bind.call(context, "view.label", options); }, init: function() { this.labelPathDidChange(); this.valuePathDidChange(); this._super(); }, selected: Ember.computed(function() { var content = get(this, 'content'), selection = get(this, 'parentView.selection'); if (get(this, 'parentView.multiple')) { return selection && indexOf(selection, content.valueOf()) > -1; } else { // Primitives get passed through bindings as objects... since // `new Number(4) !== 4`, we use `==` below return content == selection; } }).property('content', 'parentView.selection').volatile(), labelPathDidChange: Ember.observer(function() { var labelPath = get(this, 'parentView.optionLabelPath'); if (!labelPath) { return; } Ember.defineProperty(this, 'label', Ember.computed(function() { return get(this, labelPath); }).property(labelPath)); }, 'parentView.optionLabelPath'), valuePathDidChange: Ember.observer(function() { var valuePath = get(this, 'parentView.optionValuePath'); if (!valuePath) { return; } Ember.defineProperty(this, 'value', Ember.computed(function() { return get(this, valuePath); }).property(valuePath)); }, 'parentView.optionValuePath') }); })(); (function() { })(); (function() { /*globals Handlebars */ /** @module ember @submodule ember-handlebars */ /** @private Find templates stored in the head tag as script tags and make them available to Ember.CoreView in the global Ember.TEMPLATES object. This will be run as as jQuery DOM-ready callback. Script tags with "text/x-handlebars" will be compiled with Ember's Handlebars and are suitable for use as a view's template. Those with type="text/x-raw-handlebars" will be compiled with regular Handlebars and are suitable for use in views' computed properties. @method bootstrap @for Ember.Handlebars @static @param ctx */ Ember.Handlebars.bootstrap = function(ctx) { var selectors = 'script[type="text/x-handlebars"], script[type="text/x-raw-handlebars"]'; Ember.$(selectors, ctx) .each(function() { // Get a reference to the script tag var script = Ember.$(this), type = script.attr('type'); var compile = (script.attr('type') === 'text/x-raw-handlebars') ? Ember.$.proxy(Handlebars.compile, Handlebars) : Ember.$.proxy(Ember.Handlebars.compile, Ember.Handlebars), // Get the name of the script, used by Ember.View's templateName property. // First look for data-template-name attribute, then fall back to its // id if no name is found. templateName = script.attr('data-template-name') || script.attr('id') || 'application', template = compile(script.html()); // For templates which have a name, we save them and then remove them from the DOM Ember.TEMPLATES[templateName] = template; // Remove script tag from DOM script.remove(); }); }; function bootstrap() { Ember.Handlebars.bootstrap( Ember.$(document) ); } /* We tie this to application.load to ensure that we've at least attempted to bootstrap at the point that the application is loaded. We also tie this to document ready since we're guaranteed that all the inline templates are present at this point. There's no harm to running this twice, since we remove the templates from the DOM after processing. */ Ember.onLoad('application', bootstrap); })(); (function() { /** Ember Handlebars @module ember @submodule ember-handlebars @requires ember-views */ })(); // Version: v1.0.pre-243-g2578a65 // Last commit: 2578a65 (2012-10-21 18:51:25 +0200) (function() { /** Ember @module ember */ })(); ;ansiparse = function (str) { // // I'm terrible at writing parsers. // var matchingControl = null, matchingData = null, matchingText = '', ansiState = [], result = [], state = {}; // // General workflow for this thing is: // \033\[33mText // | | | // | | matchingText // | matchingData // matchingControl // // In further steps we hope it's all going to be fine. It usually is. // for (var i = 0; i < str.length; i++) { if (matchingControl != null) { if (matchingControl == '\033' && str[i] == '\[') { // // We've matched full control code. Lets start matching formating data. // // // "emit" matched text with correct state // if (matchingText) { state.text = matchingText; result.push(state); state = {}; matchingText = ""; } matchingControl = null; matchingData = ''; } else { // // We failed to match anything - most likely a bad control code. We // go back to matching regular strings. // matchingText += matchingControl + str[i]; matchingControl = null; } continue; } else if (matchingData != null) { if (str[i] == ';') { // // `;` separates many formatting codes, for example: `\033[33;43m` // means that both `33` and `43` should be applied. // // TODO: this can be simplified by modifying state here. // ansiState.push(matchingData); matchingData = ''; } else if (str[i] == 'm') { // // `m` finished whole formatting code. We can proceed to matching // formatted text. // ansiState.push(matchingData); matchingData = null; matchingText = ''; // // Convert matched formatting data into user-friendly state object. // // TODO: DRY. // ansiState.forEach(function (ansiCode) { if (ansiparse.foregroundColors[ansiCode]) { state.foreground = ansiparse.foregroundColors[ansiCode]; } else if (ansiparse.backgroundColors[ansiCode]) { state.background = ansiparse.backgroundColors[ansiCode]; } else if (ansiCode == 39) { delete state.foreground; } else if (ansiCode == 49) { delete state.background; } else if (ansiparse.styles[ansiCode]) { state[ansiparse.styles[ansiCode]] = true; } else if (ansiCode == 22) { state.bold = false; } else if (ansiCode == 23) { state.italic = false; } else if (ansiCode == 24) { state.underline = false; } }); ansiState = []; } else { matchingData += str[i]; } continue; } if (str[i] == '\033') { matchingControl = str[i]; } else { matchingText += str[i]; } } if (matchingText) { state.text = matchingText + (matchingControl ? matchingControl : ''); result.push(state); } return result; } ansiparse.foregroundColors = { '30': 'black', '31': 'red', '32': 'green', '33': 'yellow', '34': 'blue', '35': 'magenta', '36': 'cyan', '37': 'white', '90': 'grey' }; ansiparse.backgroundColors = { '40': 'black', '41': 'red', '42': 'green', '43': 'yellow', '44': 'blue', '45': 'magenta', '46': 'cyan', '47': 'white' }; ansiparse.styles = { '1': 'bold', '3': 'italic', '4': 'underline' }; if (typeof module == "object" && typeof window == "undefined") { module.exports = ansiparse; } ;(function() { window.DS = Ember.Namespace.create({ CURRENT_API_REVISION: 4 }); })(); (function() { var get = Ember.get, set = Ember.set; /** A record array is an array that contains records of a certain type. The record array materializes records as needed when they are retrieved for the first time. You should not create record arrays yourself. Instead, an instance of DS.RecordArray or its subclasses will be returned by your application's store in response to queries. */ DS.RecordArray = Ember.ArrayProxy.extend({ /** The model type contained by this record array. @type DS.Model */ type: null, // The array of client ids backing the record array. When a // record is requested from the record array, the record // for the client id at the same index is materialized, if // necessary, by the store. content: null, // The store that created this record array. store: null, objectAtContent: function(index) { var content = get(this, 'content'), clientId = content.objectAt(index), store = get(this, 'store'); if (clientId !== undefined) { return store.findByClientId(get(this, 'type'), clientId); } } }); })(); (function() { var get = Ember.get; DS.FilteredRecordArray = DS.RecordArray.extend({ filterFunction: null, replace: function() { var type = get(this, 'type').toString(); throw new Error("The result of a client-side filter (on " + type + ") is immutable."); }, updateFilter: Ember.observer(function() { var store = get(this, 'store'); store.updateRecordArrayFilter(this, get(this, 'type'), get(this, 'filterFunction')); }, 'filterFunction') }); })(); (function() { var get = Ember.get, set = Ember.set; DS.AdapterPopulatedRecordArray = DS.RecordArray.extend({ query: null, isLoaded: false, replace: function() { var type = get(this, 'type').toString(); throw new Error("The result of a server query (on " + type + ") is immutable."); }, load: function(array) { var store = get(this, 'store'), type = get(this, 'type'); var clientIds = store.loadMany(type, array).clientIds; this.beginPropertyChanges(); set(this, 'content', Ember.A(clientIds)); set(this, 'isLoaded', true); this.endPropertyChanges(); } }); })(); (function() { var get = Ember.get, set = Ember.set, guidFor = Ember.guidFor; var Set = function() { this.hash = {}; this.list = []; }; Set.prototype = { add: function(item) { var hash = this.hash, guid = guidFor(item); if (hash.hasOwnProperty(guid)) { return; } hash[guid] = true; this.list.push(item); }, remove: function(item) { var hash = this.hash, guid = guidFor(item); if (!hash.hasOwnProperty(guid)) { return; } delete hash[guid]; var list = this.list, index = Ember.EnumerableUtils.indexOf(this, item); list.splice(index, 1); }, isEmpty: function() { return this.list.length === 0; } }; var LoadedState = Ember.State.extend({ recordWasAdded: function(manager, record) { var dirty = manager.dirty, observer; dirty.add(record); observer = function() { if (!get(record, 'isDirty')) { record.removeObserver('isDirty', observer); manager.send('childWasSaved', record); } }; record.addObserver('isDirty', observer); }, recordWasRemoved: function(manager, record) { var dirty = manager.dirty, observer; dirty.add(record); observer = function() { record.removeObserver('isDirty', observer); if (!get(record, 'isDirty')) { manager.send('childWasSaved', record); } }; record.addObserver('isDirty', observer); } }); var states = { loading: Ember.State.create({ isLoaded: false, isDirty: false, loadedRecords: function(manager, count) { manager.decrement(count); }, becameLoaded: function(manager) { manager.transitionTo('clean'); } }), clean: LoadedState.create({ isLoaded: true, isDirty: false, recordWasAdded: function(manager, record) { this._super(manager, record); manager.goToState('dirty'); }, update: function(manager, clientIds) { var manyArray = manager.manyArray; set(manyArray, 'content', clientIds); } }), dirty: LoadedState.create({ isLoaded: true, isDirty: true, childWasSaved: function(manager, child) { var dirty = manager.dirty; dirty.remove(child); if (dirty.isEmpty()) { manager.send('arrayBecameSaved'); } }, arrayBecameSaved: function(manager) { manager.goToState('clean'); } }) }; DS.ManyArrayStateManager = Ember.StateManager.extend({ manyArray: null, initialState: 'loading', states: states, /** This number is used to keep track of the number of outstanding records that must be loaded before the array is considered loaded. As results stream in, this number is decremented until it becomes zero, at which case the `isLoaded` flag will be set to true */ counter: 0, init: function() { this._super(); this.dirty = new Set(); this.counter = get(this, 'manyArray.length'); }, decrement: function(count) { var counter = this.counter = this.counter - count; Ember.assert("Somehow the ManyArray loaded counter went below 0. This is probably an ember-data bug. Please report it at https://github.com/emberjs/data/issues", counter >= 0); if (counter === 0) { this.send('becameLoaded'); } } }); })(); (function() { var get = Ember.get, set = Ember.set; DS.ManyArray = DS.RecordArray.extend({ init: function() { set(this, 'stateManager', DS.ManyArrayStateManager.create({ manyArray: this })); return this._super(); }, parentRecord: null, isDirty: Ember.computed(function() { return get(this, 'stateManager.currentState.isDirty'); }).property('stateManager.currentState').cacheable(), isLoaded: Ember.computed(function() { return get(this, 'stateManager.currentState.isLoaded'); }).property('stateManager.currentState').cacheable(), send: function(event, context) { this.get('stateManager').send(event, context); }, fetch: function() { var clientIds = get(this, 'content'), store = get(this, 'store'), type = get(this, 'type'); store.fetchUnloadedClientIds(type, clientIds); }, // Overrides Ember.Array's replace method to implement replaceContent: function(index, removed, added) { var parentRecord = get(this, 'parentRecord'); var pendingParent = parentRecord && !get(parentRecord, 'id'); var stateManager = get(this, 'stateManager'); // Map the array of record objects into an array of client ids. added = added.map(function(record) { Ember.assert("You can only add records of " + (get(this, 'type') && get(this, 'type').toString()) + " to this association.", !get(this, 'type') || (get(this, 'type') === record.constructor)); // If the record to which this many array belongs does not yet // have an id, notify the newly-added record that it must wait // for the parent to receive an id before the child can be // saved. if (pendingParent) { record.send('waitingOn', parentRecord); } var oldParent = this.assignInverse(record, parentRecord); record.get('transaction') .relationshipBecameDirty(record, oldParent, parentRecord); stateManager.send('recordWasAdded', record); return record.get('clientId'); }, this); var store = this.store; var len = index+removed, record; for (var i = index; i < len; i++) { // TODO: null out inverse FK record = this.objectAt(i); var oldParent = this.assignInverse(record, parentRecord, true); record.get('transaction') .relationshipBecameDirty(record, parentRecord, null); // If we put the child record into a pending state because // we were waiting on the parent record to get an id, we // can tell the child it no longer needs to wait. if (pendingParent) { record.send('doneWaitingOn', parentRecord); } stateManager.send('recordWasAdded', record); } this._super(index, removed, added); }, assignInverse: function(record, parentRecord, remove) { var associationMap = get(record.constructor, 'associations'), possibleAssociations = associationMap.get(parentRecord.constructor), possible, actual, oldParent; if (!possibleAssociations) { return; } for (var i = 0, l = possibleAssociations.length; i < l; i++) { possible = possibleAssociations[i]; if (possible.kind === 'belongsTo') { actual = possible; break; } } if (actual) { oldParent = get(record, actual.name); set(record, actual.name, remove ? null : parentRecord); return oldParent; } }, // Create a child record within the parentRecord createRecord: function(hash, transaction) { var parentRecord = get(this, 'parentRecord'), store = get(parentRecord, 'store'), type = get(this, 'type'), record; transaction = transaction || get(parentRecord, 'transaction'); record = store.createRecord.call(store, type, hash, transaction); this.pushObject(record); return record; } }); })(); (function() { })(); (function() { var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt, removeObject = Ember.EnumerableUtils.removeObject; /** A transaction allows you to collect multiple records into a unit of work that can be committed or rolled back as a group. For example, if a record has local modifications that have not yet been saved, calling `commit()` on its transaction will cause those modifications to be sent to the adapter to be saved. Calling `rollback()` on its transaction would cause all of the modifications to be discarded and the record to return to the last known state before changes were made. If a newly created record's transaction is rolled back, it will immediately transition to the deleted state. If you do not explicitly create a transaction, a record is assigned to an implicit transaction called the default transaction. In these cases, you can treat your application's instance of `DS.Store` as a transaction and call the `commit()` and `rollback()` methods on the store itself. Once a record has been successfully committed or rolled back, it will be moved back to the implicit transaction. Because it will now be in a clean state, it can be moved to a new transaction if you wish. ### Creating a Transaction To create a new transaction, call the `transaction()` method of your application's `DS.Store` instance: var transaction = App.store.transaction(); This will return a new instance of `DS.Transaction` with no records yet assigned to it. ### Adding Existing Records Add records to a transaction using the `add()` method: record = App.store.find(Person, 1); transaction.add(record); Note that only records whose `isDirty` flag is `false` may be added to a transaction. Once modifications to a record have been made (its `isDirty` flag is `true`), it is not longer able to be added to a transaction. ### Creating New Records Because newly created records are dirty from the time they are created, and because dirty records can not be added to a transaction, you must use the `createRecord()` method to assign new records to a transaction. For example, instead of this: var transaction = store.transaction(); var person = Person.createRecord({ name: "Steve" }); // won't work because person is dirty transaction.add(person); Call `createRecord()` on the transaction directly: var transaction = store.transaction(); transaction.createRecord(Person, { name: "Steve" }); ### Asynchronous Commits Typically, all of the records in a transaction will be committed together. However, new records that have a dependency on other new records need to wait for their parent record to be saved and assigned an ID. In that case, the child record will continue to live in the transaction until its parent is saved, at which time the transaction will attempt to commit again. For this reason, you should not re-use transactions once you have committed them. Always make a new transaction and move the desired records to it before calling commit. */ DS.Transaction = Ember.Object.extend({ /** @private Creates the bucket data structure used to segregate records by type. */ init: function() { set(this, 'buckets', { clean: Ember.Map.create(), created: Ember.Map.create(), updated: Ember.Map.create(), deleted: Ember.Map.create(), inflight: Ember.Map.create() }); this.dirtyRelationships = { byChild: Ember.Map.create(), byNewParent: Ember.Map.create(), byOldParent: Ember.Map.create() }; }, /** Creates a new record of the given type and assigns it to the transaction on which the method was called. This is useful as only clean records can be added to a transaction and new records created using other methods immediately become dirty. @param {DS.Model} type the model type to create @param {Object} hash the data hash to assign the new record */ createRecord: function(type, hash) { var store = get(this, 'store'); return store.createRecord(type, hash, this); }, /** Adds an existing record to this transaction. Only records without modficiations (i.e., records whose `isDirty` property is `false`) can be added to a transaction. @param {DS.Model} record the record to add to the transaction */ add: function(record) { // we could probably make this work if someone has a valid use case. Do you? Ember.assert("Once a record has changed, you cannot move it into a different transaction", !get(record, 'isDirty')); var recordTransaction = get(record, 'transaction'), defaultTransaction = get(this, 'store.defaultTransaction'); Ember.assert("Models cannot belong to more than one transaction at a time.", recordTransaction === defaultTransaction); this.adoptRecord(record); }, /** Commits the transaction, which causes all of the modified records that belong to the transaction to be sent to the adapter to be saved. Once you call `commit()` on a transaction, you should not re-use it. When a record is saved, it will be removed from this transaction and moved back to the store's default transaction. */ commit: function() { var self = this, iterate; iterate = function(bucketType, fn, binding) { var dirty = self.bucketForType(bucketType); dirty.forEach(function(type, records) { if (records.isEmpty()) { return; } var array = []; records.forEach(function(record) { record.send('willCommit'); if (get(record, 'isPending') === false) { array.push(record); } }); fn.call(binding, type, array); }); }; var commitDetails = { updated: { eachType: function(fn, binding) { iterate('updated', fn, binding); } }, created: { eachType: function(fn, binding) { iterate('created', fn, binding); } }, deleted: { eachType: function(fn, binding) { iterate('deleted', fn, binding); } } }; var store = get(this, 'store'); var adapter = get(store, '_adapter'); this.removeCleanRecords(); if (adapter && adapter.commit) { adapter.commit(store, commitDetails); } else { throw fmt("Adapter is either null or does not implement `commit` method", this); } }, /** Rolling back a transaction resets the records that belong to that transaction. Updated records have their properties reset to the last known value from the persistence layer. Deleted records are reverted to a clean, non-deleted state. Newly created records immediately become deleted, and are not sent to the adapter to be persisted. After the transaction is rolled back, any records that belong to it will return to the store's default transaction, and the current transaction should not be used again. */ rollback: function() { var store = get(this, 'store'), dirty; // Loop through all of the records in each of the dirty states // and initiate a rollback on them. As a side effect of telling // the record to roll back, it should also move itself out of // the dirty bucket and into the clean bucket. ['created', 'updated', 'deleted', 'inflight'].forEach(function(bucketType) { dirty = this.bucketForType(bucketType); dirty.forEach(function(type, records) { records.forEach(function(record) { record.send('rollback'); }); }); }, this); // Now that all records in the transaction are guaranteed to be // clean, migrate them all to the store's default transaction. this.removeCleanRecords(); }, /** @private Removes a record from this transaction and back to the store's default transaction. Note: This method is private for now, but should probably be exposed in the future once we have stricter error checking (for example, in the case of the record being dirty). @param {DS.Model} record */ remove: function(record) { var defaultTransaction = get(this, 'store.defaultTransaction'); defaultTransaction.adoptRecord(record); }, /** @private Removes all of the records in the transaction's clean bucket. */ removeCleanRecords: function() { var clean = this.bucketForType('clean'), self = this; clean.forEach(function(type, records) { records.forEach(function(record) { self.remove(record); }); }); }, /** @private Returns the bucket for the given bucket type. For example, you might call `this.bucketForType('updated')` to get the `Ember.Map` that contains all of the records that have changes pending. @param {String} bucketType the type of bucket @returns Ember.Map */ bucketForType: function(bucketType) { var buckets = get(this, 'buckets'); return get(buckets, bucketType); }, /** @private This method moves a record into a different transaction without the normal checks that ensure that the user is not doing something weird, like moving a dirty record into a new transaction. It is designed for internal use, such as when we are moving a clean record into a new transaction when the transaction is committed. This method must not be called unless the record is clean. @param {DS.Model} record */ adoptRecord: function(record) { var oldTransaction = get(record, 'transaction'); if (oldTransaction) { oldTransaction.removeFromBucket('clean', record); } this.addToBucket('clean', record); set(record, 'transaction', this); }, /** @private Adds a record to the named bucket. @param {String} bucketType one of `clean`, `created`, `updated`, or `deleted` */ addToBucket: function(bucketType, record) { var bucket = this.bucketForType(bucketType), type = record.constructor; var records = bucket.get(type); if (!records) { records = Ember.OrderedSet.create(); bucket.set(type, records); } records.add(record); }, /** @private Removes a record from the named bucket. @param {String} bucketType one of `clean`, `created`, `updated`, or `deleted` */ removeFromBucket: function(bucketType, record) { var bucket = this.bucketForType(bucketType), type = record.constructor; var records = bucket.get(type); records.remove(record); }, /** @private Called by a ManyArray when a new record is added to it. This method will index a relationship description by the child record, its old parent, and its new parent. The store will provide this description to the adapter's shouldCommit method, so it can determine whether any of the records is pending another record. The store will also provide a list of these descriptions to the adapter's commit method. @param {DS.Model} record the new child record @param {DS.Model} oldParent the parent that the child is moving from, or null @param {DS.Model} newParent the parent that the child is moving to, or null */ relationshipBecameDirty: function(child, oldParent, newParent) { var relationships = this.dirtyRelationships, relationship; var relationshipsForChild = relationships.byChild.get(child), possibleRelationship, needsNewEntries = true; // If the child has any existing dirty relationships in this // transaction, we need to collapse the old relationship // into the new one. For example, if we change the parent of // a child record before saving, there is no need to save the // record that was its parent temporarily. if (relationshipsForChild) { // Loop through all of the relationships we know about that // contain the same child as the new relationship. for (var i=0, l=relationshipsForChild.length; i B // B -> C // // In this case, there is no need to remember the A->B // change. We can collapse both changes into: // // A -> C // // Another possible case is: // // A -> B // B -> A // // In this case, we don't need to do anything. We can // simply remove the original A->B change and call it // a day. if (relationship.newParent === oldParent) { oldParent = relationship.oldParent; this.removeRelationship(relationship); // This is the case of A->B followed by B->A. if (relationship.oldParent === newParent) { needsNewEntries = false; } } } } relationship = { child: child, oldParent: oldParent, newParent: newParent }; // If we didn't go A->B and then B->A, add new dirty relationship // entries. if (needsNewEntries) { this.addRelationshipTo('byChild', child, relationship); this.addRelationshipTo('byOldParent', oldParent, relationship); this.addRelationshipTo('byNewParent', newParent, relationship); } }, removeRelationship: function(relationship) { var relationships = this.dirtyRelationships; removeObject(relationships.byOldParent.get(relationship.oldParent), relationship); removeObject(relationships.byNewParent.get(relationship.newParent), relationship); removeObject(relationships.byChild.get(relationship.child), relationship); }, addRelationshipTo: function(type, record, description) { var map = this.dirtyRelationships[type]; var relationships = map.get(record); if (!relationships) { relationships = [ description ]; map.set(record, relationships); } else { relationships.push(description); } }, /** @private Called by a record's state manager to indicate that the record has entered a dirty state. The record will be moved from the `clean` bucket and into the appropriate dirty bucket. @param {String} bucketType one of `created`, `updated`, or `deleted` */ recordBecameDirty: function(bucketType, record) { this.removeFromBucket('clean', record); this.addToBucket(bucketType, record); }, /** @private Called by a record's state manager to indicate that the record has entered inflight state. The record will be moved from its current dirty bucket and into the `inflight` bucket. @param {String} bucketType one of `created`, `updated`, or `deleted` */ recordBecameInFlight: function(kind, record) { this.removeFromBucket(kind, record); this.addToBucket('inflight', record); }, /** @private Called by a record's state manager to indicate that the record has entered a clean state. The record will be moved from its current dirty or inflight bucket and into the `clean` bucket. @param {String} bucketType one of `created`, `updated`, or `deleted` */ recordBecameClean: function(kind, record) { this.removeFromBucket(kind, record); this.remove(record); } }); })(); (function() { /*globals Ember*/ var get = Ember.get, set = Ember.set, fmt = Ember.String.fmt; var DATA_PROXY = { get: function(name) { return this.savedData[name]; } }; // These values are used in the data cache when clientIds are // needed but the underlying data has not yet been loaded by // the server. var UNLOADED = 'unloaded'; var LOADING = 'loading'; // Implementors Note: // // The variables in this file are consistently named according to the following // scheme: // // * +id+ means an identifier managed by an external source, provided inside the // data hash provided by that source. // * +clientId+ means a transient numerical identifier generated at runtime by // the data store. It is important primarily because newly created objects may // not yet have an externally generated id. // * +type+ means a subclass of DS.Model. /** The store contains all of the hashes for records loaded from the server. It is also responsible for creating instances of DS.Model when you request one of these data hashes, so that they can be bound to in your Handlebars templates. Create a new store like this: MyApp.store = DS.Store.create(); You can retrieve DS.Model instances from the store in several ways. To retrieve a record for a specific id, use the `find()` method: var record = MyApp.store.find(MyApp.Contact, 123); By default, the store will talk to your backend using a standard REST mechanism. You can customize how the store talks to your backend by specifying a custom adapter: MyApp.store = DS.Store.create({ adapter: 'MyApp.CustomAdapter' }); You can learn more about writing a custom adapter by reading the `DS.Adapter` documentation. */ DS.Store = Ember.Object.extend({ /** Many methods can be invoked without specifying which store should be used. In those cases, the first store created will be used as the default. If an application has multiple stores, it should specify which store to use when performing actions, such as finding records by id. The init method registers this store as the default if none is specified. */ init: function() { // Enforce API revisioning. See BREAKING_CHANGES.md for more. var revision = get(this, 'revision'); if (revision !== DS.CURRENT_API_REVISION && !Ember.ENV.TESTING) { throw new Error("Error: The Ember Data library has had breaking API changes since the last time you updated the library. Please review the list of breaking changes at https://github.com/emberjs/data/blob/master/BREAKING_CHANGES.md, then update your store's `revision` property to " + DS.CURRENT_API_REVISION); } if (!get(DS, 'defaultStore') || get(this, 'isDefaultStore')) { set(DS, 'defaultStore', this); } // internal bookkeeping; not observable this.typeMaps = {}; this.recordCache = []; this.clientIdToId = {}; this.recordArraysByClientId = {}; // Internally, we maintain a map of all unloaded IDs requested by // a ManyArray. As the adapter loads hashes into the store, the // store notifies any interested ManyArrays. When the ManyArray's // total number of loading records drops to zero, it becomes // `isLoaded` and fires a `didLoad` event. this.loadingRecordArrays = {}; set(this, 'defaultTransaction', this.transaction()); return this._super(); }, /** Returns a new transaction scoped to this store. @see {DS.Transaction} @returns DS.Transaction */ transaction: function() { return DS.Transaction.create({ store: this }); }, /** @private This is used only by the record's DataProxy. Do not use this directly. */ dataForRecord: function(record) { var type = record.constructor, clientId = get(record, 'clientId'), typeMap = this.typeMapFor(type); return typeMap.cidToHash[clientId]; }, /** The adapter to use to communicate to a backend server or other persistence layer. This can be specified as an instance, a class, or a property path that specifies where the adapter can be located. @property {DS.Adapter|String} */ adapter: null, /** @private This property returns the adapter, after resolving a possible String. @returns DS.Adapter */ _adapter: Ember.computed(function() { var adapter = get(this, 'adapter'); if (typeof adapter === 'string') { return get(this, adapter, false) || get(window, adapter); } return adapter; }).property('adapter').cacheable(), // A monotonically increasing number to be used to uniquely identify // data hashes and records. clientIdCounter: 1, // ..................... // . CREATE NEW RECORD . // ..................... /** Create a new record in the current store. The properties passed to this method are set on the newly created record. @param {subclass of DS.Model} type @param {Object} properties a hash of properties to set on the newly created record. @returns DS.Model */ createRecord: function(type, properties, transaction) { properties = properties || {}; // Create a new instance of the model `type` and put it // into the specified `transaction`. If no transaction is // specified, the default transaction will be used. // // NOTE: A `transaction` is specified when the // `transaction.createRecord` API is used. var record = type._create({ store: this }); transaction = transaction || get(this, 'defaultTransaction'); transaction.adoptRecord(record); // Extract the primary key from the `properties` hash, // based on the `primaryKey` for the model type. var primaryKey = get(record, 'primaryKey'), id = properties[primaryKey] || null; // If the passed properties do not include a primary key, // give the adapter an opportunity to generate one. var adapter; if (Ember.none(id)) { adapter = get(this, 'adapter'); if (adapter && adapter.generateIdForRecord) { id = adapter.generateIdForRecord(this, record); properties.id = id; } } var hash = {}, clientId; // Push the hash into the store. If present, associate the // extracted `id` with the hash. clientId = this.pushHash(hash, id, type); record.send('didChangeData'); var recordCache = get(this, 'recordCache'); // Now that we have a clientId, attach it to the record we // just created. set(record, 'clientId', clientId); // Store the record we just created in the record cache for // this clientId. recordCache[clientId] = record; // Set the properties specified on the record. record.setProperties(properties); this.updateRecordArrays(type, clientId, get(record, 'data')); return record; }, // ................. // . DELETE RECORD . // ................. /** For symmetry, a record can be deleted via the store. @param {DS.Model} record */ deleteRecord: function(record) { record.send('deleteRecord'); }, // ................ // . FIND RECORDS . // ................ /** This is the main entry point into finding records. The first parameter to this method is always a subclass of `DS.Model`. You can use the `find` method on a subclass of `DS.Model` directly if your application only has one store. For example, instead of `store.find(App.Person, 1)`, you could say `App.Person.find(1)`. --- To find a record by ID, pass the `id` as the second parameter: store.find(App.Person, 1); App.Person.find(1); If the record with that `id` had not previously been loaded, the store will return an empty record immediately and ask the adapter to find the data by calling the adapter's `find` method. The `find` method will always return the same object for a given type and `id`. To check whether the adapter has populated a record, you can check its `isLoaded` property. --- To find all records for a type, call `find` with no additional parameters: store.find(App.Person); App.Person.find(); This will return a `RecordArray` representing all known records for the given type and kick off a request to the adapter's `findAll` method to load any additional records for the type. The `RecordArray` returned by `find()` is live. If any more records for the type are added at a later time through any mechanism, it will automatically update to reflect the change. --- To find a record by a query, call `find` with a hash as the second parameter: store.find(App.Person, { page: 1 }); App.Person.find({ page: 1 }); This will return a `RecordArray` immediately, but it will always be an empty `RecordArray` at first. It will call the adapter's `findQuery` method, which will populate the `RecordArray` once the server has returned results. You can check whether a query results `RecordArray` has loaded by checking its `isLoaded` property. */ find: function(type, id, query) { if (id === undefined) { return this.findAll(type); } if (query !== undefined) { return this.findMany(type, id, query); } else if (Ember.typeOf(id) === 'object') { return this.findQuery(type, id); } if (Ember.isArray(id)) { return this.findMany(type, id); } var clientId = this.typeMapFor(type).idToCid[id]; return this.findByClientId(type, clientId, id); }, findByClientId: function(type, clientId, id) { var recordCache = get(this, 'recordCache'), dataCache, record; // If there is already a clientId assigned for this // type/id combination, try to find an existing // record for that id and return. Otherwise, // materialize a new record and set its data to the // value we already have. if (clientId !== undefined) { record = recordCache[clientId]; if (!record) { // create a new instance of the model type in the // 'isLoading' state record = this.materializeRecord(type, clientId); dataCache = this.typeMapFor(type).cidToHash; if (typeof dataCache[clientId] === 'object') { record.send('didChangeData'); } } } else { clientId = this.pushHash(LOADING, id, type); // create a new instance of the model type in the // 'isLoading' state record = this.materializeRecord(type, clientId, id); // let the adapter set the data, possibly async var adapter = get(this, '_adapter'); if (adapter && adapter.find) { adapter.find(this, type, id); } else { throw fmt("Adapter is either null or does not implement `find` method", this); } } return record; }, /** @private Given a type and array of `clientId`s, determines which of those `clientId`s has not yet been loaded. In preparation for loading, this method also marks any unloaded `clientId`s as loading. */ neededClientIds: function(type, clientIds) { var neededClientIds = [], typeMap = this.typeMapFor(type), dataCache = typeMap.cidToHash, clientId; for (var i=0, l=clientIds.length; i "created.uncommitted" The `DS.Model` states are themselves stateless. What we mean is that, though each instance of a record also has a unique instance of a `DS.StateManager`, the hierarchical states that each of *those* points to is a shared data structure. For performance reasons, instead of each record getting its own copy of the hierarchy of states, each state manager points to this global, immutable shared instance. How does a state know which record it should be acting on? We pass a reference to the current state manager as the first parameter to every method invoked on a state. The state manager passed as the first parameter is where you should stash state about the record if needed; you should never store data on the state object itself. If you need access to the record being acted on, you can retrieve the state manager's `record` property. For example, if you had an event handler `myEvent`: myEvent: function(manager) { var record = manager.get('record'); record.doSomething(); } For more information about state managers in general, see the Ember.js documentation on `Ember.StateManager`. ### Events, Flags, and Transitions A state may implement zero or more events, flags, or transitions. #### Events Events are named functions that are invoked when sent to a record. The state manager will first look for a method with the given name on the current state. If no method is found, it will search the current state's parent, and then its grandparent, and so on until reaching the top of the hierarchy. If the root is reached without an event handler being found, an exception will be raised. This can be very helpful when debugging new features. Here's an example implementation of a state with a `myEvent` event handler: aState: DS.State.create({ myEvent: function(manager, param) { console.log("Received myEvent with "+param); } }) To trigger this event: record.send('myEvent', 'foo'); //=> "Received myEvent with foo" Note that an optional parameter can be sent to a record's `send()` method, which will be passed as the second parameter to the event handler. Events should transition to a different state if appropriate. This can be done by calling the state manager's `goToState()` method with a path to the desired state. The state manager will attempt to resolve the state path relative to the current state. If no state is found at that path, it will attempt to resolve it relative to the current state's parent, and then its parent, and so on until the root is reached. For example, imagine a hierarchy like this: * created * start <-- currentState * inFlight * updated * inFlight If we are currently in the `start` state, calling `goToState('inFlight')` would transition to the `created.inFlight` state, while calling `goToState('updated.inFlight')` would transition to the `updated.inFlight` state. Remember that *only events* should ever cause a state transition. You should never call `goToState()` from outside a state's event handler. If you are tempted to do so, create a new event and send that to the state manager. #### Flags Flags are Boolean values that can be used to introspect a record's current state in a more user-friendly way than examining its state path. For example, instead of doing this: var statePath = record.get('stateManager.currentState.path'); if (statePath === 'created.inFlight') { doSomething(); } You can say: if (record.get('isNew') && record.get('isSaving')) { doSomething(); } If your state does not set a value for a given flag, the value will be inherited from its parent (or the first place in the state hierarchy where it is defined). The current set of flags are defined below. If you want to add a new flag, in addition to the area below, you will also need to declare it in the `DS.Model` class. #### Transitions Transitions are like event handlers but are called automatically upon entering or exiting a state. To implement a transition, just call a method either `enter` or `exit`: myState: DS.State.create({ // Gets called automatically when entering // this state. enter: function(manager) { console.log("Entered myState"); } }) Note that enter and exit events are called once per transition. If the current state changes, but changes to another child state of the parent, the transition event on the parent will not be triggered. */ var stateProperty = Ember.computed(function(key) { var parent = get(this, 'parentState'); if (parent) { return get(parent, key); } }).property(); var isEmptyObject = function(object) { for (var name in object) { if (object.hasOwnProperty(name)) { return false; } } return true; }; var hasDefinedProperties = function(object) { for (var name in object) { if (object.hasOwnProperty(name) && object[name]) { return true; } } return false; }; DS.State = Ember.State.extend({ isLoaded: stateProperty, isDirty: stateProperty, isSaving: stateProperty, isDeleted: stateProperty, isError: stateProperty, isNew: stateProperty, isValid: stateProperty, isPending: stateProperty, // For states that are substates of a // DirtyState (updated or created), it is // useful to be able to determine which // type of dirty state it is. dirtyType: stateProperty }); var setProperty = function(manager, context) { var key = context.key, value = context.value; var record = get(manager, 'record'), data = get(record, 'data'); set(data, key, value); }; var setAssociation = function(manager, context) { var key = context.key, value = context.value; var record = get(manager, 'record'), data = get(record, 'data'); data.setAssociation(key, value); }; var didChangeData = function(manager) { var record = get(manager, 'record'), data = get(record, 'data'); data._savedData = null; record.notifyPropertyChange('data'); }; // The waitingOn event shares common functionality // between the different dirty states, but each is // treated slightly differently. This method is exposed // so that each implementation can invoke the common // behavior, and then implement the behavior specific // to the state. var waitingOn = function(manager, object) { var record = get(manager, 'record'), pendingQueue = get(record, 'pendingQueue'), objectGuid = guidFor(object); var observer = function() { if (get(object, 'id')) { manager.send('doneWaitingOn', object); Ember.removeObserver(object, 'id', observer); } }; pendingQueue[objectGuid] = [object, observer]; Ember.addObserver(object, 'id', observer); }; // Implementation notes: // // Each state has a boolean value for all of the following flags: // // * isLoaded: The record has a populated `data` property. When a // record is loaded via `store.find`, `isLoaded` is false // until the adapter sets it. When a record is created locally, // its `isLoaded` property is always true. // * isDirty: The record has local changes that have not yet been // saved by the adapter. This includes records that have been // created (but not yet saved) or deleted. // * isSaving: The record's transaction has been committed, but // the adapter has not yet acknowledged that the changes have // been persisted to the backend. // * isDeleted: The record was marked for deletion. When `isDeleted` // is true and `isDirty` is true, the record is deleted locally // but the deletion was not yet persisted. When `isSaving` is // true, the change is in-flight. When both `isDirty` and // `isSaving` are false, the change has persisted. // * isError: The adapter reported that it was unable to save // local changes to the backend. This may also result in the // record having its `isValid` property become false if the // adapter reported that server-side validations failed. // * isNew: The record was created on the client and the adapter // did not yet report that it was successfully saved. // * isValid: No client-side validations have failed and the // adapter did not report any server-side validation failures. // * isPending: A record `isPending` when it belongs to an // association on another record and that record has not been // saved. A record in this state cannot be saved because it // lacks a "foreign key" that will be supplied by its parent // association when the parent record has been created. When // the adapter reports that the parent has saved, the // `isPending` property on all children will become `false` // and the transaction will try to commit the records. // This mixin is mixed into various uncommitted states. Make // sure to mix it in *after* the class definition, so its // super points to the class definition. var Uncommitted = Ember.Mixin.create({ setProperty: setProperty, setAssociation: setAssociation }); // These mixins are mixed into substates of the concrete // subclasses of DirtyState. var CreatedUncommitted = Ember.Mixin.create({ deleteRecord: function(manager) { var record = get(manager, 'record'); this._super(manager); record.withTransaction(function(t) { t.recordBecameClean('created', record); }); manager.goToState('deleted.saved'); } }); var UpdatedUncommitted = Ember.Mixin.create({ deleteRecord: function(manager) { this._super(manager); var record = get(manager, 'record'); record.withTransaction(function(t) { t.recordBecameClean('updated', record); }); manager.goToState('deleted'); } }); // The dirty state is a abstract state whose functionality is // shared between the `created` and `updated` states. // // The deleted state shares the `isDirty` flag with the // subclasses of `DirtyState`, but with a very different // implementation. var DirtyState = DS.State.extend({ initialState: 'uncommitted', // FLAGS isDirty: true, // SUBSTATES // When a record first becomes dirty, it is `uncommitted`. // This means that there are local pending changes, // but they have not yet begun to be saved. uncommitted: DS.State.extend({ // TRANSITIONS enter: function(manager) { var dirtyType = get(this, 'dirtyType'), record = get(manager, 'record'); record.withTransaction(function (t) { t.recordBecameDirty(dirtyType, record); }); }, // EVENTS deleteRecord: Ember.K, waitingOn: function(manager, object) { waitingOn(manager, object); manager.goToState('pending'); }, willCommit: function(manager) { manager.goToState('inFlight'); }, becameInvalid: function(manager) { var dirtyType = get(this, 'dirtyType'), record = get(manager, 'record'); record.withTransaction(function (t) { t.recordBecameInFlight(dirtyType, record); }); manager.goToState('invalid'); }, rollback: function(manager) { var record = get(manager, 'record'), dirtyType = get(this, 'dirtyType'), data = get(record, 'data'); data.rollback(); record.withTransaction(function(t) { t.recordBecameClean(dirtyType, record); }); manager.goToState('saved'); } }, Uncommitted), // Once a record has been handed off to the adapter to be // saved, it is in the 'in flight' state. Changes to the // record cannot be made during this window. inFlight: DS.State.extend({ // FLAGS isSaving: true, // TRANSITIONS enter: function(manager) { var dirtyType = get(this, 'dirtyType'), record = get(manager, 'record'); record.withTransaction(function (t) { t.recordBecameInFlight(dirtyType, record); }); }, // EVENTS didCommit: function(manager) { var dirtyType = get(this, 'dirtyType'), record = get(manager, 'record'); record.withTransaction(function(t) { t.recordBecameClean('inflight', record); }); manager.goToState('saved'); manager.send('invokeLifecycleCallbacks', dirtyType); }, becameInvalid: function(manager, errors) { var record = get(manager, 'record'); set(record, 'errors', errors); manager.goToState('invalid'); manager.send('invokeLifecycleCallbacks'); }, becameError: function(manager) { manager.goToState('error'); manager.send('invokeLifecycleCallbacks'); }, didChangeData: didChangeData }), // If a record becomes associated with a newly created // parent record, it will be `pending` until the parent // record has successfully persisted. Once this happens, // this record can use the parent's primary key as its // foreign key. // // If the record's transaction had already started to // commit, the record will transition to the `inFlight` // state. If it had not, the record will transition to // the `uncommitted` state. pending: DS.State.extend({ initialState: 'uncommitted', // FLAGS isPending: true, // SUBSTATES // A pending record whose transaction has not yet // started to commit is in this state. uncommitted: DS.State.extend({ // EVENTS deleteRecord: function(manager) { var record = get(manager, 'record'), pendingQueue = get(record, 'pendingQueue'), tuple; // since we are leaving the pending state, remove any // observers we have registered on other records. for (var prop in pendingQueue) { if (!pendingQueue.hasOwnProperty(prop)) { continue; } tuple = pendingQueue[prop]; Ember.removeObserver(tuple[0], 'id', tuple[1]); } }, willCommit: function(manager) { manager.goToState('committing'); }, doneWaitingOn: function(manager, object) { var record = get(manager, 'record'), pendingQueue = get(record, 'pendingQueue'), objectGuid = guidFor(object); delete pendingQueue[objectGuid]; if (isEmptyObject(pendingQueue)) { manager.send('doneWaiting'); } }, doneWaiting: function(manager) { var dirtyType = get(this, 'dirtyType'); manager.goToState(dirtyType + '.uncommitted'); } }, Uncommitted), // A pending record whose transaction has started // to commit is in this state. Since it has not yet // been sent to the adapter, it is not `inFlight` // until all of its dependencies have been committed. committing: DS.State.extend({ // FLAGS isSaving: true, // EVENTS doneWaitingOn: function(manager, object) { var record = get(manager, 'record'), pendingQueue = get(record, 'pendingQueue'), objectGuid = guidFor(object); delete pendingQueue[objectGuid]; if (isEmptyObject(pendingQueue)) { manager.send('doneWaiting'); } }, doneWaiting: function(manager) { var record = get(manager, 'record'), transaction = get(record, 'transaction'); // Now that the record is no longer pending, schedule // the transaction to commit. Ember.run.once(transaction, transaction.commit); }, willCommit: function(manager) { var record = get(manager, 'record'), pendingQueue = get(record, 'pendingQueue'); if (isEmptyObject(pendingQueue)) { var dirtyType = get(this, 'dirtyType'); manager.goToState(dirtyType + '.inFlight'); } } }) }), // A record is in the `invalid` state when its client-side // invalidations have failed, or if the adapter has indicated // the the record failed server-side invalidations. invalid: DS.State.extend({ // FLAGS isValid: false, exit: function(manager) { var record = get(manager, 'record'); record.withTransaction(function (t) { t.recordBecameClean('inflight', record); }); }, // EVENTS deleteRecord: function(manager) { manager.goToState('deleted'); }, setAssociation: setAssociation, setProperty: function(manager, context) { setProperty(manager, context); var record = get(manager, 'record'), errors = get(record, 'errors'), key = context.key; set(errors, key, null); if (!hasDefinedProperties(errors)) { manager.send('becameValid'); } }, rollback: function(manager) { manager.send('becameValid'); manager.send('rollback'); }, becameValid: function(manager) { manager.goToState('uncommitted'); }, invokeLifecycleCallbacks: function(manager) { var record = get(manager, 'record'); record.trigger('becameInvalid', record); } }) }); // The created and updated states are created outside the state // chart so we can reopen their substates and add mixins as // necessary. var createdState = DirtyState.create({ dirtyType: 'created', // FLAGS isNew: true }); var updatedState = DirtyState.create({ dirtyType: 'updated' }); // The created.uncommitted state and created.pending.uncommitted share // some logic defined in CreatedUncommitted. createdState.states.uncommitted.reopen(CreatedUncommitted); createdState.states.pending.states.uncommitted.reopen(CreatedUncommitted); // The created.uncommitted state needs to immediately transition to the // deleted state if it is rolled back. createdState.states.uncommitted.reopen({ rollback: function(manager) { this._super(manager); manager.goToState('deleted.saved'); } }); // The updated.uncommitted state and updated.pending.uncommitted share // some logic defined in UpdatedUncommitted. updatedState.states.uncommitted.reopen(UpdatedUncommitted); updatedState.states.pending.states.uncommitted.reopen(UpdatedUncommitted); updatedState.states.inFlight.reopen({ didSaveData: function(manager) { var record = get(manager, 'record'), data = get(record, 'data'); data.saveData(); data.adapterDidUpdate(); } }); var states = { rootState: Ember.State.create({ // FLAGS isLoaded: false, isDirty: false, isSaving: false, isDeleted: false, isError: false, isNew: false, isValid: true, isPending: false, // SUBSTATES // A record begins its lifecycle in the `empty` state. // If its data will come from the adapter, it will // transition into the `loading` state. Otherwise, if // the record is being created on the client, it will // transition into the `created` state. empty: DS.State.create({ // EVENTS loadingData: function(manager) { manager.goToState('loading'); }, didChangeData: function(manager) { didChangeData(manager); manager.goToState('loaded.created'); } }), // A record enters this state when the store askes // the adapter for its data. It remains in this state // until the adapter provides the requested data. // // Usually, this process is asynchronous, using an // XHR to retrieve the data. loading: DS.State.create({ // TRANSITIONS exit: function(manager) { var record = get(manager, 'record'); record.trigger('didLoad'); }, // EVENTS didChangeData: function(manager, data) { didChangeData(manager); manager.send('loadedData'); }, loadedData: function(manager) { manager.goToState('loaded'); } }), // A record enters this state when its data is populated. // Most of a record's lifecycle is spent inside substates // of the `loaded` state. loaded: DS.State.create({ initialState: 'saved', // FLAGS isLoaded: true, // SUBSTATES // If there are no local changes to a record, it remains // in the `saved` state. saved: DS.State.create({ // EVENTS setProperty: function(manager, context) { setProperty(manager, context); manager.goToState('updated'); }, setAssociation: function(manager, context) { setAssociation(manager, context); manager.goToState('updated'); }, didChangeData: didChangeData, deleteRecord: function(manager) { manager.goToState('deleted'); }, waitingOn: function(manager, object) { waitingOn(manager, object); manager.goToState('updated.pending'); }, invokeLifecycleCallbacks: function(manager, dirtyType) { var record = get(manager, 'record'); if (dirtyType === 'created') { record.trigger('didCreate', record); } else { record.trigger('didUpdate', record); } } }), // A record is in this state after it has been locally // created but before the adapter has indicated that // it has been saved. created: createdState, // A record is in this state if it has already been // saved to the server, but there are new local changes // that have not yet been saved. updated: updatedState }), // A record is in this state if it was deleted from the store. deleted: DS.State.create({ // FLAGS isDeleted: true, isLoaded: true, isDirty: true, // TRANSITIONS enter: function(manager) { var record = get(manager, 'record'), store = get(record, 'store'); store.removeFromRecordArrays(record); }, // SUBSTATES // When a record is deleted, it enters the `start` // state. It will exit this state when the record's // transaction starts to commit. start: DS.State.create({ // TRANSITIONS enter: function(manager) { var record = get(manager, 'record'); record.withTransaction(function(t) { t.recordBecameDirty('deleted', record); }); }, // EVENTS willCommit: function(manager) { manager.goToState('inFlight'); }, rollback: function(manager) { var record = get(manager, 'record'), data = get(record, 'data'); data.rollback(); record.withTransaction(function(t) { t.recordBecameClean('deleted', record); }); manager.goToState('loaded'); } }), // After a record's transaction is committing, but // before the adapter indicates that the deletion // has saved to the server, a record is in the // `inFlight` substate of `deleted`. inFlight: DS.State.create({ // FLAGS isSaving: true, // TRANSITIONS enter: function(manager) { var record = get(manager, 'record'); record.withTransaction(function (t) { t.recordBecameInFlight('deleted', record); }); }, // EVENTS didCommit: function(manager) { var record = get(manager, 'record'); record.withTransaction(function(t) { t.recordBecameClean('inflight', record); }); manager.goToState('saved'); manager.send('invokeLifecycleCallbacks'); } }), // Once the adapter indicates that the deletion has // been saved, the record enters the `saved` substate // of `deleted`. saved: DS.State.create({ // FLAGS isDirty: false, invokeLifecycleCallbacks: function(manager) { var record = get(manager, 'record'); record.trigger('didDelete', record); } }) }), // If the adapter indicates that there was an unknown // error saving a record, the record enters the `error` // state. error: DS.State.create({ isError: true, // EVENTS invokeLifecycleCallbacks: function(manager) { var record = get(manager, 'record'); record.trigger('becameError', record); } }) }) }; DS.StateManager = Ember.StateManager.extend({ record: null, initialState: 'rootState', states: states }); })(); (function() { var get = Ember.get, set = Ember.set; // When a record is changed on the client, it is considered "dirty"--there are // pending changes that need to be saved to a persistence layer, such as a // server. // // If the record is rolled back, it re-enters a clean state, any changes are // discarded, and its attributes are reset back to the last known good copy // of the data that came from the server. // // If the record is committed, the changes are sent to the server to be saved, // and once the server confirms that they are valid, the record's "canonical" // data becomes the original canonical data plus the changes merged in. // // A DataProxy is an object that encapsulates this change tracking. It // contains three buckets: // // * `savedData` - the last-known copy of the data from the server // * `unsavedData` - a hash that contains any changes that have not yet // been committed // * `associations` - this is similar to `savedData`, but holds the client // ids of associated records // // When setting a property on the object, the value is placed into the // `unsavedData` bucket: // // proxy.set('key', 'value'); // // // unsavedData: // { // key: "value" // } // // When retrieving a property from the object, it first looks to see // if that value exists in the `unsavedData` bucket, and returns it if so. // Otherwise, it returns the value from the `savedData` bucket. // // When the adapter notifies a record that it has been saved, it merges the // `unsavedData` bucket into the `savedData` bucket. If the record's // transaction is rolled back, the `unsavedData` hash is simply discarded. // // This object is a regular JS object for performance. It is only // used internally for bookkeeping purposes. var DataProxy = DS._DataProxy = function(record) { this.record = record; this.unsavedData = {}; this.associations = {}; }; DataProxy.prototype = { get: function(key) { return Ember.get(this, key); }, set: function(key, value) { return Ember.set(this, key, value); }, setAssociation: function(key, value) { this.associations[key] = value; }, savedData: function() { var savedData = this._savedData; if (savedData) { return savedData; } var record = this.record, clientId = get(record, 'clientId'), store = get(record, 'store'); if (store) { savedData = store.dataForRecord(record); this._savedData = savedData; return savedData; } }, unknownProperty: function(key) { var unsavedData = this.unsavedData, associations = this.associations, savedData = this.savedData(), store; var value = unsavedData[key], association; // if this is a belongsTo association, this will // be a clientId. association = associations[key]; if (association !== undefined) { store = get(this.record, 'store'); return store.clientIdToId[association]; } if (savedData && value === undefined) { value = savedData[key]; } return value; }, setUnknownProperty: function(key, value) { var record = this.record, unsavedData = this.unsavedData; unsavedData[key] = value; record.hashWasUpdated(); return value; }, commit: function() { this.saveData(); this.record.notifyPropertyChange('data'); }, rollback: function() { this.unsavedData = {}; this.record.notifyPropertyChange('data'); }, saveData: function() { var record = this.record; var unsavedData = this.unsavedData; var savedData = this.savedData(); for (var prop in unsavedData) { if (unsavedData.hasOwnProperty(prop)) { savedData[prop] = unsavedData[prop]; delete unsavedData[prop]; } } }, adapterDidUpdate: function() { this.unsavedData = {}; } }; })(); (function() { var get = Ember.get, set = Ember.set, none = Ember.none; var retrieveFromCurrentState = Ember.computed(function(key) { return get(get(this, 'stateManager.currentState'), key); }).property('stateManager.currentState').cacheable(); DS.Model = Ember.Object.extend(Ember.Evented, { isLoaded: retrieveFromCurrentState, isDirty: retrieveFromCurrentState, isSaving: retrieveFromCurrentState, isDeleted: retrieveFromCurrentState, isError: retrieveFromCurrentState, isNew: retrieveFromCurrentState, isPending: retrieveFromCurrentState, isValid: retrieveFromCurrentState, clientId: null, transaction: null, stateManager: null, pendingQueue: null, errors: null, // because unknownProperty is used, any internal property // must be initialized here. primaryKey: 'id', id: Ember.computed(function(key, value) { var primaryKey = get(this, 'primaryKey'), data = get(this, 'data'); if (arguments.length === 2) { set(data, primaryKey, value); return value; } var id = get(data, primaryKey); return id ? id : this._id; }).property('primaryKey', 'data'), // The following methods are callbacks invoked by `toJSON`. You // can override one of the callbacks to override specific behavior, // or toJSON itself. // // If you override toJSON, you can invoke these callbacks manually // to get the default behavior. /** Add the record's primary key to the JSON hash. The default implementation uses the record's specified `primaryKey` and the `id` computed property, which are passed in as parameters. @param {Object} json the JSON hash being built @param {Number|String} id the record's id @param {String} key the primaryKey for the record */ addIdToJSON: function(json, id, key) { if (id) { json[key] = id; } }, /** Add the attributes' current values to the JSON hash. The default implementation gets the current value of each attribute from the `data`, and uses a `defaultValue` if specified in the `DS.attr` definition. @param {Object} json the JSON hash being build @param {Ember.Map} attributes a Map of attributes @param {DataProxy} data the record's data, accessed with `get` and `set`. */ addAttributesToJSON: function(json, attributes, data) { attributes.forEach(function(name, meta) { var key = meta.key(this.constructor), value = get(data, key); if (value === undefined) { value = meta.options.defaultValue; } json[key] = value; }, this); }, /** Add the value of a `hasMany` association to the JSON hash. The default implementation honors the `embedded` option passed to `DS.hasMany`. If embedded, `toJSON` is recursively called on the child records. If not, the `id` of each record is added. Note that if a record is not embedded and does not yet have an `id` (usually provided by the server), it will not be included in the output. @param {Object} json the JSON hash being built @param {DataProxy} data the record's data, accessed with `get` and `set`. @param {Object} meta information about the association @param {Object} options options passed to `toJSON` */ addHasManyToJSON: function(json, data, meta, options) { var key = meta.key, manyArray = get(this, key), records = [], i, l, clientId, id; if (meta.options.embedded) { // TODO: Avoid materializing embedded hashes if possible manyArray.forEach(function(record) { records.push(record.toJSON(options)); }); } else { var clientIds = get(manyArray, 'content'); for (i=0, l=clientIds.length; i-1?b.split(".")[1].length:0):a=isNaN(b=M(b))?2:b;var b=a,c=c===void 0?e.decimalPoint:c,d=d===void 0?e.thousandsSep:d,e=f<0?"-":"",a=String(w(f=M(+f||0).toFixed(b))),g=a.length>3?a.length%3:0;return e+(g?a.substr(0,g)+d:"")+ a.substr(g).replace(/(\d{3})(?=\d)/g,"$1"+d)+(b?c+M(f-a).toFixed(b).slice(2):"")}function sa(a,b){return Array((b||2)+1-String(a).length).join(0)+a}function gb(a,b,c,d){var e,c=o(c,1);e=a/c;b||(b=[1,2,2.5,5,10],d&&d.allowDecimals===!1&&(c===1?b=[1,2,5,10]:c<=0.1&&(b=[1/c])));for(d=0;d=D[hb]&&(i.setMilliseconds(0),i.setSeconds(b>=D[Ya]?0:j*W(i.getSeconds()/j)));if(b>=D[Ya])i[wb](b>=D[Ma]?0:j*W(i[ib]()/j)); if(b>=D[Ma])i[xb](b>=D[oa]?0:j*W(i[jb]()/j));if(b>=D[oa])i[kb](b>=D[Na]?1:j*W(i[Oa]()/j));b>=D[Na]&&(i[yb](b>=D[ta]?0:j*W(i[$a]()/j)),h=i[ab]());b>=D[ta]&&(h-=h%j,i[zb](h));if(b===D[Za])i[kb](i[Oa]()-i[lb]()+o(d,1));d=1;h=i[ab]();for(var k=i.getTime(),l=i[$a](),m=i[Oa](),i=g?0:(864E5+i.getTimezoneOffset()*6E4)%864E5;kc&&(c=a[b]);return c}function Ba(a,b){for(var c in a)a[c]&&a[c]!==b&&a[c].destroy&&a[c].destroy(),delete a[c]}function Qa(a){cb||(cb=S(ia)); a&&cb.appendChild(a);cb.innerHTML=""}function mb(a,b){var c="Highcharts error #"+a+": www.highcharts.com/errors/"+a;if(b)throw c;else N.console&&console.log(c)}function ja(a){return parseFloat(a.toPrecision(14))}function ua(a,b){Ra=o(a,b.animation)}function Bb(){var a=V.global.useUTC,b=a?"getUTC":"get",c=a?"setUTC":"set";bb=a?Date.UTC:function(a,b,c,g,h,i){return(new Date(a,b,o(c,1),o(g,0),o(h,0),o(i,0))).getTime()};ib=b+"Minutes";jb=b+"Hours";lb=b+"Day";Oa=b+"Date";$a=b+"Month";ab=b+"FullYear";wb= c+"Minutes";xb=c+"Hours";kb=c+"Date";yb=c+"Month";zb=c+"FullYear"}function va(){}function Sa(a,b,c){this.axis=a;this.pos=b;this.type=c||"";this.isNew=!0;c||this.addLabel()}function nb(a,b){this.axis=a;if(b)this.options=b,this.id=b.id;return this}function Cb(a,b,c,d,e){var f=a.chart.inverted;this.axis=a;this.isNegative=c;this.options=b;this.x=d;this.stack=e;this.alignOptions={align:b.align||(f?c?"left":"right":"center"),verticalAlign:b.verticalAlign||(f?"middle":c?"bottom":"top"),y:o(b.y,f?4:c?14: -6),x:o(b.x,f?c?-6:6:0)};this.textAlign=b.textAlign||(f?c?"right":"left":"center")}function ob(){this.init.apply(this,arguments)}function pb(a,b){var c=b.borderWidth,d=b.style,e=b.shared,f=w(d.padding);this.chart=a;this.options=b;d.padding=0;this.crosshairs=[];this.currentY=this.currentX=0;this.tooltipIsHidden=!0;this.label=a.renderer.label("",0,0,null,null,null,b.useHTML,null,"tooltip").attr({padding:f,fill:b.backgroundColor,"stroke-width":c,r:b.borderRadius,zIndex:8}).css(d).hide().add();ga||this.label.shadow(b.shadow); this.shared=e}function Db(a,b){var c=ga?"":b.chart.zoomType;this.zoomX=/x/.test(c);this.zoomY=/y/.test(c);this.options=b;this.chart=a;this.init(a,b.tooltip)}function qb(a){this.init(a)}function rb(a,b){var c,d=a.series;a.series=null;c=C(V,a);c.series=a.series=d;var d=c.chart,e=d.margin,e=aa(e)?e:[e,e,e,e];this.optionsMarginTop=o(d.marginTop,e[0]);this.optionsMarginRight=o(d.marginRight,e[1]);this.optionsMarginBottom=o(d.marginBottom,e[2]);this.optionsMarginLeft=o(d.marginLeft,e[3]);this.runChartClick= (e=d.events)&&!!e.click;this.callback=b;this.isResizing=0;this.options=c;this.axes=[];this.series=[];this.hasCartesianSeries=d.showAxes;this.init(e)}var A,B=document,N=window,L=Math,t=L.round,W=L.floor,wa=L.ceil,x=L.max,O=L.min,M=L.abs,X=L.cos,da=L.sin,xa=L.PI,Eb=xa*2/360,ya=navigator.userAgent,La=/msie/i.test(ya)&&!N.opera,Ca=B.documentMode===8,Fb=/AppleWebKit/.test(ya),Gb=/Firefox/.test(ya),Da=!!B.createElementNS&&!!B.createElementNS("http://www.w3.org/2000/svg","svg").createSVGRect,Rb=Gb&&parseInt(ya.split("Firefox/")[1], 10)<4,ga=!Da&&!La&&!!B.createElement("canvas").getContext,Ta,ea=B.documentElement.ontouchstart!==A,Hb={},sb=0,cb,V,db,Ra,Ua,D,Sb=function(){},ia="div",U="none",tb="rgba(192,192,192,"+(Da?1.0E-6:0.0020)+")",vb="millisecond",hb="second",Ya="minute",Ma="hour",oa="day",Za="week",Na="month",ta="year",bb,ib,jb,lb,Oa,$a,ab,wb,xb,kb,yb,zb,Y={};N.Highcharts={};db=function(a,b,c){if(!s(b)||isNaN(b))return"Invalid date";var a=o(a,"%Y-%m-%d %H:%M:%S"),d=new Date(b),e,f=d[jb](),g=d[lb](),h=d[Oa](),i=d[$a](),j= d[ab](),k=V.lang,l=k.weekdays,b={a:l[g].substr(0,3),A:l[g],d:sa(h),e:h,b:k.shortMonths[i],B:k.months[i],m:sa(i+1),y:j.toString().substr(2,2),Y:j,H:sa(f),I:sa(f%12||12),l:f%12||12,M:sa(d[ib]()),p:f<12?"AM":"PM",P:f<12?"am":"pm",S:sa(d.getSeconds()),L:sa(t(b%1E3),3)};for(e in b)a=a.replace("%"+e,b[e]);return c?a.substr(0,1).toUpperCase()+a.substr(1):a};Ab.prototype={wrapColor:function(a){if(this.color>=a)this.color=0},wrapSymbol:function(a){if(this.symbol>=a)this.symbol=0}};D=la(vb,1,hb,1E3,Ya,6E4, Ma,36E5,oa,864E5,Za,6048E5,Na,2592E6,ta,31556952E3);Ua={init:function(a,b,c){var b=b||"",d=a.shift,e=b.indexOf("C")>-1,f=e?7:3,g,b=b.split(" "),c=[].concat(c),h,i,j=function(a){for(g=a.length;g--;)a[g]==="M"&&a.splice(g+1,0,a[g+1],a[g+2],a[g+1],a[g+2])};e&&(j(b),j(c));a.isArea&&(h=b.splice(b.length-6,6),i=c.splice(c.length-6,6));if(d<=c.length/f)for(;d--;)c=[].concat(c).splice(0,f).concat(c);a.shift=0;if(b.length)for(a=c.length;b.length{point.key}
',pointFormat:'{series.name}: {point.y}
',shadow:!0,shared:ga,snap:ea?25:10,style:{color:"#333333",fontSize:"12px",padding:"5px",whiteSpace:"nowrap"}},credits:{enabled:!0,text:"Highcharts.com",href:"http://www.highcharts.com",position:{align:"right",x:-10,verticalAlign:"bottom",y:-5}, style:{cursor:"pointer",color:"#909090",fontSize:"10px"}}};var Z=V.plotOptions,T=Z.line;Bb();var pa=function(a){var b=[],c;(function(a){(c=/rgba\(\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]?(?:\.[0-9]+)?)\s*\)/.exec(a))?b=[w(c[1]),w(c[2]),w(c[3]),parseFloat(c[4],10)]:(c=/#([a-fA-F0-9]{2})([a-fA-F0-9]{2})([a-fA-F0-9]{2})/.exec(a))&&(b=[w(c[1],16),w(c[2],16),w(c[3],16),1])})(a);return{get:function(c){return b&&!isNaN(b[0])?c==="rgb"?"rgb("+b[0]+","+b[1]+","+b[2]+")":c==="a"?b[3]: "rgba("+b.join(",")+")":a},brighten:function(a){if(Ka(a)&&a!==0){var c;for(c=0;c<3;c++)b[c]+=w(a*255),b[c]<0&&(b[c]=0),b[c]>255&&(b[c]=255)}return this},setOpacity:function(a){b[3]=a;return this}}};va.prototype={init:function(a,b){this.element=b==="span"?S(b):B.createElementNS("http://www.w3.org/2000/svg",b);this.renderer=a;this.attrSetters={}},animate:function(a,b,c){b=o(b,Ra,!0);Fa(this);if(b){b=C(b);if(c)b.complete=c;eb(this,a,b)}else this.attr(a),c&&c()},attr:function(a,b){var c,d,e,f,g=this.element, h=g.nodeName,i=this.renderer,j,k=this.attrSetters,l=this.shadows,m,p,q=this;ra(a)&&s(b)&&(c=a,a={},a[c]=b);if(ra(a))c=a,h==="circle"?c={x:"cx",y:"cy"}[c]||c:c==="strokeWidth"&&(c="stroke-width"),q=z(g,c)||this[c]||0,c!=="d"&&c!=="visibility"&&(q=parseFloat(q));else for(c in a)if(j=!1,d=a[c],e=k[c]&&k[c](d,c),e!==!1){e!==A&&(d=e);if(c==="d")d&&d.join&&(d=d.join(" ")),/(NaN| {2}|^$)/.test(d)&&(d="M 0 0");else if(c==="x"&&h==="text"){for(e=0;em&&/[ \-]/.test(b.innerText)&&(F(b,{width:m+"px",display:"block",whiteSpace:"normal"}),k=m),m=a.fontMetrics(b.style.fontSize).b,r=p<0&&-k,y=q<0&&-l,fa=p*q<0,r+=q*m*(fa?1-h:h),y-=p*m*(j?fa?h:1-h:1),i&&(r-=k*h*(p<0?-1:1),j&&(y-=l*h*(q<0?-1:1)),F(b,{textAlign:g})),this.xCorr=r,this.yCorr=y;F(b,{left:e+r+"px",top:f+y+"px"});this.cTT=$}}else this.alignOnAdd= !0},updateTransform:function(){var a=this.translateX||0,b=this.translateY||0,c=this.inverted,d=this.rotation,e=[];c&&(a+=this.attr("width"),b+=this.attr("height"));(a||b)&&e.push("translate("+a+","+b+")");c?e.push("rotate(90) scale(-1,1)"):d&&e.push("rotate("+d+" "+(this.x||0)+" "+(this.y||0)+")");e.length&&z(this.element,"transform",e.join(" "))},toFront:function(){var a=this.element;a.parentNode.appendChild(a);return this},align:function(a,b,c){a?(this.alignOptions=a,this.alignByTranslate=b,c|| this.renderer.alignedObjects.push(this)):(a=this.alignOptions,b=this.alignByTranslate);var c=o(c,this.renderer),d=a.align,e=a.verticalAlign,f=(c.x||0)+(a.x||0),g=(c.y||0)+(a.y||0),h={};/^(right|center)$/.test(d)&&(f+=(c.width-(a.width||0))/{right:1,center:2}[d]);h[b?"translateX":"x"]=t(f);/^(bottom|middle)$/.test(e)&&(g+=(c.height-(a.height||0))/({bottom:1,middle:2}[e]||1));h[b?"translateY":"y"]=t(g);this[this.placed?"animate":"attr"](h);this.placed=!0;this.alignAttr=h;return this},getBBox:function(a){var b, c,d=this.rotation;c=this.element;var e=d*Eb;if(c.namespaceURI==="http://www.w3.org/2000/svg"||this.renderer.forExport){try{b=c.getBBox?u({},c.getBBox()):{width:c.offsetWidth,height:c.offsetHeight}}catch(f){}if(!b||b.width<0)b={width:0,height:0};a=b.width;c=b.height;if(d)b.width=M(c*da(e))+M(a*X(e)),b.height=M(c*X(e))+M(a*da(e))}else b=this.htmlGetBBox(a);return b},show:function(){return this.attr({visibility:"visible"})},hide:function(){return this.attr({visibility:"hidden"})},add:function(a){var b= this.renderer,c=a||b,d=c.element||b.box,e=d.childNodes,f=this.element,g=z(f,"zIndex"),h;this.parentInverted=a&&a.inverted;this.textStr!==void 0&&b.buildText(this);if(g)c.handleZ=!0,g=w(g);if(c.handleZ)for(c=0;cg||!s(g)&&s(b))){d.insertBefore(f,a);h=!0;break}h||d.appendChild(f);this.added=!0;E(this,"add");return this},safeRemoveChild:function(a){var b=a.parentNode;b&&b.removeChild(a)},destroy:function(){var a=this,b=a.element||{},c=a.shadows,d=a.box, e,f;b.onclick=b.onmouseout=b.onmouseover=b.onmousemove=null;Fa(a);if(a.clipPath)a.clipPath=a.clipPath.destroy();if(a.stops){for(f=0;f/g,'').replace(/<(i|em)>/g,'').replace(//g,"").split(//g),d=b.childNodes,e=/style="([^"]+)"/,f=/href="([^"]+)"/,g=z(b,"x"),h=a.styles,i=h&&w(h.width),j=h&&h.lineHeight,k,h=d.length,l=[];h--;)b.removeChild(d[h]);i&&!a.added&&this.box.appendChild(b);c[c.length-1]===""&&c.pop();n(c,function(c,d){var h,fa=0,r,c=c.replace(//g,"|||");h=c.split("|||");n(h,function(c){if(c!==""||h.length===1){var m={},n=B.createElementNS("http://www.w3.org/2000/svg", "tspan");e.test(c)&&z(n,"style",c.match(e)[1].replace(/(;| |^)color([ :])/,"$1fill$2"));f.test(c)&&(z(n,"onclick",'location.href="'+c.match(f)[1]+'"'),F(n,{cursor:"pointer"}));c=(c.replace(/<(.|\n)*?>/g,"")||" ").replace(/</g,"<").replace(/>/g,">");n.appendChild(B.createTextNode(c));fa?m.dx=3:m.x=g;if(!fa){if(d){!Da&&a.renderer.forExport&&F(n,{display:"block"});r=N.getComputedStyle&&w(N.getComputedStyle(k,null).getPropertyValue("line-height"));if(!r||isNaN(r)){var o;if(!(o=j))if(!(o=k.offsetHeight))l[d]= b.getBBox().height,o=t(l[d]-(l[d-1]||0))||18;r=o}z(n,"dy",r)}k=n}z(n,m);b.appendChild(n);fa++;if(i)for(var c=c.replace(/-/g,"- ").split(" "),H=[];c.length||H.length;)o=a.getBBox().width,m=o>i,!m||c.length===1?(c=H,H=[],c.length&&(n=B.createElementNS("http://www.w3.org/2000/svg","tspan"),z(n,{dy:j||16,x:g}),b.appendChild(n),o>i&&(i=o))):(n.removeChild(n.firstChild),H.unshift(c.pop())),c.length&&n.appendChild(B.createTextNode(c.join(" ").replace(/- /g,"-")))}})})},button:function(a,b,c,d,e,f,g){var h= this.label(a,b,c),i=0,j,k,l,m,p,a={x1:0,y1:0,x2:0,y2:1},e=C(la("stroke-width",1,"stroke","#999","fill",la("linearGradient",a,"stops",[[0,"#FFF"],[1,"#DDD"]]),"r",3,"padding",3,"style",la("color","black")),e);l=e.style;delete e.style;f=C(e,la("stroke","#68A","fill",la("linearGradient",a,"stops",[[0,"#FFF"],[1,"#ACF"]])),f);m=f.style;delete f.style;g=C(e,la("stroke","#68A","fill",la("linearGradient",a,"stops",[[0,"#9BD"],[1,"#CDF"]])),g);p=g.style;delete g.style;I(h.element,"mouseenter",function(){h.attr(f).css(m)}); I(h.element,"mouseleave",function(){j=[e,f,g][i];k=[l,m,p][i];h.attr(j).css(k)});h.setState=function(a){(i=a)?a===2&&h.attr(g).css(p):h.attr(e).css(l)};return h.on("click",function(){d.call(h)}).attr(e).css(u({cursor:"default"},l))},crispLine:function(a,b){a[1]===a[4]&&(a[1]=a[4]=t(a[1])+b%2/2);a[2]===a[5]&&(a[2]=a[5]=t(a[2])+b%2/2);return a},path:function(a){var b={fill:U};Ja(a)?b.d=a:aa(a)&&u(b,a);return this.createElement("path").attr(b)},circle:function(a,b,c){a=aa(a)?a:{x:a,y:b,r:c};return this.createElement("circle").attr(a)}, arc:function(a,b,c,d,e,f){if(aa(a))b=a.y,c=a.r,d=a.innerR,e=a.start,f=a.end,a=a.x;return this.symbol("arc",a||0,b||0,c||0,c||0,{innerR:d||0,start:e||0,end:f||0})},rect:function(a,b,c,d,e,f){e=aa(a)?a.r:e;e=this.createElement("rect").attr({rx:e,ry:e,fill:U});return e.attr(aa(a)?a:e.crisp(f,a,b,x(c,0),x(d,0)))},setSize:function(a,b,c){var d=this.alignedObjects,e=d.length;this.width=a;this.height=b;for(this.boxWrapper[o(c,!0)?"animate":"attr"]({width:a,height:b});e--;)d[e].align()},g:function(a){var b= this.createElement("g");return s(a)?b.attr({"class":"highcharts-"+a}):b},image:function(a,b,c,d,e){var f={preserveAspectRatio:U};arguments.length>1&&u(f,{x:b,y:c,width:d,height:e});f=this.createElement("image").attr(f);f.element.setAttributeNS?f.element.setAttributeNS("http://www.w3.org/1999/xlink","href",a):f.element.setAttribute("hc-svg-href",a);return f},symbol:function(a,b,c,d,e,f){var g,h=this.symbols[a],h=h&&h(t(b),t(c),d,e,f),i=/^url\((.*?)\)$/,j,k;h?(g=this.path(h),u(g,{symbolName:a,x:b,y:c, width:d,height:e}),f&&u(g,f)):i.test(a)&&(k=function(a,b){a.attr({width:b[0],height:b[1]});a.alignByTranslate||a.translate(-t(b[0]/2),-t(b[1]/2))},j=a.match(i)[1],a=Hb[j],g=this.image(j).attr({x:b,y:c}),a?k(g,a):(g.attr({width:0,height:0}),S("img",{onload:function(){k(g,Hb[j]=[this.width,this.height])},src:j})));return g},symbols:{circle:function(a,b,c,d){var e=0.166*c;return["M",a+c/2,b,"C",a+c+e,b,a+c+e,b+d,a+c/2,b+d,"C",a-e,b+d,a-e,b,a+c/2,b,"Z"]},square:function(a,b,c,d){return["M",a,b,"L",a+ c,b,a+c,b+d,a,b+d,"Z"]},triangle:function(a,b,c,d){return["M",a+c/2,b,"L",a+c,b+d,a,b+d,"Z"]},"triangle-down":function(a,b,c,d){return["M",a,b,"L",a+c,b,a+c/2,b+d,"Z"]},diamond:function(a,b,c,d){return["M",a+c/2,b,"L",a+c,b+d/2,a+c/2,b+d,a,b+d/2,"Z"]},arc:function(a,b,c,d,e){var f=e.start,c=e.r||c||d,g=e.end-1.0E-6,d=e.innerR,h=e.open,i=X(f),j=da(f),k=X(g),g=da(g),e=e.end-f');if(b)c=b===ia||b==="span"||b==="img"?c.join(""):a.prepVML(c),this.element=S(c);this.renderer=a;this.attrSetters={}},add:function(a){var b=this.renderer,c=this.element,d=b.box,d=a?a.element||a:d;a&&a.inverted&&b.invertChild(c,d);Ca&&d.gVis==="hidden"&&F(c,{visibility:"hidden"});d.appendChild(c);this.added=!0;this.alignOnAdd&& !this.deferUpdateTransform&&this.updateTransform();E(this,"add");return this},toggleChildren:function(a,b){for(var c=a.childNodes,d=c.length;d--;)F(c[d],{visibility:b}),c[d].nodeName==="DIV"&&this.toggleChildren(c[d],b)},updateTransform:va.prototype.htmlUpdateTransform,attr:function(a,b){var c,d,e,f=this.element||{},g=f.style,h=f.nodeName,i=this.renderer,j=this.symbolName,k,l=this.shadows,m,p=this.attrSetters,q=this;ra(a)&&s(b)&&(c=a,a={},a[c]=b);if(ra(a))c=a,q=c==="strokeWidth"||c==="stroke-width"? this.strokeweight:this[c];else for(c in a)if(d=a[c],m=!1,e=p[c]&&p[c](d,c),e!==!1&&d!==null){e!==A&&(d=e);if(j&&/^(x|y|r|start|end|width|height|innerR|anchorX|anchorY)/.test(c))k||(this.symbolAttr(a),k=!0),m=!0;else if(c==="d"){d=d||[];this.d=d.join(" ");e=d.length;for(m=[];e--;)m[e]=Ka(d[e])?t(d[e]*10)-5:d[e]==="Z"?"x":d[e];d=m.join(" ")||"x";f.path=d;if(l)for(e=l.length;e--;)l[e].path=l[e].cutOff?this.cutOffPath(d,l[e].cutOff):d;m=!0}else if(c==="zIndex"||c==="visibility"){if(Ca&&c==="visibility"&& h==="DIV")f.gVis=d,this.toggleChildren(f,d),d==="visible"&&(d=null);d&&(g[c]=d);m=!0}else if(c==="width"||c==="height")d=x(0,d),this[c]=d,this.updateClipping?(this[c]=d,this.updateClipping()):g[c]=d,m=!0;else if(c==="x"||c==="y")this[c]=d,g[{x:"left",y:"top"}[c]]=d;else if(c==="class")f.className=d;else if(c==="stroke")d=i.color(d,f,c),c="strokecolor";else if(c==="stroke-width"||c==="strokeWidth")f.stroked=d?!0:!1,c="strokeweight",this[c]=d,Ka(d)&&(d+="px");else if(c==="dashstyle")(f.getElementsByTagName("stroke")[0]|| S(i.prepVML([""]),null,null,f))[c]=d||"solid",this.dashstyle=d,m=!0;else if(c==="fill")h==="SPAN"?g.color=d:(f.filled=d!==U?!0:!1,d=i.color(d,f,c),c="fillcolor");else if(h==="shape"&&c==="rotation")this[c]=d;else if(c==="translateX"||c==="translateY"||c==="rotation")this[c]=d,this.updateTransform(),m=!0;else if(c==="text")this.bBox=null,f.innerHTML=d,m=!0;if(l&&c==="visibility")for(e=l.length;e--;)l[e].style[c]=d;m||(Ca?f[c]=d:z(f,c,d))}return q},clip:function(a){var b=this,c=a.members,d= b.element,e=d.parentNode;c.push(b);b.destroyClip=function(){za(c,b)};e&&e.className==="highcharts-tracker"&&!Ca&&F(d,{visibility:"hidden"});return b.css(a.getCSS(b))},css:va.prototype.htmlCss,safeRemoveChild:function(a){a.parentNode&&Qa(a)},destroy:function(){this.destroyClip&&this.destroyClip();return va.prototype.destroy.apply(this)},empty:function(){for(var a=this.element.childNodes,b=a.length,c;b--;)c=a[b],c.parentNode.removeChild(c)},on:function(a,b){this.element["on"+a]=function(){var a=N.event; a.target=a.srcElement;b(a)};return this},cutOffPath:function(a,b){var c,a=a.split(/[ ,]/);c=a.length;if(c===9||c===11)a[c-4]=a[c-2]=w(a[c-2])-10*b;return a.join(" ")},shadow:function(a,b,c){var d=[],e=this.element,f=this.renderer,g,h=e.style,i,j=e.path,k,l;j&&typeof j.value!=="string"&&(j="x");l=j;if(a){for(a=1;a<=3;a++){k=7-2*a;c&&(l=this.cutOffPath(j.value,k+0.5));i=[''];g= S(f.prepVML(i),null,{left:w(h.left)+1,top:w(h.top)+1});if(c)g.cutOff=k+1;i=[''];S(f.prepVML(i),null,null,g);b?b.element.appendChild(g):e.parentNode.insertBefore(g,e);d.push(g)}this.shadows=d}return this}};ka=ca(va,ka);var ha={Element:ka,isIE8:ya.indexOf("MSIE 8.0")>-1,init:function(a,b,c){var d,e;this.alignedObjects=[];d=this.createElement(ia);e=d.element;e.style.position="relative";a.appendChild(d.element);this.box=e;this.boxWrapper=d;this.setSize(b,c, !1);if(!B.namespaces.hcv)B.namespaces.add("hcv","urn:schemas-microsoft-com:vml"),B.createStyleSheet().cssText="hcv\\:fill, hcv\\:path, hcv\\:shape, hcv\\:stroke{ behavior:url(#default#VML); display: inline-block; } "},isHidden:function(){return!this.box.offsetWidth},clipRect:function(a,b,c,d){var e=this.createElement();return u(e,{members:[],left:a,top:b,width:c,height:d,getCSS:function(a){var b=a.inverted,c=this.top,d=this.left,e=d+this.width,k=c+this.height,c={clip:"rect("+t(b?d:c)+"px,"+t(b?k: e)+"px,"+t(b?e:k)+"px,"+t(b?c:d)+"px)"};!b&&Ca&&a.element.nodeName!=="IMG"&&u(c,{width:e+"px",height:k+"px"});return c},updateClipping:function(){n(e.members,function(a){a.css(e.getCSS(a))})}})},color:function(a,b,c){var d,e=/^rgba/,f,g=U;a&&a.linearGradient?f="gradient":a&&a.radialGradient&&(f="pattern");if(f){var h,i,j=a.linearGradient||a.radialGradient,k,l,m,p,q,o,r="",a=a.stops,y,s=[];l=a[0];y=a[a.length-1];l[0]>0&&a.unshift([0,l[1]]);y[0]<1&&a.push([1,y[1]]);n(a,function(a,b){e.test(a[1])?(d= pa(a[1]),h=d.get("rgb"),i=d.get("a")):(h=a[1],i=1);s.push(a[0]*100+"% "+h);b?(p=i,q=h):(m=i,o=h)});f==="gradient"?(k=j.x1||j[0]||0,a=j.y1||j[1]||0,l=j.x2||j[2]||0,j=j.y2||j[3]||0,k=90-L.atan((j-a)/(l-k))*180/xa):(g=j.r*2,r='src="http://code.highcharts.com/gfx/radial-gradient.png" size="'+g+","+g+'" origin="0.5,0.5" position="'+j.cx+","+j.cy+'" color2="'+o+'" ',g=q);c==="fill"?(c=[''], S(this.prepVML(c),null,null,b)):g=h}else if(e.test(a)&&b.tagName!=="IMG")d=pa(a),c=["<",c,' opacity="',d.get("a"),'"/>'],S(this.prepVML(c),null,null,b),g=d.get("rgb");else{b=b.getElementsByTagName(c);if(b.length)b[0].opacity=1;g=a}return g},prepVML:function(a){var b=this.isIE8,a=a.join("");b?(a=a.replace("/>",' xmlns="urn:schemas-microsoft-com:vml" />'),a=a.indexOf('style="')===-1?a.replace("/>",' style="display:inline-block;behavior:url(#default#VML);" />'):a.replace('style="','style="display:inline-block;behavior:url(#default#VML);')): a=a.replace("<","1&&f.css({left:b,top:c,width:d, height:e});return f},rect:function(a,b,c,d,e,f){if(aa(a))b=a.y,c=a.width,d=a.height,f=a.strokeWidth,a=a.x;var g=this.symbol("rect");g.r=e;return g.attr(g.crisp(f,a,b,x(c,0),x(d,0)))},invertChild:function(a,b){var c=b.style;F(a,{flip:"x",left:w(c.width)-1,top:w(c.height)-1,rotation:-90})},symbols:{arc:function(a,b,c,d,e){var f=e.start,g=e.end,h=e.r||c||d,c=X(f),d=da(f),i=X(g),j=da(g),k=e.innerR,l=0.08/h,m=k&&0.1/k||0;if(g-f===0)return["x"];else 2*xa-g+fj&&(c=!1)):h+k>m&&(h=m-k,d&&h+l0&&b.height>0){f=C({align:c&&k&&"center",x:c?!k&&4:10,verticalAlign:!c&&k&&"middle",y:c?k?16:10:k?6:-4,rotation:c&&!k&&90},f);if(!g)a.label=g=u.text(f.text,0,0).attr({align:f.textAlign||f.align,rotation:f.rotation, zIndex:y}).css(f.style).add();b=[q[1],q[4],o(q[6],q[1])];q=[q[2],q[5],o(q[7],q[2])];c=Pa(b);k=Pa(q);g.align(f,!1,{x:c,y:k,width:Aa(b)-c,height:Aa(q)-k});g.show()}else g&&g.hide();return a},destroy:function(){za(this.axis.plotLinesAndBands,this);Ba(this,this.axis)}};Cb.prototype={destroy:function(){Ba(this,this.axis)},setTotal:function(a){this.cum=this.total=a},render:function(a){var b=this.options.formatter.call(this);this.label?this.label.attr({text:b,visibility:"hidden"}):this.label=this.axis.chart.renderer.text(b, 0,0).css(this.options.style).attr({align:this.textAlign,rotation:this.options.rotation,visibility:"hidden"}).add(a)},setOffset:function(a,b){var c=this.axis,d=c.chart,e=d.inverted,f=this.isNegative,g=c.translate(this.total,0,0,0,1),c=c.translate(0),c=M(g-c),h=d.xAxis[0].translate(this.x)+a,d=d.plotHeight,e={x:e?f?g:g-c:h,y:e?d-h-b:f?d-g-c:d-g,width:e?c:b,height:e?b:c};this.label&&this.label.align(this.alignOptions,null,e).attr({visibility:"visible"})}};ob.prototype={defaultOptions:{dateTimeLabelFormats:{millisecond:"%H:%M:%S.%L", second:"%H:%M:%S",minute:"%H:%M",hour:"%H:%M",day:"%e. %b",week:"%e. %b",month:"%b '%y",year:"%Y"},endOnTick:!1,gridLineColor:"#C0C0C0",labels:G,lineColor:"#C0D0E0",lineWidth:1,minPadding:0.01,maxPadding:0.01,minorGridLineColor:"#E0E0E0",minorGridLineWidth:1,minorTickColor:"#A0A0A0",minorTickLength:2,minorTickPosition:"outside",startOfWeek:1,startOnTick:!1,tickColor:"#C0D0E0",tickLength:5,tickmarkPlacement:"between",tickPixelInterval:100,tickPosition:"outside",tickWidth:1,title:{align:"middle",style:{color:"#6D869F", fontWeight:"bold"}},type:"linear"},defaultYAxisOptions:{endOnTick:!0,gridLineWidth:1,tickPixelInterval:72,showLastLabel:!0,labels:{align:"right",x:-8,y:3},lineWidth:0,maxPadding:0.05,minPadding:0.05,startOnTick:!0,tickWidth:0,title:{rotation:270,text:"Y-values"},stackLabels:{enabled:!1,formatter:function(){return this.total},style:G.style}},defaultLeftAxisOptions:{labels:{align:"right",x:-8,y:null},title:{rotation:270}},defaultRightAxisOptions:{labels:{align:"left",x:8,y:null},title:{rotation:90}}, defaultBottomAxisOptions:{labels:{align:"center",x:0,y:14},title:{rotation:0}},defaultTopAxisOptions:{labels:{align:"center",x:0,y:-5},title:{rotation:0}},init:function(a,b){var c=b.isX;this.horiz=a.inverted?!c:c;this.xOrY=(this.isXAxis=c)?"x":"y";this.opposite=b.opposite;this.side=this.horiz?this.opposite?0:2:this.opposite?1:3;this.setOptions(b);var d=this.options,e=d.type,f=e==="datetime";this.labelFormatter=d.labels.formatter||this.defaultLabelFormatter;this.staggerLines=this.horiz&&d.labels.staggerLines; this.userOptions=b;this.minPixelPadding=0;this.chart=a;this.reversed=d.reversed;this.categories=d.categories;this.isLog=e==="logarithmic";this.isLinked=s(d.linkedTo);this.isDatetimeAxis=f;this.ticks={};this.minorTicks={};this.plotLinesAndBands=[];this.alternateBands={};this.len=0;this.minRange=this.userMinRange=d.minRange||d.maxZoom;this.range=d.range;this.offset=d.offset||0;this.stacks={};this.min=this.max=null;var g,d=this.options.events;a.axes.push(this);a[c?"xAxis":"yAxis"].push(this);this.series= [];if(a.inverted&&c&&this.reversed===A)this.reversed=!0;this.removePlotLine=this.removePlotBand=this.removePlotBandOrLine;this.addPlotLine=this.addPlotBand=this.addPlotBandOrLine;for(g in d)I(this,g,d[g]);if(this.isLog)this.val2lin=ma,this.lin2val=ba},setOptions:function(a){this.options=C(this.defaultOptions,this.isXAxis?{}:this.defaultYAxisOptions,[this.defaultTopAxisOptions,this.defaultRightAxisOptions,this.defaultBottomAxisOptions,this.defaultLeftAxisOptions][this.side],a)},defaultLabelFormatter:function(){var a= this.axis,b=this.value,c=a.tickInterval,d=this.dateTimeLabelFormat;return a.categories?b:d?db(d,b):c%1E6===0?b/1E6+"M":c%1E3===0?b/1E3+"k":b>=1E3?Xa(b,0):Xa(b,-1)},getSeriesExtremes:function(){var a=this,b=a.chart,c=a.stacks,d=[],e=[],f;a.dataMin=a.dataMax=null;n(a.series,function(g){if(g.visible||!b.options.chart.ignoreHiddenSeries){var h=g.options,i,j,k,l,m,p,q,n,r,y=h.threshold,t,u=[],v=0;if(a.isLog&&y<=0)y=h.threshold=null;if(a.isXAxis){if(h=g.xData,h.length)a.dataMin=O(o(a.dataMin,h[0]),Pa(h)), a.dataMax=x(o(a.dataMax,h[0]),Aa(h))}else{var H,J,K,C=g.cropped,Ha=g.xAxis.getExtremes(),w=!!g.modifyValue;i=h.stacking;a.usePercentage=i==="percent";if(i)m=h.stack,l=g.type+o(m,""),p="-"+l,g.stackKey=l,j=d[l]||[],d[l]=j,k=e[p]||[],e[p]=k;if(a.usePercentage)a.dataMin=0,a.dataMax=99;h=g.processedXData;q=g.processedYData;t=q.length;for(f=0;f=Ha.min&&(h[f-1]||n)<=Ha.max))if(n=r.length)for(;n--;)r[n]!==null&&(u[v++]=r[n]);else u[v++]=r;if(!a.usePercentage&&u.length)a.dataMin=O(o(a.dataMin,u[0]),Pa(u)),a.dataMax=x(o(a.dataMax,u[0]),Aa(u));if(s(y))if(a.dataMin>=y)a.dataMin=y,a.ignoreMinPadding=!0;else if(a.dataMaxe+this.width)l= !0}else if(c=e,h=k-this.right,gf+this.height)l=!0;return l?null:d.renderer.crispLine(["M",c,g,"L",h,i],b||0)},getPlotBandPath:function(a,b){var c=this.getPlotLinePath(b),d=this.getPlotLinePath(a);d&&c?d.push(c[4],c[5],c[1],c[2]):d=null;return d},getLinearTickPositions:function(a,b,c){for(var d,b=ja(W(b/a)*a),c=ja(wa(c/a)*a),e=[];b<=c;){e.push(b);b=ja(b+a);if(b===d)break;d=b}return e},getLogTickPositions:function(a,b,c,d){var e=this.options,f=this.len,g=[];if(!d)this._minorAutoInterval=null; if(a>=0.5)a=t(a),g=this.getLinearTickPositions(a,b,c);else if(a>=0.08)for(var f=W(b),h,i,j,k,l,e=a>0.3?[1,2,4]:a>0.15?[1,2,4,6,8]:[1,2,3,4,5,6,7,8,9];fb&&g.push(k),k>c&&(l=!0),k=j}else if(b=ba(b),c=ba(c),a=e[d?"minorTickInterval":"tickInterval"],a=o(a==="auto"?null:a,this._minorAutoInterval,(c-b)*(e.tickPixelInterval/(d?5:1))/((d?f/this.tickPositions.length:f)||1)),a=gb(a,null,L.pow(10,W(L.log(a)/L.LN10))),g=Ea(this.getLinearTickPositions(a, b,c),ma),!d)this._minorAutoInterval=a/5;if(!d)this.tickInterval=a;return g},getMinorTickPositions:function(){var a=this.tickPositions,b=this.minorTickInterval,c=[],d,e;if(this.isLog){e=a.length;for(d=1;d=this.minRange,f,g,h,i,j;if(this.isXAxis&&this.minRange===A&& !this.isLog)s(a.min)||s(a.max)?this.minRange=null:(n(this.series,function(a){i=a.xData;for(g=j=a.xIncrement?1:i.length-1;g>0;g--)if(h=i[g]-i[g-1],f===A||h0||!b.ignoreMaxPadding))b.max+=c*j}b.tickInterval=b.min===b.max||b.min===void 0||b.max===void 0?1:h&&!l&&m===b.linkedParent.options.tickPixelInterval?b.linkedParent.tickInterval:o(l,p?1:(b.max-b.min)*m/(b.len||1));g&&!a&&n(b.series,function(a){a.processData(b.min!==b.oldMin||b.max!==b.oldMax)}); b.setAxisTranslation();b.beforeSetTickPositions&&b.beforeSetTickPositions();if(b.postProcessTickInterval)b.tickInterval=b.postProcessTickInterval(b.tickInterval);if(!f&&!e&&(a=L.pow(10,W(L.log(b.tickInterval)/L.LN10)),!s(d.tickInterval)))b.tickInterval=gb(b.tickInterval,null,a,d);b.minorTickInterval=d.minorTickInterval==="auto"&&b.tickInterval?b.tickInterval/5:d.minorTickInterval;b.tickPositions=i=d.tickPositions||i&&i.apply(b,[b.min,b.max]);if(!i)i=f?(b.getNonLinearTimeTicks||Pb)(Ob(b.tickInterval, d.units),b.min,b.max,d.startOfWeek,b.ordinalPositions,b.closestPointRange,!0):e?b.getLogTickPositions(b.tickInterval,b.min,b.max):b.getLinearTickPositions(b.tickInterval,b.min,b.max),b.tickPositions=i;if(!h)e=i[0],f=i[i.length-1],d.startOnTick?b.min=e:b.min>e&&i.shift(),d.endOnTick?b.max=f:b.maxb[d]&&this.options.alignTicks!==!1)b[d]= c.length;a.maxTicks=b},adjustTickAmount:function(){var a=this.xOrY,b=this.tickPositions,c=this.chart.maxTicks;if(c&&c[a]&&!this.isDatetimeAxis&&!this.categories&&!this.isLinked&&this.options.alignTicks!==!1){var d=this.tickAmount,e=b.length;this.tickAmount=a=c[a];if(ea||a===null?a=c:b=a.min&&b<=a.max)j[b]||(j[b]=new Sa(a,b)),r&&j[b].isNew&&j[b].render(c,!0),j[b].isActive=!0,j[b].render(c)}),p&&n(g,function(b,c){if(c%2===0&&b1|| M(b-c.currentY)>1?function(){c.move(a,b)}:null},hide:function(){if(!this.tooltipIsHidden){var a=this.chart.hoverPoints;this.label.hide();a&&n(a,function(a){a.setState()});this.chart.hoverPoints=null;this.tooltipIsHidden=!0}},hideCrosshairs:function(){n(this.crosshairs,function(a){a&&a.hide()})},getAnchor:function(a,b){var c,d=this.chart,e=d.inverted,f=0,g=0,a=na(a);c=a[0].tooltipPos;c||(n(a,function(a){f+=a.plotX;g+=a.plotLow?(a.plotLow+a.plotHigh)/2:a.plotY}),f/=a.length,g/=a.length,c=[e?d.plotWidth- g:f,this.shared&&!e&&a.length>1&&b?b.chartY-d.plotTop:e?d.plotHeight-f:g]);return Ea(c,t)},getPosition:function(a,b,c){var d=this.chart,e=d.plotLeft,f=d.plotTop,g=d.plotWidth,h=d.plotHeight,i=o(this.options.distance,12),j=c.plotX,c=c.plotY,d=j+e+(d.inverted?i:-a-i),k=c-b+f+15,l;d<7&&(d=e+j+i);d+a>e+g&&(d-=d+a-(e+g),k=c-b+f-i,l=!0);k=k&&c<=k+b&&(k=c+f+i));k+b>f+h&&(k=x(f,f+h-b-i));return{x:d,y:k}},refresh:function(a,b){function c(){var a=this.points||na(this),b=a[0].series,c;c=[b.tooltipHeaderFormatter(a[0].key)]; n(a,function(a){b=a.series;c.push(b.tooltipFormatter&&b.tooltipFormatter(a)||a.point.tooltipFormatter(b.tooltipOptions.pointFormat))});c.push(f.footerFormat||"");return c.join("")}var d=this.chart,e=this.label,f=this.options,g,h,i,j={},k,l=[];k=f.formatter||c;var j=d.hoverPoints,m,p=f.crosshairs;i=this.shared;h=this.getAnchor(a,b);g=h[0];h=h[1];i&&(!a.series||!a.series.noSharedTooltip)?(j&&n(j,function(a){a.setState()}),d.hoverPoints=a,n(a,function(a){a.setState("hover");l.push(a.getLabelConfig())}), j={x:a[0].category,y:a[0].y},j.points=l,a=a[0]):j=a.getLabelConfig();k=k.call(j);j=a.series;i=i||!j.isCartesian||j.tooltipOutsidePlot||d.isInsidePlot(g,h);k===!1||!i?this.hide():(this.tooltipIsHidden&&e.show(),e.attr({text:k}),m=f.borderColor||a.color||j.color||"#606060",e.attr({stroke:m}),e=(f.positioner||this.getPosition).call(this,e.width,e.height,{plotX:g,plotY:h}),this.move(t(e.x),t(e.y)),this.tooltipIsHidden=!1);if(p){p=na(p);for(e=p.length;e--;)if(i=a.series[e?"yAxis":"xAxis"],p[e]&&i)if(i= i.getPlotLinePath(e?o(a.stackY,a.y):a.x,1),this.crosshairs[e])this.crosshairs[e].attr({d:i,visibility:"visible"});else{j={"stroke-width":p[e].width||1,stroke:p[e].color||"#C0C0C0",zIndex:p[e].zIndex||2};if(p[e].dashStyle)j.dashstyle=p[e].dashStyle;this.crosshairs[e]=d.renderer.path(i).attr(j).add()}}E(d,"tooltipRefresh",{text:k,x:g+d.plotLeft,y:h+d.plotTop,borderColor:m})},tick:function(){this.tooltipTick&&this.tooltipTick()}};Db.prototype={normalizeMouseEvent:function(a){var b,c,d,a=a||N.event;if(!a.target)a.target= a.srcElement;if(a.originalEvent)a=a.originalEvent;if(a.event)a=a.event;d=a.touches?a.touches.item(0):a;this.chartPosition=b=Jb(this.chart.container);d.pageX===A?(c=a.x,b=a.y):(c=d.pageX-b.left,b=d.pageY-b.top);return u(a,{chartX:t(c),chartY:t(b)})},getMouseCoordinates:function(a){var b={xAxis:[],yAxis:[]},c=this.chart;n(c.axes,function(d){var e=d.isXAxis;b[e?"xAxis":"yAxis"].push({axis:d,value:d.translate((c.inverted?!e:e)?a.chartX-c.plotLeft:c.plotHeight-a.chartY+c.plotTop,!0)})});return b},onmousemove:function(a){var b= this.chart,c=b.series,d,e,f=b.hoverPoint,g=b.hoverSeries,h,i,j=b.chartWidth,k=b.inverted?b.plotHeight+b.plotTop-a.chartY:a.chartX-b.plotLeft;if(b.tooltip&&this.options.tooltip.shared&&(!g||!g.noSharedTooltip)){e=[];h=c.length;for(i=0;ij&&e.splice(h,1);if(e.length&&e[0].plotX!==this.hoverX)b.tooltip.refresh(e, a),this.hoverX=e[0].plotX}if(g&&g.tracker&&(d=g.tooltipPoints[k])&&d!==f)d.onMouseOver()},resetTracker:function(a){var b=this.chart,c=b.hoverSeries,d=b.hoverPoint,e=b.hoverPoints||d,b=b.tooltip;(a=a&&b&&e)&&na(e)[0].plotX===A&&(a=!1);if(a)b.refresh(e);else{if(d)d.onMouseOut();if(c)c.onMouseOut();b&&(b.hide(),b.hideCrosshairs());this.hoverX=null}},setDOMEvents:function(){function a(){if(b.selectionMarker){var f={xAxis:[],yAxis:[]},g=b.selectionMarker.getBBox(),h=g.x-c.plotLeft,l=g.y-c.plotTop,m;e&& (n(c.axes,function(a){if(a.options.zoomEnabled!==!1){var b=a.isXAxis,d=c.inverted?!b:b,e=a.translate(d?h:c.plotHeight-l-g.height,!0,0,0,1),d=a.translate(d?h+g.width:c.plotHeight-l,!0,0,0,1);!isNaN(e)&&!isNaN(d)&&(f[b?"xAxis":"yAxis"].push({axis:a,min:O(e,d),max:x(e,d)}),m=!0)}}),m&&E(c,"selection",f,function(a){c.zoom(a)}));b.selectionMarker=b.selectionMarker.destroy()}if(c)F(d,{cursor:"auto"}),c.cancelClick=e,c.mouseIsDown=e=!1;P(B,ea?"touchend":"mouseup",a)}var b=this,c=b.chart,d=c.container,e, f=b.zoomX&&!c.inverted||b.zoomY&&c.inverted,g=b.zoomY&&!c.inverted||b.zoomX&&c.inverted;b.hideTooltipOnMouseMove=function(a){Kb(a);b.chartPosition&&c.hoverSeries&&c.hoverSeries.isCartesian&&!c.isInsidePlot(a.pageX-b.chartPosition.left-c.plotLeft,a.pageY-b.chartPosition.top-c.plotTop)&&b.resetTracker()};b.hideTooltipOnMouseLeave=function(){b.resetTracker();b.chartPosition=null};d.onmousedown=function(d){d=b.normalizeMouseEvent(d);!ea&&d.preventDefault&&d.preventDefault();c.mouseIsDown=!0;c.cancelClick= !1;c.mouseDownX=b.mouseDownX=d.chartX;b.mouseDownY=d.chartY;I(B,ea?"touchend":"mouseup",a)};var h=function(a){if(!a||!(a.touches&&a.touches.length>1)){a=b.normalizeMouseEvent(a);if(!ea)a.returnValue=!1;var d=a.chartX,h=a.chartY,l=!c.isInsidePlot(d-c.plotLeft,h-c.plotTop);ea&&a.type==="touchstart"&&(z(a.target,"isTracker")?c.runTrackerClick||a.preventDefault():!c.runChartClick&&!l&&a.preventDefault());if(l)dc.plotLeft+c.plotWidth&&(d=c.plotLeft+c.plotWidth),hc.plotTop+c.plotHeight&&(h=c.plotTop+c.plotHeight);if(c.mouseIsDown&&a.type!=="touchstart"){if(e=Math.sqrt(Math.pow(b.mouseDownX-d,2)+Math.pow(b.mouseDownY-h,2)),e>10){a=c.isInsidePlot(b.mouseDownX-c.plotLeft,b.mouseDownY-c.plotTop);if(c.hasCartesianSeries&&(b.zoomX||b.zoomY)&&a&&!b.selectionMarker)b.selectionMarker=c.renderer.rect(c.plotLeft,c.plotTop,f?1:c.plotWidth,g?1:c.plotHeight,0).attr({fill:b.options.chart.selectionMarkerFill||"rgba(69,114,167,0.25)",zIndex:7}).add();if(b.selectionMarker&& f){var m=d-b.mouseDownX;b.selectionMarker.attr({width:M(m),x:(m>0?0:m)+b.mouseDownX})}b.selectionMarker&&g&&(h-=b.mouseDownY,b.selectionMarker.attr({height:M(h),y:(h>0?0:h)+b.mouseDownY}));a&&!b.selectionMarker&&b.options.chart.panning&&c.pan(d)}}else if(!l)b.onmousemove(a);return l||!c.hasCartesianSeries}};d.onmousemove=h;I(d,"mouseleave",b.hideTooltipOnMouseLeave);I(B,"mousemove",b.hideTooltipOnMouseMove);d.ontouchstart=function(a){if(b.zoomX||b.zoomY)d.onmousedown(a);h(a)};d.ontouchmove=h;d.ontouchend= function(){e&&b.resetTracker()};d.onclick=function(a){var d=c.hoverPoint,e,f,a=b.normalizeMouseEvent(a);a.cancelBubble=!0;if(!c.cancelClick)d&&(z(a.target,"isTracker")||z(a.target.parentNode,"isTracker"))?(e=d.plotX,f=d.plotY,u(d,{pageX:b.chartPosition.left+c.plotLeft+(c.inverted?c.plotWidth-f:e),pageY:b.chartPosition.top+c.plotTop+(c.inverted?c.plotHeight-e:f)}),E(d.series,"click",u(a,{point:d})),d.firePointEvent("click",a)):(u(a,b.getMouseCoordinates(a)),c.isInsidePlot(a.chartX-c.plotLeft,a.chartY- c.plotTop)&&E(c,"click",a))}},destroy:function(){var a=this.chart,b=a.container;if(a.trackerGroup)a.trackerGroup=a.trackerGroup.destroy();P(b,"mouseleave",this.hideTooltipOnMouseLeave);P(B,"mousemove",this.hideTooltipOnMouseMove);b.onclick=b.onmousedown=b.onmousemove=b.ontouchstart=b.ontouchend=b.ontouchmove=null;clearInterval(this.tooltipInterval)},init:function(a,b){if(!a.trackerGroup)a.trackerGroup=a.renderer.g("tracker").attr({zIndex:9}).add();if(b.enabled)a.tooltip=new pb(a,b),this.tooltipInterval= setInterval(function(){a.tooltip.tick()},32);this.setDOMEvents()}};qb.prototype={init:function(a){var b=this,c=b.options=a.options.legend;if(c.enabled){var d=c.itemStyle,e=o(c.padding,8),f=c.itemMarginTop||0;b.baseline=w(d.fontSize)+3+f;b.itemStyle=d;b.itemHiddenStyle=C(d,c.itemHiddenStyle);b.itemMarginTop=f;b.padding=e;b.initialItemX=e;b.initialItemY=e-5;b.maxItemWidth=0;b.chart=a;b.itemHeight=0;b.lastLineHeight=0;b.render();I(b.chart,"endResize",function(){b.positionCheckboxes()})}},colorizeItem:function(a, b){var c=this.options,d=a.legendItem,e=a.legendLine,f=a.legendSymbol,g=this.itemHiddenStyle.color,c=b?c.itemStyle.color:g,g=b?a.color:g;d&&d.css({fill:c});e&&e.attr({stroke:g});f&&f.attr({stroke:g,fill:g})},positionItem:function(a){var b=this.options,c=b.symbolPadding,b=!b.rtl,d=a._legendItemPos,e=d[0],d=d[1],f=a.checkbox;a.legendGroup&&a.legendGroup.translate(b?e:this.legendWidth-e-2*c-4,d);if(f)f.x=e,f.y=d},destroyItem:function(a){var b=a.checkbox;n(["legendItem","legendLine","legendSymbol","legendGroup"], function(b){a[b]&&a[b].destroy()});b&&Qa(a.checkbox)},destroy:function(){var a=this.group,b=this.box;if(b)this.box=b.destroy();if(a)this.group=a.destroy()},positionCheckboxes:function(){var a=this;n(a.allItems,function(b){var c=b.checkbox,d=a.group.alignAttr;c&&F(c,{left:d.translateX+b.legendItemWidth+c.x-20+"px",top:d.translateY+c.y+3+"px"})})},renderItem:function(a){var q;var b=this,c=b.chart,d=c.renderer,e=b.options,f=e.layout==="horizontal",g=e.symbolWidth,h=e.symbolPadding,i=b.itemStyle,j=b.itemHiddenStyle, k=b.padding,l=!e.rtl,m=e.width,p=e.itemMarginBottom||0,n=b.itemMarginTop,o=b.initialItemX,r=a.legendItem,s=a.series||a,t=s.options,u=t.showCheckbox;if(!r&&(a.legendGroup=d.g("legend-item").attr({zIndex:1}).add(b.scrollGroup),s.drawLegendSymbol(b,a),a.legendItem=r=d.text(e.labelFormatter.call(a),l?g+h:-h,b.baseline,e.useHTML).css(C(a.visible?i:j)).attr({align:l?"left":"right",zIndex:2}).add(a.legendGroup),a.legendGroup.on("mouseover",function(){a.setState("hover");r.css(b.options.itemHoverStyle)}).on("mouseout", function(){r.css(a.visible?i:j);a.setState()}).on("click",function(b){var c=function(){a.setVisible()},b={browserEvent:b};a.firePointEvent?a.firePointEvent("legendItemClick",b,c):E(a,"legendItemClick",b,c)}),b.colorizeItem(a,a.visible),t&&u))a.checkbox=S("input",{type:"checkbox",checked:a.selected,defaultChecked:a.selected},e.itemCheckboxStyle,c.container),I(a.checkbox,"click",function(b){E(a,"checkboxClick",{checked:b.target.checked},function(){a.select()})});d=r.getBBox();q=a.legendItemWidth=e.itemWidth|| g+h+d.width+k+(u?20:0),e=q;b.itemHeight=g=d.height;if(f&&b.itemX-o+e>(m||c.chartWidth-2*k-o))b.itemX=o,b.itemY+=n+b.lastLineHeight+p,b.lastLineHeight=0;b.maxItemWidth=x(b.maxItemWidth,e);b.lastItemY=n+b.itemY+p;b.lastLineHeight=x(g,b.lastLineHeight);a._legendItemPos=[b.itemX,b.itemY];f?b.itemX+=e:(b.itemY+=n+g+p,b.lastLineHeight=g);b.offsetWidth=m||x(f?b.itemX-o:e,b.offsetWidth)},render:function(){var a=this,b=a.chart,c=b.renderer,d=a.group,e,f,g,h,i=a.box,j=a.options,k=a.padding,l=j.borderWidth, m=j.backgroundColor;a.itemX=a.initialItemX;a.itemY=a.initialItemY;a.offsetWidth=0;a.lastItemY=0;if(!d)a.group=d=c.g("legend").attr({zIndex:7}).add(),a.contentGroup=c.g().attr({zIndex:1}).add(d),a.scrollGroup=c.g().add(a.contentGroup),a.clipRect=c.clipRect(0,0,9999,b.chartHeight),a.contentGroup.clip(a.clipRect);e=[];n(b.series,function(a){var b=a.options;b.showInLegend&&(e=e.concat(a.legendItems||(b.legendType==="point"?a.data:a)))});Qb(e,function(a,b){return(a.options.legendIndex||0)-(b.options.legendIndex|| 0)});j.reversed&&e.reverse();a.allItems=e;a.display=f=!!e.length;n(e,function(b){a.renderItem(b)});g=j.width||a.offsetWidth;h=a.lastItemY+a.lastLineHeight;h=a.handleOverflow(h);if(l||m){g+=k;h+=k;if(i){if(g>0&&h>0)i[i.isNew?"attr":"animate"](i.crisp(null,null,null,g,h)),i.isNew=!1}else a.box=i=c.rect(0,0,g,h,j.borderRadius,l||0).attr({stroke:j.borderColor,"stroke-width":l||0,fill:m||U}).add(d).shadow(j.shadow),i.isNew=!0;i[f?"show":"hide"]()}a.legendWidth=g;a.legendHeight=h;n(e,function(b){a.positionItem(b)}); f&&d.align(u({width:g,height:h},j),!0,b.spacingBox);b.isResizing||this.positionCheckboxes()},handleOverflow:function(a){var b=this,c=this.chart,d=c.renderer,e=this.options,f=e.y,f=c.spacingBox.height+(e.verticalAlign==="top"?-f:f)-this.padding,g=e.maxHeight,h=this.clipRect,i=e.navigation,j=o(i.animation,!0),k=i.arrowSize||12,l=this.nav;e.layout==="horizontal"&&(f/=2);g&&(f=O(f,g));if(a>f){this.clipHeight=c=f-20;this.pageCount=wa(a/c);this.currentPage=o(this.currentPage,1);this.fullHeight=a;h.attr({height:c}); if(!l)this.nav=l=d.g().attr({zIndex:1}).add(this.group),this.up=d.symbol("triangle",0,0,k,k).on("click",function(){b.scroll(-1,j)}).add(l),this.pager=d.text("",15,10).css(i.style).add(l),this.down=d.symbol("triangle-down",0,0,k,k).on("click",function(){b.scroll(1,j)}).add(l);b.scroll(0);a=f}else l&&(h.attr({height:c.chartHeight}),l.hide(),this.scrollGroup.attr({translateY:1}));return a},scroll:function(a,b){var c=this.pageCount,d=this.currentPage+a,e=this.clipHeight,f=this.options.navigation,g=f.activeColor, f=f.inactiveColor,h=this.pager,i=this.padding;d>c&&(d=c);if(d>0)b!==A&&ua(b,this.chart),this.nav.attr({translateX:i,translateY:e+7,visibility:"visible"}),this.up.attr({fill:d===1?f:g}).css({cursor:d===1?"default":"pointer"}),h.attr({text:d+"/"+this.pageCount}),this.down.attr({x:18+this.pager.getBBox().width,fill:d===c?f:g}).css({cursor:d===c?"default":"pointer"}),this.scrollGroup.animate({translateY:-O(e*(d-1),this.fullHeight-e+i)+1}),h.attr({text:d+"/"+c}),this.currentPage=d}};rb.prototype={initSeries:function(a){var b= this.options.chart,b=new Y[a.type||b.type||b.defaultSeriesType];b.init(this,a);return b},addSeries:function(a,b,c){var d=this;a&&(ua(c,d),b=o(b,!0),E(d,"addSeries",{options:a},function(){d.initSeries(a);d.isDirtyLegend=!0;b&&d.redraw()}))},isInsidePlot:function(a,b){return a>=0&&a<=this.plotWidth&&b>=0&&b<=this.plotHeight},adjustTickAmounts:function(){this.options.chart.alignTicks!==!1&&n(this.axes,function(a){a.adjustTickAmount()});this.maxTicks=null},redraw:function(a){var b=this.axes,c=this.series, d=this.tracker,e=this.legend,f=this.isDirtyLegend,g,h=this.isDirtyBox,i=c.length,j=i,k=this.clipRect,l=this.renderer,m=l.isHidden();ua(a,this);for(m&&this.cloneRenderTo();j--;)if(a=c[j],a.isDirty&&a.options.stacking){g=!0;break}if(g)for(j=i;j--;)if(a=c[j],a.options.stacking)a.isDirty=!0;n(c,function(a){a.isDirty&&a.options.legendType==="point"&&(f=!0)});if(f&&e.options.enabled)e.render(),this.isDirtyLegend=!1;if(this.hasCartesianSeries){if(!this.isResizing)this.maxTicks=null,n(b,function(a){a.setScale()}); this.adjustTickAmounts();this.getMargins();n(b,function(a){if(a.isDirtyExtremes)a.isDirtyExtremes=!1,E(a,"afterSetExtremes",a.getExtremes());if(a.isDirty||h||g)a.redraw(),h=!0})}h&&(this.drawChartBox(),k&&(Fa(k),k.animate({width:this.plotSizeX,height:this.plotSizeY+1})));n(c,function(a){a.isDirty&&a.visible&&(!a.isCartesian||a.xAxis)&&a.redraw()});d&&d.resetTracker&&d.resetTracker(!0);l.draw();E(this,"redraw");m&&this.cloneRenderTo(!0)},showLoading:function(a){var b=this.options,c=this.loadingDiv, d=b.loading;if(!c)this.loadingDiv=c=S(ia,{className:"highcharts-loading"},u(d.style,{left:this.plotLeft+"px",top:this.plotTop+"px",width:this.plotWidth+"px",height:this.plotHeight+"px",zIndex:10,display:U}),this.container),this.loadingSpan=S("span",null,d.labelStyle,c);this.loadingSpan.innerHTML=a||b.lang.loading;if(!this.loadingShown)F(c,{opacity:0,display:""}),eb(c,{opacity:d.style.opacity},{duration:d.showDuration||0}),this.loadingShown=!0},hideLoading:function(){var a=this.options,b=this.loadingDiv; b&&eb(b,{opacity:0},{duration:a.loading.hideDuration||100,complete:function(){F(b,{display:U})}});this.loadingShown=!1},get:function(a){var b=this.axes,c=this.series,d,e;for(d=0;dO(e.dataMin,e.min)&&c19?this.containerHeight:400)},cloneRenderTo:function(a){var b=this.renderToClone,c=this.container;a?b&&(this.renderTo.appendChild(c),Qa(b),delete this.renderToClone):(c&&this.renderTo.removeChild(c),this.renderToClone=b=this.renderTo.cloneNode(0),F(b,{position:"absolute",top:"-9999px",display:"block"}), B.body.appendChild(b),c&&b.appendChild(c))},getContainer:function(){var a,b=this.options.chart,c,d,e;this.renderTo=a=b.renderTo;e="highcharts-"+sb++;if(ra(a))this.renderTo=a=B.getElementById(a);a||mb(13,!0);a.innerHTML="";a.offsetWidth||this.cloneRenderTo();this.getChartSize();c=this.chartWidth;d=this.chartHeight;this.container=a=S(ia,{className:"highcharts-container"+(b.className?" "+b.className:""),id:e},u({position:"relative",overflow:"hidden",width:c+"px",height:d+"px",textAlign:"left",lineHeight:"normal"}, b.style),this.renderToClone||a);this.renderer=b.forExport?new qa(a,c,d,!0):new Ta(a,c,d);ga&&this.renderer.create(this,a,c,d)},getMargins:function(){var a=this.options.chart,b=a.spacingTop,c=a.spacingRight,d=a.spacingBottom,a=a.spacingLeft,e,f=this.legend,g=this.optionsMarginTop,h=this.optionsMarginLeft,i=this.optionsMarginRight,j=this.optionsMarginBottom,k=this.chartTitleOptions,l=this.chartSubtitleOptions,m=this.options.legend,p=o(m.margin,10),q=m.x,t=m.y,r=m.align,y=m.verticalAlign;this.resetMargins(); e=this.axisOffset;if((this.title||this.subtitle)&&!s(this.optionsMarginTop))if(l=x(this.title&&!k.floating&&!k.verticalAlign&&k.y||0,this.subtitle&&!l.floating&&!l.verticalAlign&&l.y||0))this.plotTop=x(this.plotTop,l+o(k.margin,15)+b);if(f.display&&!m.floating)if(r==="right"){if(!s(i))this.marginRight=x(this.marginRight,f.legendWidth-q+p+c)}else if(r==="left"){if(!s(h))this.plotLeft=x(this.plotLeft,f.legendWidth+q+p+a)}else if(y==="top"){if(!s(g))this.plotTop=x(this.plotTop,f.legendHeight+t+p+b)}else if(y=== "bottom"&&!s(j))this.marginBottom=x(this.marginBottom,f.legendHeight-t+p+d);this.extraBottomMargin&&(this.marginBottom+=this.extraBottomMargin);this.extraTopMargin&&(this.plotTop+=this.extraTopMargin);this.hasCartesianSeries&&n(this.axes,function(a){a.getOffset()});s(h)||(this.plotLeft+=e[3]);s(g)||(this.plotTop+=e[0]);s(j)||(this.marginBottom+=e[2]);s(i)||(this.marginRight+=e[1]);this.setChartSize()},initReflow:function(){function a(a){var g=c.width||Va(d,"width"),h=c.height||Va(d,"height"),a=a? a.target:N;if(g&&h&&(a===N||a===B)){if(g!==b.containerWidth||h!==b.containerHeight)clearTimeout(e),e=setTimeout(function(){b.resize(g,h,!1)},100);b.containerWidth=g;b.containerHeight=h}}var b=this,c=b.options.chart,d=b.renderTo,e;I(N,"resize",a);I(b,"destroy",function(){P(N,"resize",a)})},fireEndResize:function(){var a=this;a&&E(a,"endResize",null,function(){a.isResizing-=1})},resize:function(a,b,c){var d,e,f=this.title,g=this.subtitle;this.isResizing+=1;ua(c,this);this.oldChartHeight=this.chartHeight; this.oldChartWidth=this.chartWidth;if(s(a))this.chartWidth=d=t(a);if(s(b))this.chartHeight=e=t(b);F(this.container,{width:d+"px",height:e+"px"});this.renderer.setSize(d,e,c);this.plotWidth=d-this.plotLeft-this.marginRight;this.plotHeight=e-this.plotTop-this.marginBottom;this.maxTicks=null;n(this.axes,function(a){a.isDirty=!0;a.setScale()});n(this.series,function(a){a.isDirty=!0});this.isDirtyBox=this.isDirtyLegend=!0;this.getMargins();a=this.spacingBox;f&&f.align(null,null,a);g&&g.align(null,null, a);this.redraw(c);this.oldChartHeight=null;E(this,"resize");Ra===!1?this.fireEndResize():setTimeout(this.fireEndResize,Ra&&Ra.duration||500)},setChartSize:function(){var a=this.inverted,b=this.chartWidth,c=this.chartHeight,d=this.options.chart,e=d.spacingTop,f=d.spacingRight,g=d.spacingBottom,d=d.spacingLeft;this.plotLeft=t(this.plotLeft);this.plotTop=t(this.plotTop);this.plotWidth=t(b-this.plotLeft-this.marginRight);this.plotHeight=t(c-this.plotTop-this.marginBottom);this.plotSizeX=a?this.plotHeight: this.plotWidth;this.plotSizeY=a?this.plotWidth:this.plotHeight;this.spacingBox={x:d,y:e,width:b-d-f,height:c-e-g};n(this.axes,function(a){a.setAxisSize();a.setAxisTranslation()})},resetMargins:function(){var a=this.options.chart,b=a.spacingRight,c=a.spacingBottom,d=a.spacingLeft;this.plotTop=o(this.optionsMarginTop,a.spacingTop);this.marginRight=o(this.optionsMarginRight,b);this.marginBottom=o(this.optionsMarginBottom,c);this.plotLeft=o(this.optionsMarginLeft,d);this.axisOffset=[0,0,0,0]},drawChartBox:function(){var a= this.options.chart,b=this.renderer,c=this.chartWidth,d=this.chartHeight,e=this.chartBackground,f=this.plotBackground,g=this.plotBorder,h=this.plotBGImage,i=a.borderWidth||0,j=a.backgroundColor,k=a.plotBackgroundColor,l=a.plotBackgroundImage,m,p={x:this.plotLeft,y:this.plotTop,width:this.plotWidth,height:this.plotHeight};m=i+(a.shadow?8:0);if(i||j)if(e)e.animate(e.crisp(null,null,null,c-m,d-m));else{e={fill:j||U};if(i)e.stroke=a.borderColor,e["stroke-width"]=i;this.chartBackground=b.rect(m/2,m/2,c- m,d-m,a.borderRadius,i).attr(e).add().shadow(a.shadow)}if(k)f?f.animate(p):this.plotBackground=b.rect(this.plotLeft,this.plotTop,this.plotWidth,this.plotHeight,0).attr({fill:k}).add().shadow(a.plotShadow);if(l)h?h.animate(p):this.plotBGImage=b.image(l,this.plotLeft,this.plotTop,this.plotWidth,this.plotHeight).add();if(a.plotBorderWidth)g?g.animate(g.crisp(null,this.plotLeft,this.plotTop,this.plotWidth,this.plotHeight)):this.plotBorder=b.rect(this.plotLeft,this.plotTop,this.plotWidth,this.plotHeight, 0,a.plotBorderWidth).attr({stroke:a.plotBorderColor,"stroke-width":a.plotBorderWidth,zIndex:4}).add();this.isDirtyBox=!1},propFromSeries:function(){var a=this,b=a.options.chart,c,d=a.options.series,e,f;n(["inverted","angular","polar"],function(g){c=Y[b.type||b.defaultSeriesType];f=a[g]||b[g]||c&&c.prototype[g];for(e=d&&d.length;!f&&e--;)(c=Y[d[e].type])&&c.prototype[g]&&(f=!0);a[g]=f})},render:function(){var a=this,b=a.axes,c=a.renderer,d=a.options,e=d.labels,d=d.credits,f;a.setTitle();a.legend=new qb(a); n(b,function(a){a.setScale()});a.getMargins();a.maxTicks=null;n(b,function(a){a.setTickPositions(!0);a.setMaxTicks()});a.adjustTickAmounts();a.getMargins();a.drawChartBox();a.hasCartesianSeries&&n(b,function(a){a.render()});if(!a.seriesGroup)a.seriesGroup=c.g("series-group").attr({zIndex:3}).add();n(a.series,function(a){a.translate();a.setTooltipPoints();a.render()});e.items&&n(e.items,function(){var b=u(e.style,this.style),d=w(b.left)+a.plotLeft,f=w(b.top)+a.plotTop+12;delete b.left;delete b.top; c.text(this.html,d,f).attr({zIndex:2}).css(b).add()});if(d.enabled&&!a.credits)f=d.href,a.credits=c.text(d.text,0,0).on("click",function(){if(f)location.href=f}).attr({align:d.position.align,zIndex:8}).css(d.style).add().align(d.position);a.hasRendered=!0},destroy:function(){var a=this,b=a.axes,c=a.series,d=a.container,e,f=d&&d.parentNode;if(a!==null){E(a,"destroy");P(a);for(e=b.length;e--;)b[e]=b[e].destroy();for(e=c.length;e--;)c[e]=c[e].destroy();n("title,subtitle,chartBackground,plotBackground,plotBGImage,plotBorder,seriesGroup,clipRect,credits,tracker,scroller,rangeSelector,legend,resetZoomButton,tooltip,renderer".split(","), function(b){var c=a[b];c&&(a[b]=c.destroy())});if(d)d.innerHTML="",P(d),f&&Qa(d),d=null;for(e in a)delete a[e];a=a.options=null}},firstRender:function(){var a=this,b=a.options,c=a.callback;if(!Da&&N==N.top&&B.readyState!=="complete"||ga&&!N.canvg)ga?Nb.push(function(){a.firstRender()},b.global.canvasToolsURL):B.attachEvent("onreadystatechange",function(){B.detachEvent("onreadystatechange",a.firstRender);B.readyState==="complete"&&a.firstRender()});else{a.getContainer();E(a,"init");if(Highcharts.RangeSelector&& b.rangeSelector.enabled)a.rangeSelector=new Highcharts.RangeSelector(a);a.resetMargins();a.setChartSize();a.propFromSeries();a.getAxes();n(b.series||[],function(b){a.initSeries(b)});if(Highcharts.Scroller&&(b.navigator.enabled||b.scrollbar.enabled))a.scroller=new Highcharts.Scroller(a);a.tracker=new Db(a,b);a.render();a.renderer.draw();c&&c.apply(a,[a]);n(a.callbacks,function(b){b.apply(a,[a])});a.cloneRenderTo(!0);E(a,"load")}},init:function(a){var b=this.options.chart,c;b.reflow!==!1&&I(this,"load", this.initReflow);if(a)for(c in a)I(this,c,a[c]);this.xAxis=[];this.yAxis=[];this.animation=ga?!1:o(b.animation,!0);this.setSize=this.resize;this.pointCount=0;this.counters=new Ab;this.firstRender()}};rb.prototype.callbacks=[];var Wa=function(){};Wa.prototype={init:function(a,b,c){var d=a.chart.counters;this.series=a;this.applyOptions(b,c);this.pointAttr={};if(a.options.colorByPoint){b=a.chart.options.colors;if(!this.options)this.options={};this.color=this.options.color=this.color||b[d.color++];d.wrapColor(b.length)}a.chart.pointCount++; return this},applyOptions:function(a,b){var c=this.series,d=typeof a;this.config=a;if(d==="number"||a===null)this.y=a;else if(typeof a[0]==="number")this.x=a[0],this.y=a[1];else if(d==="object"&&typeof a.length!=="number"){if(u(this,a),this.options=a,a.dataLabels)c._hasPointLabels=!0}else if(typeof a[0]==="string")this.name=a[0],this.y=a[1];if(this.x===A)this.x=b===A?c.autoIncrement():b},destroy:function(){var a=this.series.chart,b=a.hoverPoints,c;a.pointCount--;if(b&&(this.setState(),za(b,this), !b.length))a.hoverPoints=null;if(this===a.hoverPoint)this.onMouseOut();if(this.graphic||this.dataLabel)P(this),this.destroyElements();this.legendItem&&a.legend.destroyItem(this);for(c in this)this[c]=null},destroyElements:function(){for(var a="graphic,tracker,dataLabel,group,connector,shadowGroup".split(","),b,c=6;c--;)b=a[c],this[b]&&(this[b]=this[b].destroy())},getLabelConfig:function(){return{x:this.category,y:this.y,key:this.name||this.category,series:this.series,point:this,percentage:this.percentage, total:this.total||this.stackTotal}},select:function(a,b){var c=this,d=c.series.chart,a=o(a,!c.selected);c.firePointEvent(a?"select":"unselect",{accumulate:b},function(){c.selected=a;c.setState(a&&"select");b||n(d.getSelectedPoints(),function(a){if(a.selected&&a!==c)a.selected=!1,a.setState(""),a.firePointEvent("unselect")})})},onMouseOver:function(){var a=this.series,b=a.chart,c=b.tooltip,d=b.hoverPoint;if(d&&d!==this)d.onMouseOut();this.firePointEvent("mouseOver");c&&(!c.shared||a.noSharedTooltip)&& c.refresh(this);this.setState("hover");b.hoverPoint=this},onMouseOut:function(){this.firePointEvent("mouseOut");this.setState();this.series.chart.hoverPoint=null},tooltipFormatter:function(a){var b=this.series,c=b.tooltipOptions,d=a.match(/\{(series|point)\.[a-zA-Z]+\}/g),e=/[{\.}]/,f,g,h,i,j={y:0,open:0,high:0,low:0,close:0,percentage:1,total:1};c.valuePrefix=c.valuePrefix||c.yPrefix;c.valueDecimals=c.valueDecimals||c.yDecimals;c.valueSuffix=c.valueSuffix||c.ySuffix;for(i in d)g=d[i],ra(g)&&g!== a&&(h=(" "+g).split(e),f={point:this,series:b}[h[1]],h=h[2],f===this&&j.hasOwnProperty(h)?(f=j[h]?h:"value",f=(c[f+"Prefix"]||"")+Xa(this[h],o(c[f+"Decimals"],-1))+(c[f+"Suffix"]||"")):f=f[h],a=a.replace(g,f));return a},update:function(a,b,c){var d=this,e=d.series,f=d.graphic,g,h=e.data,i=h.length,j=e.chart,b=o(b,!0);d.firePointEvent("update",{options:a},function(){d.applyOptions(a);aa(a)&&(e.getAttribs(),f&&f.attr(d.pointAttr[e.state]));for(g=0;ga+1&&b.push(d.slice(a+1,g)),a=g):g===e-1&&b.push(d.slice(a+1,g+1))});this.segments=b},setOptions:function(a){var b=this.chart.options,c=b.plotOptions,d=a.data;a.data=null;c=C(c[this.type],c.series,a);c.data=a.data=d;this.tooltipOptions=C(b.tooltip,c.tooltip);return c},getColor:function(){var a= this.options,b=this.chart.options.colors,c=this.chart.counters;this.color=a.color||!a.colorByPoint&&b[c.color++]||"gray";c.wrapColor(b.length)},getSymbol:function(){var a=this.options.marker,b=this.chart,c=b.options.symbols,b=b.counters;this.symbol=a.symbol||c[b.symbol++];if(/^url/.test(this.symbol))a.radius=0;b.wrapSymbol(c.length)},drawLegendSymbol:function(a){var b=this.options,c=b.marker,d=a.options.symbolWidth,e=this.chart.renderer,f=this.legendGroup,a=a.baseline,g;if(b.lineWidth){g={"stroke-width":b.lineWidth}; if(b.dashStyle)g.dashstyle=b.dashStyle;this.legendLine=e.path(["M",0,a-4,"L",d,a-4]).attr(g).add(f)}if(c&&c.enabled)b=c.radius,this.legendSymbol=e.symbol(this.symbol,d/2-b,a-4-b,2*b,2*b).attr(this.pointAttr[""]).add(f)},addPoint:function(a,b,c,d){var e=this.data,f=this.graph,g=this.area,h=this.chart,i=this.xData,j=this.yData,k=f&&f.shift||0,l=this.options.data;ua(d,h);if(f&&c)f.shift=k+1;if(g){if(c)g.shift=k+1;g.isArea=!0}b=o(b,!0);d={series:this};this.pointClass.prototype.applyOptions.apply(d,[a]); i.push(d.x);j.push(this.valueCount===4?[d.open,d.high,d.low,d.close]:d.y);l.push(a);c&&(e[0]&&e[0].remove?e[0].remove(!1):(e.shift(),i.shift(),j.shift(),l.shift()));this.getAttribs();this.isDirtyData=this.isDirty=!0;b&&h.redraw()},setData:function(a,b){var c=this.points,d=this.options,e=this.initialColor,f=this.chart,g=null,h=this.xAxis,i=this.pointClass.prototype;this.xIncrement=null;this.pointRange=h&&h.categories&&1||d.pointRange;if(s(e))f.counters.color=e;var j=[],k=[],l=a?a.length:[],m=this.valueCount; if(l>(d.turboThreshold||1E3)){for(e=0;g===null&&ek||this.forceCrop))if(a=i.getExtremes(),i=a.min,k=a.max,b[d-1]k)b=[],c=[];else if(b[0]k){for(a=0;a=i){e=x(0,a-1);break}for(;ak){f=a+1;break}b=b.slice(e,f);c=c.slice(e,f);g=!0}for(a=b.length-1;a>0;a--)if(d=b[a]-b[a-1],d>0&&(h===A||d=0&&d<=e;)h[d++]=f}this.tooltipPoints=h}},tooltipHeaderFormatter:function(a){var b=this.tooltipOptions,c=b.xDateFormat,d=this.xAxis,e=d&&d.options.type==="datetime",f;if(e&&!c)for(f in D)if(D[f]>=d.closestPointRange){c=b.dateTimeLabelFormats[f];break}return b.headerFormat.replace("{point.key}",e?db(c,a):a).replace("{series.name}", this.name).replace("{series.color}",this.color)},onMouseOver:function(){var a=this.chart,b=a.hoverSeries;if(ea||!a.mouseIsDown){if(b&&b!==this)b.onMouseOut();this.options.events.mouseOver&&E(this,"mouseOver");this.setState("hover");a.hoverSeries=this}},onMouseOut:function(){var a=this.options,b=this.chart,c=b.tooltip,d=b.hoverPoint;if(d)d.onMouseOut();this&&a.events.mouseOut&&E(this,"mouseOut");c&&!a.stickyTracking&&!c.shared&&c.hide();this.setState();b.hoverSeries=null},animate:function(a){var b= this.chart,c=this.clipRect,d=this.options.animation;d&&!aa(d)&&(d={});if(a){if(!c.isAnimating)c.attr("width",0),c.isAnimating=!0}else c.animate({width:b.plotSizeX},d),this.animate=null},drawPoints:function(){var a,b=this.points,c=this.chart,d,e,f,g,h,i,j,k;if(this.options.marker.enabled)for(f=b.length;f--;)if(g=b[f],d=g.plotX,e=g.plotY,k=g.graphic,e!==A&&!isNaN(e))if(a=g.pointAttr[g.selected?"select":""],h=a.r,i=o(g.marker&&g.marker.symbol,this.symbol),j=i.indexOf("url")===0,k)k.animate(u({x:d-h, y:e-h},k.symbolName?{width:2*h,height:2*h}:{}));else if(h>0||j)g.graphic=c.renderer.symbol(i,d-h,e-h,2*h,2*h).attr(a).add(this.group)},convertAttribs:function(a,b,c,d){var e=this.pointAttrToOptions,f,g,h={},a=a||{},b=b||{},c=c||{},d=d||{};for(f in e)g=e[f],h[f]=o(a[g],b[f],c[f],d[f]);return h},getAttribs:function(){var a=this,b=Z[a.type].marker?a.options.marker:a.options,c=b.states,d=c.hover,e,f=a.color,g={stroke:f,fill:f},h=a.points||[],i=[],j,k=a.pointAttrToOptions,l;a.options.marker?(d.radius= d.radius||b.radius+2,d.lineWidth=d.lineWidth||b.lineWidth+1):d.color=d.color||pa(d.color||f).brighten(d.brightness).get();i[""]=a.convertAttribs(b,g);n(["hover","select"],function(b){i[b]=a.convertAttribs(c[b],i[""])});a.pointAttr=i;for(f=h.length;f--;){g=h[f];if((b=g.options&&g.options.marker||g.options)&&b.enabled===!1)b.radius=0;e=!1;if(g.options)for(l in k)s(b[k[l]])&&(e=!0);if(e){j=[];c=b.states||{};e=c.hover=c.hover||{};if(!a.options.marker)e.color=pa(e.color||g.options.color).brighten(e.brightness|| d.brightness).get();j[""]=a.convertAttribs(b,i[""]);j.hover=a.convertAttribs(c.hover,i.hover,j[""]);j.select=a.convertAttribs(c.select,i.select,j[""])}else j=i;g.pointAttr=j}},destroy:function(){var a=this,b=a.chart,c=a.clipRect,d=/AppleWebKit\/533/.test(ya),e,f,g=a.data||[],h,i,j;E(a,"destroy");P(a);n(["xAxis","yAxis"],function(b){if(j=a[b])za(j.series,a),j.isDirty=!0});a.legendItem&&a.chart.legend.destroyItem(a);for(f=g.length;f--;)(h=g[f])&&h.destroy&&h.destroy();a.points=null;if(c&&c!==b.clipRect)a.clipRect= c.destroy();n("area,graph,dataLabelsGroup,group,tracker,trackerGroup".split(","),function(b){a[b]&&(e=d&&b==="group"?"hide":"destroy",a[b][e]())});if(b.hoverSeries===a)b.hoverSeries=null;za(b.series,a);for(i in a)delete a[i]},drawDataLabels:function(){var a=this,b=a.options,c=b.dataLabels;if(c.enabled||a._hasPointLabels){var d,e,f=a.points,g,h,i,j=a.dataLabelsGroup,k=a.chart,l=a.xAxis,l=l?l.left:k.plotLeft,m=a.yAxis,m=m?m.top:k.plotTop,p=k.renderer,q=k.inverted,u=a.type,r=b.stacking,y=u==="column"|| u==="bar",x=c.verticalAlign===null,w=c.y===null,v=p.fontMetrics(c.style.fontSize),H=v.h,J=v.b,K,z;y&&(v={top:J,middle:J-H/2,bottom:-H+J},r?(x&&(c=C(c,{verticalAlign:"middle"})),w&&(c=C(c,{y:v[c.verticalAlign]}))):x?c=C(c,{verticalAlign:"top"}):w&&(c=C(c,{y:v[c.verticalAlign]})));j?j.translate(l,m):j=a.dataLabelsGroup=p.g("data-labels").attr({visibility:a.visible?"visible":"hidden",zIndex:6}).translate(l,m).add();h=c;n(f,function(f){K=f.dataLabel;c=h;(g=f.options)&&g.dataLabels&&(c=C(c,g.dataLabels)); if(z=c.enabled){var l=f.barX&&f.barX+f.barW/2||o(f.plotX,-999),m=o(f.plotY,-999),n=c.y===null?f.y>=b.threshold?-H+J:J:c.y;d=(q?k.plotWidth-m:l)+c.x;e=t((q?k.plotHeight-l:m)+n)}if(K&&a.isCartesian&&(!k.isInsidePlot(d,e)||!z))f.dataLabel=K.destroy();else if(z){var l=c.align,v;i=c.formatter.call(f.getLabelConfig(),c);u==="column"&&(d+={left:-1,right:1}[l]*f.barW/2||0);!r&&q&&f.y<0&&(l="right",d-=10);c.style.color=o(c.color,c.style.color,a.color,"black");if(K)K.attr({text:i}).animate({x:d,y:e});else if(s(i)){l= {align:l,fill:c.backgroundColor,stroke:c.borderColor,"stroke-width":c.borderWidth,r:c.borderRadius||0,rotation:c.rotation,padding:c.padding,zIndex:1};for(v in l)l[v]===A&&delete l[v];K=f.dataLabel=p[c.rotation?"text":"label"](i,d,e,null,null,null,c.useHTML,!0).attr(l).css(c.style).add(j).shadow(c.shadow)}if(y&&b.stacking&&K)v=f.barX,l=f.barY,m=f.barW,f=f.barH,K.align(c,null,{x:q?k.plotWidth-l-f:v,y:q?k.plotHeight-v-m:l,width:q?f:m,height:q?m:f})}})}},getSegmentPath:function(a){var b=this,c=[];n(a, function(d,e){b.getPointSpline?c.push.apply(c,b.getPointSpline(a,d,e)):(c.push(e?"L":"M"),e&&b.options.step&&c.push(d.plotX,a[e-1].plotY),c.push(d.plotX,d.plotY))});return c},drawGraph:function(){var a=this,b=a.options,c=a.graph,d=[],e=a.group,f=b.lineColor||a.color,g=b.lineWidth,h=b.dashStyle,i,j=a.chart.renderer,k=[];n(a.segments,function(b){i=a.getSegmentPath(b);b.length>1?d=d.concat(i):k.push(b[0])});a.graphPath=d;a.singlePoints=k;if(c)Fa(c),c.animate({d:d});else if(g){c={stroke:f,"stroke-width":g}; if(h)c.dashstyle=h;a.graph=j.path(d).attr(c).add(e).shadow(b.shadow)}},invertGroups:function(){function a(){var a={width:b.yAxis.len,height:b.xAxis.len};c.attr(a).invert();d&&d.attr(a).invert()}var b=this,c=b.group,d=b.trackerGroup,e=b.chart;I(e,"resize",a);I(b,"destroy",function(){P(e,"resize",a)});a();b.invertGroups=a},createGroup:function(){var a=this.chart;(this.group=a.renderer.g("series")).attr({visibility:this.visible?"visible":"hidden",zIndex:this.options.zIndex}).translate(this.xAxis.left, this.yAxis.top).add(a.seriesGroup);this.createGroup=Sb},render:function(){var a=this,b=a.chart,c,d=a.options,e=d.clip!==!1,f=d.animation,f=(d=f&&a.animate)?f&&f.duration||500:0,g=a.clipRect,h=b.renderer;if(!g&&(g=a.clipRect=!b.hasRendered&&b.clipRect?b.clipRect:h.clipRect(0,0,b.plotSizeX,b.plotSizeY+1),!b.clipRect))b.clipRect=g;a.createGroup();c=a.group;a.drawDataLabels();d&&a.animate(!0);a.getAttribs();a.drawGraph&&a.drawGraph();a.drawPoints();a.options.enableMouseTracking!==!1&&a.drawTracker(); b.inverted&&a.invertGroups();e&&!a.hasRendered&&(c.clip(g),a.trackerGroup&&a.trackerGroup.clip(b.clipRect));d&&a.animate();setTimeout(function(){g.isAnimating=!1;if((c=a.group)&&g!==b.clipRect&&g.renderer){if(e)c.clip(a.clipRect=b.clipRect);g.destroy()}},f);a.isDirty=a.isDirtyData=!1;a.hasRendered=!0},redraw:function(){var a=this.chart,b=this.isDirtyData,c=this.group;c&&(a.inverted&&c.attr({width:a.plotWidth,height:a.plotHeight}),c.animate({translateX:this.xAxis.left,translateY:this.yAxis.top})); this.translate();this.setTooltipPoints(!0);this.render();b&&E(this,"updatedData")},setState:function(a){var b=this.options,c=this.graph,d=b.states,b=b.lineWidth,a=a||"";if(this.state!==a)this.state=a,d[a]&&d[a].enabled===!1||(a&&(b=d[a].lineWidth||b+1),c&&!c.dashstyle&&c.attr({"stroke-width":b},a?0:500))},setVisible:function(a,b){var c=this.chart,d=this.legendItem,e=this.group,f=this.tracker,g=this.dataLabelsGroup,h,i=this.points,j=c.options.chart.ignoreHiddenSeries;h=this.visible;h=(this.visible= a=a===A?!h:a)?"show":"hide";if(e)e[h]();if(f)f[h]();else if(i)for(e=i.length;e--;)if(f=i[e],f.tracker)f.tracker[h]();if(g)g[h]();d&&c.legend.colorizeItem(this,a);this.isDirty=!0;this.options.stacking&&n(c.series,function(a){if(a.options.stacking&&a.visible)a.isDirty=!0});if(j)c.isDirtyBox=!0;b!==!1&&c.redraw();E(this,h)},show:function(){this.setVisible(!0)},hide:function(){this.setVisible(!1)},select:function(a){this.selected=a=a===A?!this.selected:a;if(this.checkbox)this.checkbox.checked=a;E(this, a?"select":"unselect")},drawTrackerGroup:function(){var a=this.trackerGroup,b=this.chart;if(this.isCartesian){if(!a)this.trackerGroup=a=b.renderer.g().attr({zIndex:this.options.zIndex||1}).add(b.trackerGroup);a.translate(this.xAxis.left,this.yAxis.top)}return a},drawTracker:function(){var a=this,b=a.options,c=b.trackByArea,d=[].concat(c?a.areaPath:a.graphPath),e=d.length,f=a.chart,g=f.renderer,h=f.options.tooltip.snap,i=a.tracker,j=b.cursor,j=j&&{cursor:j},k=a.singlePoints,l=a.drawTrackerGroup(), m;if(e&&!c)for(m=e+1;m--;)d[m]==="M"&&d.splice(m+1,0,d[m+1]-h,d[m+2],"L"),(m&&d[m]==="M"||m===e)&&d.splice(m,0,"L",d[m-2]+h,d[m-1]);for(m=0;m=0;d--)da&&i>e?(i=x(a,e),k=2*e-i):ig&&k>e?(k=x(g,e),i=2*e-k):kv?g-v:z-(f<=z?v:0));u(c,{barX:h,barY:i,barW:y,barH:j,pointWidth:r});c.shapeType="rect";c.shapeArgs=f=b.renderer.Element.prototype.crisp.call(0,e,h,i,y,j);e%2&&(f.y-=1,f.height+=1);c.trackerArgs=M(j)<3&&C(c.shapeArgs,{height:6,y:i-3})})},getSymbol:function(){},drawLegendSymbol:G.prototype.drawLegendSymbol,drawGraph:function(){},drawPoints:function(){var a=this,b=a.options,c=a.chart.renderer,d,e;n(a.points,function(f){var g=f.plotY;if(g!==A&&!isNaN(g)&& f.y!==null)d=f.graphic,e=f.shapeArgs,d?(Fa(d),d.animate(C(e))):f.graphic=d=c[f.shapeType](e).attr(f.pointAttr[f.selected?"select":""]).add(a.group).shadow(b.shadow,null,b.stacking&&!b.borderRadius)})},drawTracker:function(){var a=this,b=a.chart,c=b.renderer,d,e,f=+new Date,g=a.options,h=g.cursor,i=h&&{cursor:h},j=a.drawTrackerGroup(),k,l,m;n(a.points,function(h){e=h.tracker;d=h.trackerArgs||h.shapeArgs;l=h.plotY;m=!a.isCartesian||l!==A&&!isNaN(l);delete d.strokeWidth;if(h.y!==null&&m)e?e.attr(d): h.tracker=c[h.shapeType](d).attr({isTracker:f,fill:tb,visibility:a.visible?"visible":"hidden"}).on(ea?"touchstart":"mouseover",function(c){k=c.relatedTarget||c.fromElement;if(b.hoverSeries!==a&&z(k,"isTracker")!==f)a.onMouseOver();h.onMouseOver()}).on("mouseout",function(b){if(!g.stickyTracking&&(k=b.relatedTarget||b.toElement,z(k,"isTracker")!==f))a.onMouseOut()}).css(i).add(h.group||j)})},animate:function(a){var b=this,c=b.points,d=b.options;if(!a)n(c,function(a){var c=a.graphic,a=a.shapeArgs,g= b.yAxis,h=d.threshold;c&&(c.attr({height:0,y:s(h)?g.getThreshold(h):g.translate(g.getExtremes().min,0,1,0,1)}),c.animate({height:a.height,y:a.y},d.animation))}),b.animate=null},remove:function(){var a=this,b=a.chart;b.hasRendered&&n(b.series,function(b){if(b.type===a.type)b.isDirty=!0});R.prototype.remove.apply(a,arguments)}});Y.column=ha;Z.bar=C(Z.column,{dataLabels:{align:"left",x:5,y:null,verticalAlign:"middle"}});Ia=ca(ha,{type:"bar",inverted:!0});Y.bar=Ia;Z.scatter=C(T,{lineWidth:0,states:{hover:{lineWidth:0}}, tooltip:{headerFormat:'{series.name}
',pointFormat:"x: {point.x}
y: {point.y}
"}});Ia=ca(R,{type:"scatter",sorted:!1,translate:function(){var a=this;R.prototype.translate.apply(a);n(a.points,function(b){b.shapeType="circle";b.shapeArgs={x:b.plotX,y:b.plotY,r:a.chart.options.tooltip.snap}})},drawTracker:function(){for(var a=this,b=a.options.cursor,b=b&&{cursor:b},c=a.points,d=c.length,e;d--;)if(e=c[d].graphic)e.element._i= d;a._hasTracking?a._hasTracking=!0:a.group.attr({isTracker:!0}).on(ea?"touchstart":"mouseover",function(b){a.onMouseOver();if(b.target._i!==A)c[b.target._i].onMouseOver()}).on("mouseout",function(){if(!a.options.stickyTracking)a.onMouseOut()}).css(b)}});Y.scatter=Ia;Z.pie=C(T,{borderColor:"#FFFFFF",borderWidth:1,center:["50%","50%"],colorByPoint:!0,dataLabels:{distance:30,enabled:!0,formatter:function(){return this.point.name},y:5},legendType:"point",marker:null,size:"75%",showInLegend:!1,slicedOffset:10, states:{hover:{brightness:0.1,shadow:!1}}});T={type:"pie",isCartesian:!1,pointClass:ca(Wa,{init:function(){Wa.prototype.init.apply(this,arguments);var a=this,b;u(a,{visible:a.visible!==!1,name:o(a.name,"Slice")});b=function(){a.slice()};I(a,"select",b);I(a,"unselect",b);return a},setVisible:function(a){var b=this.series.chart,c=this.tracker,d=this.dataLabel,e=this.connector,f=this.shadowGroup,g;g=(this.visible=a=a===A?!this.visible:a)?"show":"hide";this.group[g]();if(c)c[g]();if(d)d[g]();if(e)e[g](); if(f)f[g]();this.legendItem&&b.legend.colorizeItem(this,a)},slice:function(a,b,c){var d=this.series.chart,e=this.slicedTranslation;ua(c,d);o(b,!0);a=this.sliced=s(a)?a:!this.sliced;a={translateX:a?e[0]:d.plotLeft,translateY:a?e[1]:d.plotTop};this.group.animate(a);this.shadowGroup&&this.shadowGroup.animate(a)}}),pointAttrToOptions:{stroke:"borderColor","stroke-width":"borderWidth",fill:"color"},getColor:function(){this.initialColor=this.chart.counters.color},animate:function(){var a=this;n(a.points, function(b){var c=b.graphic,b=b.shapeArgs,d=-xa/2;c&&(c.attr({r:0,start:d,end:d}),c.animate({r:b.r,start:b.start,end:b.end},a.options.animation))});a.animate=null},setData:function(a,b){R.prototype.setData.call(this,a,!1);this.processData();this.generatePoints();o(b,!0)&&this.chart.redraw()},getCenter:function(){var a=this.options,b=this.chart,c=b.plotWidth,d=b.plotHeight,a=a.center.concat([a.size,a.innerSize||0]),e=O(c,d),f;return Ea(a,function(a,b){return(f=/%$/.test(a))?[c,d,e,e][b]*w(a)/100:a})}, translate:function(){this.generatePoints();var a=0,b=-0.25,c=this.options,d=c.slicedOffset,e=d+c.borderWidth,f,g=this.chart,h,i,j,k=this.points,l=2*xa,m,p,o,s=c.dataLabels.distance;this.center=f=this.getCenter();this.getX=function(a,b){j=L.asin((a-f[1])/(f[2]/2+s));return f[0]+(b?-1:1)*X(j)*(f[2]/2+s)};n(k,function(b){a+=b.y});n(k,function(c){m=a?c.y/a:0;h=t(b*l*1E3)/1E3;b+=m;i=t(b*l*1E3)/1E3;c.shapeType="arc";c.shapeArgs={x:f[0],y:f[1],r:f[2]/2,innerR:f[3]/2,start:h,end:i};j=(i+h)/2;c.slicedTranslation= Ea([X(j)*d+g.plotLeft,da(j)*d+g.plotTop],t);p=X(j)*f[2]/2;o=da(j)*f[2]/2;c.tooltipPos=[f[0]+p*0.7,f[1]+o*0.7];c.labelPos=[f[0]+p+X(j)*s,f[1]+o+da(j)*s,f[0]+p+X(j)*e,f[1]+o+da(j)*e,f[0]+p,f[1]+o,s<0?"center":j0,q=[[],[]],s,r,t,u,x=2,v;if(d.enabled){R.prototype.drawDataLabels.apply(this);n(a,function(a){a.dataLabel&&q[a.labelPos[7]0){for(v=m-l-j;v<=m+l+j;v+=a)w.push(v);t=w.length;if(A>t){h=[].concat(z);h.sort(u);for(v=A;v--;)h[v].rank=v;for(v=A;v--;)z[v].rank>=t&&z.splice(v,1);A=z.length}for(v=0;v 0){if(r=C.pop(),B=r.i,r=r.y,s>r&&w[B+1]!==null||s>> 0; if (len === 0) { return -1; } var n = 0; if (arguments.length > 0) { n = Number(arguments[1]); if (n !== n) { // shortcut for verifying if it's NaN n = 0; } else if (n !== 0 && n !== (Infinity) && n !== -(Infinity)) { n = (n > 0 || -1) * Math.floor(Math.abs(n)); } } if (n >= len) { return -1; } var k = n >= 0 ? n : Math.max(len - Math.abs(n), 0); for (; k < len; k++) { if (k in t && t[k] === searchElement) { return k; } } return -1; }; } // Instantiate the object window.I18n = {}; // Set default locale to english I18n.defaultLocale = "en"; // Set default handling of translation fallbacks to false I18n.fallbacks = false; // Set default separator I18n.defaultSeparator = "."; // Set current locale to null I18n.locale = null; // Set the placeholder format. Accepts `{{placeholder}}` and `%{placeholder}`. I18n.PLACEHOLDER = /(?:\{\{|%\{)(.*?)(?:\}\}?)/gm; I18n.fallbackRules = { }; I18n.pluralizationRules = { en: function (n) { return n == 0 ? ["zero", "none", "other"] : n == 1 ? "one" : "other"; } }; I18n.getFallbacks = function(locale) { if (locale === I18n.defaultLocale) { return []; } else if (!I18n.fallbackRules[locale]) { var rules = [] , components = locale.split("-"); for (var l = 1; l < components.length; l++) { rules.push(components.slice(0, l).join("-")); } rules.push(I18n.defaultLocale); I18n.fallbackRules[locale] = rules; } return I18n.fallbackRules[locale]; } I18n.isValidNode = function(obj, node, undefined) { return obj[node] !== null && obj[node] !== undefined; }; I18n.lookup = function(scope, options) { var options = options || {} , lookupInitialScope = scope , translations = this.prepareOptions(I18n.translations) , locale = options.locale || I18n.currentLocale() , messages = translations[locale] || {} , options = this.prepareOptions(options) , currentScope ; if (typeof(scope) == "object") { scope = scope.join(this.defaultSeparator); } if (options.scope) { scope = options.scope.toString() + this.defaultSeparator + scope; } scope = scope.split(this.defaultSeparator); while (messages && scope.length > 0) { currentScope = scope.shift(); messages = messages[currentScope]; } if (!messages) { if (I18n.fallbacks) { var fallbacks = this.getFallbacks(locale); for (var fallback = 0; fallback < fallbacks.length; fallbacks++) { messages = I18n.lookup(lookupInitialScope, this.prepareOptions({locale: fallbacks[fallback]}, options)); if (messages) { break; } } } if (!messages && this.isValidNode(options, "defaultValue")) { messages = options.defaultValue; } } return messages; }; // Merge serveral hash options, checking if value is set before // overwriting any value. The precedence is from left to right. // // I18n.prepareOptions({name: "John Doe"}, {name: "Mary Doe", role: "user"}); // #=> {name: "John Doe", role: "user"} // I18n.prepareOptions = function() { var options = {} , opts , count = arguments.length ; for (var i = 0; i < count; i++) { opts = arguments[i]; if (!opts) { continue; } for (var key in opts) { if (!this.isValidNode(options, key)) { options[key] = opts[key]; } } } return options; }; I18n.interpolate = function(message, options) { options = this.prepareOptions(options); var matches = message.match(this.PLACEHOLDER) , placeholder , value , name ; if (!matches) { return message; } for (var i = 0; placeholder = matches[i]; i++) { name = placeholder.replace(this.PLACEHOLDER, "$1"); value = options[name]; if (!this.isValidNode(options, name)) { value = "[missing " + placeholder + " value]"; } regex = new RegExp(placeholder.replace(/\{/gm, "\\{").replace(/\}/gm, "\\}")); message = message.replace(regex, value); } return message; }; I18n.translate = function(scope, options) { options = this.prepareOptions(options); var translation = this.lookup(scope, options); try { if (typeof(translation) == "object") { if (typeof(options.count) == "number") { return this.pluralize(options.count, scope, options); } else { return translation; } } else { return this.interpolate(translation, options); } } catch(err) { return this.missingTranslation(scope); } }; I18n.localize = function(scope, value) { switch (scope) { case "currency": return this.toCurrency(value); case "number": scope = this.lookup("number.format"); return this.toNumber(value, scope); case "percentage": return this.toPercentage(value); default: if (scope.match(/^(date|time)/)) { return this.toTime(scope, value); } else { return value.toString(); } } }; I18n.parseDate = function(date) { var matches, convertedDate; // we have a date, so just return it. if (typeof(date) == "object") { return date; }; // it matches the following formats: // yyyy-mm-dd // yyyy-mm-dd[ T]hh:mm::ss // yyyy-mm-dd[ T]hh:mm::ss // yyyy-mm-dd[ T]hh:mm::ssZ // yyyy-mm-dd[ T]hh:mm::ss+0000 // matches = date.toString().match(/(\d{4})-(\d{2})-(\d{2})(?:[ T](\d{2}):(\d{2}):(\d{2}))?(Z|\+0000)?/); if (matches) { for (var i = 1; i <= 6; i++) { matches[i] = parseInt(matches[i], 10) || 0; } // month starts on 0 matches[2] -= 1; if (matches[7]) { convertedDate = new Date(Date.UTC(matches[1], matches[2], matches[3], matches[4], matches[5], matches[6])); } else { convertedDate = new Date(matches[1], matches[2], matches[3], matches[4], matches[5], matches[6]); } } else if (typeof(date) == "number") { // UNIX timestamp convertedDate = new Date(); convertedDate.setTime(date); } else if (date.match(/\d+ \d+:\d+:\d+ [+-]\d+ \d+/)) { // a valid javascript format with timezone info convertedDate = new Date(); convertedDate.setTime(Date.parse(date)) } else { // an arbitrary javascript string convertedDate = new Date(); convertedDate.setTime(Date.parse(date)); } return convertedDate; }; I18n.toTime = function(scope, d) { var date = this.parseDate(d) , format = this.lookup(scope) ; if (date.toString().match(/invalid/i)) { return date.toString(); } if (!format) { return date.toString(); } return this.strftime(date, format); }; I18n.strftime = function(date, format) { var options = this.lookup("date"); if (!options) { return date.toString(); } options.meridian = options.meridian || ["AM", "PM"]; var weekDay = date.getDay() , day = date.getDate() , year = date.getFullYear() , month = date.getMonth() + 1 , hour = date.getHours() , hour12 = hour , meridian = hour > 11 ? 1 : 0 , secs = date.getSeconds() , mins = date.getMinutes() , offset = date.getTimezoneOffset() , absOffsetHours = Math.floor(Math.abs(offset / 60)) , absOffsetMinutes = Math.abs(offset) - (absOffsetHours * 60) , timezoneoffset = (offset > 0 ? "-" : "+") + (absOffsetHours.toString().length < 2 ? "0" + absOffsetHours : absOffsetHours) + (absOffsetMinutes.toString().length < 2 ? "0" + absOffsetMinutes : absOffsetMinutes) ; if (hour12 > 12) { hour12 = hour12 - 12; } else if (hour12 === 0) { hour12 = 12; } var padding = function(n) { var s = "0" + n.toString(); return s.substr(s.length - 2); }; var f = format; f = f.replace("%a", options.abbr_day_names[weekDay]); f = f.replace("%A", options.day_names[weekDay]); f = f.replace("%b", options.abbr_month_names[month]); f = f.replace("%B", options.month_names[month]); f = f.replace("%d", padding(day)); f = f.replace("%e", day); f = f.replace("%-d", day); f = f.replace("%H", padding(hour)); f = f.replace("%-H", hour); f = f.replace("%I", padding(hour12)); f = f.replace("%-I", hour12); f = f.replace("%m", padding(month)); f = f.replace("%-m", month); f = f.replace("%M", padding(mins)); f = f.replace("%-M", mins); f = f.replace("%p", options.meridian[meridian]); f = f.replace("%S", padding(secs)); f = f.replace("%-S", secs); f = f.replace("%w", weekDay); f = f.replace("%y", padding(year)); f = f.replace("%-y", padding(year).replace(/^0+/, "")); f = f.replace("%Y", year); f = f.replace("%z", timezoneoffset); return f; }; I18n.toNumber = function(number, options) { options = this.prepareOptions( options, this.lookup("number.format"), {precision: 3, separator: ".", delimiter: ",", strip_insignificant_zeros: false} ); var negative = number < 0 , string = Math.abs(number).toFixed(options.precision).toString() , parts = string.split(".") , precision , buffer = [] , formattedNumber ; number = parts[0]; precision = parts[1]; while (number.length > 0) { buffer.unshift(number.substr(Math.max(0, number.length - 3), 3)); number = number.substr(0, number.length -3); } formattedNumber = buffer.join(options.delimiter); if (options.precision > 0) { formattedNumber += options.separator + parts[1]; } if (negative) { formattedNumber = "-" + formattedNumber; } if (options.strip_insignificant_zeros) { var regex = { separator: new RegExp(options.separator.replace(/\./, "\\.") + "$") , zeros: /0+$/ }; formattedNumber = formattedNumber .replace(regex.zeros, "") .replace(regex.separator, "") ; } return formattedNumber; }; I18n.toCurrency = function(number, options) { options = this.prepareOptions( options, this.lookup("number.currency.format"), this.lookup("number.format"), {unit: "$", precision: 2, format: "%u%n", delimiter: ",", separator: "."} ); number = this.toNumber(number, options); number = options.format .replace("%u", options.unit) .replace("%n", number) ; return number; }; I18n.toHumanSize = function(number, options) { var kb = 1024 , size = number , iterations = 0 , unit , precision ; while (size >= kb && iterations < 4) { size = size / kb; iterations += 1; } if (iterations === 0) { unit = this.t("number.human.storage_units.units.byte", {count: size}); precision = 0; } else { unit = this.t("number.human.storage_units.units." + [null, "kb", "mb", "gb", "tb"][iterations]); precision = (size - Math.floor(size) === 0) ? 0 : 1; } options = this.prepareOptions( options, {precision: precision, format: "%n%u", delimiter: ""} ); number = this.toNumber(size, options); number = options.format .replace("%u", unit) .replace("%n", number) ; return number; }; I18n.toPercentage = function(number, options) { options = this.prepareOptions( options, this.lookup("number.percentage.format"), this.lookup("number.format"), {precision: 3, separator: ".", delimiter: ""} ); number = this.toNumber(number, options); return number + "%"; }; I18n.pluralizer = function(locale) { pluralizer = this.pluralizationRules[locale]; if (pluralizer !== undefined) return pluralizer; return this.pluralizationRules["en"]; }; I18n.findAndTranslateValidNode = function(keys, translation) { for (i = 0; i < keys.length; i++) { key = keys[i]; if (this.isValidNode(translation, key)) return translation[key]; } return null; }; I18n.pluralize = function(count, scope, options) { var translation; try { translation = this.lookup(scope, options); } catch (error) {} if (!translation) { return this.missingTranslation(scope); } var message; options = this.prepareOptions(options); options.count = count.toString(); pluralizer = this.pluralizer(this.currentLocale()); key = pluralizer(Math.abs(count)); keys = ((typeof key == "object") && (key instanceof Array)) ? key : [key]; message = this.findAndTranslateValidNode(keys, translation); if (message == null) message = this.missingTranslation(scope, keys[0]); return this.interpolate(message, options); }; I18n.missingTranslation = function() { var message = '[missing "' + this.currentLocale() , count = arguments.length ; for (var i = 0; i < count; i++) { message += "." + arguments[i]; } message += '" translation]'; return message; }; I18n.currentLocale = function() { return (I18n.locale || I18n.defaultLocale); }; // shortcuts I18n.t = I18n.translate; I18n.l = I18n.localize; I18n.p = I18n.pluralize; ;/*! * jQuery throttle / debounce - v1.1 - 3/7/2010 * http://benalman.com/projects/jquery-throttle-debounce-plugin/ * * Copyright (c) 2010 "Cowboy" Ben Alman * Dual licensed under the MIT and GPL licenses. * http://benalman.com/about/license/ */ // Script: jQuery throttle / debounce: Sometimes, less is more! // // *Version: 1.1, Last updated: 3/7/2010* // // Project Home - http://benalman.com/projects/jquery-throttle-debounce-plugin/ // GitHub - http://github.com/cowboy/jquery-throttle-debounce/ // Source - http://github.com/cowboy/jquery-throttle-debounce/raw/master/jquery.ba-throttle-debounce.js // (Minified) - http://github.com/cowboy/jquery-throttle-debounce/raw/master/jquery.ba-throttle-debounce.min.js (0.7kb) // // About: License // // Copyright (c) 2010 "Cowboy" Ben Alman, // Dual licensed under the MIT and GPL licenses. // http://benalman.com/about/license/ // // About: Examples // // These working examples, complete with fully commented code, illustrate a few // ways in which this plugin can be used. // // Throttle - http://benalman.com/code/projects/jquery-throttle-debounce/examples/throttle/ // Debounce - http://benalman.com/code/projects/jquery-throttle-debounce/examples/debounce/ // // About: Support and Testing // // Information about what version or versions of jQuery this plugin has been // tested with, what browsers it has been tested in, and where the unit tests // reside (so you can test it yourself). // // jQuery Versions - none, 1.3.2, 1.4.2 // Browsers Tested - Internet Explorer 6-8, Firefox 2-3.6, Safari 3-4, Chrome 4-5, Opera 9.6-10.1. // Unit Tests - http://benalman.com/code/projects/jquery-throttle-debounce/unit/ // // About: Release History // // 1.1 - (3/7/2010) Fixed a bug in where trailing callbacks // executed later than they should. Reworked a fair amount of internal // logic as well. // 1.0 - (3/6/2010) Initial release as a stand-alone project. Migrated over // from jquery-misc repo v0.4 to jquery-throttle repo v1.0, added the // no_trailing throttle parameter and debounce functionality. // // Topic: Note for non-jQuery users // // jQuery isn't actually required for this plugin, because nothing internal // uses any jQuery methods or properties. jQuery is just used as a namespace // under which these methods can exist. // // Since jQuery isn't actually required for this plugin, if jQuery doesn't exist // when this plugin is loaded, the method described below will be created in // the `Cowboy` namespace. Usage will be exactly the same, but instead of // $.method() or jQuery.method(), you'll need to use Cowboy.method(). (function(window,undefined){ '$:nomunge'; // Used by YUI compressor. // Since jQuery really isn't required for this plugin, use `jQuery` as the // namespace only if it already exists, otherwise use the `Cowboy` namespace, // creating it if necessary. var $ = window.jQuery || window.Cowboy || ( window.Cowboy = {} ), // Internal method reference. jq_throttle; // Method: jQuery.throttle // // Throttle execution of a function. Especially useful for rate limiting // execution of handlers on events like resize and scroll. If you want to // rate-limit execution of a function to a single time, see the // method. // // In this visualization, | is a throttled-function call and X is the actual // callback execution: // // > Throttled with `no_trailing` specified as false or unspecified: // > ||||||||||||||||||||||||| (pause) ||||||||||||||||||||||||| // > X X X X X X X X X X X X // > // > Throttled with `no_trailing` specified as true: // > ||||||||||||||||||||||||| (pause) ||||||||||||||||||||||||| // > X X X X X X X X X X // // Usage: // // > var throttled = jQuery.throttle( delay, [ no_trailing, ] callback ); // > // > jQuery('selector').bind( 'someevent', throttled ); // > jQuery('selector').unbind( 'someevent', throttled ); // // This also works in jQuery 1.4+: // // > jQuery('selector').bind( 'someevent', jQuery.throttle( delay, [ no_trailing, ] callback ) ); // > jQuery('selector').unbind( 'someevent', callback ); // // Arguments: // // delay - (Number) A zero-or-greater delay in milliseconds. For event // callbacks, values around 100 or 250 (or even higher) are most useful. // no_trailing - (Boolean) Optional, defaults to false. If no_trailing is // true, callback will only execute every `delay` milliseconds while the // throttled-function is being called. If no_trailing is false or // unspecified, callback will be executed one final time after the last // throttled-function call. (After the throttled-function has not been // called for `delay` milliseconds, the internal counter is reset) // callback - (Function) A function to be executed after delay milliseconds. // The `this` context and all arguments are passed through, as-is, to // `callback` when the throttled-function is executed. // // Returns: // // (Function) A new, throttled, function. $.throttle = jq_throttle = function( delay, no_trailing, callback, debounce_mode ) { // After wrapper has stopped being called, this timeout ensures that // `callback` is executed at the proper times in `throttle` and `end` // debounce modes. var timeout_id, // Keep track of the last time `callback` was executed. last_exec = 0; // `no_trailing` defaults to falsy. if ( typeof no_trailing !== 'boolean' ) { debounce_mode = callback; callback = no_trailing; no_trailing = undefined; } // The `wrapper` function encapsulates all of the throttling / debouncing // functionality and when executed will limit the rate at which `callback` // is executed. function wrapper() { var that = this, elapsed = +new Date() - last_exec, args = arguments; // Execute `callback` and update the `last_exec` timestamp. function exec() { last_exec = +new Date(); callback.apply( that, args ); }; // If `debounce_mode` is true (at_begin) this is used to clear the flag // to allow future `callback` executions. function clear() { timeout_id = undefined; }; if ( debounce_mode && !timeout_id ) { // Since `wrapper` is being called for the first time and // `debounce_mode` is true (at_begin), execute `callback`. exec(); } // Clear any existing timeout. timeout_id && clearTimeout( timeout_id ); if ( debounce_mode === undefined && elapsed > delay ) { // In throttle mode, if `delay` time has been exceeded, execute // `callback`. exec(); } else if ( no_trailing !== true ) { // In trailing throttle mode, since `delay` time has not been // exceeded, schedule `callback` to execute `delay` ms after most // recent execution. // // If `debounce_mode` is true (at_begin), schedule `clear` to execute // after `delay` ms. // // If `debounce_mode` is false (at end), schedule `callback` to // execute after `delay` ms. timeout_id = setTimeout( debounce_mode ? clear : exec, debounce_mode === undefined ? delay - elapsed : delay ); } }; // Set the guid of `wrapper` function to the same of original callback, so // it can be removed in jQuery 1.4+ .unbind or .die by using the original // callback as a reference. if ( $.guid ) { wrapper.guid = callback.guid = callback.guid || $.guid++; } // Return the wrapper function. return wrapper; }; // Method: jQuery.debounce // // Debounce execution of a function. Debouncing, unlike throttling, // guarantees that a function is only executed a single time, either at the // very beginning of a series of calls, or at the very end. If you want to // simply rate-limit execution of a function, see the // method. // // In this visualization, | is a debounced-function call and X is the actual // callback execution: // // > Debounced with `at_begin` specified as false or unspecified: // > ||||||||||||||||||||||||| (pause) ||||||||||||||||||||||||| // > X X // > // > Debounced with `at_begin` specified as true: // > ||||||||||||||||||||||||| (pause) ||||||||||||||||||||||||| // > X X // // Usage: // // > var debounced = jQuery.debounce( delay, [ at_begin, ] callback ); // > // > jQuery('selector').bind( 'someevent', debounced ); // > jQuery('selector').unbind( 'someevent', debounced ); // // This also works in jQuery 1.4+: // // > jQuery('selector').bind( 'someevent', jQuery.debounce( delay, [ at_begin, ] callback ) ); // > jQuery('selector').unbind( 'someevent', callback ); // // Arguments: // // delay - (Number) A zero-or-greater delay in milliseconds. For event // callbacks, values around 100 or 250 (or even higher) are most useful. // at_begin - (Boolean) Optional, defaults to false. If at_begin is false or // unspecified, callback will only be executed `delay` milliseconds after // the last debounced-function call. If at_begin is true, callback will be // executed only at the first debounced-function call. (After the // throttled-function has not been called for `delay` milliseconds, the // internal counter is reset) // callback - (Function) A function to be executed after delay milliseconds. // The `this` context and all arguments are passed through, as-is, to // `callback` when the debounced-function is executed. // // Returns: // // (Function) A new, debounced, function. $.debounce = function( delay, at_begin, callback ) { return callback === undefined ? jq_throttle( delay, at_begin, false ) : jq_throttle( delay, callback, at_begin !== false ); }; })(this); ;/* * timeago: a jQuery plugin, version: 0.9.2 (2010-09-14) * @requires jQuery v1.2.3 or later * * Timeago is a jQuery plugin that makes it easy to support automatically * updating fuzzy timestamps (e.g. '4 minutes ago' or 'about 1 day ago'). * * For usage and examples, visit: * http://timeago.yarp.com/ * * Licensed under the MIT: * http://www.opensource.org/licenses/mit-license.php * * Copyright (c) 2008-2010, Ryan McGeary (ryanonjavascript -[at]- mcgeary [*dot*] org) */ (function($) { $.timeago = function(timestamp) { if (timestamp instanceof Date) return inWords(timestamp); else if (typeof timestamp == 'string') return inWords($.timeago.parse(timestamp)); else return inWords($.timeago.datetime(timestamp)); }; var $t = $.timeago; $.extend($.timeago, { settings: { refreshMillis: 3000, allowFuture: true, strings: { prefixAgo: null, prefixFromNow: null, suffixAgo: 'ago', suffixFromNow: 'from now', seconds: 'less than a minute', minute: 'about a minute', minutes: '%d minutes', hour: 'about an hour', hours: 'about %d hours', day: 'a day', days: '%d days', month: 'about a month', months: '%d months', year: 'about a year', years: '%d years', numbers: [] } }, distanceInWords: function(date) { if(!date) { return; } if(typeof date == 'string') { date = $.timeago.parse(date); } return $.timeago.inWords($.timeago.distance(date)); }, inWords: function(distanceMillis) { var $l = this.settings.strings; var prefix = $l.prefixAgo; var suffix = $l.suffixAgo; if (this.settings.allowFuture) { if (distanceMillis < 0) { prefix = $l.prefixFromNow; suffix = $l.suffixFromNow; } distanceMillis = Math.abs(distanceMillis); } var seconds = distanceMillis / 1000; var minutes = seconds / 60; var hours = minutes / 60; var days = hours / 24; var years = days / 365; function substitute(stringOrFunction, number) { var string = $.isFunction(stringOrFunction) ? stringOrFunction(number, distanceMillis) : stringOrFunction; var value = ($l.numbers && $l.numbers[number]) || number; return string.replace(/%d/i, value); } var words = seconds < 45 && substitute($l.seconds, Math.round(seconds)) || seconds < 90 && substitute($l.minute, 1) || minutes < 45 && substitute($l.minutes, Math.round(minutes)) || minutes < 90 && substitute($l.hour, 1) || hours < 24 && substitute($l.hours, Math.round(hours)) || hours < 48 && substitute($l.day, 1) || days < 30 && substitute($l.days, Math.floor(days)) || days < 60 && substitute($l.month, 1) || days < 365 && substitute($l.months, Math.floor(days / 30)) || years < 2 && substitute($l.year, 1) || substitute($l.years, Math.floor(years)); return $.trim([prefix, words, suffix].join(' ')); }, distance: function(date) { return (this.now() - date.getTime()); }, now: function() { return new Date().getTime(); }, parse: function(iso8601) { var s = $.trim(iso8601); s = s.replace(/\.\d\d\d+/,''); // remove milliseconds s = s.replace(/-/,'/').replace(/-/,'/'); s = s.replace(/T/,' ').replace(/Z/,' UTC'); s = s.replace(/([\+-]\d\d)\:?(\d\d)/,' $1$2'); // -04:00 -> -0400 return new Date(s); } }); $.fn.timeago = function() { this.each(function() { var data = prepareData(this); if (!isNaN(data.datetime)) { $(this).text(inWords(data.datetime)); } }); return this; }; function prepareData(element) { element = $(element); if (!element.data('timeago') || (element.data('timeago').title != element.attr('title'))) { element.data('timeago', { datetime: $t.parse(element.attr('title')), title: element.attr('title') }); } return element.data('timeago'); } function inWords(date) { return $t.inWords(distance(date)); } function distance(date) { return $t.distance(date); } // fix for IE6 suckage document.createElement('abbr'); document.createElement('time'); })(jQuery); ;/*! * Pusher JavaScript Library v1.12.2 * http://pusherapp.com/ * * Copyright 2011, Pusher * Released under the MIT licence. */ (function(){if(Function.prototype.scopedTo===void 0)Function.prototype.scopedTo=function(a,b){var e=this;return function(){return e.apply(a,Array.prototype.slice.call(b||[]).concat(Array.prototype.slice.call(arguments)))}};var c=function(a,b){this.options=b||{};this.key=a;this.channels=new c.Channels;this.global_emitter=new c.EventsDispatcher;var e=this;this.checkAppKey();this.connection=new c.Connection(this.key,this.options);this.connection.bind("connected",function(){e.subscribeAll()}).bind("message", function(b){var a=b.event.indexOf("pusher_internal:")===0;if(b.channel){var c;(c=e.channel(b.channel))&&c.emit(b.event,b.data)}a||e.global_emitter.emit(b.event,b.data)}).bind("disconnected",function(){e.channels.disconnect()}).bind("error",function(b){c.warn("Error",b)});c.instances.push(this);c.isReady&&e.connect()};c.instances=[];c.prototype={channel:function(a){return this.channels.find(a)},connect:function(){this.connection.connect()},disconnect:function(){this.connection.disconnect()},bind:function(a, b){this.global_emitter.bind(a,b);return this},bind_all:function(a){this.global_emitter.bind_all(a);return this},subscribeAll:function(){for(channelName in this.channels.channels)this.channels.channels.hasOwnProperty(channelName)&&this.subscribe(channelName)},subscribe:function(a){var b=this,e=this.channels.add(a,this);this.connection.state==="connected"&&e.authorize(this.connection.socket_id,this.options,function(c,f){c?e.emit("pusher:subscription_error",f):b.send_event("pusher:subscribe",{channel:a, auth:f.auth,channel_data:f.channel_data})});return e},unsubscribe:function(a){this.channels.remove(a);this.connection.state==="connected"&&this.send_event("pusher:unsubscribe",{channel:a})},send_event:function(a,b,e){return this.connection.send_event(a,b,e)},checkAppKey:function(){(this.key===null||this.key===void 0)&&c.warn("Warning","You must pass your app key when you instantiate Pusher.")}};c.Util={extend:function b(e,c){for(var f in c)e[f]=c[f]&&c[f].constructor&&c[f].constructor===Object?b(e[f]|| {},c[f]):c[f];return e},stringify:function(){for(var b=["Pusher"],e=0;e "+a),d.emit("state_change",{previous:e,current:a}),d.emit(a,c))}var d=this;b.EventsDispatcher.call(this);this.options=b.Util.extend({encrypted:!1},r);this.netInfo=new b.NetInfo;this.netInfo.bind("online",function(){d._machine.is("waiting")&&(d._machine.transition("connecting"),j("connecting"))});this.netInfo.bind("offline",function(){if(d._machine.is("connected"))d.socket.onclose=void 0,d.socket.onmessage=void 0,d.socket.onerror=void 0,d.socket.onopen=void 0,d.socket.close(),d.socket=void 0, d._machine.transition("waiting")});this._machine=new b.Machine("initialized",e,{initializedPre:function(){d.compulsorySecure=d.options.encrypted;d.key=a;d.socket=null;d.socket_id=null;d.state="initialized"},waitingPre:function(){d.connectionWait>0&&d.emit("connecting_in",d.connectionWait);d.netInfo.isOnLine()&&d.connectionAttempts<=4?j("connecting"):j("unavailable");if(d.netInfo.isOnLine())d._waitingTimer=setTimeout(function(){d._machine.transition("connecting")},v())},waitingExit:function(){clearTimeout(d._waitingTimer)}, connectingPre:function(){if(d.netInfo.isOnLine()===!1)d._machine.transition("waiting"),j("unavailable");else{var a;a=b.ws_port;var c="ws://";if(d.connectionSecure||document.location.protocol==="https:")a=b.wss_port,c="wss://";a=c+b.host+":"+a+"/app/"+d.key+"?protocol=5&client=js&version="+b.VERSION+"&flash="+(b.TransportType==="flash"?"true":"false");b.debug("Connecting",a);d.socket=new b.Transport(a);d.socket.onopen=w;d.socket.onclose=n;d.socket.onerror=o;d._connectingTimer=setTimeout(m,d.openTimeout)}}, connectingExit:function(){clearTimeout(d._connectingTimer);d.socket.onopen=void 0},connectingToWaiting:function(){k()},connectingToImpermanentlyClosing:function(){k()},openPre:function(){d.socket.onmessage=x;d.socket.onerror=o;d.socket.onclose=n;d._openTimer=setTimeout(m,d.connectedTimeout)},openExit:function(){clearTimeout(d._openTimer);d.socket.onmessage=void 0},openToWaiting:function(){k()},openToImpermanentlyClosing:function(){k()},connectedPre:function(a){d.socket_id=a;d.socket.onmessage=y;d.socket.onerror= o;d.socket.onclose=n;c(d);d.connectedAt=(new Date).getTime();p()},connectedPost:function(){j("connected")},connectedExit:function(){d._activityTimer&&clearTimeout(d._activityTimer);j("disconnected")},impermanentlyClosingPost:function(){if(d.socket)d.socket.onclose=n,d.socket.close()},permanentlyClosingPost:function(){d.socket?(d.socket.onclose=function(){c(d);d._machine.transition("permanentlyClosed")},d.socket.close()):(c(d),d._machine.transition("permanentlyClosed"))},failedPre:function(){j("failed"); b.debug("WebSockets are not available in this browser.")},permanentlyClosedPost:function(){j("disconnected")}})}var b=this.Pusher,e={initialized:["waiting","failed"],waiting:["connecting","permanentlyClosed"],connecting:["open","permanentlyClosing","impermanentlyClosing","waiting"],open:["connected","permanentlyClosing","impermanentlyClosing","waiting"],connected:["permanentlyClosing","waiting"],impermanentlyClosing:["waiting","permanentlyClosing"],permanentlyClosing:["permanentlyClosed"],permanentlyClosed:["waiting", "failed"],failed:["permanentlyClosed"]},g=2E3,f=2E3,h=2E3,s=5*g,t=5*f,u=5*h;a.prototype.connect=function(){!this._machine.is("failed")&&!b.Transport?this._machine.transition("failed"):this._machine.is("initialized")?(c(this),this._machine.transition("waiting")):this._machine.is("waiting")&&this.netInfo.isOnLine()===!0?this._machine.transition("connecting"):this._machine.is("permanentlyClosed")&&(c(this),this._machine.transition("waiting"))};a.prototype.send=function(a){if(this._machine.is("connected")){var b= this;setTimeout(function(){b.socket.send(a)},0);return!0}else return!1};a.prototype.send_event=function(a,c,e){a={event:a,data:c};e&&(a.channel=e);b.debug("Event sent",a);return this.send(JSON.stringify(a))};a.prototype.disconnect=function(){this._machine.is("permanentlyClosed")||(this._machine.is("waiting")||this._machine.is("failed")?this._machine.transition("permanentlyClosed"):this._machine.transition("permanentlyClosing"))};b.Util.extend(a.prototype,b.EventsDispatcher.prototype);this.Pusher.Connection= a}).call(this); (function(){Pusher.Channels=function(){this.channels={}};Pusher.Channels.prototype={add:function(a,b){var c=this.find(a);c||(c=Pusher.Channel.factory(a,b),this.channels[a]=c);return c},find:function(a){return this.channels[a]},remove:function(a){delete this.channels[a]},disconnect:function(){for(var a in this.channels)this.channels[a].disconnect()}};Pusher.Channel=function(a,b){var c=this;Pusher.EventsDispatcher.call(this,function(b){Pusher.debug("No callbacks on "+a+" for "+b)});this.pusher=b;this.name= a;this.subscribed=!1;this.bind("pusher_internal:subscription_succeeded",function(a){c.onSubscriptionSucceeded(a)})};Pusher.Channel.prototype={init:function(){},disconnect:function(){this.subscribed=!1;this.emit("pusher_internal:disconnected")},onSubscriptionSucceeded:function(){this.subscribed=!0;this.emit("pusher:subscription_succeeded")},authorize:function(a,b,c){return c(!1,{})},trigger:function(a,b){return this.pusher.send_event(a,b,this.name)}};Pusher.Util.extend(Pusher.Channel.prototype,Pusher.EventsDispatcher.prototype); Pusher.Channel.PrivateChannel={authorize:function(a,b,c){var g=this;return(new Pusher.Channel.Authorizer(this,Pusher.channel_auth_transport,b)).authorize(a,function(a,b){a||g.emit("pusher_internal:authorized",b);c(a,b)})}};Pusher.Channel.PresenceChannel={init:function(){this.members=new c(this)},onSubscriptionSucceeded:function(){this.subscribed=!0}};var c=function(a){var b=this,c=function(){this._members_map={};this.count=0;this.me=null};c.call(this);a.bind("pusher_internal:authorized",function(c){var e= JSON.parse(c.channel_data);a.bind("pusher_internal:subscription_succeeded",function(c){b._members_map=c.presence.hash;b.count=c.presence.count;b.me=b.get(e.user_id);a.emit("pusher:subscription_succeeded",b)})});a.bind("pusher_internal:member_added",function(c){b.get(c.user_id)===null&&b.count++;b._members_map[c.user_id]=c.user_info;a.emit("pusher:member_added",b.get(c.user_id))});a.bind("pusher_internal:member_removed",function(c){var e=b.get(c.user_id);e&&(delete b._members_map[c.user_id],b.count--, a.emit("pusher:member_removed",e))});a.bind("pusher_internal:disconnected",function(){c.call(b)})};c.prototype={each:function(a){for(var b in this._members_map)a(this.get(b))},get:function(a){return this._members_map.hasOwnProperty(a)?{id:a,info:this._members_map[a]}:null}};Pusher.Channel.factory=function(a,b){var c=new Pusher.Channel(a,b);a.indexOf("private-")===0?Pusher.Util.extend(c,Pusher.Channel.PrivateChannel):a.indexOf("presence-")===0&&(Pusher.Util.extend(c,Pusher.Channel.PrivateChannel), Pusher.Util.extend(c,Pusher.Channel.PresenceChannel));c.init();return c}}).call(this); (function(){Pusher.Channel.Authorizer=function(c,a,b){this.channel=c;this.type=a;this.authOptions=(b||{}).auth||{}};Pusher.Channel.Authorizer.prototype={composeQuery:function(c){var c="&socket_id="+encodeURIComponent(c)+"&channel_name="+encodeURIComponent(this.channel.name),a;for(a in this.authOptions.params)c+="&"+encodeURIComponent(a)+"="+encodeURIComponent(this.authOptions.params[a]);return c},authorize:function(c,a){return Pusher.authorizers[this.type].call(this,c,a)}};Pusher.auth_callbacks={}; Pusher.authorizers={ajax:function(c,a){var b;b=Pusher.XHR?new Pusher.XHR:window.XMLHttpRequest?new window.XMLHttpRequest:new ActiveXObject("Microsoft.XMLHTTP");b.open("POST",Pusher.channel_auth_endpoint,!0);b.setRequestHeader("Content-Type","application/x-www-form-urlencoded");for(var e in this.authOptions.headers)b.setRequestHeader(e,this.authOptions.headers[e]);b.onreadystatechange=function(){if(b.readyState==4)if(b.status==200){var c,e=!1;try{c=JSON.parse(b.responseText),e=!0}catch(h){a(!0,"JSON returned from webapp was invalid, yet status code was 200. Data was: "+ b.responseText)}e&&a(!1,c)}else Pusher.warn("Couldn't get auth info from your webapp",b.status),a(!0,b.status)};b.send(this.composeQuery(c));return b},jsonp:function(c,a){this.authOptions.headers!==void 0&&Pusher.warn("Warn","To send headers with the auth request, you must use AJAX, rather than JSONP.");var b=document.createElement("script");Pusher.auth_callbacks[this.channel.name]=function(b){a(!1,b)};b.src=Pusher.channel_auth_endpoint+"?callback="+encodeURIComponent("Pusher.auth_callbacks['"+this.channel.name+ "']")+this.composeQuery(c);var e=document.getElementsByTagName("head")[0]||document.documentElement;e.insertBefore(b,e.firstChild)}}}).call(this); var _require=function(){function c(a,c){document.addEventListener?a.addEventListener("load",c,!1):a.attachEvent("onreadystatechange",function(){(a.readyState=="loaded"||a.readyState=="complete")&&c()})}function a(a,e){var g=document.getElementsByTagName("head")[0],f=document.createElement("script");f.setAttribute("src",a);f.setAttribute("type","text/javascript");f.setAttribute("async",!0);c(f,function(){e()});g.appendChild(f)}return function(b,c){for(var g=0,f=0;f0?_require(a,g):g()})(); ;minispade.register('app', "(function() {(function() {\nminispade.require('auth');\nminispade.require('controllers');\nminispade.require('helpers');\nminispade.require('models');\nminispade.require('pusher');\nminispade.require('routes');\nminispade.require('slider');\nminispade.require('store');\nminispade.require('tailing');\nminispade.require('templates');\nminispade.require('views');\nminispade.require('config/locales');\nminispade.require('data/sponsors');\n\n Travis.reopen({\n App: Em.Application.extend({\n autoinit: false,\n currentUserBinding: 'auth.user',\n authStateBinding: 'auth.state',\n init: function() {\n this._super.apply(this, arguments);\n this.store = Travis.Store.create();\n this.store.loadMany(Travis.Sponsor, Travis.SPONSORS);\n this.slider = new Travis.Slider();\n this.pusher = new Travis.Pusher(Travis.config.pusher_key);\n this.tailing = new Travis.Tailing();\n return this.set('auth', Travis.Auth.create({\n app: this,\n endpoint: Travis.config.api_endpoint\n }));\n },\n storeAfterSignInPath: function(path) {\n return this.get('auth').storeAfterSignInPath(path);\n },\n autoSignIn: function(path) {\n return this.get('auth').autoSignIn(path);\n },\n signIn: function() {\n return this.get('auth').signIn();\n },\n signOut: function() {\n this.get('auth').signOut();\n return this.get('router').send('afterSignOut');\n },\n receive: function() {\n return this.store.receive.apply(this.store, arguments);\n },\n toggleSidebar: function() {\n var element;\n $('body').toggleClass('maximized');\n element = $('');\n $('#top .profile').append(element);\n Em.run.later((function() {\n return element.remove();\n }), 10);\n element = $('');\n $('#repo').append(element);\n return Em.run.later((function() {\n return element.remove();\n }), 10);\n }\n })\n });\n\n}).call(this);\n\n})();\n//@ sourceURL=app");minispade.register('auth', "(function() {(function() {\n\n this.Travis.Auth = Ember.Object.extend({\n iframe: $('