4 * Copyright(c) 2006-2007, Ext JS, LLC.
6 * Originally Released Under LGPL - original licence link has changed is not relivant.
9 * <script type="text/javascript">
15 * These classes are derivatives of the similarly named classes in the YUI Library.
16 * The original license:
17 * Copyright (c) 2006, Yahoo! Inc. All rights reserved.
18 * Code licensed under the BSD License:
19 * http://developer.yahoo.net/yui/license.txt
24 var Event=Roo.EventManager;
28 * @class Roo.dd.DragDrop
29 * @extends Roo.util.Observable
30 * Defines the interface and base operation of items that that can be
31 * dragged or can be drop targets. It was designed to be extended, overriding
32 * the event handlers for startDrag, onDrag, onDragOver and onDragOut.
33 * Up to three html elements can be associated with a DragDrop instance:
35 * <li>linked element: the element that is passed into the constructor.
36 * This is the element which defines the boundaries for interaction with
37 * other DragDrop objects.</li>
38 * <li>handle element(s): The drag operation only occurs if the element that
39 * was clicked matches a handle element. By default this is the linked
40 * element, but there are times that you will want only a portion of the
41 * linked element to initiate the drag operation, and the setHandleElId()
42 * method provides a way to define this.</li>
43 * <li>drag element: this represents the element that would be moved along
44 * with the cursor during a drag operation. By default, this is the linked
45 * element itself as in {@link Roo.dd.DD}. setDragElId() lets you define
46 * a separate element that would be moved, as in {@link Roo.dd.DDProxy}.
49 * This class should not be instantiated until the onload event to ensure that
50 * the associated elements are available.
51 * The following would define a DragDrop obj that would interact with any
52 * other DragDrop obj in the "group1" group:
54 * dd = new Roo.dd.DragDrop("div1", "group1");
56 * Since none of the event handlers have been implemented, nothing would
57 * actually happen if you were to run the code above. Normally you would
58 * override this class or one of the default implementations, but you can
59 * also override the methods you want on an instance of the class...
61 * dd.onDragDrop = function(e, id) {
62 * alert("dd was dropped on " + id);
66 * @param {String} id of the element that is linked to this instance
67 * @param {String} sGroup the group of related DragDrop objects
68 * @param {object} config an object containing configurable attributes
69 * Valid properties for DragDrop:
70 * padding, isTarget, maintainOffset, primaryButtonOnly
72 Roo.dd.DragDrop = function(id, sGroup, config) {
74 this.init(id, sGroup, config);
79 Roo.extend(Roo.dd.DragDrop, Roo.util.Observable , {
82 * The id of the element associated with this object. This is what we
83 * refer to as the "linked element" because the size and position of
84 * this element is used to determine when the drag and drop objects have
92 * Configuration attributes passed into the constructor
99 * The id of the element that will be dragged. By default this is same
100 * as the linked element , but could be changed to another element. Ex:
109 * the id of the element that initiates the drag operation. By default
110 * this is the linked element, but could be changed to be a child of this
111 * element. This lets us do things like only starting the drag when the
112 * header element within the linked html element is clicked.
113 * @property handleElId
120 * An associative array of HTML tags that will be ignored if clicked.
121 * @property invalidHandleTypes
122 * @type {string: string}
124 invalidHandleTypes: null,
127 * An associative array of ids for elements that will be ignored if clicked
128 * @property invalidHandleIds
129 * @type {string: string}
131 invalidHandleIds: null,
134 * An indexted array of css class names for elements that will be ignored
136 * @property invalidHandleClasses
139 invalidHandleClasses: null,
142 * The linked element's absolute X position at the time the drag was
144 * @property startPageX
151 * The linked element's absolute X position at the time the drag was
153 * @property startPageY
160 * The group defines a logical collection of DragDrop objects that are
161 * related. Instances only get events when interacting with other
162 * DragDrop object in the same group. This lets us define multiple
163 * groups using a single DragDrop subclass if we want.
165 * @type {string: string}
170 * Individual drag/drop instances can be locked. This will prevent
171 * onmousedown start drag.
182 lock: function() { this.locked = true; },
185 * Unlock this instace
188 unlock: function() { this.locked = false; },
191 * By default, all insances can be a drop target. This can be disabled by
192 * setting isTarget to false.
199 * The padding configured for this drag and drop object for calculating
200 * the drop zone intersection with this object.
207 * Cached reference to the linked element
214 * Internal typeof flag
215 * @property __ygDragDrop
221 * Set to true when horizontal contraints are applied
222 * @property constrainX
229 * Set to true when vertical contraints are applied
230 * @property constrainY
237 * The left constraint
245 * The right constraint
262 * The down constraint
270 * Maintain offsets when we resetconstraints. Set to true when you want
271 * the position of the element relative to its parent to stay the same
272 * when the page changes
274 * @property maintainOffset
277 maintainOffset: false,
280 * Array of pixel locations the element will snap to if we specified a
281 * horizontal graduation/interval. This array is generated automatically
282 * when you define a tick interval.
289 * Array of pixel locations the element will snap to if we specified a
290 * vertical graduation/interval. This array is generated automatically
291 * when you define a tick interval.
298 * By default the drag and drop instance will only respond to the primary
299 * button click (left button for a right-handed mouse). Set to true to
300 * allow drag and drop to start with any mouse click that is propogated
302 * @property primaryButtonOnly
305 primaryButtonOnly: true,
308 * The availabe property is false until the linked dom element is accessible.
309 * @property available
315 * By default, drags can only be initiated if the mousedown occurs in the
316 * region the linked element is. This is done in part to work around a
317 * bug in some browsers that mis-report the mousedown if the previous
318 * mouseup happened outside of the window. This property is set to true
319 * if outer handles are defined.
321 * @property hasOuterHandles
325 hasOuterHandles: false,
328 * Code that executes immediately before the startDrag event
329 * @method b4StartDrag
332 b4StartDrag: function(x, y) { },
335 * Abstract method called after a drag/drop object is clicked
336 * and the drag or mousedown time thresholds have beeen met.
338 * @param {int} X click location
339 * @param {int} Y click location
341 startDrag: function(x, y) { /* override this */ },
344 * Code that executes immediately before the onDrag event
348 b4Drag: function(e) { },
351 * Abstract method called during the onMouseMove event while dragging an
354 * @param {Event} e the mousemove event
356 onDrag: function(e) { /* override this */ },
359 * Abstract method called when this element fist begins hovering over
360 * another DragDrop obj
361 * @method onDragEnter
362 * @param {Event} e the mousemove event
363 * @param {String|DragDrop[]} id In POINT mode, the element
364 * id this is hovering over. In INTERSECT mode, an array of one or more
365 * dragdrop items being hovered over.
367 onDragEnter: function(e, id) { /* override this */ },
370 * Code that executes immediately before the onDragOver event
374 b4DragOver: function(e) { },
377 * Abstract method called when this element is hovering over another
380 * @param {Event} e the mousemove event
381 * @param {String|DragDrop[]} id In POINT mode, the element
382 * id this is hovering over. In INTERSECT mode, an array of dd items
383 * being hovered over.
385 onDragOver: function(e, id) { /* override this */ },
388 * Code that executes immediately before the onDragOut event
392 b4DragOut: function(e) { },
395 * Abstract method called when we are no longer hovering over an element
397 * @param {Event} e the mousemove event
398 * @param {String|DragDrop[]} id In POINT mode, the element
399 * id this was hovering over. In INTERSECT mode, an array of dd items
400 * that the mouse is no longer over.
402 onDragOut: function(e, id) { /* override this */ },
405 * Code that executes immediately before the onDragDrop event
409 b4DragDrop: function(e) { },
412 * Abstract method called when this item is dropped on another DragDrop
415 * @param {Event} e the mouseup event
416 * @param {String|DragDrop[]} id In POINT mode, the element
417 * id this was dropped on. In INTERSECT mode, an array of dd items this
420 onDragDrop: function(e, id) { /* override this */ },
423 * Abstract method called when this item is dropped on an area with no
425 * @method onInvalidDrop
426 * @param {Event} e the mouseup event
428 onInvalidDrop: function(e) { /* override this */ },
431 * Code that executes immediately before the endDrag event
435 b4EndDrag: function(e) { },
438 * Fired when we are done dragging the object
440 * @param {Event} e the mouseup event
442 endDrag: function(e) { /* override this */ },
445 * Code executed immediately before the onMouseDown event
446 * @method b4MouseDown
447 * @param {Event} e the mousedown event
450 b4MouseDown: function(e) { },
453 * Event handler that fires when a drag/drop obj gets a mousedown
454 * @method onMouseDown
455 * @param {Event} e the mousedown event
457 onMouseDown: function(e) { /* override this */ },
460 * Event handler that fires when a drag/drop obj gets a mouseup
462 * @param {Event} e the mouseup event
464 onMouseUp: function(e) { /* override this */ },
467 * Override the onAvailable method to do what is needed after the initial
468 * position was determined.
469 * @method onAvailable
471 onAvailable: function () {
475 * Provides default constraint padding to "constrainTo" elements (defaults to {left: 0, right:0, top:0, bottom:0}).
478 defaultPadding : {left:0, right:0, top:0, bottom:0},
481 * Initializes the drag drop object's constraints to restrict movement to a certain element.
485 var dd = new Roo.dd.DDProxy("dragDiv1", "proxytest",
486 { dragElId: "existingProxyDiv" });
487 dd.startDrag = function(){
488 this.constrainTo("parent-id");
491 * Or you can initalize it using the {@link Roo.Element} object:
493 Roo.get("dragDiv1").initDDProxy("proxytest", {dragElId: "existingProxyDiv"}, {
494 startDrag : function(){
495 this.constrainTo("parent-id");
499 * @param {String/HTMLElement/Element} constrainTo The element to constrain to.
500 * @param {Object/Number} pad (optional) Pad provides a way to specify "padding" of the constraints,
501 * and can be either a number for symmetrical padding (4 would be equal to {left:4, right:4, top:4, bottom:4}) or
502 * an object containing the sides to pad. For example: {right:10, bottom:10}
503 * @param {Boolean} inContent (optional) Constrain the draggable in the content box of the element (inside padding and borders)
505 constrainTo : function(constrainTo, pad, inContent){
506 if(typeof pad == "number"){
507 pad = {left: pad, right:pad, top:pad, bottom:pad};
509 pad = pad || this.defaultPadding;
510 var b = Roo.get(this.getEl()).getBox();
511 var ce = Roo.get(constrainTo);
512 var s = ce.getScroll();
514 if(cd == document.body){
515 c = { x: s.left, y: s.top, width: Roo.lib.Dom.getViewWidth(), height: Roo.lib.Dom.getViewHeight()};
518 c = {x : xy[0]+s.left, y: xy[1]+s.top, width: cd.clientWidth, height: cd.clientHeight};
522 var topSpace = b.y - c.y;
523 var leftSpace = b.x - c.x;
525 this.resetConstraints();
526 this.setXConstraint(leftSpace - (pad.left||0), // left
527 c.width - leftSpace - b.width - (pad.right||0) //right
529 this.setYConstraint(topSpace - (pad.top||0), //top
530 c.height - topSpace - b.height - (pad.bottom||0) //bottom
535 * Returns a reference to the linked element
537 * @return {HTMLElement} the html element
541 this._domRef = Roo.getDom(this.id);
548 * Returns a reference to the actual element to drag. By default this is
549 * the same as the html element, but it can be assigned to another
550 * element. An example of this can be found in Roo.dd.DDProxy
552 * @return {HTMLElement} the html element
554 getDragEl: function() {
555 return Roo.getDom(this.dragElId);
559 * Sets up the DragDrop object. Must be called in the constructor of any
560 * Roo.dd.DragDrop subclass
562 * @param id the id of the linked element
563 * @param {String} sGroup the group of related items
564 * @param {object} config configuration attributes
566 init: function(id, sGroup, config) {
567 this.initTarget(id, sGroup, config);
568 Event.on(this.id, "mousedown", this.handleMouseDown, this);
569 // Event.on(this.id, "selectstart", Event.preventDefault);
573 * Initializes Targeting functionality only... the object does not
574 * get a mousedown handler.
576 * @param id the id of the linked element
577 * @param {String} sGroup the group of related items
578 * @param {object} config configuration attributes
580 initTarget: function(id, sGroup, config) {
582 // configuration attributes
583 this.config = config || {};
585 // create a local reference to the drag and drop manager
586 this.DDM = Roo.dd.DDM;
587 // initialize the groups array
590 // assume that we have an element reference instead of an id if the
591 // parameter is not a string
592 if (typeof id !== "string") {
599 // add to an interaction group
600 this.addToGroup((sGroup) ? sGroup : "default");
602 // We don't want to register this as the handle with the manager
603 // so we just set the id rather than calling the setter.
604 this.handleElId = id;
606 // the linked element is the element that gets dragged by default
607 this.setDragElId(id);
609 // by default, clicked anchors will not start drag operations.
610 this.invalidHandleTypes = { A: "A" };
611 this.invalidHandleIds = {};
612 this.invalidHandleClasses = [];
616 this.handleOnAvailable();
620 * Applies the configuration parameters that were passed into the constructor.
621 * This is supposed to happen at each level through the inheritance chain. So
622 * a DDProxy implentation will execute apply config on DDProxy, DD, and
623 * DragDrop in order to get all of the parameters that are available in
625 * @method applyConfig
627 applyConfig: function() {
629 // configurable properties:
630 // padding, isTarget, maintainOffset, primaryButtonOnly
631 this.padding = this.config.padding || [0, 0, 0, 0];
632 this.isTarget = (this.config.isTarget !== false);
633 this.maintainOffset = (this.config.maintainOffset);
634 this.primaryButtonOnly = (this.config.primaryButtonOnly !== false);
639 * Executed when the linked element is available
640 * @method handleOnAvailable
643 handleOnAvailable: function() {
644 this.available = true;
645 this.resetConstraints();
650 * Configures the padding for the target zone in px. Effectively expands
651 * (or reduces) the virtual object size for targeting calculations.
652 * Supports css-style shorthand; if only one parameter is passed, all sides
653 * will have that padding, and if only two are passed, the top and bottom
654 * will have the first param, the left and right the second.
656 * @param {int} iTop Top pad
657 * @param {int} iRight Right pad
658 * @param {int} iBot Bot pad
659 * @param {int} iLeft Left pad
661 setPadding: function(iTop, iRight, iBot, iLeft) {
662 // this.padding = [iLeft, iRight, iTop, iBot];
663 if (!iRight && 0 !== iRight) {
664 this.padding = [iTop, iTop, iTop, iTop];
665 } else if (!iBot && 0 !== iBot) {
666 this.padding = [iTop, iRight, iTop, iRight];
668 this.padding = [iTop, iRight, iBot, iLeft];
673 * Stores the initial placement of the linked element.
674 * @method setInitialPosition
675 * @param {int} diffX the X offset, default 0
676 * @param {int} diffY the Y offset, default 0
678 setInitPosition: function(diffX, diffY) {
679 var el = this.getEl();
681 if (!this.DDM.verifyEl(el)) {
688 var p = Dom.getXY( el );
690 this.initPageX = p[0] - dx;
691 this.initPageY = p[1] - dy;
693 this.lastPageX = p[0];
694 this.lastPageY = p[1];
697 this.setStartPosition(p);
701 * Sets the start position of the element. This is set when the obj
702 * is initialized, the reset when a drag is started.
703 * @method setStartPosition
704 * @param pos current position (from previous lookup)
707 setStartPosition: function(pos) {
708 var p = pos || Dom.getXY( this.getEl() );
709 this.deltaSetXY = null;
711 this.startPageX = p[0];
712 this.startPageY = p[1];
716 * Add this instance to a group of related drag/drop objects. All
717 * instances belong to at least one group, and can belong to as many
720 * @param sGroup {string} the name of the group
722 addToGroup: function(sGroup) {
723 this.groups[sGroup] = true;
724 this.DDM.regDragDrop(this, sGroup);
728 * Remove's this instance from the supplied interaction group
729 * @method removeFromGroup
730 * @param {string} sGroup The group to drop
732 removeFromGroup: function(sGroup) {
733 if (this.groups[sGroup]) {
734 delete this.groups[sGroup];
737 this.DDM.removeDDFromGroup(this, sGroup);
741 * Allows you to specify that an element other than the linked element
742 * will be moved with the cursor during a drag
743 * @method setDragElId
744 * @param id {string} the id of the element that will be used to initiate the drag
746 setDragElId: function(id) {
751 * Allows you to specify a child of the linked element that should be
752 * used to initiate the drag operation. An example of this would be if
753 * you have a content div with text and links. Clicking anywhere in the
754 * content area would normally start the drag operation. Use this method
755 * to specify that an element inside of the content div is the element
756 * that starts the drag operation.
757 * @method setHandleElId
758 * @param id {string} the id of the element that will be used to
761 setHandleElId: function(id) {
762 if (typeof id !== "string") {
765 this.handleElId = id;
766 this.DDM.regHandle(this.id, id);
770 * Allows you to set an element outside of the linked element as a drag
772 * @method setOuterHandleElId
773 * @param id the id of the element that will be used to initiate the drag
775 setOuterHandleElId: function(id) {
776 if (typeof id !== "string") {
779 Event.on(id, "mousedown",
780 this.handleMouseDown, this);
781 this.setHandleElId(id);
783 this.hasOuterHandles = true;
787 * Remove all drag and drop hooks for this element
791 Event.un(this.id, "mousedown",
792 this.handleMouseDown);
794 this.DDM._remove(this);
797 destroy : function(){
802 * Returns true if this instance is locked, or the drag drop mgr is locked
803 * (meaning that all drag/drop is disabled on the page.)
805 * @return {boolean} true if this obj or all drag/drop is locked, else
808 isLocked: function() {
809 return (this.DDM.isLocked() || this.locked);
813 * Fired when this object is clicked
814 * @method handleMouseDown
816 * @param {Roo.dd.DragDrop} oDD the clicked dd object (this dd obj)
819 handleMouseDown: function(e, oDD){
820 if (this.primaryButtonOnly && e.button != 0) {
824 if (this.isLocked()) {
828 this.DDM.refreshCache(this.groups);
830 var pt = new Roo.lib.Point(Roo.lib.Event.getPageX(e), Roo.lib.Event.getPageY(e));
831 if (!this.hasOuterHandles && !this.DDM.isOverTarget(pt, this) ) {
833 if (this.clickValidator(e)) {
835 // set the initial element position
836 this.setStartPosition();
842 this.DDM.handleMouseDown(e, this);
844 this.DDM.stopEvent(e);
852 clickValidator: function(e) {
853 var target = e.getTarget();
854 return ( this.isValidHandleChild(target) &&
855 (this.id == this.handleElId ||
856 this.DDM.handleWasClicked(target, this.id)) );
860 * Allows you to specify a tag name that should not start a drag operation
861 * when clicked. This is designed to facilitate embedding links within a
862 * drag handle that do something other than start the drag.
863 * @method addInvalidHandleType
864 * @param {string} tagName the type of element to exclude
866 addInvalidHandleType: function(tagName) {
867 var type = tagName.toUpperCase();
868 this.invalidHandleTypes[type] = type;
872 * Lets you to specify an element id for a child of a drag handle
873 * that should not initiate a drag
874 * @method addInvalidHandleId
875 * @param {string} id the element id of the element you wish to ignore
877 addInvalidHandleId: function(id) {
878 if (typeof id !== "string") {
881 this.invalidHandleIds[id] = id;
885 * Lets you specify a css class of elements that will not initiate a drag
886 * @method addInvalidHandleClass
887 * @param {string} cssClass the class of the elements you wish to ignore
889 addInvalidHandleClass: function(cssClass) {
890 this.invalidHandleClasses.push(cssClass);
894 * Unsets an excluded tag name set by addInvalidHandleType
895 * @method removeInvalidHandleType
896 * @param {string} tagName the type of element to unexclude
898 removeInvalidHandleType: function(tagName) {
899 var type = tagName.toUpperCase();
900 // this.invalidHandleTypes[type] = null;
901 delete this.invalidHandleTypes[type];
905 * Unsets an invalid handle id
906 * @method removeInvalidHandleId
907 * @param {string} id the id of the element to re-enable
909 removeInvalidHandleId: function(id) {
910 if (typeof id !== "string") {
913 delete this.invalidHandleIds[id];
917 * Unsets an invalid css class
918 * @method removeInvalidHandleClass
919 * @param {string} cssClass the class of the element(s) you wish to
922 removeInvalidHandleClass: function(cssClass) {
923 for (var i=0, len=this.invalidHandleClasses.length; i<len; ++i) {
924 if (this.invalidHandleClasses[i] == cssClass) {
925 delete this.invalidHandleClasses[i];
931 * Checks the tag exclusion list to see if this click should be ignored
932 * @method isValidHandleChild
933 * @param {HTMLElement} node the HTMLElement to evaluate
934 * @return {boolean} true if this is a valid tag type, false if not
936 isValidHandleChild: function(node) {
939 // var n = (node.nodeName == "#text") ? node.parentNode : node;
942 nodeName = node.nodeName.toUpperCase();
944 nodeName = node.nodeName;
946 valid = valid && !this.invalidHandleTypes[nodeName];
947 valid = valid && !this.invalidHandleIds[node.id];
949 for (var i=0, len=this.invalidHandleClasses.length; valid && i<len; ++i) {
950 valid = !Dom.hasClass(node, this.invalidHandleClasses[i]);
959 * Create the array of horizontal tick marks if an interval was specified
960 * in setXConstraint().
964 setXTicks: function(iStartX, iTickSize) {
966 this.xTickSize = iTickSize;
970 for (var i = this.initPageX; i >= this.minX; i = i - iTickSize) {
972 this.xTicks[this.xTicks.length] = i;
977 for (i = this.initPageX; i <= this.maxX; i = i + iTickSize) {
979 this.xTicks[this.xTicks.length] = i;
984 this.xTicks.sort(this.DDM.numericSort) ;
988 * Create the array of vertical tick marks if an interval was specified in
993 setYTicks: function(iStartY, iTickSize) {
995 this.yTickSize = iTickSize;
999 for (var i = this.initPageY; i >= this.minY; i = i - iTickSize) {
1001 this.yTicks[this.yTicks.length] = i;
1006 for (i = this.initPageY; i <= this.maxY; i = i + iTickSize) {
1008 this.yTicks[this.yTicks.length] = i;
1013 this.yTicks.sort(this.DDM.numericSort) ;
1017 * By default, the element can be dragged any place on the screen. Use
1018 * this method to limit the horizontal travel of the element. Pass in
1019 * 0,0 for the parameters if you want to lock the drag to the y axis.
1020 * @method setXConstraint
1021 * @param {int} iLeft the number of pixels the element can move to the left
1022 * @param {int} iRight the number of pixels the element can move to the
1024 * @param {int} iTickSize optional parameter for specifying that the
1026 * should move iTickSize pixels at a time.
1028 setXConstraint: function(iLeft, iRight, iTickSize) {
1029 this.leftConstraint = iLeft;
1030 this.rightConstraint = iRight;
1032 this.minX = this.initPageX - iLeft;
1033 this.maxX = this.initPageX + iRight;
1034 if (iTickSize) { this.setXTicks(this.initPageX, iTickSize); }
1036 this.constrainX = true;
1040 * Clears any constraints applied to this instance. Also clears ticks
1041 * since they can't exist independent of a constraint at this time.
1042 * @method clearConstraints
1044 clearConstraints: function() {
1045 this.constrainX = false;
1046 this.constrainY = false;
1051 * Clears any tick interval defined for this instance
1052 * @method clearTicks
1054 clearTicks: function() {
1062 * By default, the element can be dragged any place on the screen. Set
1063 * this to limit the vertical travel of the element. Pass in 0,0 for the
1064 * parameters if you want to lock the drag to the x axis.
1065 * @method setYConstraint
1066 * @param {int} iUp the number of pixels the element can move up
1067 * @param {int} iDown the number of pixels the element can move down
1068 * @param {int} iTickSize optional parameter for specifying that the
1069 * element should move iTickSize pixels at a time.
1071 setYConstraint: function(iUp, iDown, iTickSize) {
1072 this.topConstraint = iUp;
1073 this.bottomConstraint = iDown;
1075 this.minY = this.initPageY - iUp;
1076 this.maxY = this.initPageY + iDown;
1077 if (iTickSize) { this.setYTicks(this.initPageY, iTickSize); }
1079 this.constrainY = true;
1084 * resetConstraints must be called if you manually reposition a dd element.
1085 * @method resetConstraints
1086 * @param {boolean} maintainOffset
1088 resetConstraints: function() {
1091 // Maintain offsets if necessary
1092 if (this.initPageX || this.initPageX === 0) {
1093 // figure out how much this thing has moved
1094 var dx = (this.maintainOffset) ? this.lastPageX - this.initPageX : 0;
1095 var dy = (this.maintainOffset) ? this.lastPageY - this.initPageY : 0;
1097 this.setInitPosition(dx, dy);
1099 // This is the first time we have detected the element's position
1101 this.setInitPosition();
1104 if (this.constrainX) {
1105 this.setXConstraint( this.leftConstraint,
1106 this.rightConstraint,
1110 if (this.constrainY) {
1111 this.setYConstraint( this.topConstraint,
1112 this.bottomConstraint,
1118 * Normally the drag element is moved pixel by pixel, but we can specify
1119 * that it move a number of pixels at a time. This method resolves the
1120 * location when we have it set up like this.
1122 * @param {int} val where we want to place the object
1123 * @param {int[]} tickArray sorted array of valid points
1124 * @return {int} the closest tick
1127 getTick: function(val, tickArray) {
1130 // If tick interval is not defined, it is effectively 1 pixel,
1131 // so we return the value passed to us.
1133 } else if (tickArray[0] >= val) {
1134 // The value is lower than the first tick, so we return the first
1136 return tickArray[0];
1138 for (var i=0, len=tickArray.length; i<len; ++i) {
1140 if (tickArray[next] && tickArray[next] >= val) {
1141 var diff1 = val - tickArray[i];
1142 var diff2 = tickArray[next] - val;
1143 return (diff2 > diff1) ? tickArray[i] : tickArray[next];
1147 // The value is larger than the last tick, so we return the last
1149 return tickArray[tickArray.length - 1];
1156 * @return {string} string representation of the dd obj
1158 toString: function() {
1159 return ("DragDrop " + this.id);
1167 * Ext JS Library 1.1.1
1168 * Copyright(c) 2006-2007, Ext JS, LLC.
1170 * Originally Released Under LGPL - original licence link has changed is not relivant.
1173 * <script type="text/javascript">
1178 * The drag and drop utility provides a framework for building drag and drop
1179 * applications. In addition to enabling drag and drop for specific elements,
1180 * the drag and drop elements are tracked by the manager class, and the
1181 * interactions between the various elements are tracked during the drag and
1182 * the implementing code is notified about these important moments.
1185 // Only load the library once. Rewriting the manager class would orphan
1186 // existing drag and drop instances.
1187 if (!Roo.dd.DragDropMgr) {
1190 * @class Roo.dd.DragDropMgr
1191 * DragDropMgr is a singleton that tracks the element interaction for
1192 * all DragDrop items in the window. Generally, you will not call
1193 * this class directly, but it does have helper methods that could
1194 * be useful in your DragDrop implementations.
1197 Roo.dd.DragDropMgr = function() {
1199 var Event = Roo.EventManager;
1204 * Two dimensional Array of registered DragDrop objects. The first
1205 * dimension is the DragDrop item group, the second the DragDrop
1208 * @type {string: string}
1215 * Array of element ids defined as drag handles. Used to determine
1216 * if the element that generated the mousedown event is actually the
1217 * handle and not the html element itself.
1218 * @property handleIds
1219 * @type {string: string}
1226 * the DragDrop object that is currently being dragged
1227 * @property dragCurrent
1235 * the DragDrop object(s) that are being hovered over
1236 * @property dragOvers
1244 * the X distance between the cursor and the object being dragged
1253 * the Y distance between the cursor and the object being dragged
1262 * Flag to determine if we should prevent the default behavior of the
1263 * events we define. By default this is true, but this can be set to
1264 * false if you need the default behavior (not recommended)
1265 * @property preventDefault
1269 preventDefault: true,
1272 * Flag to determine if we should stop the propagation of the events
1273 * we generate. This is true by default but you may want to set it to
1274 * false if the html element contains other features that require the
1276 * @property stopPropagation
1280 stopPropagation: true,
1283 * Internal flag that is set to true when drag and drop has been
1285 * @property initialized
1292 * All drag and drop can be disabled.
1300 * Called the first time an element is registered.
1306 this.initialized = true;
1310 * In point mode, drag and drop interaction is defined by the
1311 * location of the cursor during the drag/drop
1319 * In intersect mode, drag and drop interactio nis defined by the
1320 * overlap of two or more drag and drop objects.
1321 * @property INTERSECT
1328 * The current drag and drop mode. Default: POINT
1336 * Runs method on all drag and drop objects
1337 * @method _execOnAll
1341 _execOnAll: function(sMethod, args) {
1342 for (var i in this.ids) {
1343 for (var j in this.ids[i]) {
1344 var oDD = this.ids[i][j];
1345 if (! this.isTypeOfDD(oDD)) {
1348 oDD[sMethod].apply(oDD, args);
1354 * Drag and drop initialization. Sets up the global event handlers
1359 _onLoad: function() {
1364 Event.on(document, "mouseup", this.handleMouseUp, this, true);
1365 Event.on(document, "mousemove", this.handleMouseMove, this, true);
1366 Event.on(window, "unload", this._onUnload, this, true);
1367 Event.on(window, "resize", this._onResize, this, true);
1368 // Event.on(window, "mouseout", this._test);
1373 * Reset constraints on all drag and drop objs
1378 _onResize: function(e) {
1379 this._execOnAll("resetConstraints", []);
1383 * Lock all drag and drop functionality
1387 lock: function() { this.locked = true; },
1390 * Unlock all drag and drop functionality
1394 unlock: function() { this.locked = false; },
1397 * Is drag and drop locked?
1399 * @return {boolean} True if drag and drop is locked, false otherwise.
1402 isLocked: function() { return this.locked; },
1405 * Location cache that is set for all drag drop objects when a drag is
1406 * initiated, cleared when the drag is finished.
1407 * @property locationCache
1414 * Set useCache to false if you want to force object the lookup of each
1415 * drag and drop linked element constantly during a drag.
1416 * @property useCache
1423 * The number of pixels that the mouse needs to move after the
1424 * mousedown before the drag is initiated. Default=3;
1425 * @property clickPixelThresh
1429 clickPixelThresh: 3,
1432 * The number of milliseconds after the mousedown event to initiate the
1433 * drag if we don't get a mouseup event. Default=1000
1434 * @property clickTimeThresh
1438 clickTimeThresh: 350,
1441 * Flag that indicates that either the drag pixel threshold or the
1442 * mousdown time threshold has been met
1443 * @property dragThreshMet
1448 dragThreshMet: false,
1451 * Timeout used for the click time threshold
1452 * @property clickTimeout
1460 * The X position of the mousedown event stored for later use when a
1461 * drag threshold is met.
1470 * The Y position of the mousedown event stored for later use when a
1471 * drag threshold is met.
1480 * Each DragDrop instance must be registered with the DragDropMgr.
1481 * This is executed in DragDrop.init()
1482 * @method regDragDrop
1483 * @param {DragDrop} oDD the DragDrop object to register
1484 * @param {String} sGroup the name of the group this element belongs to
1487 regDragDrop: function(oDD, sGroup) {
1488 if (!this.initialized) { this.init(); }
1490 if (!this.ids[sGroup]) {
1491 this.ids[sGroup] = {};
1493 this.ids[sGroup][oDD.id] = oDD;
1497 * Removes the supplied dd instance from the supplied group. Executed
1498 * by DragDrop.removeFromGroup, so don't call this function directly.
1499 * @method removeDDFromGroup
1503 removeDDFromGroup: function(oDD, sGroup) {
1504 if (!this.ids[sGroup]) {
1505 this.ids[sGroup] = {};
1508 var obj = this.ids[sGroup];
1509 if (obj && obj[oDD.id]) {
1515 * Unregisters a drag and drop item. This is executed in
1516 * DragDrop.unreg, use that method instead of calling this directly.
1521 _remove: function(oDD) {
1522 for (var g in oDD.groups) {
1523 if (g && this.ids[g][oDD.id]) {
1524 delete this.ids[g][oDD.id];
1527 delete this.handleIds[oDD.id];
1531 * Each DragDrop handle element must be registered. This is done
1532 * automatically when executing DragDrop.setHandleElId()
1534 * @param {String} sDDId the DragDrop id this element is a handle for
1535 * @param {String} sHandleId the id of the element that is the drag
1539 regHandle: function(sDDId, sHandleId) {
1540 if (!this.handleIds[sDDId]) {
1541 this.handleIds[sDDId] = {};
1543 this.handleIds[sDDId][sHandleId] = sHandleId;
1547 * Utility function to determine if a given element has been
1548 * registered as a drag drop item.
1549 * @method isDragDrop
1550 * @param {String} id the element id to check
1551 * @return {boolean} true if this element is a DragDrop item,
1555 isDragDrop: function(id) {
1556 return ( this.getDDById(id) ) ? true : false;
1560 * Returns the drag and drop instances that are in all groups the
1561 * passed in instance belongs to.
1562 * @method getRelated
1563 * @param {DragDrop} p_oDD the obj to get related data for
1564 * @param {boolean} bTargetsOnly if true, only return targetable objs
1565 * @return {DragDrop[]} the related instances
1568 getRelated: function(p_oDD, bTargetsOnly) {
1570 for (var i in p_oDD.groups) {
1571 for (j in this.ids[i]) {
1572 var dd = this.ids[i][j];
1573 if (! this.isTypeOfDD(dd)) {
1576 if (!bTargetsOnly || dd.isTarget) {
1577 oDDs[oDDs.length] = dd;
1586 * Returns true if the specified dd target is a legal target for
1587 * the specifice drag obj
1588 * @method isLegalTarget
1589 * @param {DragDrop} the drag obj
1590 * @param {DragDrop} the target
1591 * @return {boolean} true if the target is a legal target for the
1595 isLegalTarget: function (oDD, oTargetDD) {
1596 var targets = this.getRelated(oDD, true);
1597 for (var i=0, len=targets.length;i<len;++i) {
1598 if (targets[i].id == oTargetDD.id) {
1607 * My goal is to be able to transparently determine if an object is
1608 * typeof DragDrop, and the exact subclass of DragDrop. typeof
1609 * returns "object", oDD.constructor.toString() always returns
1610 * "DragDrop" and not the name of the subclass. So for now it just
1611 * evaluates a well-known variable in DragDrop.
1612 * @method isTypeOfDD
1613 * @param {Object} the object to evaluate
1614 * @return {boolean} true if typeof oDD = DragDrop
1617 isTypeOfDD: function (oDD) {
1618 return (oDD && oDD.__ygDragDrop);
1622 * Utility function to determine if a given element has been
1623 * registered as a drag drop handle for the given Drag Drop object.
1625 * @param {String} id the element id to check
1626 * @return {boolean} true if this element is a DragDrop handle, false
1630 isHandle: function(sDDId, sHandleId) {
1631 return ( this.handleIds[sDDId] &&
1632 this.handleIds[sDDId][sHandleId] );
1636 * Returns the DragDrop instance for a given id
1638 * @param {String} id the id of the DragDrop object
1639 * @return {DragDrop} the drag drop object, null if it is not found
1642 getDDById: function(id) {
1643 for (var i in this.ids) {
1644 if (this.ids[i][id]) {
1645 return this.ids[i][id];
1652 * Fired after a registered DragDrop object gets the mousedown event.
1653 * Sets up the events required to track the object being dragged
1654 * @method handleMouseDown
1655 * @param {Event} e the event
1656 * @param oDD the DragDrop object being dragged
1660 handleMouseDown: function(e, oDD) {
1662 Roo.QuickTips.disable();
1664 this.currentTarget = e.getTarget();
1666 this.dragCurrent = oDD;
1668 var el = oDD.getEl();
1670 // track start position
1671 this.startX = e.getPageX();
1672 this.startY = e.getPageY();
1674 this.deltaX = this.startX - el.offsetLeft;
1675 this.deltaY = this.startY - el.offsetTop;
1677 this.dragThreshMet = false;
1679 this.clickTimeout = setTimeout(
1681 var DDM = Roo.dd.DDM;
1682 DDM.startDrag(DDM.startX, DDM.startY);
1684 this.clickTimeThresh );
1688 * Fired when either the drag pixel threshol or the mousedown hold
1689 * time threshold has been met.
1691 * @param x {int} the X position of the original mousedown
1692 * @param y {int} the Y position of the original mousedown
1695 startDrag: function(x, y) {
1696 clearTimeout(this.clickTimeout);
1697 if (this.dragCurrent) {
1698 this.dragCurrent.b4StartDrag(x, y);
1699 this.dragCurrent.startDrag(x, y);
1701 this.dragThreshMet = true;
1705 * Internal function to handle the mouseup event. Will be invoked
1706 * from the context of the document.
1707 * @method handleMouseUp
1708 * @param {Event} e the event
1712 handleMouseUp: function(e) {
1715 Roo.QuickTips.enable();
1717 if (! this.dragCurrent) {
1721 clearTimeout(this.clickTimeout);
1723 if (this.dragThreshMet) {
1724 this.fireEvents(e, true);
1734 * Utility to stop event propagation and event default, if these
1735 * features are turned on.
1737 * @param {Event} e the event as returned by this.getEvent()
1740 stopEvent: function(e){
1741 if(this.stopPropagation) {
1742 e.stopPropagation();
1745 if (this.preventDefault) {
1751 * Internal function to clean up event handlers after the drag
1752 * operation is complete
1754 * @param {Event} e the event
1758 stopDrag: function(e) {
1759 // Fire the drag end event for the item that was dragged
1760 if (this.dragCurrent) {
1761 if (this.dragThreshMet) {
1762 this.dragCurrent.b4EndDrag(e);
1763 this.dragCurrent.endDrag(e);
1766 this.dragCurrent.onMouseUp(e);
1769 this.dragCurrent = null;
1770 this.dragOvers = {};
1774 * Internal function to handle the mousemove event. Will be invoked
1775 * from the context of the html element.
1777 * @TODO figure out what we can do about mouse events lost when the
1778 * user drags objects beyond the window boundary. Currently we can
1779 * detect this in internet explorer by verifying that the mouse is
1780 * down during the mousemove event. Firefox doesn't give us the
1781 * button state on the mousemove event.
1782 * @method handleMouseMove
1783 * @param {Event} e the event
1787 handleMouseMove: function(e) {
1788 if (! this.dragCurrent) {
1792 // var button = e.which || e.button;
1794 // check for IE mouseup outside of page boundary
1795 if (Roo.isIE && (e.button !== 0 && e.button !== 1 && e.button !== 2)) {
1797 return this.handleMouseUp(e);
1800 if (!this.dragThreshMet) {
1801 var diffX = Math.abs(this.startX - e.getPageX());
1802 var diffY = Math.abs(this.startY - e.getPageY());
1803 if (diffX > this.clickPixelThresh ||
1804 diffY > this.clickPixelThresh) {
1805 this.startDrag(this.startX, this.startY);
1809 if (this.dragThreshMet) {
1810 this.dragCurrent.b4Drag(e);
1811 this.dragCurrent.onDrag(e);
1812 if(!this.dragCurrent.moveOnly){
1813 this.fireEvents(e, false);
1823 * Iterates over all of the DragDrop elements to find ones we are
1824 * hovering over or dropping on
1825 * @method fireEvents
1826 * @param {Event} e the event
1827 * @param {boolean} isDrop is this a drop op or a mouseover op?
1831 fireEvents: function(e, isDrop) {
1832 var dc = this.dragCurrent;
1834 // If the user did the mouse up outside of the window, we could
1835 // get here even though we have ended the drag.
1836 if (!dc || dc.isLocked()) {
1840 var pt = e.getPoint();
1842 // cache the previous dragOver array
1850 // Check to see if the object(s) we were hovering over is no longer
1851 // being hovered over so we can fire the onDragOut event
1852 for (var i in this.dragOvers) {
1854 var ddo = this.dragOvers[i];
1856 if (! this.isTypeOfDD(ddo)) {
1860 if (! this.isOverTarget(pt, ddo, this.mode)) {
1861 outEvts.push( ddo );
1865 delete this.dragOvers[i];
1868 for (var sGroup in dc.groups) {
1870 if ("string" != typeof sGroup) {
1874 for (i in this.ids[sGroup]) {
1875 var oDD = this.ids[sGroup][i];
1876 if (! this.isTypeOfDD(oDD)) {
1880 if (oDD.isTarget && !oDD.isLocked() && oDD != dc) {
1881 if (this.isOverTarget(pt, oDD, this.mode)) {
1882 // look for drop interactions
1884 dropEvts.push( oDD );
1885 // look for drag enter and drag over interactions
1888 // initial drag over: dragEnter fires
1889 if (!oldOvers[oDD.id]) {
1890 enterEvts.push( oDD );
1891 // subsequent drag overs: dragOver fires
1893 overEvts.push( oDD );
1896 this.dragOvers[oDD.id] = oDD;
1904 if (outEvts.length) {
1905 dc.b4DragOut(e, outEvts);
1906 dc.onDragOut(e, outEvts);
1909 if (enterEvts.length) {
1910 dc.onDragEnter(e, enterEvts);
1913 if (overEvts.length) {
1914 dc.b4DragOver(e, overEvts);
1915 dc.onDragOver(e, overEvts);
1918 if (dropEvts.length) {
1919 dc.b4DragDrop(e, dropEvts);
1920 dc.onDragDrop(e, dropEvts);
1924 // fire dragout events
1926 for (i=0, len=outEvts.length; i<len; ++i) {
1927 dc.b4DragOut(e, outEvts[i].id);
1928 dc.onDragOut(e, outEvts[i].id);
1931 // fire enter events
1932 for (i=0,len=enterEvts.length; i<len; ++i) {
1933 // dc.b4DragEnter(e, oDD.id);
1934 dc.onDragEnter(e, enterEvts[i].id);
1938 for (i=0,len=overEvts.length; i<len; ++i) {
1939 dc.b4DragOver(e, overEvts[i].id);
1940 dc.onDragOver(e, overEvts[i].id);
1944 for (i=0, len=dropEvts.length; i<len; ++i) {
1945 dc.b4DragDrop(e, dropEvts[i].id);
1946 dc.onDragDrop(e, dropEvts[i].id);
1951 // notify about a drop that did not find a target
1952 if (isDrop && !dropEvts.length) {
1953 dc.onInvalidDrop(e);
1959 * Helper function for getting the best match from the list of drag
1960 * and drop objects returned by the drag and drop events when we are
1961 * in INTERSECT mode. It returns either the first object that the
1962 * cursor is over, or the object that has the greatest overlap with
1963 * the dragged element.
1964 * @method getBestMatch
1965 * @param {DragDrop[]} dds The array of drag and drop objects
1967 * @return {DragDrop} The best single match
1970 getBestMatch: function(dds) {
1972 // Return null if the input is not what we expect
1973 //if (!dds || !dds.length || dds.length == 0) {
1975 // If there is only one item, it wins
1976 //} else if (dds.length == 1) {
1978 var len = dds.length;
1983 // Loop through the targeted items
1984 for (var i=0; i<len; ++i) {
1986 // If the cursor is over the object, it wins. If the
1987 // cursor is over multiple matches, the first one we come
1989 if (dd.cursorIsOver) {
1992 // Otherwise the object with the most overlap wins
1995 winner.overlap.getArea() < dd.overlap.getArea()) {
2006 * Refreshes the cache of the top-left and bottom-right points of the
2007 * drag and drop objects in the specified group(s). This is in the
2008 * format that is stored in the drag and drop instance, so typical
2011 * Roo.dd.DragDropMgr.refreshCache(ddinstance.groups);
2015 * Roo.dd.DragDropMgr.refreshCache({group1:true, group2:true});
2017 * @TODO this really should be an indexed array. Alternatively this
2018 * method could accept both.
2019 * @method refreshCache
2020 * @param {Object} groups an associative array of groups to refresh
2023 refreshCache: function(groups) {
2024 for (var sGroup in groups) {
2025 if ("string" != typeof sGroup) {
2028 for (var i in this.ids[sGroup]) {
2029 var oDD = this.ids[sGroup][i];
2031 if (this.isTypeOfDD(oDD)) {
2032 // if (this.isTypeOfDD(oDD) && oDD.isTarget) {
2033 var loc = this.getLocation(oDD);
2035 this.locationCache[oDD.id] = loc;
2037 delete this.locationCache[oDD.id];
2038 // this will unregister the drag and drop object if
2039 // the element is not in a usable state
2048 * This checks to make sure an element exists and is in the DOM. The
2049 * main purpose is to handle cases where innerHTML is used to remove
2050 * drag and drop objects from the DOM. IE provides an 'unspecified
2051 * error' when trying to access the offsetParent of such an element
2053 * @param {HTMLElement} el the element to check
2054 * @return {boolean} true if the element looks usable
2057 verifyEl: function(el) {
2062 parent = el.offsetParent;
2065 parent = el.offsetParent;
2076 * Returns a Region object containing the drag and drop element's position
2077 * and size, including the padding configured for it
2078 * @method getLocation
2079 * @param {DragDrop} oDD the drag and drop object to get the
2081 * @return {Roo.lib.Region} a Region object representing the total area
2082 * the element occupies, including any padding
2083 * the instance is configured for.
2086 getLocation: function(oDD) {
2087 if (! this.isTypeOfDD(oDD)) {
2091 var el = oDD.getEl(), pos, x1, x2, y1, y2, t, r, b, l;
2094 pos= Roo.lib.Dom.getXY(el);
2102 x2 = x1 + el.offsetWidth;
2104 y2 = y1 + el.offsetHeight;
2106 t = y1 - oDD.padding[0];
2107 r = x2 + oDD.padding[1];
2108 b = y2 + oDD.padding[2];
2109 l = x1 - oDD.padding[3];
2111 return new Roo.lib.Region( t, r, b, l );
2115 * Checks the cursor location to see if it over the target
2116 * @method isOverTarget
2117 * @param {Roo.lib.Point} pt The point to evaluate
2118 * @param {DragDrop} oTarget the DragDrop object we are inspecting
2119 * @return {boolean} true if the mouse is over the target
2123 isOverTarget: function(pt, oTarget, intersect) {
2124 // use cache if available
2125 var loc = this.locationCache[oTarget.id];
2126 if (!loc || !this.useCache) {
2127 loc = this.getLocation(oTarget);
2128 this.locationCache[oTarget.id] = loc;
2136 oTarget.cursorIsOver = loc.contains( pt );
2138 // DragDrop is using this as a sanity check for the initial mousedown
2139 // in this case we are done. In POINT mode, if the drag obj has no
2140 // contraints, we are also done. Otherwise we need to evaluate the
2141 // location of the target as related to the actual location of the
2143 var dc = this.dragCurrent;
2144 if (!dc || !dc.getTargetCoord ||
2145 (!intersect && !dc.constrainX && !dc.constrainY)) {
2146 return oTarget.cursorIsOver;
2149 oTarget.overlap = null;
2151 // Get the current location of the drag element, this is the
2152 // location of the mouse event less the delta that represents
2153 // where the original mousedown happened on the element. We
2154 // need to consider constraints and ticks as well.
2155 var pos = dc.getTargetCoord(pt.x, pt.y);
2157 var el = dc.getDragEl();
2158 var curRegion = new Roo.lib.Region( pos.y,
2159 pos.x + el.offsetWidth,
2160 pos.y + el.offsetHeight,
2163 var overlap = curRegion.intersect(loc);
2166 oTarget.overlap = overlap;
2167 return (intersect) ? true : oTarget.cursorIsOver;
2174 * unload event handler
2179 _onUnload: function(e, me) {
2180 Roo.dd.DragDropMgr.unregAll();
2184 * Cleans up the drag and drop events and objects.
2189 unregAll: function() {
2191 if (this.dragCurrent) {
2193 this.dragCurrent = null;
2196 this._execOnAll("unreg", []);
2198 for (i in this.elementCache) {
2199 delete this.elementCache[i];
2202 this.elementCache = {};
2207 * A cache of DOM elements
2208 * @property elementCache
2215 * Get the wrapper for the DOM element specified
2216 * @method getElWrapper
2217 * @param {String} id the id of the element to get
2218 * @return {Roo.dd.DDM.ElementWrapper} the wrapped element
2220 * @deprecated This wrapper isn't that useful
2223 getElWrapper: function(id) {
2224 var oWrapper = this.elementCache[id];
2225 if (!oWrapper || !oWrapper.el) {
2226 oWrapper = this.elementCache[id] =
2227 new this.ElementWrapper(Roo.getDom(id));
2233 * Returns the actual DOM element
2234 * @method getElement
2235 * @param {String} id the id of the elment to get
2236 * @return {Object} The element
2237 * @deprecated use Roo.getDom instead
2240 getElement: function(id) {
2241 return Roo.getDom(id);
2245 * Returns the style property for the DOM element (i.e.,
2246 * document.getElById(id).style)
2248 * @param {String} id the id of the elment to get
2249 * @return {Object} The style property of the element
2250 * @deprecated use Roo.getDom instead
2253 getCss: function(id) {
2254 var el = Roo.getDom(id);
2255 return (el) ? el.style : null;
2259 * Inner class for cached elements
2260 * @class DragDropMgr.ElementWrapper
2265 ElementWrapper: function(el) {
2270 this.el = el || null;
2275 this.id = this.el && el.id;
2277 * A reference to the style property
2280 this.css = this.el && el.style;
2284 * Returns the X position of an html element
2286 * @param el the element for which to get the position
2287 * @return {int} the X coordinate
2289 * @deprecated use Roo.lib.Dom.getX instead
2292 getPosX: function(el) {
2293 return Roo.lib.Dom.getX(el);
2297 * Returns the Y position of an html element
2299 * @param el the element for which to get the position
2300 * @return {int} the Y coordinate
2301 * @deprecated use Roo.lib.Dom.getY instead
2304 getPosY: function(el) {
2305 return Roo.lib.Dom.getY(el);
2309 * Swap two nodes. In IE, we use the native method, for others we
2310 * emulate the IE behavior
2312 * @param n1 the first node to swap
2313 * @param n2 the other node to swap
2316 swapNode: function(n1, n2) {
2320 var p = n2.parentNode;
2321 var s = n2.nextSibling;
2324 p.insertBefore(n1, n2);
2325 } else if (n2 == n1.nextSibling) {
2326 p.insertBefore(n2, n1);
2328 n1.parentNode.replaceChild(n2, n1);
2329 p.insertBefore(n1, s);
2335 * Returns the current scroll position
2340 getScroll: function () {
2341 var t, l, dde=document.documentElement, db=document.body;
2342 if (dde && (dde.scrollTop || dde.scrollLeft)) {
2351 return { top: t, left: l };
2355 * Returns the specified element style property
2357 * @param {HTMLElement} el the element
2358 * @param {string} styleProp the style property
2359 * @return {string} The value of the style property
2360 * @deprecated use Roo.lib.Dom.getStyle
2363 getStyle: function(el, styleProp) {
2364 return Roo.fly(el).getStyle(styleProp);
2368 * Gets the scrollTop
2369 * @method getScrollTop
2370 * @return {int} the document's scrollTop
2373 getScrollTop: function () { return this.getScroll().top; },
2376 * Gets the scrollLeft
2377 * @method getScrollLeft
2378 * @return {int} the document's scrollTop
2381 getScrollLeft: function () { return this.getScroll().left; },
2384 * Sets the x/y position of an element to the location of the
2387 * @param {HTMLElement} moveEl The element to move
2388 * @param {HTMLElement} targetEl The position reference element
2391 moveToEl: function (moveEl, targetEl) {
2392 var aCoord = Roo.lib.Dom.getXY(targetEl);
2393 Roo.lib.Dom.setXY(moveEl, aCoord);
2397 * Numeric array sort function
2398 * @method numericSort
2401 numericSort: function(a, b) { return (a - b); },
2405 * @property _timeoutCount
2412 * Trying to make the load order less important. Without this we get
2413 * an error if this file is loaded before the Event Utility.
2414 * @method _addListeners
2418 _addListeners: function() {
2419 var DDM = Roo.dd.DDM;
2420 if ( Roo.lib.Event && document ) {
2423 if (DDM._timeoutCount > 2000) {
2425 setTimeout(DDM._addListeners, 10);
2426 if (document && document.body) {
2427 DDM._timeoutCount += 1;
2434 * Recursively searches the immediate parent and all child nodes for
2435 * the handle element in order to determine wheter or not it was
2437 * @method handleWasClicked
2438 * @param node the html element to inspect
2441 handleWasClicked: function(node, id) {
2442 if (this.isHandle(id, node.id)) {
2445 // check to see if this is a text node child of the one we want
2446 var p = node.parentNode;
2449 if (this.isHandle(id, p.id)) {
2464 // shorter alias, save a few bytes
2465 Roo.dd.DDM = Roo.dd.DragDropMgr;
2466 Roo.dd.DDM._addListeners();
2470 * Ext JS Library 1.1.1
2471 * Copyright(c) 2006-2007, Ext JS, LLC.
2473 * Originally Released Under LGPL - original licence link has changed is not relivant.
2476 * <script type="text/javascript">
2481 * A DragDrop implementation where the linked element follows the
2482 * mouse cursor during a drag.
2483 * @extends Roo.dd.DragDrop
2485 * @param {String} id the id of the linked element
2486 * @param {String} sGroup the group of related DragDrop items
2487 * @param {object} config an object containing configurable attributes
2488 * Valid properties for DD:
2491 Roo.dd.DD = function(id, sGroup, config) {
2493 this.init(id, sGroup, config);
2497 Roo.extend(Roo.dd.DD, Roo.dd.DragDrop, {
2500 * When set to true, the utility automatically tries to scroll the browser
2501 * window wehn a drag and drop element is dragged near the viewport boundary.
2509 * Sets the pointer offset to the distance between the linked element's top
2510 * left corner and the location the element was clicked
2511 * @method autoOffset
2512 * @param {int} iPageX the X coordinate of the click
2513 * @param {int} iPageY the Y coordinate of the click
2515 autoOffset: function(iPageX, iPageY) {
2516 var x = iPageX - this.startPageX;
2517 var y = iPageY - this.startPageY;
2518 this.setDelta(x, y);
2522 * Sets the pointer offset. You can call this directly to force the
2523 * offset to be in a particular location (e.g., pass in 0,0 to set it
2524 * to the center of the object)
2526 * @param {int} iDeltaX the distance from the left
2527 * @param {int} iDeltaY the distance from the top
2529 setDelta: function(iDeltaX, iDeltaY) {
2530 this.deltaX = iDeltaX;
2531 this.deltaY = iDeltaY;
2535 * Sets the drag element to the location of the mousedown or click event,
2536 * maintaining the cursor location relative to the location on the element
2537 * that was clicked. Override this if you want to place the element in a
2538 * location other than where the cursor is.
2539 * @method setDragElPos
2540 * @param {int} iPageX the X coordinate of the mousedown or drag event
2541 * @param {int} iPageY the Y coordinate of the mousedown or drag event
2543 setDragElPos: function(iPageX, iPageY) {
2544 // the first time we do this, we are going to check to make sure
2545 // the element has css positioning
2547 var el = this.getDragEl();
2548 this.alignElWithMouse(el, iPageX, iPageY);
2552 * Sets the element to the location of the mousedown or click event,
2553 * maintaining the cursor location relative to the location on the element
2554 * that was clicked. Override this if you want to place the element in a
2555 * location other than where the cursor is.
2556 * @method alignElWithMouse
2557 * @param {HTMLElement} el the element to move
2558 * @param {int} iPageX the X coordinate of the mousedown or drag event
2559 * @param {int} iPageY the Y coordinate of the mousedown or drag event
2561 alignElWithMouse: function(el, iPageX, iPageY) {
2562 var oCoord = this.getTargetCoord(iPageX, iPageY);
2563 var fly = el.dom ? el : Roo.fly(el);
2564 if (!this.deltaSetXY) {
2565 var aCoord = [oCoord.x, oCoord.y];
2567 var newLeft = fly.getLeft(true);
2568 var newTop = fly.getTop(true);
2569 this.deltaSetXY = [ newLeft - oCoord.x, newTop - oCoord.y ];
2571 fly.setLeftTop(oCoord.x + this.deltaSetXY[0], oCoord.y + this.deltaSetXY[1]);
2574 this.cachePosition(oCoord.x, oCoord.y);
2575 this.autoScroll(oCoord.x, oCoord.y, el.offsetHeight, el.offsetWidth);
2580 * Saves the most recent position so that we can reset the constraints and
2581 * tick marks on-demand. We need to know this so that we can calculate the
2582 * number of pixels the element is offset from its original position.
2583 * @method cachePosition
2584 * @param iPageX the current x position (optional, this just makes it so we
2585 * don't have to look it up again)
2586 * @param iPageY the current y position (optional, this just makes it so we
2587 * don't have to look it up again)
2589 cachePosition: function(iPageX, iPageY) {
2591 this.lastPageX = iPageX;
2592 this.lastPageY = iPageY;
2594 var aCoord = Roo.lib.Dom.getXY(this.getEl());
2595 this.lastPageX = aCoord[0];
2596 this.lastPageY = aCoord[1];
2601 * Auto-scroll the window if the dragged object has been moved beyond the
2602 * visible window boundary.
2603 * @method autoScroll
2604 * @param {int} x the drag element's x position
2605 * @param {int} y the drag element's y position
2606 * @param {int} h the height of the drag element
2607 * @param {int} w the width of the drag element
2610 autoScroll: function(x, y, h, w) {
2613 // The client height
2614 var clientH = Roo.lib.Dom.getViewWidth();
2617 var clientW = Roo.lib.Dom.getViewHeight();
2619 // The amt scrolled down
2620 var st = this.DDM.getScrollTop();
2622 // The amt scrolled right
2623 var sl = this.DDM.getScrollLeft();
2625 // Location of the bottom of the element
2628 // Location of the right of the element
2631 // The distance from the cursor to the bottom of the visible area,
2632 // adjusted so that we don't scroll if the cursor is beyond the
2633 // element drag constraints
2634 var toBot = (clientH + st - y - this.deltaY);
2636 // The distance from the cursor to the right of the visible area
2637 var toRight = (clientW + sl - x - this.deltaX);
2640 // How close to the edge the cursor must be before we scroll
2641 // var thresh = (document.all) ? 100 : 40;
2644 // How many pixels to scroll per autoscroll op. This helps to reduce
2645 // clunky scrolling. IE is more sensitive about this ... it needs this
2646 // value to be higher.
2647 var scrAmt = (document.all) ? 80 : 30;
2649 // Scroll down if we are near the bottom of the visible page and the
2650 // obj extends below the crease
2651 if ( bot > clientH && toBot < thresh ) {
2652 window.scrollTo(sl, st + scrAmt);
2655 // Scroll up if the window is scrolled down and the top of the object
2656 // goes above the top border
2657 if ( y < st && st > 0 && y - st < thresh ) {
2658 window.scrollTo(sl, st - scrAmt);
2661 // Scroll right if the obj is beyond the right border and the cursor is
2663 if ( right > clientW && toRight < thresh ) {
2664 window.scrollTo(sl + scrAmt, st);
2667 // Scroll left if the window has been scrolled to the right and the obj
2668 // extends past the left border
2669 if ( x < sl && sl > 0 && x - sl < thresh ) {
2670 window.scrollTo(sl - scrAmt, st);
2676 * Finds the location the element should be placed if we want to move
2677 * it to where the mouse location less the click offset would place us.
2678 * @method getTargetCoord
2679 * @param {int} iPageX the X coordinate of the click
2680 * @param {int} iPageY the Y coordinate of the click
2681 * @return an object that contains the coordinates (Object.x and Object.y)
2684 getTargetCoord: function(iPageX, iPageY) {
2687 var x = iPageX - this.deltaX;
2688 var y = iPageY - this.deltaY;
2690 if (this.constrainX) {
2691 if (x < this.minX) { x = this.minX; }
2692 if (x > this.maxX) { x = this.maxX; }
2695 if (this.constrainY) {
2696 if (y < this.minY) { y = this.minY; }
2697 if (y > this.maxY) { y = this.maxY; }
2700 x = this.getTick(x, this.xTicks);
2701 y = this.getTick(y, this.yTicks);
2708 * Sets up config options specific to this class. Overrides
2709 * Roo.dd.DragDrop, but all versions of this method through the
2710 * inheritance chain are called
2712 applyConfig: function() {
2713 Roo.dd.DD.superclass.applyConfig.call(this);
2714 this.scroll = (this.config.scroll !== false);
2718 * Event that fires prior to the onMouseDown event. Overrides
2721 b4MouseDown: function(e) {
2722 // this.resetConstraints();
2723 this.autoOffset(e.getPageX(),
2728 * Event that fires prior to the onDrag event. Overrides
2731 b4Drag: function(e) {
2732 this.setDragElPos(e.getPageX(),
2736 toString: function() {
2737 return ("DD " + this.id);
2740 //////////////////////////////////////////////////////////////////////////
2741 // Debugging ygDragDrop events that can be overridden
2742 //////////////////////////////////////////////////////////////////////////
2744 startDrag: function(x, y) {
2747 onDrag: function(e) {
2750 onDragEnter: function(e, id) {
2753 onDragOver: function(e, id) {
2756 onDragOut: function(e, id) {
2759 onDragDrop: function(e, id) {
2762 endDrag: function(e) {
2769 * Ext JS Library 1.1.1
2770 * Copyright(c) 2006-2007, Ext JS, LLC.
2772 * Originally Released Under LGPL - original licence link has changed is not relivant.
2775 * <script type="text/javascript">
2779 * @class Roo.dd.DDProxy
2780 * A DragDrop implementation that inserts an empty, bordered div into
2781 * the document that follows the cursor during drag operations. At the time of
2782 * the click, the frame div is resized to the dimensions of the linked html
2783 * element, and moved to the exact location of the linked element.
2785 * References to the "frame" element refer to the single proxy element that
2786 * was created to be dragged in place of all DDProxy elements on the
2789 * @extends Roo.dd.DD
2791 * @param {String} id the id of the linked html element
2792 * @param {String} sGroup the group of related DragDrop objects
2793 * @param {object} config an object containing configurable attributes
2794 * Valid properties for DDProxy in addition to those in DragDrop:
2795 * resizeFrame, centerFrame, dragElId
2797 Roo.dd.DDProxy = function(id, sGroup, config) {
2799 this.init(id, sGroup, config);
2805 * The default drag frame div id
2806 * @property Roo.dd.DDProxy.dragElId
2810 Roo.dd.DDProxy.dragElId = "ygddfdiv";
2812 Roo.extend(Roo.dd.DDProxy, Roo.dd.DD, {
2815 * By default we resize the drag frame to be the same size as the element
2816 * we want to drag (this is to get the frame effect). We can turn it off
2817 * if we want a different behavior.
2818 * @property resizeFrame
2824 * By default the frame is positioned exactly where the drag element is, so
2825 * we use the cursor offset provided by Roo.dd.DD. Another option that works only if
2826 * you do not have constraints on the obj is to have the drag frame centered
2827 * around the cursor. Set centerFrame to true for this effect.
2828 * @property centerFrame
2834 * Creates the proxy element if it does not yet exist
2835 * @method createFrame
2837 createFrame: function() {
2839 var body = document.body;
2841 if (!body || !body.firstChild) {
2842 setTimeout( function() { self.createFrame(); }, 50 );
2846 var div = this.getDragEl();
2849 div = document.createElement("div");
2850 div.id = this.dragElId;
2853 s.position = "absolute";
2854 s.visibility = "hidden";
2856 s.border = "2px solid #aaa";
2859 // appendChild can blow up IE if invoked prior to the window load event
2860 // while rendering a table. It is possible there are other scenarios
2861 // that would cause this to happen as well.
2862 body.insertBefore(div, body.firstChild);
2867 * Initialization for the drag frame element. Must be called in the
2868 * constructor of all subclasses
2871 initFrame: function() {
2875 applyConfig: function() {
2876 Roo.dd.DDProxy.superclass.applyConfig.call(this);
2878 this.resizeFrame = (this.config.resizeFrame !== false);
2879 this.centerFrame = (this.config.centerFrame);
2880 this.setDragElId(this.config.dragElId || Roo.dd.DDProxy.dragElId);
2884 * Resizes the drag frame to the dimensions of the clicked object, positions
2885 * it over the object, and finally displays it
2887 * @param {int} iPageX X click position
2888 * @param {int} iPageY Y click position
2891 showFrame: function(iPageX, iPageY) {
2892 var el = this.getEl();
2893 var dragEl = this.getDragEl();
2894 var s = dragEl.style;
2896 this._resizeProxy();
2898 if (this.centerFrame) {
2899 this.setDelta( Math.round(parseInt(s.width, 10)/2),
2900 Math.round(parseInt(s.height, 10)/2) );
2903 this.setDragElPos(iPageX, iPageY);
2905 Roo.fly(dragEl).show();
2909 * The proxy is automatically resized to the dimensions of the linked
2910 * element when a drag is initiated, unless resizeFrame is set to false
2911 * @method _resizeProxy
2914 _resizeProxy: function() {
2915 if (this.resizeFrame) {
2916 var el = this.getEl();
2917 Roo.fly(this.getDragEl()).setSize(el.offsetWidth, el.offsetHeight);
2921 // overrides Roo.dd.DragDrop
2922 b4MouseDown: function(e) {
2923 var x = e.getPageX();
2924 var y = e.getPageY();
2925 this.autoOffset(x, y);
2926 this.setDragElPos(x, y);
2929 // overrides Roo.dd.DragDrop
2930 b4StartDrag: function(x, y) {
2931 // show the drag frame
2932 this.showFrame(x, y);
2935 // overrides Roo.dd.DragDrop
2936 b4EndDrag: function(e) {
2937 Roo.fly(this.getDragEl()).hide();
2940 // overrides Roo.dd.DragDrop
2941 // By default we try to move the element to the last location of the frame.
2942 // This is so that the default behavior mirrors that of Roo.dd.DD.
2943 endDrag: function(e) {
2945 var lel = this.getEl();
2946 var del = this.getDragEl();
2948 // Show the drag frame briefly so we can get its position
2949 del.style.visibility = "";
2952 // Hide the linked element before the move to get around a Safari
2954 lel.style.visibility = "hidden";
2955 Roo.dd.DDM.moveToEl(lel, del);
2956 del.style.visibility = "hidden";
2957 lel.style.visibility = "";
2962 beforeMove : function(){
2966 afterDrag : function(){
2970 toString: function() {
2971 return ("DDProxy " + this.id);
2977 * Ext JS Library 1.1.1
2978 * Copyright(c) 2006-2007, Ext JS, LLC.
2980 * Originally Released Under LGPL - original licence link has changed is not relivant.
2983 * <script type="text/javascript">
2987 * @class Roo.dd.DDTarget
2988 * A DragDrop implementation that does not move, but can be a drop
2989 * target. You would get the same result by simply omitting implementation
2990 * for the event callbacks, but this way we reduce the processing cost of the
2991 * event listener and the callbacks.
2992 * @extends Roo.dd.DragDrop
2994 * @param {String} id the id of the element that is a drop target
2995 * @param {String} sGroup the group of related DragDrop objects
2996 * @param {object} config an object containing configurable attributes
2997 * Valid properties for DDTarget in addition to those in
3001 Roo.dd.DDTarget = function(id, sGroup, config) {
3003 this.initTarget(id, sGroup, config);
3005 if (config.listeners || config.events) {
3006 Roo.dd.DragDrop.superclass.constructor.call(this, {
3007 listeners : config.listeners || {},
3008 events : config.events || {}
3013 // Roo.dd.DDTarget.prototype = new Roo.dd.DragDrop();
3014 Roo.extend(Roo.dd.DDTarget, Roo.dd.DragDrop, {
3015 toString: function() {
3016 return ("DDTarget " + this.id);
3021 * Ext JS Library 1.1.1
3022 * Copyright(c) 2006-2007, Ext JS, LLC.
3024 * Originally Released Under LGPL - original licence link has changed is not relivant.
3027 * <script type="text/javascript">
3032 * @class Roo.dd.ScrollManager
3033 * Provides automatic scrolling of overflow regions in the page during drag operations.<br><br>
3034 * <b>Note: This class uses "Point Mode" and is untested in "Intersect Mode".</b>
3037 Roo.dd.ScrollManager = function(){
3038 var ddm = Roo.dd.DragDropMgr;
3043 var onStop = function(e){
3048 var triggerRefresh = function(){
3049 if(ddm.dragCurrent){
3050 ddm.refreshCache(ddm.dragCurrent.groups);
3054 var doScroll = function(){
3055 if(ddm.dragCurrent){
3056 var dds = Roo.dd.ScrollManager;
3058 if(proc.el.scroll(proc.dir, dds.increment)){
3062 proc.el.scroll(proc.dir, dds.increment, true, dds.animDuration, triggerRefresh);
3067 var clearProc = function(){
3069 clearInterval(proc.id);
3076 var startProc = function(el, dir){
3080 proc.id = setInterval(doScroll, Roo.dd.ScrollManager.frequency);
3083 var onFire = function(e, isDrop){
3084 if(isDrop || !ddm.dragCurrent){ return; }
3085 var dds = Roo.dd.ScrollManager;
3086 if(!dragEl || dragEl != ddm.dragCurrent){
3087 dragEl = ddm.dragCurrent;
3088 // refresh regions on drag start
3092 var xy = Roo.lib.Event.getXY(e);
3093 var pt = new Roo.lib.Point(xy[0], xy[1]);
3095 var el = els[id], r = el._region;
3096 if(r && r.contains(pt) && el.isScrollable()){
3097 if(r.bottom - pt.y <= dds.thresh){
3099 startProc(el, "down");
3102 }else if(r.right - pt.x <= dds.thresh){
3104 startProc(el, "left");
3107 }else if(pt.y - r.top <= dds.thresh){
3109 startProc(el, "up");
3112 }else if(pt.x - r.left <= dds.thresh){
3114 startProc(el, "right");
3123 ddm.fireEvents = ddm.fireEvents.createSequence(onFire, ddm);
3124 ddm.stopDrag = ddm.stopDrag.createSequence(onStop, ddm);
3128 * Registers new overflow element(s) to auto scroll
3129 * @param {String/HTMLElement/Element/Array} el The id of or the element to be scrolled or an array of either
3131 register : function(el){
3132 if(el instanceof Array){
3133 for(var i = 0, len = el.length; i < len; i++) {
3134 this.register(el[i]);
3143 * Unregisters overflow element(s) so they are no longer scrolled
3144 * @param {String/HTMLElement/Element/Array} el The id of or the element to be removed or an array of either
3146 unregister : function(el){
3147 if(el instanceof Array){
3148 for(var i = 0, len = el.length; i < len; i++) {
3149 this.unregister(el[i]);
3158 * The number of pixels from the edge of a container the pointer needs to be to
3159 * trigger scrolling (defaults to 25)
3165 * The number of pixels to scroll in each scroll increment (defaults to 50)
3171 * The frequency of scrolls in milliseconds (defaults to 500)
3177 * True to animate the scroll (defaults to true)
3183 * The animation duration in seconds -
3184 * MUST BE less than Roo.dd.ScrollManager.frequency! (defaults to .4)
3190 * Manually trigger a cache refresh.
3192 refreshCache : function(){
3194 if(typeof els[id] == 'object'){ // for people extending the object prototype
3195 els[id]._region = els[id].getRegion();
3202 * Ext JS Library 1.1.1
3203 * Copyright(c) 2006-2007, Ext JS, LLC.
3205 * Originally Released Under LGPL - original licence link has changed is not relivant.
3208 * <script type="text/javascript">
3213 * @class Roo.dd.Registry
3214 * Provides easy access to all drag drop components that are registered on a page. Items can be retrieved either
3215 * directly by DOM node id, or by passing in the drag drop event that occurred and looking up the event target.
3218 Roo.dd.Registry = function(){
3223 var getId = function(el, autogen){
3224 if(typeof el == "string"){
3228 if(!id && autogen !== false){
3229 id = "roodd-" + (++autoIdSeed);
3237 * Register a drag drop element
3238 * @param {String|HTMLElement} element The id or DOM node to register
3239 * @param {Object} data (optional) A custom data object that will be passed between the elements that are involved
3240 * in drag drop operations. You can populate this object with any arbitrary properties that your own code
3241 * knows how to interpret, plus there are some specific properties known to the Registry that should be
3242 * populated in the data object (if applicable):
3244 Value Description<br />
3245 --------- ------------------------------------------<br />
3246 handles Array of DOM nodes that trigger dragging<br />
3247 for the element being registered<br />
3248 isHandle True if the element passed in triggers<br />
3249 dragging itself, else false
3252 register : function(el, data){
3254 if(typeof el == "string"){
3255 el = document.getElementById(el);
3258 elements[getId(el)] = data;
3259 if(data.isHandle !== false){
3260 handles[data.ddel.id] = data;
3263 var hs = data.handles;
3264 for(var i = 0, len = hs.length; i < len; i++){
3265 handles[getId(hs[i])] = data;
3271 * Unregister a drag drop element
3272 * @param {String|HTMLElement} element The id or DOM node to unregister
3274 unregister : function(el){
3275 var id = getId(el, false);
3276 var data = elements[id];
3278 delete elements[id];
3280 var hs = data.handles;
3281 for(var i = 0, len = hs.length; i < len; i++){
3282 delete handles[getId(hs[i], false)];
3289 * Returns the handle registered for a DOM Node by id
3290 * @param {String|HTMLElement} id The DOM node or id to look up
3291 * @return {Object} handle The custom handle data
3293 getHandle : function(id){
3294 if(typeof id != "string"){ // must be element?
3301 * Returns the handle that is registered for the DOM node that is the target of the event
3302 * @param {Event} e The event
3303 * @return {Object} handle The custom handle data
3305 getHandleFromEvent : function(e){
3306 var t = Roo.lib.Event.getTarget(e);
3307 return t ? handles[t.id] : null;
3311 * Returns a custom data object that is registered for a DOM node by id
3312 * @param {String|HTMLElement} id The DOM node or id to look up
3313 * @return {Object} data The custom data
3315 getTarget : function(id){
3316 if(typeof id != "string"){ // must be element?
3319 return elements[id];
3323 * Returns a custom data object that is registered for the DOM node that is the target of the event
3324 * @param {Event} e The event
3325 * @return {Object} data The custom data
3327 getTargetFromEvent : function(e){
3328 var t = Roo.lib.Event.getTarget(e);
3329 return t ? elements[t.id] || handles[t.id] : null;
3334 * Ext JS Library 1.1.1
3335 * Copyright(c) 2006-2007, Ext JS, LLC.
3337 * Originally Released Under LGPL - original licence link has changed is not relivant.
3340 * <script type="text/javascript">
3345 * @class Roo.dd.StatusProxy
3346 * A specialized drag proxy that supports a drop status icon, {@link Roo.Layer} styles and auto-repair. This is the
3347 * default drag proxy used by all Roo.dd components.
3349 * @param {Object} config
3351 Roo.dd.StatusProxy = function(config){
3352 Roo.apply(this, config);
3353 this.id = this.id || Roo.id();
3354 this.el = new Roo.Layer({
3356 id: this.id, tag: "div", cls: "x-dd-drag-proxy "+this.dropNotAllowed, children: [
3357 {tag: "div", cls: "x-dd-drop-icon"},
3358 {tag: "div", cls: "x-dd-drag-ghost"}
3361 shadow: !config || config.shadow !== false
3363 this.ghost = Roo.get(this.el.dom.childNodes[1]);
3364 this.dropStatus = this.dropNotAllowed;
3367 Roo.dd.StatusProxy.prototype = {
3369 * @cfg {String} dropAllowed
3370 * The CSS class to apply to the status element when drop is allowed (defaults to "x-dd-drop-ok").
3372 dropAllowed : "x-dd-drop-ok",
3374 * @cfg {String} dropNotAllowed
3375 * The CSS class to apply to the status element when drop is not allowed (defaults to "x-dd-drop-nodrop").
3377 dropNotAllowed : "x-dd-drop-nodrop",
3380 * Updates the proxy's visual element to indicate the status of whether or not drop is allowed
3381 * over the current target element.
3382 * @param {String} cssClass The css class for the new drop status indicator image
3384 setStatus : function(cssClass){
3385 cssClass = cssClass || this.dropNotAllowed;
3386 if(this.dropStatus != cssClass){
3387 this.el.replaceClass(this.dropStatus, cssClass);
3388 this.dropStatus = cssClass;
3393 * Resets the status indicator to the default dropNotAllowed value
3394 * @param {Boolean} clearGhost True to also remove all content from the ghost, false to preserve it
3396 reset : function(clearGhost){
3397 this.el.dom.className = "x-dd-drag-proxy " + this.dropNotAllowed;
3398 this.dropStatus = this.dropNotAllowed;
3400 this.ghost.update("");
3405 * Updates the contents of the ghost element
3406 * @param {String} html The html that will replace the current innerHTML of the ghost element
3408 update : function(html){
3409 if(typeof html == "string"){
3410 this.ghost.update(html);
3412 this.ghost.update("");
3413 html.style.margin = "0";
3414 this.ghost.dom.appendChild(html);
3416 // ensure float = none set?? cant remember why though.
3417 var el = this.ghost.dom.firstChild;
3419 Roo.fly(el).setStyle('float', 'none');
3424 * Returns the underlying proxy {@link Roo.Layer}
3425 * @return {Roo.Layer} el
3432 * Returns the ghost element
3433 * @return {Roo.Element} el
3435 getGhost : function(){
3441 * @param {Boolean} clear True to reset the status and clear the ghost contents, false to preserve them
3443 hide : function(clear){
3451 * Stops the repair animation if it's currently running
3454 if(this.anim && this.anim.isAnimated && this.anim.isAnimated()){
3460 * Displays this proxy
3467 * Force the Layer to sync its shadow and shim positions to the element
3474 * Causes the proxy to return to its position of origin via an animation. Should be called after an
3475 * invalid drop operation by the item being dragged.
3476 * @param {Array} xy The XY position of the element ([x, y])
3477 * @param {Function} callback The function to call after the repair is complete
3478 * @param {Object} scope The scope in which to execute the callback
3480 repair : function(xy, callback, scope){
3481 this.callback = callback;
3483 if(xy && this.animRepair !== false){
3484 this.el.addClass("x-dd-drag-repair");
3485 this.el.hideUnders(true);
3486 this.anim = this.el.shift({
3487 duration: this.repairDuration || .5,
3491 callback: this.afterRepair,
3500 afterRepair : function(){
3502 if(typeof this.callback == "function"){
3503 this.callback.call(this.scope || this);
3505 this.callback = null;
3510 * Ext JS Library 1.1.1
3511 * Copyright(c) 2006-2007, Ext JS, LLC.
3513 * Originally Released Under LGPL - original licence link has changed is not relivant.
3516 * <script type="text/javascript">
3520 * @class Roo.dd.DragSource
3521 * @extends Roo.dd.DDProxy
3522 * A simple class that provides the basic implementation needed to make any element draggable.
3524 * @param {String/HTMLElement/Element} el The container element
3525 * @param {Object} config
3527 Roo.dd.DragSource = function(el, config){
3528 this.el = Roo.get(el);
3531 Roo.apply(this, config);
3534 this.proxy = new Roo.dd.StatusProxy();
3537 Roo.dd.DragSource.superclass.constructor.call(this, this.el.dom, this.ddGroup || this.group,
3538 {dragElId : this.proxy.id, resizeFrame: false, isTarget: false, scroll: this.scroll === true});
3540 this.dragging = false;
3543 Roo.extend(Roo.dd.DragSource, Roo.dd.DDProxy, {
3545 * @cfg {String} dropAllowed
3546 * The CSS class returned to the drag source when drop is allowed (defaults to "x-dd-drop-ok").
3548 dropAllowed : "x-dd-drop-ok",
3550 * @cfg {String} dropNotAllowed
3551 * The CSS class returned to the drag source when drop is not allowed (defaults to "x-dd-drop-nodrop").
3553 dropNotAllowed : "x-dd-drop-nodrop",
3556 * Returns the data object associated with this drag source
3557 * @return {Object} data An object containing arbitrary data
3559 getDragData : function(e){
3560 return this.dragData;
3564 onDragEnter : function(e, id){
3565 var target = Roo.dd.DragDropMgr.getDDById(id);
3566 this.cachedTarget = target;
3567 if(this.beforeDragEnter(target, e, id) !== false){
3568 if(target.isNotifyTarget){
3569 var status = target.notifyEnter(this, e, this.dragData);
3570 this.proxy.setStatus(status);
3572 this.proxy.setStatus(this.dropAllowed);
3575 if(this.afterDragEnter){
3577 * An empty function by default, but provided so that you can perform a custom action
3578 * when the dragged item enters the drop target by providing an implementation.
3579 * @param {Roo.dd.DragDrop} target The drop target
3580 * @param {Event} e The event object
3581 * @param {String} id The id of the dragged element
3582 * @method afterDragEnter
3584 this.afterDragEnter(target, e, id);
3590 * An empty function by default, but provided so that you can perform a custom action
3591 * before the dragged item enters the drop target and optionally cancel the onDragEnter.
3592 * @param {Roo.dd.DragDrop} target The drop target
3593 * @param {Event} e The event object
3594 * @param {String} id The id of the dragged element
3595 * @return {Boolean} isValid True if the drag event is valid, else false to cancel
3597 beforeDragEnter : function(target, e, id){
3602 alignElWithMouse: function() {
3603 Roo.dd.DragSource.superclass.alignElWithMouse.apply(this, arguments);
3608 onDragOver : function(e, id){
3609 var target = this.cachedTarget || Roo.dd.DragDropMgr.getDDById(id);
3610 if(this.beforeDragOver(target, e, id) !== false){
3611 if(target.isNotifyTarget){
3612 var status = target.notifyOver(this, e, this.dragData);
3613 this.proxy.setStatus(status);
3616 if(this.afterDragOver){
3618 * An empty function by default, but provided so that you can perform a custom action
3619 * while the dragged item is over the drop target by providing an implementation.
3620 * @param {Roo.dd.DragDrop} target The drop target
3621 * @param {Event} e The event object
3622 * @param {String} id The id of the dragged element
3623 * @method afterDragOver
3625 this.afterDragOver(target, e, id);
3631 * An empty function by default, but provided so that you can perform a custom action
3632 * while the dragged item is over the drop target and optionally cancel the onDragOver.
3633 * @param {Roo.dd.DragDrop} target The drop target
3634 * @param {Event} e The event object
3635 * @param {String} id The id of the dragged element
3636 * @return {Boolean} isValid True if the drag event is valid, else false to cancel
3638 beforeDragOver : function(target, e, id){
3643 onDragOut : function(e, id){
3644 var target = this.cachedTarget || Roo.dd.DragDropMgr.getDDById(id);
3645 if(this.beforeDragOut(target, e, id) !== false){
3646 if(target.isNotifyTarget){
3647 target.notifyOut(this, e, this.dragData);
3650 if(this.afterDragOut){
3652 * An empty function by default, but provided so that you can perform a custom action
3653 * after the dragged item is dragged out of the target without dropping.
3654 * @param {Roo.dd.DragDrop} target The drop target
3655 * @param {Event} e The event object
3656 * @param {String} id The id of the dragged element
3657 * @method afterDragOut
3659 this.afterDragOut(target, e, id);
3662 this.cachedTarget = null;
3666 * An empty function by default, but provided so that you can perform a custom action before the dragged
3667 * item is dragged out of the target without dropping, and optionally cancel the onDragOut.
3668 * @param {Roo.dd.DragDrop} target The drop target
3669 * @param {Event} e The event object
3670 * @param {String} id The id of the dragged element
3671 * @return {Boolean} isValid True if the drag event is valid, else false to cancel
3673 beforeDragOut : function(target, e, id){
3678 onDragDrop : function(e, id){
3679 var target = this.cachedTarget || Roo.dd.DragDropMgr.getDDById(id);
3680 if(this.beforeDragDrop(target, e, id) !== false){
3681 if(target.isNotifyTarget){
3682 if(target.notifyDrop(this, e, this.dragData)){ // valid drop?
3683 this.onValidDrop(target, e, id);
3685 this.onInvalidDrop(target, e, id);
3688 this.onValidDrop(target, e, id);
3691 if(this.afterDragDrop){
3693 * An empty function by default, but provided so that you can perform a custom action
3694 * after a valid drag drop has occurred by providing an implementation.
3695 * @param {Roo.dd.DragDrop} target The drop target
3696 * @param {Event} e The event object
3697 * @param {String} id The id of the dropped element
3698 * @method afterDragDrop
3700 this.afterDragDrop(target, e, id);
3703 delete this.cachedTarget;
3707 * An empty function by default, but provided so that you can perform a custom action before the dragged
3708 * item is dropped onto the target and optionally cancel the onDragDrop.
3709 * @param {Roo.dd.DragDrop} target The drop target
3710 * @param {Event} e The event object
3711 * @param {String} id The id of the dragged element
3712 * @return {Boolean} isValid True if the drag drop event is valid, else false to cancel
3714 beforeDragDrop : function(target, e, id){
3719 onValidDrop : function(target, e, id){
3721 if(this.afterValidDrop){
3723 * An empty function by default, but provided so that you can perform a custom action
3724 * after a valid drop has occurred by providing an implementation.
3725 * @param {Object} target The target DD
3726 * @param {Event} e The event object
3727 * @param {String} id The id of the dropped element
3728 * @method afterInvalidDrop
3730 this.afterValidDrop(target, e, id);
3735 getRepairXY : function(e, data){
3736 return this.el.getXY();
3740 onInvalidDrop : function(target, e, id){
3741 this.beforeInvalidDrop(target, e, id);
3742 if(this.cachedTarget){
3743 if(this.cachedTarget.isNotifyTarget){
3744 this.cachedTarget.notifyOut(this, e, this.dragData);
3746 this.cacheTarget = null;
3748 this.proxy.repair(this.getRepairXY(e, this.dragData), this.afterRepair, this);
3750 if(this.afterInvalidDrop){
3752 * An empty function by default, but provided so that you can perform a custom action
3753 * after an invalid drop has occurred by providing an implementation.
3754 * @param {Event} e The event object
3755 * @param {String} id The id of the dropped element
3756 * @method afterInvalidDrop
3758 this.afterInvalidDrop(e, id);
3763 afterRepair : function(){
3765 this.el.highlight(this.hlColor || "c3daf9");
3767 this.dragging = false;
3771 * An empty function by default, but provided so that you can perform a custom action after an invalid
3772 * drop has occurred.
3773 * @param {Roo.dd.DragDrop} target The drop target
3774 * @param {Event} e The event object
3775 * @param {String} id The id of the dragged element
3776 * @return {Boolean} isValid True if the invalid drop should proceed, else false to cancel
3778 beforeInvalidDrop : function(target, e, id){
3783 handleMouseDown : function(e){
3787 var data = this.getDragData(e);
3788 if(data && this.onBeforeDrag(data, e) !== false){
3789 this.dragData = data;
3791 Roo.dd.DragSource.superclass.handleMouseDown.apply(this, arguments);
3796 * An empty function by default, but provided so that you can perform a custom action before the initial
3797 * drag event begins and optionally cancel it.
3798 * @param {Object} data An object containing arbitrary data to be shared with drop targets
3799 * @param {Event} e The event object
3800 * @return {Boolean} isValid True if the drag event is valid, else false to cancel
3802 onBeforeDrag : function(data, e){
3807 * An empty function by default, but provided so that you can perform a custom action once the initial
3808 * drag event has begun. The drag cannot be canceled from this function.
3809 * @param {Number} x The x position of the click on the dragged object
3810 * @param {Number} y The y position of the click on the dragged object
3812 onStartDrag : Roo.emptyFn,
3814 // private - YUI override
3815 startDrag : function(x, y){
3817 this.dragging = true;
3818 this.proxy.update("");
3819 this.onInitDrag(x, y);
3824 onInitDrag : function(x, y){
3825 var clone = this.el.dom.cloneNode(true);
3826 clone.id = Roo.id(); // prevent duplicate ids
3827 this.proxy.update(clone);
3828 this.onStartDrag(x, y);
3833 * Returns the drag source's underlying {@link Roo.dd.StatusProxy}
3834 * @return {Roo.dd.StatusProxy} proxy The StatusProxy
3836 getProxy : function(){
3841 * Hides the drag source's {@link Roo.dd.StatusProxy}
3843 hideProxy : function(){
3845 this.proxy.reset(true);
3846 this.dragging = false;
3850 triggerCacheRefresh : function(){
3851 Roo.dd.DDM.refreshCache(this.groups);
3854 // private - override to prevent hiding
3855 b4EndDrag: function(e) {
3858 // private - override to prevent moving
3859 endDrag : function(e){
3860 this.onEndDrag(this.dragData, e);
3864 onEndDrag : function(data, e){
3867 // private - pin to cursor
3868 autoOffset : function(x, y) {
3869 this.setDelta(-12, -20);
3873 * Ext JS Library 1.1.1
3874 * Copyright(c) 2006-2007, Ext JS, LLC.
3876 * Originally Released Under LGPL - original licence link has changed is not relivant.
3879 * <script type="text/javascript">
3884 * @class Roo.dd.DropTarget
3885 * @extends Roo.dd.DDTarget
3886 * A simple class that provides the basic implementation needed to make any element a drop target that can have
3887 * draggable items dropped onto it. The drop has no effect until an implementation of notifyDrop is provided.
3889 * @param {String/HTMLElement/Element} el The container element
3890 * @param {Object} config
3892 Roo.dd.DropTarget = function(el, config){
3893 this.el = Roo.get(el);
3895 var listeners = false; ;
3896 if (config && config.listeners) {
3897 listeners= config.listeners;
3898 delete config.listeners;
3900 Roo.apply(this, config);
3902 if(this.containerScroll){
3903 Roo.dd.ScrollManager.register(this.el);
3907 * @scope Roo.dd.DropTarget
3912 * The function a {@link Roo.dd.DragSource} calls once to notify this drop target that the source is now over the
3913 * target. This default implementation adds the CSS class specified by overClass (if any) to the drop element
3914 * and returns the dropAllowed config value. This method should be overridden if drop validation is required.
3916 * IMPORTANT : it should set this.overClass and this.dropAllowed
3918 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
3919 * @param {Event} e The event
3920 * @param {Object} data An object containing arbitrary data supplied by the drag source
3926 * The function a {@link Roo.dd.DragSource} calls continuously while it is being dragged over the target.
3927 * This method will be called on every mouse movement while the drag source is over the drop target.
3928 * This default implementation simply returns the dropAllowed config value.
3930 * IMPORTANT : it should set this.dropAllowed
3932 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
3933 * @param {Event} e The event
3934 * @param {Object} data An object containing arbitrary data supplied by the drag source
3940 * The function a {@link Roo.dd.DragSource} calls once to notify this drop target that the source has been dragged
3941 * out of the target without dropping. This default implementation simply removes the CSS class specified by
3942 * overClass (if any) from the drop element.
3943 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
3944 * @param {Event} e The event
3945 * @param {Object} data An object containing arbitrary data supplied by the drag source
3951 * The function a {@link Roo.dd.DragSource} calls once to notify this drop target that the dragged item has
3952 * been dropped on it. This method has no default implementation and returns false, so you must provide an
3953 * implementation that does something to process the drop event and returns true so that the drag source's
3954 * repair action does not run.
3956 * IMPORTANT : it should set this.success
3958 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
3959 * @param {Event} e The event
3960 * @param {Object} data An object containing arbitrary data supplied by the drag source
3966 Roo.dd.DropTarget.superclass.constructor.call( this,
3968 this.ddGroup || this.group,
3971 listeners : listeners || {}
3979 Roo.extend(Roo.dd.DropTarget, Roo.dd.DDTarget, {
3981 * @cfg {String} overClass
3982 * The CSS class applied to the drop target element while the drag source is over it (defaults to "").
3985 * @cfg {String} ddGroup
3986 * The drag drop group to handle drop events for
3990 * @cfg {String} dropAllowed
3991 * The CSS class returned to the drag source when drop is allowed (defaults to "x-dd-drop-ok").
3993 dropAllowed : "x-dd-drop-ok",
3995 * @cfg {String} dropNotAllowed
3996 * The CSS class returned to the drag source when drop is not allowed (defaults to "x-dd-drop-nodrop").
3998 dropNotAllowed : "x-dd-drop-nodrop",
4000 * @cfg {boolean} success
4001 * set this after drop listener..
4005 * @cfg {boolean|String} valid true/false or string (ok-add/ok-sub/ok/nodrop)
4006 * if the drop point is valid for over/enter..
4013 isNotifyTarget : true,
4018 notifyEnter : function(dd, e, data)
4021 this.fireEvent('enter', dd, e, data);
4023 this.el.addClass(this.overClass);
4025 return typeof(this.valid) == 'string' ? 'x-dd-drop-' + this.valid : (
4026 this.valid ? this.dropAllowed : this.dropNotAllowed
4033 notifyOver : function(dd, e, data)
4036 this.fireEvent('over', dd, e, data);
4037 return typeof(this.valid) == 'string' ? 'x-dd-drop-' + this.valid : (
4038 this.valid ? this.dropAllowed : this.dropNotAllowed
4045 notifyOut : function(dd, e, data)
4047 this.fireEvent('out', dd, e, data);
4049 this.el.removeClass(this.overClass);
4056 notifyDrop : function(dd, e, data)
4058 this.success = false;
4059 this.fireEvent('drop', dd, e, data);
4060 return this.success;
4064 * Ext JS Library 1.1.1
4065 * Copyright(c) 2006-2007, Ext JS, LLC.
4067 * Originally Released Under LGPL - original licence link has changed is not relivant.
4070 * <script type="text/javascript">
4075 * @class Roo.dd.DragZone
4076 * @extends Roo.dd.DragSource
4077 * This class provides a container DD instance that proxies for multiple child node sources.<br />
4078 * By default, this class requires that draggable child nodes are registered with {@link Roo.dd.Registry}.
4080 * @param {String/HTMLElement/Element} el The container element
4081 * @param {Object} config
4083 Roo.dd.DragZone = function(el, config){
4084 Roo.dd.DragZone.superclass.constructor.call(this, el, config);
4085 if(this.containerScroll){
4086 Roo.dd.ScrollManager.register(this.el);
4090 Roo.extend(Roo.dd.DragZone, Roo.dd.DragSource, {
4092 * @cfg {Boolean} containerScroll True to register this container with the Scrollmanager
4093 * for auto scrolling during drag operations.
4096 * @cfg {String} hlColor The color to use when visually highlighting the drag source in the afterRepair
4097 * method after a failed drop (defaults to "c3daf9" - light blue)
4101 * Called when a mousedown occurs in this container. Looks in {@link Roo.dd.Registry}
4102 * for a valid target to drag based on the mouse down. Override this method
4103 * to provide your own lookup logic (e.g. finding a child by class name). Make sure your returned
4104 * object has a "ddel" attribute (with an HTML Element) for other functions to work.
4105 * @param {EventObject} e The mouse down event
4106 * @return {Object} The dragData
4108 getDragData : function(e){
4109 return Roo.dd.Registry.getHandleFromEvent(e);
4113 * Called once drag threshold has been reached to initialize the proxy element. By default, it clones the
4114 * this.dragData.ddel
4115 * @param {Number} x The x position of the click on the dragged object
4116 * @param {Number} y The y position of the click on the dragged object
4117 * @return {Boolean} true to continue the drag, false to cancel
4119 onInitDrag : function(x, y){
4120 this.proxy.update(this.dragData.ddel.cloneNode(true));
4121 this.onStartDrag(x, y);
4126 * Called after a repair of an invalid drop. By default, highlights this.dragData.ddel
4128 afterRepair : function(){
4130 Roo.Element.fly(this.dragData.ddel).highlight(this.hlColor || "c3daf9");
4132 this.dragging = false;
4136 * Called before a repair of an invalid drop to get the XY to animate to. By default returns
4137 * the XY of this.dragData.ddel
4138 * @param {EventObject} e The mouse up event
4139 * @return {Array} The xy location (e.g. [100, 200])
4141 getRepairXY : function(e){
4142 return Roo.Element.fly(this.dragData.ddel).getXY();
4146 * Ext JS Library 1.1.1
4147 * Copyright(c) 2006-2007, Ext JS, LLC.
4149 * Originally Released Under LGPL - original licence link has changed is not relivant.
4152 * <script type="text/javascript">
4155 * @class Roo.dd.DropZone
4156 * @extends Roo.dd.DropTarget
4157 * This class provides a container DD instance that proxies for multiple child node targets.<br />
4158 * By default, this class requires that child nodes accepting drop are registered with {@link Roo.dd.Registry}.
4160 * @param {String/HTMLElement/Element} el The container element
4161 * @param {Object} config
4163 Roo.dd.DropZone = function(el, config){
4164 Roo.dd.DropZone.superclass.constructor.call(this, el, config);
4167 Roo.extend(Roo.dd.DropZone, Roo.dd.DropTarget, {
4169 * Returns a custom data object associated with the DOM node that is the target of the event. By default
4170 * this looks up the event target in the {@link Roo.dd.Registry}, although you can override this method to
4171 * provide your own custom lookup.
4172 * @param {Event} e The event
4173 * @return {Object} data The custom data
4175 getTargetFromEvent : function(e){
4176 return Roo.dd.Registry.getTargetFromEvent(e);
4180 * Called internally when the DropZone determines that a {@link Roo.dd.DragSource} has entered a drop node
4181 * that it has registered. This method has no default implementation and should be overridden to provide
4182 * node-specific processing if necessary.
4183 * @param {Object} nodeData The custom data associated with the drop node (this is the same value returned from
4184 * {@link #getTargetFromEvent} for this node)
4185 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
4186 * @param {Event} e The event
4187 * @param {Object} data An object containing arbitrary data supplied by the drag source
4189 onNodeEnter : function(n, dd, e, data){
4194 * Called internally while the DropZone determines that a {@link Roo.dd.DragSource} is over a drop node
4195 * that it has registered. The default implementation returns this.dropNotAllowed, so it should be
4196 * overridden to provide the proper feedback.
4197 * @param {Object} nodeData The custom data associated with the drop node (this is the same value returned from
4198 * {@link #getTargetFromEvent} for this node)
4199 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
4200 * @param {Event} e The event
4201 * @param {Object} data An object containing arbitrary data supplied by the drag source
4202 * @return {String} status The CSS class that communicates the drop status back to the source so that the
4203 * underlying {@link Roo.dd.StatusProxy} can be updated
4205 onNodeOver : function(n, dd, e, data){
4206 return this.dropAllowed;
4210 * Called internally when the DropZone determines that a {@link Roo.dd.DragSource} has been dragged out of
4211 * the drop node without dropping. This method has no default implementation and should be overridden to provide
4212 * node-specific processing if necessary.
4213 * @param {Object} nodeData The custom data associated with the drop node (this is the same value returned from
4214 * {@link #getTargetFromEvent} for this node)
4215 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
4216 * @param {Event} e The event
4217 * @param {Object} data An object containing arbitrary data supplied by the drag source
4219 onNodeOut : function(n, dd, e, data){
4224 * Called internally when the DropZone determines that a {@link Roo.dd.DragSource} has been dropped onto
4225 * the drop node. The default implementation returns false, so it should be overridden to provide the
4226 * appropriate processing of the drop event and return true so that the drag source's repair action does not run.
4227 * @param {Object} nodeData The custom data associated with the drop node (this is the same value returned from
4228 * {@link #getTargetFromEvent} for this node)
4229 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
4230 * @param {Event} e The event
4231 * @param {Object} data An object containing arbitrary data supplied by the drag source
4232 * @return {Boolean} True if the drop was valid, else false
4234 onNodeDrop : function(n, dd, e, data){
4239 * Called internally while the DropZone determines that a {@link Roo.dd.DragSource} is being dragged over it,
4240 * but not over any of its registered drop nodes. The default implementation returns this.dropNotAllowed, so
4241 * it should be overridden to provide the proper feedback if necessary.
4242 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
4243 * @param {Event} e The event
4244 * @param {Object} data An object containing arbitrary data supplied by the drag source
4245 * @return {String} status The CSS class that communicates the drop status back to the source so that the
4246 * underlying {@link Roo.dd.StatusProxy} can be updated
4248 onContainerOver : function(dd, e, data){
4249 return this.dropNotAllowed;
4253 * Called internally when the DropZone determines that a {@link Roo.dd.DragSource} has been dropped on it,
4254 * but not on any of its registered drop nodes. The default implementation returns false, so it should be
4255 * overridden to provide the appropriate processing of the drop event if you need the drop zone itself to
4256 * be able to accept drops. It should return true when valid so that the drag source's repair action does not run.
4257 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
4258 * @param {Event} e The event
4259 * @param {Object} data An object containing arbitrary data supplied by the drag source
4260 * @return {Boolean} True if the drop was valid, else false
4262 onContainerDrop : function(dd, e, data){
4267 * The function a {@link Roo.dd.DragSource} calls once to notify this drop zone that the source is now over
4268 * the zone. The default implementation returns this.dropNotAllowed and expects that only registered drop
4269 * nodes can process drag drop operations, so if you need the drop zone itself to be able to process drops
4270 * you should override this method and provide a custom implementation.
4271 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
4272 * @param {Event} e The event
4273 * @param {Object} data An object containing arbitrary data supplied by the drag source
4274 * @return {String} status The CSS class that communicates the drop status back to the source so that the
4275 * underlying {@link Roo.dd.StatusProxy} can be updated
4277 notifyEnter : function(dd, e, data){
4278 return this.dropNotAllowed;
4282 * The function a {@link Roo.dd.DragSource} calls continuously while it is being dragged over the drop zone.
4283 * This method will be called on every mouse movement while the drag source is over the drop zone.
4284 * It will call {@link #onNodeOver} while the drag source is over a registered node, and will also automatically
4285 * delegate to the appropriate node-specific methods as necessary when the drag source enters and exits
4286 * registered nodes ({@link #onNodeEnter}, {@link #onNodeOut}). If the drag source is not currently over a
4287 * registered node, it will call {@link #onContainerOver}.
4288 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
4289 * @param {Event} e The event
4290 * @param {Object} data An object containing arbitrary data supplied by the drag source
4291 * @return {String} status The CSS class that communicates the drop status back to the source so that the
4292 * underlying {@link Roo.dd.StatusProxy} can be updated
4294 notifyOver : function(dd, e, data){
4295 var n = this.getTargetFromEvent(e);
4296 if(!n){ // not over valid drop target
4297 if(this.lastOverNode){
4298 this.onNodeOut(this.lastOverNode, dd, e, data);
4299 this.lastOverNode = null;
4301 return this.onContainerOver(dd, e, data);
4303 if(this.lastOverNode != n){
4304 if(this.lastOverNode){
4305 this.onNodeOut(this.lastOverNode, dd, e, data);
4307 this.onNodeEnter(n, dd, e, data);
4308 this.lastOverNode = n;
4310 return this.onNodeOver(n, dd, e, data);
4314 * The function a {@link Roo.dd.DragSource} calls once to notify this drop zone that the source has been dragged
4315 * out of the zone without dropping. If the drag source is currently over a registered node, the notification
4316 * will be delegated to {@link #onNodeOut} for node-specific handling, otherwise it will be ignored.
4317 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop target
4318 * @param {Event} e The event
4319 * @param {Object} data An object containing arbitrary data supplied by the drag zone
4321 notifyOut : function(dd, e, data){
4322 if(this.lastOverNode){
4323 this.onNodeOut(this.lastOverNode, dd, e, data);
4324 this.lastOverNode = null;
4329 * The function a {@link Roo.dd.DragSource} calls once to notify this drop zone that the dragged item has
4330 * been dropped on it. The drag zone will look up the target node based on the event passed in, and if there
4331 * is a node registered for that event, it will delegate to {@link #onNodeDrop} for node-specific handling,
4332 * otherwise it will call {@link #onContainerDrop}.
4333 * @param {Roo.dd.DragSource} source The drag source that was dragged over this drop zone
4334 * @param {Event} e The event
4335 * @param {Object} data An object containing arbitrary data supplied by the drag source
4336 * @return {Boolean} True if the drop was valid, else false
4338 notifyDrop : function(dd, e, data){
4339 if(this.lastOverNode){
4340 this.onNodeOut(this.lastOverNode, dd, e, data);
4341 this.lastOverNode = null;
4343 var n = this.getTargetFromEvent(e);
4345 this.onNodeDrop(n, dd, e, data) :
4346 this.onContainerDrop(dd, e, data);
4350 triggerCacheRefresh : function(){
4351 Roo.dd.DDM.refreshCache(this.groups);
4355 * Ext JS Library 1.1.1
4356 * Copyright(c) 2006-2007, Ext JS, LLC.
4358 * Originally Released Under LGPL - original licence link has changed is not relivant.
4361 * <script type="text/javascript">
4366 * @class Roo.data.SortTypes
4368 * Defines the default sorting (casting?) comparison functions used when sorting data.
4370 Roo.data.SortTypes = {
4372 * Default sort that does nothing
4373 * @param {Mixed} s The value being converted
4374 * @return {Mixed} The comparison value
4381 * The regular expression used to strip tags
4385 stripTagsRE : /<\/?[^>]+>/gi,
4388 * Strips all HTML tags to sort on text only
4389 * @param {Mixed} s The value being converted
4390 * @return {String} The comparison value
4392 asText : function(s){
4393 return String(s).replace(this.stripTagsRE, "");
4397 * Strips all HTML tags to sort on text only - Case insensitive
4398 * @param {Mixed} s The value being converted
4399 * @return {String} The comparison value
4401 asUCText : function(s){
4402 return String(s).toUpperCase().replace(this.stripTagsRE, "");
4406 * Case insensitive string
4407 * @param {Mixed} s The value being converted
4408 * @return {String} The comparison value
4410 asUCString : function(s) {
4411 return String(s).toUpperCase();
4416 * @param {Mixed} s The value being converted
4417 * @return {Number} The comparison value
4419 asDate : function(s) {
4423 if(s instanceof Date){
4426 return Date.parse(String(s));
4431 * @param {Mixed} s The value being converted
4432 * @return {Float} The comparison value
4434 asFloat : function(s) {
4435 var val = parseFloat(String(s).replace(/,/g, ""));
4436 if(isNaN(val)) val = 0;
4442 * @param {Mixed} s The value being converted
4443 * @return {Number} The comparison value
4445 asInt : function(s) {
4446 var val = parseInt(String(s).replace(/,/g, ""));
4447 if(isNaN(val)) val = 0;
4452 * Ext JS Library 1.1.1
4453 * Copyright(c) 2006-2007, Ext JS, LLC.
4455 * Originally Released Under LGPL - original licence link has changed is not relivant.
4458 * <script type="text/javascript">
4462 * @class Roo.data.Record
4463 * Instances of this class encapsulate both record <em>definition</em> information, and record
4464 * <em>value</em> information for use in {@link Roo.data.Store} objects, or any code which needs
4465 * to access Records cached in an {@link Roo.data.Store} object.<br>
4467 * Constructors for this class are generated by passing an Array of field definition objects to {@link #create}.
4468 * Instances are usually only created by {@link Roo.data.Reader} implementations when processing unformatted data
4471 * Record objects generated by this constructor inherit all the methods of Roo.data.Record listed below.
4473 * This constructor should not be used to create Record objects. Instead, use the constructor generated by
4474 * {@link #create}. The parameters are the same.
4475 * @param {Array} data An associative Array of data values keyed by the field name.
4476 * @param {Object} id (Optional) The id of the record. This id should be unique, and is used by the
4477 * {@link Roo.data.Store} object which owns the Record to index its collection of Records. If
4478 * not specified an integer id is generated.
4480 Roo.data.Record = function(data, id){
4481 this.id = (id || id === 0) ? id : ++Roo.data.Record.AUTO_ID;
4486 * Generate a constructor for a specific record layout.
4487 * @param {Array} o An Array of field definition objects which specify field names, and optionally,
4488 * data types, and a mapping for an {@link Roo.data.Reader} to extract the field's value from a data object.
4489 * Each field definition object may contain the following properties: <ul>
4490 * <li><b>name</b> : String<p style="margin-left:1em">The name by which the field is referenced within the Record. This is referenced by,
4491 * for example the <em>dataIndex</em> property in column definition objects passed to {@link Roo.grid.ColumnModel}</p></li>
4492 * <li><b>mapping</b> : String<p style="margin-left:1em">(Optional) A path specification for use by the {@link Roo.data.Reader} implementation
4493 * that is creating the Record to access the data value from the data object. If an {@link Roo.data.JsonReader}
4494 * is being used, then this is a string containing the javascript expression to reference the data relative to
4495 * the record item's root. If an {@link Roo.data.XmlReader} is being used, this is an {@link Roo.DomQuery} path
4496 * to the data item relative to the record element. If the mapping expression is the same as the field name,
4497 * this may be omitted.</p></li>
4498 * <li><b>type</b> : String<p style="margin-left:1em">(Optional) The data type for conversion to displayable value. Possible values are
4499 * <ul><li>auto (Default, implies no conversion)</li>
4504 * <li>date</li></ul></p></li>
4505 * <li><b>sortType</b> : Mixed<p style="margin-left:1em">(Optional) A member of {@link Roo.data.SortTypes}.</p></li>
4506 * <li><b>sortDir</b> : String<p style="margin-left:1em">(Optional) Initial direction to sort. "ASC" or "DESC"</p></li>
4507 * <li><b>convert</b> : Function<p style="margin-left:1em">(Optional) A function which converts the value provided
4508 * by the Reader into an object that will be stored in the Record. It is passed the
4509 * following parameters:<ul>
4510 * <li><b>v</b> : Mixed<p style="margin-left:1em">The data value as read by the Reader.</p></li>
4512 * <li><b>dateFormat</b> : String<p style="margin-left:1em">(Optional) A format String for the Date.parseDate function.</p></li>
4514 * <br>usage:<br><pre><code>
4515 var TopicRecord = Roo.data.Record.create(
4516 {name: 'title', mapping: 'topic_title'},
4517 {name: 'author', mapping: 'username'},
4518 {name: 'totalPosts', mapping: 'topic_replies', type: 'int'},
4519 {name: 'lastPost', mapping: 'post_time', type: 'date'},
4520 {name: 'lastPoster', mapping: 'user2'},
4521 {name: 'excerpt', mapping: 'post_text'}
4524 var myNewRecord = new TopicRecord({
4525 title: 'Do my job please',
4528 lastPost: new Date(),
4529 lastPoster: 'Animal',
4530 excerpt: 'No way dude!'
4532 myStore.add(myNewRecord);
4537 Roo.data.Record.create = function(o){
4539 f.superclass.constructor.apply(this, arguments);
4541 Roo.extend(f, Roo.data.Record);
4542 var p = f.prototype;
4543 p.fields = new Roo.util.MixedCollection(false, function(field){
4546 for(var i = 0, len = o.length; i < len; i++){
4547 p.fields.add(new Roo.data.Field(o[i]));
4549 f.getField = function(name){
4550 return p.fields.get(name);
4555 Roo.data.Record.AUTO_ID = 1000;
4556 Roo.data.Record.EDIT = 'edit';
4557 Roo.data.Record.REJECT = 'reject';
4558 Roo.data.Record.COMMIT = 'commit';
4560 Roo.data.Record.prototype = {
4562 * Readonly flag - true if this record has been modified.
4571 join : function(store){
4576 * Set the named field to the specified value.
4577 * @param {String} name The name of the field to set.
4578 * @param {Object} value The value to set the field to.
4580 set : function(name, value){
4581 if(this.data[name] == value){
4588 if(typeof this.modified[name] == 'undefined'){
4589 this.modified[name] = this.data[name];
4591 this.data[name] = value;
4592 if(!this.editing && this.store){
4593 this.store.afterEdit(this);
4598 * Get the value of the named field.
4599 * @param {String} name The name of the field to get the value of.
4600 * @return {Object} The value of the field.
4602 get : function(name){
4603 return this.data[name];
4607 beginEdit : function(){
4608 this.editing = true;
4613 cancelEdit : function(){
4614 this.editing = false;
4615 delete this.modified;
4619 endEdit : function(){
4620 this.editing = false;
4621 if(this.dirty && this.store){
4622 this.store.afterEdit(this);
4627 * Usually called by the {@link Roo.data.Store} which owns the Record.
4628 * Rejects all changes made to the Record since either creation, or the last commit operation.
4629 * Modified fields are reverted to their original values.
4631 * Developers should subscribe to the {@link Roo.data.Store#update} event to have their code notified
4632 * of reject operations.
4634 reject : function(){
4635 var m = this.modified;
4637 if(typeof m[n] != "function"){
4638 this.data[n] = m[n];
4642 delete this.modified;
4643 this.editing = false;
4645 this.store.afterReject(this);
4650 * Usually called by the {@link Roo.data.Store} which owns the Record.
4651 * Commits all changes made to the Record since either creation, or the last commit operation.
4653 * Developers should subscribe to the {@link Roo.data.Store#update} event to have their code notified
4654 * of commit operations.
4656 commit : function(){
4658 delete this.modified;
4659 this.editing = false;
4661 this.store.afterCommit(this);
4666 hasError : function(){
4667 return this.error != null;
4671 clearError : function(){
4676 * Creates a copy of this record.
4677 * @param {String} id (optional) A new record id if you don't want to use this record's id
4680 copy : function(newId) {
4681 return new this.constructor(Roo.apply({}, this.data), newId || this.id);
4685 * Ext JS Library 1.1.1
4686 * Copyright(c) 2006-2007, Ext JS, LLC.
4688 * Originally Released Under LGPL - original licence link has changed is not relivant.
4691 * <script type="text/javascript">
4697 * @class Roo.data.Store
4698 * @extends Roo.util.Observable
4699 * The Store class encapsulates a client side cache of {@link Roo.data.Record} objects which provide input data
4700 * for widgets such as the Roo.grid.Grid, or the Roo.form.ComboBox.<br>
4702 * A Store object uses an implementation of {@link Roo.data.DataProxy} to access a data object unless you call loadData() directly and pass in your data. The Store object
4703 * has no knowledge of the format of the data returned by the Proxy.<br>
4705 * A Store object uses its configured implementation of {@link Roo.data.DataReader} to create {@link Roo.data.Record}
4706 * instances from the data object. These records are cached and made available through accessor functions.
4708 * Creates a new Store.
4709 * @param {Object} config A config object containing the objects needed for the Store to access data,
4710 * and read the data into Records.
4712 Roo.data.Store = function(config){
4713 this.data = new Roo.util.MixedCollection(false);
4714 this.data.getKey = function(o){
4717 this.baseParams = {};
4724 "multisort" : "_multisort"
4727 if(config && config.data){
4728 this.inlineData = config.data;
4732 Roo.apply(this, config);
4734 if(this.reader){ // reader passed
4735 this.reader = Roo.factory(this.reader, Roo.data);
4736 this.reader.xmodule = this.xmodule || false;
4737 if(!this.recordType){
4738 this.recordType = this.reader.recordType;
4740 if(this.reader.onMetaChange){
4741 this.reader.onMetaChange = this.onMetaChange.createDelegate(this);
4745 if(this.recordType){
4746 this.fields = this.recordType.prototype.fields;
4752 * @event datachanged
4753 * Fires when the data cache has changed, and a widget which is using this Store
4754 * as a Record cache should refresh its view.
4755 * @param {Store} this
4760 * Fires when this store's reader provides new metadata (fields). This is currently only support for JsonReaders.
4761 * @param {Store} this
4762 * @param {Object} meta The JSON metadata
4767 * Fires when Records have been added to the Store
4768 * @param {Store} this
4769 * @param {Roo.data.Record[]} records The array of Records added
4770 * @param {Number} index The index at which the record(s) were added
4775 * Fires when a Record has been removed from the Store
4776 * @param {Store} this
4777 * @param {Roo.data.Record} record The Record that was removed
4778 * @param {Number} index The index at which the record was removed
4783 * Fires when a Record has been updated
4784 * @param {Store} this
4785 * @param {Roo.data.Record} record The Record that was updated
4786 * @param {String} operation The update operation being performed. Value may be one of:
4788 Roo.data.Record.EDIT
4789 Roo.data.Record.REJECT
4790 Roo.data.Record.COMMIT
4796 * Fires when the data cache has been cleared.
4797 * @param {Store} this
4802 * Fires before a request is made for a new data object. If the beforeload handler returns false
4803 * the load action will be canceled.
4804 * @param {Store} this
4805 * @param {Object} options The loading options that were specified (see {@link #load} for details)
4810 * Fires after a new set of Records has been loaded.
4811 * @param {Store} this
4812 * @param {Roo.data.Record[]} records The Records that were loaded
4813 * @param {Object} options The loading options that were specified (see {@link #load} for details)
4817 * @event loadexception
4818 * Fires if an exception occurs in the Proxy during loading.
4819 * Called with the signature of the Proxy's "loadexception" event.
4820 * If you return Json { data: [] , success: false, .... } then this will be thrown with the following args
4823 * @param {Object} return from JsonData.reader() - success, totalRecords, records
4824 * @param {Object} load options
4825 * @param {Object} jsonData from your request (normally this contains the Exception)
4827 loadexception : true
4831 this.proxy = Roo.factory(this.proxy, Roo.data);
4832 this.proxy.xmodule = this.xmodule || false;
4833 this.relayEvents(this.proxy, ["loadexception"]);
4835 this.sortToggle = {};
4836 this.sortOrder = []; // array of order of sorting - updated by grid if multisort is enabled.
4838 Roo.data.Store.superclass.constructor.call(this);
4840 if(this.inlineData){
4841 this.loadData(this.inlineData);
4842 delete this.inlineData;
4845 Roo.extend(Roo.data.Store, Roo.util.Observable, {
4847 * @cfg {boolean} isLocal flag if data is locally available (and can be always looked up
4848 * without a remote query - used by combo/forms at present.
4852 * @cfg {Roo.data.DataProxy} proxy The Proxy object which provides access to a data object.
4855 * @cfg {Array} data Inline data to be loaded when the store is initialized.
4858 * @cfg {Roo.data.Reader} reader The Reader object which processes the data object and returns
4859 * an Array of Roo.data.record objects which are cached keyed by their <em>id</em> property.
4862 * @cfg {Object} baseParams An object containing properties which are to be sent as parameters
4863 * on any HTTP request
4866 * @cfg {Object} sortInfo A config object in the format: {field: "fieldName", direction: "ASC|DESC"}
4869 * @cfg {Boolean} multiSort enable multi column sorting (sort is based on the order of columns, remote only at present)
4873 * @cfg {boolean} remoteSort True if sorting is to be handled by requesting the Proxy to provide a refreshed
4874 * version of the data object in sorted order, as opposed to sorting the Record cache in place (defaults to false).
4879 * @cfg {boolean} pruneModifiedRecords True to clear all modified record information each time the store is
4880 * loaded or when a record is removed. (defaults to false).
4882 pruneModifiedRecords : false,
4888 * Add Records to the Store and fires the add event.
4889 * @param {Roo.data.Record[]} records An Array of Roo.data.Record objects to add to the cache.
4891 add : function(records){
4892 records = [].concat(records);
4893 for(var i = 0, len = records.length; i < len; i++){
4894 records[i].join(this);
4896 var index = this.data.length;
4897 this.data.addAll(records);
4898 this.fireEvent("add", this, records, index);
4902 * Remove a Record from the Store and fires the remove event.
4903 * @param {Ext.data.Record} record The Roo.data.Record object to remove from the cache.
4905 remove : function(record){
4906 var index = this.data.indexOf(record);
4907 this.data.removeAt(index);
4908 if(this.pruneModifiedRecords){
4909 this.modified.remove(record);
4911 this.fireEvent("remove", this, record, index);
4915 * Remove all Records from the Store and fires the clear event.
4917 removeAll : function(){
4919 if(this.pruneModifiedRecords){
4922 this.fireEvent("clear", this);
4926 * Inserts Records to the Store at the given index and fires the add event.
4927 * @param {Number} index The start index at which to insert the passed Records.
4928 * @param {Roo.data.Record[]} records An Array of Roo.data.Record objects to add to the cache.
4930 insert : function(index, records){
4931 records = [].concat(records);
4932 for(var i = 0, len = records.length; i < len; i++){
4933 this.data.insert(index, records[i]);
4934 records[i].join(this);
4936 this.fireEvent("add", this, records, index);
4940 * Get the index within the cache of the passed Record.
4941 * @param {Roo.data.Record} record The Roo.data.Record object to to find.
4942 * @return {Number} The index of the passed Record. Returns -1 if not found.
4944 indexOf : function(record){
4945 return this.data.indexOf(record);
4949 * Get the index within the cache of the Record with the passed id.
4950 * @param {String} id The id of the Record to find.
4951 * @return {Number} The index of the Record. Returns -1 if not found.
4953 indexOfId : function(id){
4954 return this.data.indexOfKey(id);
4958 * Get the Record with the specified id.
4959 * @param {String} id The id of the Record to find.
4960 * @return {Roo.data.Record} The Record with the passed id. Returns undefined if not found.
4962 getById : function(id){
4963 return this.data.key(id);
4967 * Get the Record at the specified index.
4968 * @param {Number} index The index of the Record to find.
4969 * @return {Roo.data.Record} The Record at the passed index. Returns undefined if not found.
4971 getAt : function(index){
4972 return this.data.itemAt(index);
4976 * Returns a range of Records between specified indices.
4977 * @param {Number} startIndex (optional) The starting index (defaults to 0)
4978 * @param {Number} endIndex (optional) The ending index (defaults to the last Record in the Store)
4979 * @return {Roo.data.Record[]} An array of Records
4981 getRange : function(start, end){
4982 return this.data.getRange(start, end);
4986 storeOptions : function(o){
4987 o = Roo.apply({}, o);
4990 this.lastOptions = o;
4994 * Loads the Record cache from the configured Proxy using the configured Reader.
4996 * If using remote paging, then the first load call must specify the <em>start</em>
4997 * and <em>limit</em> properties in the options.params property to establish the initial
4998 * position within the dataset, and the number of Records to cache on each read from the Proxy.
5000 * <strong>It is important to note that for remote data sources, loading is asynchronous,
5001 * and this call will return before the new data has been loaded. Perform any post-processing
5002 * in a callback function, or in a "load" event handler.</strong>
5004 * @param {Object} options An object containing properties which control loading options:<ul>
5005 * <li>params {Object} An object containing properties to pass as HTTP parameters to a remote data source.</li>
5006 * <li>callback {Function} A function to be called after the Records have been loaded. The callback is
5007 * passed the following arguments:<ul>
5008 * <li>r : Roo.data.Record[]</li>
5009 * <li>options: Options object from the load call</li>
5010 * <li>success: Boolean success indicator</li></ul></li>
5011 * <li>scope {Object} Scope with which to call the callback (defaults to the Store object)</li>
5012 * <li>add {Boolean} indicator to append loaded records rather than replace the current cache.</li>
5015 load : function(options){
5016 options = options || {};
5017 if(this.fireEvent("beforeload", this, options) !== false){
5018 this.storeOptions(options);
5019 var p = Roo.apply(options.params || {}, this.baseParams);
5020 // if meta was not loaded from remote source.. try requesting it.
5021 if (!this.reader.metaFromRemote) {
5024 if(this.sortInfo && this.remoteSort){
5025 var pn = this.paramNames;
5026 p[pn["sort"]] = this.sortInfo.field;
5027 p[pn["dir"]] = this.sortInfo.direction;
5029 if (this.multiSort) {
5030 var pn = this.paramNames;
5031 p[pn["multisort"]] = Roo.encode( { sort : this.sortToggle, order: this.sortOrder });
5034 this.proxy.load(p, this.reader, this.loadRecords, this, options);
5039 * Reloads the Record cache from the configured Proxy using the configured Reader and
5040 * the options from the last load operation performed.
5041 * @param {Object} options (optional) An object containing properties which may override the options
5042 * used in the last load operation. See {@link #load} for details (defaults to null, in which case
5043 * the most recently used options are reused).
5045 reload : function(options){
5046 this.load(Roo.applyIf(options||{}, this.lastOptions));
5050 // Called as a callback by the Reader during a load operation.
5051 loadRecords : function(o, options, success){
5052 if(!o || success === false){
5053 if(success !== false){
5054 this.fireEvent("load", this, [], options);
5056 if(options.callback){
5057 options.callback.call(options.scope || this, [], options, false);
5061 // if data returned failure - throw an exception.
5062 if (o.success === false) {
5063 // show a message if no listener is registered.
5064 if (!this.hasListener('loadexception') && typeof(this.reader.jsonData.errorMsg) != 'undefined') {
5065 Roo.MessageBox.alert("Error loading",this.reader.jsonData.errorMsg);
5067 // loadmask wil be hooked into this..
5068 this.fireEvent("loadexception", this, o, options, this.reader.jsonData);
5071 var r = o.records, t = o.totalRecords || r.length;
5072 if(!options || options.add !== true){
5073 if(this.pruneModifiedRecords){
5076 for(var i = 0, len = r.length; i < len; i++){
5080 this.data = this.snapshot;
5081 delete this.snapshot;
5084 this.data.addAll(r);
5085 this.totalLength = t;
5087 this.fireEvent("datachanged", this);
5089 this.totalLength = Math.max(t, this.data.length+r.length);
5092 this.fireEvent("load", this, r, options);
5093 if(options.callback){
5094 options.callback.call(options.scope || this, r, options, true);
5100 * Loads data from a passed data block. A Reader which understands the format of the data
5101 * must have been configured in the constructor.
5102 * @param {Object} data The data block from which to read the Records. The format of the data expected
5103 * is dependent on the type of Reader that is configured and should correspond to that Reader's readRecords parameter.
5104 * @param {Boolean} append (Optional) True to append the new Records rather than replace the existing cache.
5106 loadData : function(o, append){
5107 var r = this.reader.readRecords(o);
5108 this.loadRecords(r, {add: append}, true);
5112 * Gets the number of cached records.
5114 * <em>If using paging, this may not be the total size of the dataset. If the data object
5115 * used by the Reader contains the dataset size, then the getTotalCount() function returns
5116 * the data set size</em>
5118 getCount : function(){
5119 return this.data.length || 0;
5123 * Gets the total number of records in the dataset as returned by the server.
5125 * <em>If using paging, for this to be accurate, the data object used by the Reader must contain
5126 * the dataset size</em>
5128 getTotalCount : function(){
5129 return this.totalLength || 0;
5133 * Returns the sort state of the Store as an object with two properties:
5135 field {String} The name of the field by which the Records are sorted
5136 direction {String} The sort order, "ASC" or "DESC"
5139 getSortState : function(){
5140 return this.sortInfo;
5144 applySort : function(){
5145 if(this.sortInfo && !this.remoteSort){
5146 var s = this.sortInfo, f = s.field;
5147 var st = this.fields.get(f).sortType;
5148 var fn = function(r1, r2){
5149 var v1 = st(r1.data[f]), v2 = st(r2.data[f]);
5150 return v1 > v2 ? 1 : (v1 < v2 ? -1 : 0);
5152 this.data.sort(s.direction, fn);
5153 if(this.snapshot && this.snapshot != this.data){
5154 this.snapshot.sort(s.direction, fn);
5160 * Sets the default sort column and order to be used by the next load operation.
5161 * @param {String} fieldName The name of the field to sort by.
5162 * @param {String} dir (optional) The sort order, "ASC" or "DESC" (defaults to "ASC")
5164 setDefaultSort : function(field, dir){
5165 this.sortInfo = {field: field, direction: dir ? dir.toUpperCase() : "ASC"};
5170 * If remote sorting is used, the sort is performed on the server, and the cache is
5171 * reloaded. If local sorting is used, the cache is sorted internally.
5172 * @param {String} fieldName The name of the field to sort by.
5173 * @param {String} dir (optional) The sort order, "ASC" or "DESC" (defaults to "ASC")
5175 sort : function(fieldName, dir){
5176 var f = this.fields.get(fieldName);
5178 this.sortToggle[f.name] = this.sortToggle[f.name] || f.sortDir;
5180 if(this.multiSort || (this.sortInfo && this.sortInfo.field == f.name) ){ // toggle sort dir
5181 dir = (this.sortToggle[f.name] || "ASC").toggle("ASC", "DESC");
5186 this.sortToggle[f.name] = dir;
5187 this.sortInfo = {field: f.name, direction: dir};
5188 if(!this.remoteSort){
5190 this.fireEvent("datachanged", this);
5192 this.load(this.lastOptions);
5197 * Calls the specified function for each of the Records in the cache.
5198 * @param {Function} fn The function to call. The Record is passed as the first parameter.
5199 * Returning <em>false</em> aborts and exits the iteration.
5200 * @param {Object} scope (optional) The scope in which to call the function (defaults to the Record).
5202 each : function(fn, scope){
5203 this.data.each(fn, scope);
5207 * Gets all records modified since the last commit. Modified records are persisted across load operations
5208 * (e.g., during paging).
5209 * @return {Roo.data.Record[]} An array of Records containing outstanding modifications.
5211 getModifiedRecords : function(){
5212 return this.modified;
5216 createFilterFn : function(property, value, anyMatch){
5217 if(!value.exec){ // not a regex
5218 value = String(value);
5219 if(value.length == 0){
5222 value = new RegExp((anyMatch === true ? '' : '^') + Roo.escapeRe(value), "i");
5225 return value.test(r.data[property]);
5230 * Sums the value of <i>property</i> for each record between start and end and returns the result.
5231 * @param {String} property A field on your records
5232 * @param {Number} start The record index to start at (defaults to 0)
5233 * @param {Number} end The last record index to include (defaults to length - 1)
5234 * @return {Number} The sum
5236 sum : function(property, start, end){
5237 var rs = this.data.items, v = 0;
5239 end = (end || end === 0) ? end : rs.length-1;
5241 for(var i = start; i <= end; i++){
5242 v += (rs[i].data[property] || 0);
5248 * Filter the records by a specified property.
5249 * @param {String} field A field on your records
5250 * @param {String/RegExp} value Either a string that the field
5251 * should start with or a RegExp to test against the field
5252 * @param {Boolean} anyMatch True to match any part not just the beginning
5254 filter : function(property, value, anyMatch){
5255 var fn = this.createFilterFn(property, value, anyMatch);
5256 return fn ? this.filterBy(fn) : this.clearFilter();
5260 * Filter by a function. The specified function will be called with each
5261 * record in this data source. If the function returns true the record is included,
5262 * otherwise it is filtered.
5263 * @param {Function} fn The function to be called, it will receive 2 args (record, id)
5264 * @param {Object} scope (optional) The scope of the function (defaults to this)
5266 filterBy : function(fn, scope){
5267 this.snapshot = this.snapshot || this.data;
5268 this.data = this.queryBy(fn, scope||this);
5269 this.fireEvent("datachanged", this);
5273 * Query the records by a specified property.
5274 * @param {String} field A field on your records
5275 * @param {String/RegExp} value Either a string that the field
5276 * should start with or a RegExp to test against the field
5277 * @param {Boolean} anyMatch True to match any part not just the beginning
5278 * @return {MixedCollection} Returns an Roo.util.MixedCollection of the matched records
5280 query : function(property, value, anyMatch){
5281 var fn = this.createFilterFn(property, value, anyMatch);
5282 return fn ? this.queryBy(fn) : this.data.clone();
5286 * Query by a function. The specified function will be called with each
5287 * record in this data source. If the function returns true the record is included
5289 * @param {Function} fn The function to be called, it will receive 2 args (record, id)
5290 * @param {Object} scope (optional) The scope of the function (defaults to this)
5291 @return {MixedCollection} Returns an Roo.util.MixedCollection of the matched records
5293 queryBy : function(fn, scope){
5294 var data = this.snapshot || this.data;
5295 return data.filterBy(fn, scope||this);
5299 * Collects unique values for a particular dataIndex from this store.
5300 * @param {String} dataIndex The property to collect
5301 * @param {Boolean} allowNull (optional) Pass true to allow null, undefined or empty string values
5302 * @param {Boolean} bypassFilter (optional) Pass true to collect from all records, even ones which are filtered
5303 * @return {Array} An array of the unique values
5305 collect : function(dataIndex, allowNull, bypassFilter){
5306 var d = (bypassFilter === true && this.snapshot) ?
5307 this.snapshot.items : this.data.items;
5308 var v, sv, r = [], l = {};
5309 for(var i = 0, len = d.length; i < len; i++){
5310 v = d[i].data[dataIndex];
5312 if((allowNull || !Roo.isEmpty(v)) && !l[sv]){
5321 * Revert to a view of the Record cache with no filtering applied.
5322 * @param {Boolean} suppressEvent If true the filter is cleared silently without notifying listeners
5324 clearFilter : function(suppressEvent){
5325 if(this.snapshot && this.snapshot != this.data){
5326 this.data = this.snapshot;
5327 delete this.snapshot;
5328 if(suppressEvent !== true){
5329 this.fireEvent("datachanged", this);
5335 afterEdit : function(record){
5336 if(this.modified.indexOf(record) == -1){
5337 this.modified.push(record);
5339 this.fireEvent("update", this, record, Roo.data.Record.EDIT);
5343 afterReject : function(record){
5344 this.modified.remove(record);
5345 this.fireEvent("update", this, record, Roo.data.Record.REJECT);
5349 afterCommit : function(record){
5350 this.modified.remove(record);
5351 this.fireEvent("update", this, record, Roo.data.Record.COMMIT);
5355 * Commit all Records with outstanding changes. To handle updates for changes, subscribe to the
5356 * Store's "update" event, and perform updating when the third parameter is Roo.data.Record.COMMIT.
5358 commitChanges : function(){
5359 var m = this.modified.slice(0);
5361 for(var i = 0, len = m.length; i < len; i++){
5367 * Cancel outstanding changes on all changed records.
5369 rejectChanges : function(){
5370 var m = this.modified.slice(0);
5372 for(var i = 0, len = m.length; i < len; i++){
5377 onMetaChange : function(meta, rtype, o){
5378 this.recordType = rtype;
5379 this.fields = rtype.prototype.fields;
5380 delete this.snapshot;
5381 this.sortInfo = meta.sortInfo || this.sortInfo;
5383 this.fireEvent('metachange', this, this.reader.meta);
5387 * Ext JS Library 1.1.1
5388 * Copyright(c) 2006-2007, Ext JS, LLC.
5390 * Originally Released Under LGPL - original licence link has changed is not relivant.
5393 * <script type="text/javascript">
5397 * @class Roo.data.SimpleStore
5398 * @extends Roo.data.Store
5399 * Small helper class to make creating Stores from Array data easier.
5400 * @cfg {Number} id The array index of the record id. Leave blank to auto generate ids.
5401 * @cfg {Array} fields An array of field definition objects, or field name strings.
5402 * @cfg {Array} data The multi-dimensional array of data
5404 * @param {Object} config
5406 Roo.data.SimpleStore = function(config){
5407 Roo.data.SimpleStore.superclass.constructor.call(this, {
5409 reader: new Roo.data.ArrayReader({
5412 Roo.data.Record.create(config.fields)
5414 proxy : new Roo.data.MemoryProxy(config.data)
5418 Roo.extend(Roo.data.SimpleStore, Roo.data.Store);/*
5420 * Ext JS Library 1.1.1
5421 * Copyright(c) 2006-2007, Ext JS, LLC.
5423 * Originally Released Under LGPL - original licence link has changed is not relivant.
5426 * <script type="text/javascript">
5431 * @extends Roo.data.Store
5432 * @class Roo.data.JsonStore
5433 * Small helper class to make creating Stores for JSON data easier. <br/>
5435 var store = new Roo.data.JsonStore({
5436 url: 'get-images.php',
5438 fields: ['name', 'url', {name:'size', type: 'float'}, {name:'lastmod', type:'date'}]
5441 * <b>Note: Although they are not listed, this class inherits all of the config options of Store,
5442 * JsonReader and HttpProxy (unless inline data is provided).</b>
5443 * @cfg {Array} fields An array of field definition objects, or field name strings.
5445 * @param {Object} config
5447 Roo.data.JsonStore = function(c){
5448 Roo.data.JsonStore.superclass.constructor.call(this, Roo.apply(c, {
5449 proxy: !c.data ? new Roo.data.HttpProxy({url: c.url}) : undefined,
5450 reader: new Roo.data.JsonReader(c, c.fields)
5453 Roo.extend(Roo.data.JsonStore, Roo.data.Store);/*
5455 * Ext JS Library 1.1.1
5456 * Copyright(c) 2006-2007, Ext JS, LLC.
5458 * Originally Released Under LGPL - original licence link has changed is not relivant.
5461 * <script type="text/javascript">
5465 Roo.data.Field = function(config){
5466 if(typeof config == "string"){
5467 config = {name: config};
5469 Roo.apply(this, config);
5475 var st = Roo.data.SortTypes;
5476 // named sortTypes are supported, here we look them up
5477 if(typeof this.sortType == "string"){
5478 this.sortType = st[this.sortType];
5481 // set default sortType for strings and dates
5485 this.sortType = st.asUCString;
5488 this.sortType = st.asDate;
5491 this.sortType = st.none;
5496 var stripRe = /[\$,%]/g;
5498 // prebuilt conversion function for this field, instead of
5499 // switching every time we're reading a value
5501 var cv, dateFormat = this.dateFormat;
5506 cv = function(v){ return v; };
5509 cv = function(v){ return (v === undefined || v === null) ? '' : String(v); };
5513 return v !== undefined && v !== null && v !== '' ?
5514 parseInt(String(v).replace(stripRe, ""), 10) : '';
5519 return v !== undefined && v !== null && v !== '' ?
5520 parseFloat(String(v).replace(stripRe, ""), 10) : '';
5525 cv = function(v){ return v === true || v === "true" || v == 1; };
5532 if(v instanceof Date){
5536 if(dateFormat == "timestamp"){
5537 return new Date(v*1000);
5539 return Date.parseDate(v, dateFormat);
5541 var parsed = Date.parse(v);
5542 return parsed ? new Date(parsed) : null;
5551 Roo.data.Field.prototype = {
5559 * Ext JS Library 1.1.1
5560 * Copyright(c) 2006-2007, Ext JS, LLC.
5562 * Originally Released Under LGPL - original licence link has changed is not relivant.
5565 * <script type="text/javascript">
5568 // Base class for reading structured data from a data source. This class is intended to be
5569 // extended (see ArrayReader, JsonReader and XmlReader) and should not be created directly.
5572 * @class Roo.data.DataReader
5573 * Base class for reading structured data from a data source. This class is intended to be
5574 * extended (see {Roo.data.ArrayReader}, {Roo.data.JsonReader} and {Roo.data.XmlReader}) and should not be created directly.
5577 Roo.data.DataReader = function(meta, recordType){
5581 this.recordType = recordType instanceof Array ?
5582 Roo.data.Record.create(recordType) : recordType;
5585 Roo.data.DataReader.prototype = {
5587 * Create an empty record
5588 * @param {Object} data (optional) - overlay some values
5589 * @return {Roo.data.Record} record created.
5591 newRow : function(d) {
5593 this.recordType.prototype.fields.each(function(c) {
5595 case 'int' : da[c.name] = 0; break;
5596 case 'date' : da[c.name] = new Date(); break;
5597 case 'float' : da[c.name] = 0.0; break;
5598 case 'boolean' : da[c.name] = false; break;
5599 default : da[c.name] = ""; break;
5603 return new this.recordType(Roo.apply(da, d));
5608 * Ext JS Library 1.1.1
5609 * Copyright(c) 2006-2007, Ext JS, LLC.
5611 * Originally Released Under LGPL - original licence link has changed is not relivant.
5614 * <script type="text/javascript">
5618 * @class Roo.data.DataProxy
5619 * @extends Roo.data.Observable
5620 * This class is an abstract base class for implementations which provide retrieval of
5621 * unformatted data objects.<br>
5623 * DataProxy implementations are usually used in conjunction with an implementation of Roo.data.DataReader
5624 * (of the appropriate type which knows how to parse the data object) to provide a block of
5625 * {@link Roo.data.Records} to an {@link Roo.data.Store}.<br>
5627 * Custom implementations must implement the load method as described in
5628 * {@link Roo.data.HttpProxy#load}.
5630 Roo.data.DataProxy = function(){
5634 * Fires before a network request is made to retrieve a data object.
5635 * @param {Object} This DataProxy object.
5636 * @param {Object} params The params parameter to the load function.
5641 * Fires before the load method's callback is called.
5642 * @param {Object} This DataProxy object.
5643 * @param {Object} o The data object.
5644 * @param {Object} arg The callback argument object passed to the load function.
5648 * @event loadexception
5649 * Fires if an Exception occurs during data retrieval.
5650 * @param {Object} This DataProxy object.
5651 * @param {Object} o The data object.
5652 * @param {Object} arg The callback argument object passed to the load function.
5653 * @param {Object} e The Exception.
5655 loadexception : true
5657 Roo.data.DataProxy.superclass.constructor.call(this);
5660 Roo.extend(Roo.data.DataProxy, Roo.util.Observable);
5663 * @cfg {void} listeners (Not available) Constructor blocks listeners from being set
5667 * Ext JS Library 1.1.1
5668 * Copyright(c) 2006-2007, Ext JS, LLC.
5670 * Originally Released Under LGPL - original licence link has changed is not relivant.
5673 * <script type="text/javascript">
5676 * @class Roo.data.MemoryProxy
5677 * An implementation of Roo.data.DataProxy that simply passes the data specified in its constructor
5678 * to the Reader when its load method is called.
5680 * @param {Object} data The data object which the Reader uses to construct a block of Roo.data.Records.
5682 Roo.data.MemoryProxy = function(data){
5686 Roo.data.MemoryProxy.superclass.constructor.call(this);
5690 Roo.extend(Roo.data.MemoryProxy, Roo.data.DataProxy, {
5692 * Load data from the requested source (in this case an in-memory
5693 * data object passed to the constructor), read the data object into
5694 * a block of Roo.data.Records using the passed Roo.data.DataReader implementation, and
5695 * process that block using the passed callback.
5696 * @param {Object} params This parameter is not used by the MemoryProxy class.
5697 * @param {Roo.data.DataReader} reader The Reader object which converts the data
5698 * object into a block of Roo.data.Records.
5699 * @param {Function} callback The function into which to pass the block of Roo.data.records.
5700 * The function must be passed <ul>
5701 * <li>The Record block object</li>
5702 * <li>The "arg" argument from the load function</li>
5703 * <li>A boolean success indicator</li>
5705 * @param {Object} scope The scope in which to call the callback
5706 * @param {Object} arg An optional argument which is passed to the callback as its second parameter.
5708 load : function(params, reader, callback, scope, arg){
5709 params = params || {};
5712 result = reader.readRecords(this.data);
5714 this.fireEvent("loadexception", this, arg, null, e);
5715 callback.call(scope, null, arg, false);
5718 callback.call(scope, result, arg, true);
5722 update : function(params, records){
5727 * Ext JS Library 1.1.1
5728 * Copyright(c) 2006-2007, Ext JS, LLC.
5730 * Originally Released Under LGPL - original licence link has changed is not relivant.
5733 * <script type="text/javascript">
5736 * @class Roo.data.HttpProxy
5737 * @extends Roo.data.DataProxy
5738 * An implementation of {@link Roo.data.DataProxy} that reads a data object from an {@link Roo.data.Connection} object
5739 * configured to reference a certain URL.<br><br>
5741 * <em>Note that this class cannot be used to retrieve data from a domain other than the domain
5742 * from which the running page was served.<br><br>
5744 * For cross-domain access to remote data, use an {@link Roo.data.ScriptTagProxy}.</em><br><br>
5746 * Be aware that to enable the browser to parse an XML document, the server must set
5747 * the Content-Type header in the HTTP response to "text/xml".
5749 * @param {Object} conn Connection config options to add to each request (e.g. {url: 'foo.php'} or
5750 * an {@link Roo.data.Connection} object. If a Connection config is passed, the singleton {@link Roo.Ajax} object
5751 * will be used to make the request.
5753 Roo.data.HttpProxy = function(conn){
5754 Roo.data.HttpProxy.superclass.constructor.call(this);
5755 // is conn a conn config or a real conn?
5757 this.useAjax = !conn || !conn.events;
5761 Roo.extend(Roo.data.HttpProxy, Roo.data.DataProxy, {
5762 // thse are take from connection...
5765 * @cfg {String} url (Optional) The default URL to be used for requests to the server. (defaults to undefined)
5768 * @cfg {Object} extraParams (Optional) An object containing properties which are used as
5769 * extra parameters to each request made by this object. (defaults to undefined)
5772 * @cfg {Object} defaultHeaders (Optional) An object containing request headers which are added
5773 * to each request made by this object. (defaults to undefined)
5776 * @cfg {String} method (Optional) The default HTTP method to be used for requests. (defaults to undefined; if not set but parms are present will use POST, otherwise GET)
5779 * @cfg {Number} timeout (Optional) The timeout in milliseconds to be used for requests. (defaults to 30000)
5782 * @cfg {Boolean} autoAbort (Optional) Whether this request should abort any pending requests. (defaults to false)
5788 * @cfg {Boolean} disableCaching (Optional) True to add a unique cache-buster param to GET requests. (defaults to true)
5792 * Return the {@link Roo.data.Connection} object being used by this Proxy.
5793 * @return {Connection} The Connection object. This object may be used to subscribe to events on
5794 * a finer-grained basis than the DataProxy events.
5796 getConnection : function(){
5797 return this.useAjax ? Roo.Ajax : this.conn;
5801 * Load data from the configured {@link Roo.data.Connection}, read the data object into
5802 * a block of Roo.data.Records using the passed {@link Roo.data.DataReader} implementation, and
5803 * process that block using the passed callback.
5804 * @param {Object} params An object containing properties which are to be used as HTTP parameters
5805 * for the request to the remote server.
5806 * @param {Roo.data.DataReader} reader The Reader object which converts the data
5807 * object into a block of Roo.data.Records.
5808 * @param {Function} callback The function into which to pass the block of Roo.data.Records.
5809 * The function must be passed <ul>
5810 * <li>The Record block object</li>
5811 * <li>The "arg" argument from the load function</li>
5812 * <li>A boolean success indicator</li>
5814 * @param {Object} scope The scope in which to call the callback
5815 * @param {Object} arg An optional argument which is passed to the callback as its second parameter.
5817 load : function(params, reader, callback, scope, arg){
5818 if(this.fireEvent("beforeload", this, params) !== false){
5820 params : params || {},
5822 callback : callback,
5827 callback : this.loadResponse,
5831 Roo.applyIf(o, this.conn);
5832 if(this.activeRequest){
5833 Roo.Ajax.abort(this.activeRequest);
5835 this.activeRequest = Roo.Ajax.request(o);
5837 this.conn.request(o);
5840 callback.call(scope||this, null, arg, false);
5845 loadResponse : function(o, success, response){
5846 delete this.activeRequest;
5848 this.fireEvent("loadexception", this, o, response);
5849 o.request.callback.call(o.request.scope, null, o.request.arg, false);
5854 result = o.reader.read(response);
5856 this.fireEvent("loadexception", this, o, response, e);
5857 o.request.callback.call(o.request.scope, null, o.request.arg, false);
5861 this.fireEvent("load", this, o, o.request.arg);
5862 o.request.callback.call(o.request.scope, result, o.request.arg, true);
5866 update : function(dataSet){
5871 updateResponse : function(dataSet){
5876 * Ext JS Library 1.1.1
5877 * Copyright(c) 2006-2007, Ext JS, LLC.
5879 * Originally Released Under LGPL - original licence link has changed is not relivant.
5882 * <script type="text/javascript">
5886 * @class Roo.data.ScriptTagProxy
5887 * An implementation of Roo.data.DataProxy that reads a data object from a URL which may be in a domain
5888 * other than the originating domain of the running page.<br><br>
5890 * <em>Note that if you are retrieving data from a page that is in a domain that is NOT the same as the originating domain
5891 * of the running page, you must use this class, rather than DataProxy.</em><br><br>
5893 * The content passed back from a server resource requested by a ScriptTagProxy is executable JavaScript
5894 * source code that is used as the source inside a <script> tag.<br><br>
5896 * In order for the browser to process the returned data, the server must wrap the data object
5897 * with a call to a callback function, the name of which is passed as a parameter by the ScriptTagProxy.
5898 * Below is a Java example for a servlet which returns data for either a ScriptTagProxy, or an HttpProxy
5899 * depending on whether the callback name was passed:
5902 boolean scriptTag = false;
5903 String cb = request.getParameter("callback");
5906 response.setContentType("text/javascript");
5908 response.setContentType("application/x-json");
5910 Writer out = response.getWriter();
5912 out.write(cb + "(");
5914 out.print(dataBlock.toJsonString());
5921 * @param {Object} config A configuration object.
5923 Roo.data.ScriptTagProxy = function(config){
5924 Roo.data.ScriptTagProxy.superclass.constructor.call(this);
5925 Roo.apply(this, config);
5926 this.head = document.getElementsByTagName("head")[0];
5929 Roo.data.ScriptTagProxy.TRANS_ID = 1000;
5931 Roo.extend(Roo.data.ScriptTagProxy, Roo.data.DataProxy, {
5933 * @cfg {String} url The URL from which to request the data object.
5936 * @cfg {Number} timeout (Optional) The number of milliseconds to wait for a response. Defaults to 30 seconds.
5940 * @cfg {String} callbackParam (Optional) The name of the parameter to pass to the server which tells
5941 * the server the name of the callback function set up by the load call to process the returned data object.
5942 * Defaults to "callback".<p>The server-side processing must read this parameter value, and generate
5943 * javascript output which calls this named function passing the data object as its only parameter.
5945 callbackParam : "callback",
5947 * @cfg {Boolean} nocache (Optional) Defaults to true. Disable cacheing by adding a unique parameter
5948 * name to the request.
5953 * Load data from the configured URL, read the data object into
5954 * a block of Roo.data.Records using the passed Roo.data.DataReader implementation, and
5955 * process that block using the passed callback.
5956 * @param {Object} params An object containing properties which are to be used as HTTP parameters
5957 * for the request to the remote server.
5958 * @param {Roo.data.DataReader} reader The Reader object which converts the data
5959 * object into a block of Roo.data.Records.
5960 * @param {Function} callback The function into which to pass the block of Roo.data.Records.
5961 * The function must be passed <ul>
5962 * <li>The Record block object</li>
5963 * <li>The "arg" argument from the load function</li>
5964 * <li>A boolean success indicator</li>
5966 * @param {Object} scope The scope in which to call the callback
5967 * @param {Object} arg An optional argument which is passed to the callback as its second parameter.
5969 load : function(params, reader, callback, scope, arg){
5970 if(this.fireEvent("beforeload", this, params) !== false){
5972 var p = Roo.urlEncode(Roo.apply(params, this.extraParams));
5975 url += (url.indexOf("?") != -1 ? "&" : "?") + p;
5977 url += "&_dc=" + (new Date().getTime());
5979 var transId = ++Roo.data.ScriptTagProxy.TRANS_ID;
5982 cb : "stcCallback"+transId,
5983 scriptId : "stcScript"+transId,
5987 callback : callback,
5993 window[trans.cb] = function(o){
5994 conn.handleResponse(o, trans);
5997 url += String.format("&{0}={1}", this.callbackParam, trans.cb);
5999 if(this.autoAbort !== false){
6003 trans.timeoutId = this.handleFailure.defer(this.timeout, this, [trans]);
6005 var script = document.createElement("script");
6006 script.setAttribute("src", url);
6007 script.setAttribute("type", "text/javascript");
6008 script.setAttribute("id", trans.scriptId);
6009 this.head.appendChild(script);
6013 callback.call(scope||this, null, arg, false);
6018 isLoading : function(){
6019 return this.trans ? true : false;
6023 * Abort the current server request.
6026 if(this.isLoading()){
6027 this.destroyTrans(this.trans);
6032 destroyTrans : function(trans, isLoaded){
6033 this.head.removeChild(document.getElementById(trans.scriptId));
6034 clearTimeout(trans.timeoutId);
6036 window[trans.cb] = undefined;
6038 delete window[trans.cb];
6041 // if hasn't been loaded, wait for load to remove it to prevent script error
6042 window[trans.cb] = function(){
6043 window[trans.cb] = undefined;
6045 delete window[trans.cb];
6052 handleResponse : function(o, trans){
6054 this.destroyTrans(trans, true);
6057 result = trans.reader.readRecords(o);
6059 this.fireEvent("loadexception", this, o, trans.arg, e);
6060 trans.callback.call(trans.scope||window, null, trans.arg, false);
6063 this.fireEvent("load", this, o, trans.arg);
6064 trans.callback.call(trans.scope||window, result, trans.arg, true);
6068 handleFailure : function(trans){
6070 this.destroyTrans(trans, false);
6071 this.fireEvent("loadexception", this, null, trans.arg);
6072 trans.callback.call(trans.scope||window, null, trans.arg, false);
6076 * Ext JS Library 1.1.1
6077 * Copyright(c) 2006-2007, Ext JS, LLC.
6079 * Originally Released Under LGPL - original licence link has changed is not relivant.
6082 * <script type="text/javascript">
6086 * @class Roo.data.JsonReader
6087 * @extends Roo.data.DataReader
6088 * Data reader class to create an Array of Roo.data.Record objects from a JSON response
6089 * based on mappings in a provided Roo.data.Record constructor.
6091 * The default behaviour of a store is to send ?_requestMeta=1, unless the class has recieved 'metaData' property
6092 * in the reply previously.
6097 var RecordDef = Roo.data.Record.create([
6098 {name: 'name', mapping: 'name'}, // "mapping" property not needed if it's the same as "name"
6099 {name: 'occupation'} // This field will use "occupation" as the mapping.
6101 var myReader = new Roo.data.JsonReader({
6102 totalProperty: "results", // The property which contains the total dataset size (optional)
6103 root: "rows", // The property which contains an Array of row objects
6104 id: "id" // The property within each row object that provides an ID for the record (optional)
6108 * This would consume a JSON file like this:
6110 { 'results': 2, 'rows': [
6111 { 'id': 1, 'name': 'Bill', occupation: 'Gardener' },
6112 { 'id': 2, 'name': 'Ben', occupation: 'Horticulturalist' } ]
6115 * @cfg {String} totalProperty Name of the property from which to retrieve the total number of records
6116 * in the dataset. This is only needed if the whole dataset is not passed in one go, but is being
6117 * paged from the remote server.
6118 * @cfg {String} successProperty Name of the property from which to retrieve the success attribute used by forms.
6119 * @cfg {String} root name of the property which contains the Array of row objects.
6120 * @cfg {String} id Name of the property within a row object that contains a record identifier value.
6122 * Create a new JsonReader
6123 * @param {Object} meta Metadata configuration options
6124 * @param {Object} recordType Either an Array of field definition objects,
6125 * or an {@link Roo.data.Record} object created using {@link Roo.data.Record#create}.
6127 Roo.data.JsonReader = function(meta, recordType){
6130 // set some defaults:
6132 totalProperty: 'total',
6133 successProperty : 'success',
6138 Roo.data.JsonReader.superclass.constructor.call(this, meta, recordType||meta.fields);
6140 Roo.extend(Roo.data.JsonReader, Roo.data.DataReader, {
6143 * @prop {Boolean} metaFromRemote - if the meta data was loaded from the remote source.
6144 * Used by Store query builder to append _requestMeta to params.
6147 metaFromRemote : false,
6149 * This method is only used by a DataProxy which has retrieved data from a remote server.
6150 * @param {Object} response The XHR object which contains the JSON data in its responseText.
6151 * @return {Object} data A data block which is used by an Roo.data.Store object as
6152 * a cache of Roo.data.Records.
6154 read : function(response){
6155 var json = response.responseText;
6157 var o = /* eval:var:o */ eval("("+json+")");
6159 throw {message: "JsonReader.read: Json object not found"};
6165 this.metaFromRemote = true;
6166 this.meta = o.metaData;
6167 this.recordType = Roo.data.Record.create(o.metaData.fields);
6168 this.onMetaChange(this.meta, this.recordType, o);
6170 return this.readRecords(o);
6173 // private function a store will implement
6174 onMetaChange : function(meta, recordType, o){
6181 simpleAccess: function(obj, subsc) {
6188 getJsonAccessor: function(){
6190 return function(expr) {
6192 return(re.test(expr))
6193 ? new Function("obj", "return obj." + expr)
6203 * Create a data block containing Roo.data.Records from an XML document.
6204 * @param {Object} o An object which contains an Array of row objects in the property specified
6205 * in the config as 'root, and optionally a property, specified in the config as 'totalProperty'
6206 * which contains the total size of the dataset.
6207 * @return {Object} data A data block which is used by an Roo.data.Store object as
6208 * a cache of Roo.data.Records.
6210 readRecords : function(o){
6212 * After any data loads, the raw JSON data is available for further custom processing.
6216 var s = this.meta, Record = this.recordType,
6217 f = Record.prototype.fields, fi = f.items, fl = f.length;
6219 // Generate extraction functions for the totalProperty, the root, the id, and for each field
6221 if(s.totalProperty) {
6222 this.getTotal = this.getJsonAccessor(s.totalProperty);
6224 if(s.successProperty) {
6225 this.getSuccess = this.getJsonAccessor(s.successProperty);
6227 this.getRoot = s.root ? this.getJsonAccessor(s.root) : function(p){return p;};
6229 var g = this.getJsonAccessor(s.id);
6230 this.getId = function(rec) {
6232 return (r === undefined || r === "") ? null : r;
6235 this.getId = function(){return null;};
6238 for(var jj = 0; jj < fl; jj++){
6240 var map = (f.mapping !== undefined && f.mapping !== null) ? f.mapping : f.name;
6241 this.ef[jj] = this.getJsonAccessor(map);
6245 var root = this.getRoot(o), c = root.length, totalRecords = c, success = true;
6246 if(s.totalProperty){
6247 var vt = parseInt(this.getTotal(o), 10);
6252 if(s.successProperty){
6253 var vs = this.getSuccess(o);
6254 if(vs === false || vs === 'false'){
6259 for(var i = 0; i < c; i++){
6262 var id = this.getId(n);
6263 for(var j = 0; j < fl; j++){
6265 var v = this.ef[j](n);
6267 Roo.log('missing convert for ' + f.name);
6271 values[f.name] = f.convert((v !== undefined) ? v : f.defaultValue);
6273 var record = new Record(values, id);
6275 records[i] = record;
6280 totalRecords : totalRecords
6285 * Ext JS Library 1.1.1
6286 * Copyright(c) 2006-2007, Ext JS, LLC.
6288 * Originally Released Under LGPL - original licence link has changed is not relivant.
6291 * <script type="text/javascript">
6295 * @class Roo.data.XmlReader
6296 * @extends Roo.data.DataReader
6297 * Data reader class to create an Array of {@link Roo.data.Record} objects from an XML document
6298 * based on mappings in a provided Roo.data.Record constructor.<br><br>
6300 * <em>Note that in order for the browser to parse a returned XML document, the Content-Type
6301 * header in the HTTP response must be set to "text/xml".</em>
6305 var RecordDef = Roo.data.Record.create([
6306 {name: 'name', mapping: 'name'}, // "mapping" property not needed if it's the same as "name"
6307 {name: 'occupation'} // This field will use "occupation" as the mapping.
6309 var myReader = new Roo.data.XmlReader({
6310 totalRecords: "results", // The element which contains the total dataset size (optional)
6311 record: "row", // The repeated element which contains row information
6312 id: "id" // The element within the row that provides an ID for the record (optional)
6316 * This would consume an XML file like this:
6320 <results>2</results>
6323 <name>Bill</name>
6324 <occupation>Gardener</occupation>
6328 <name>Ben</name>
6329 <occupation>Horticulturalist</occupation>
6333 * @cfg {String} totalRecords The DomQuery path from which to retrieve the total number of records
6334 * in the dataset. This is only needed if the whole dataset is not passed in one go, but is being
6335 * paged from the remote server.
6336 * @cfg {String} record The DomQuery path to the repeated element which contains record information.
6337 * @cfg {String} success The DomQuery path to the success attribute used by forms.
6338 * @cfg {String} id The DomQuery path relative from the record element to the element that contains
6339 * a record identifier value.
6341 * Create a new XmlReader
6342 * @param {Object} meta Metadata configuration options
6343 * @param {Mixed} recordType The definition of the data record type to produce. This can be either a valid
6344 * Record subclass created with {@link Roo.data.Record#create}, or an array of objects with which to call
6345 * Roo.data.Record.create. See the {@link Roo.data.Record} class for more details.
6347 Roo.data.XmlReader = function(meta, recordType){
6349 Roo.data.XmlReader.superclass.constructor.call(this, meta, recordType||meta.fields);
6351 Roo.extend(Roo.data.XmlReader, Roo.data.DataReader, {
6353 * This method is only used by a DataProxy which has retrieved data from a remote server.
6354 * @param {Object} response The XHR object which contains the parsed XML document. The response is expected
6355 * to contain a method called 'responseXML' that returns an XML document object.
6356 * @return {Object} records A data block which is used by an {@link Roo.data.Store} as
6357 * a cache of Roo.data.Records.
6359 read : function(response){
6360 var doc = response.responseXML;
6362 throw {message: "XmlReader.read: XML Document not available"};
6364 return this.readRecords(doc);
6368 * Create a data block containing Roo.data.Records from an XML document.
6369 * @param {Object} doc A parsed XML document.
6370 * @return {Object} records A data block which is used by an {@link Roo.data.Store} as
6371 * a cache of Roo.data.Records.
6373 readRecords : function(doc){
6375 * After any data loads/reads, the raw XML Document is available for further custom processing.
6379 var root = doc.documentElement || doc;
6380 var q = Roo.DomQuery;
6381 var recordType = this.recordType, fields = recordType.prototype.fields;
6382 var sid = this.meta.id;
6383 var totalRecords = 0, success = true;
6384 if(this.meta.totalRecords){
6385 totalRecords = q.selectNumber(this.meta.totalRecords, root, 0);
6388 if(this.meta.success){
6389 var sv = q.selectValue(this.meta.success, root, true);
6390 success = sv !== false && sv !== 'false';
6393 var ns = q.select(this.meta.record, root);
6394 for(var i = 0, len = ns.length; i < len; i++) {
6397 var id = sid ? q.selectValue(sid, n) : undefined;
6398 for(var j = 0, jlen = fields.length; j < jlen; j++){
6399 var f = fields.items[j];
6400 var v = q.selectValue(f.mapping || f.name, n, f.defaultValue);
6404 var record = new recordType(values, id);
6406 records[records.length] = record;
6412 totalRecords : totalRecords || records.length
6417 * Ext JS Library 1.1.1
6418 * Copyright(c) 2006-2007, Ext JS, LLC.
6420 * Originally Released Under LGPL - original licence link has changed is not relivant.
6423 * <script type="text/javascript">
6427 * @class Roo.data.ArrayReader
6428 * @extends Roo.data.DataReader
6429 * Data reader class to create an Array of Roo.data.Record objects from an Array.
6430 * Each element of that Array represents a row of data fields. The
6431 * fields are pulled into a Record object using as a subscript, the <em>mapping</em> property
6432 * of the field definition if it exists, or the field's ordinal position in the definition.<br>
6436 var RecordDef = Roo.data.Record.create([
6437 {name: 'name', mapping: 1}, // "mapping" only needed if an "id" field is present which
6438 {name: 'occupation', mapping: 2} // precludes using the ordinal position as the index.
6440 var myReader = new Roo.data.ArrayReader({
6441 id: 0 // The subscript within row Array that provides an ID for the Record (optional)
6445 * This would consume an Array like this:
6447 [ [1, 'Bill', 'Gardener'], [2, 'Ben', 'Horticulturalist'] ]
6449 * @cfg {String} id (optional) The subscript within row Array that provides an ID for the Record
6451 * Create a new JsonReader
6452 * @param {Object} meta Metadata configuration options.
6453 * @param {Object} recordType Either an Array of field definition objects
6454 * as specified to {@link Roo.data.Record#create},
6455 * or an {@link Roo.data.Record} object
6456 * created using {@link Roo.data.Record#create}.
6458 Roo.data.ArrayReader = function(meta, recordType){
6459 Roo.data.ArrayReader.superclass.constructor.call(this, meta, recordType);
6462 Roo.extend(Roo.data.ArrayReader, Roo.data.JsonReader, {
6464 * Create a data block containing Roo.data.Records from an XML document.
6465 * @param {Object} o An Array of row objects which represents the dataset.
6466 * @return {Object} data A data block which is used by an Roo.data.Store object as
6467 * a cache of Roo.data.Records.
6469 readRecords : function(o){
6470 var sid = this.meta ? this.meta.id : null;
6471 var recordType = this.recordType, fields = recordType.prototype.fields;
6474 for(var i = 0; i < root.length; i++){
6477 var id = ((sid || sid === 0) && n[sid] !== undefined && n[sid] !== "" ? n[sid] : null);
6478 for(var j = 0, jlen = fields.length; j < jlen; j++){
6479 var f = fields.items[j];
6480 var k = f.mapping !== undefined && f.mapping !== null ? f.mapping : j;
6481 var v = n[k] !== undefined ? n[k] : f.defaultValue;
6485 var record = new recordType(values, id);
6487 records[records.length] = record;
6491 totalRecords : records.length
6496 * Ext JS Library 1.1.1
6497 * Copyright(c) 2006-2007, Ext JS, LLC.
6499 * Originally Released Under LGPL - original licence link has changed is not relivant.
6502 * <script type="text/javascript">
6507 * @class Roo.data.Tree
6508 * @extends Roo.util.Observable
6509 * Represents a tree data structure and bubbles all the events for its nodes. The nodes
6510 * in the tree have most standard DOM functionality.
6512 * @param {Node} root (optional) The root node
6514 Roo.data.Tree = function(root){
6517 * The root node for this tree
6522 this.setRootNode(root);
6527 * Fires when a new child node is appended to a node in this tree.
6528 * @param {Tree} tree The owner tree
6529 * @param {Node} parent The parent node
6530 * @param {Node} node The newly appended node
6531 * @param {Number} index The index of the newly appended node
6536 * Fires when a child node is removed from a node in this tree.
6537 * @param {Tree} tree The owner tree
6538 * @param {Node} parent The parent node
6539 * @param {Node} node The child node removed
6544 * Fires when a node is moved to a new location in the tree
6545 * @param {Tree} tree The owner tree
6546 * @param {Node} node The node moved
6547 * @param {Node} oldParent The old parent of this node
6548 * @param {Node} newParent The new parent of this node
6549 * @param {Number} index The index it was moved to
6554 * Fires when a new child node is inserted in a node in this tree.
6555 * @param {Tree} tree The owner tree
6556 * @param {Node} parent The parent node
6557 * @param {Node} node The child node inserted
6558 * @param {Node} refNode The child node the node was inserted before
6562 * @event beforeappend
6563 * Fires before a new child is appended to a node in this tree, return false to cancel the append.
6564 * @param {Tree} tree The owner tree
6565 * @param {Node} parent The parent node
6566 * @param {Node} node The child node to be appended
6568 "beforeappend" : true,
6570 * @event beforeremove
6571 * Fires before a child is removed from a node in this tree, return false to cancel the remove.
6572 * @param {Tree} tree The owner tree
6573 * @param {Node} parent The parent node
6574 * @param {Node} node The child node to be removed
6576 "beforeremove" : true,
6579 * Fires before a node is moved to a new location in the tree. Return false to cancel the move.
6580 * @param {Tree} tree The owner tree
6581 * @param {Node} node The node being moved
6582 * @param {Node} oldParent The parent of the node
6583 * @param {Node} newParent The new parent the node is moving to
6584 * @param {Number} index The index it is being moved to
6586 "beforemove" : true,
6588 * @event beforeinsert
6589 * Fires before a new child is inserted in a node in this tree, return false to cancel the insert.
6590 * @param {Tree} tree The owner tree
6591 * @param {Node} parent The parent node
6592 * @param {Node} node The child node to be inserted
6593 * @param {Node} refNode The child node the node is being inserted before
6595 "beforeinsert" : true
6598 Roo.data.Tree.superclass.constructor.call(this);
6601 Roo.extend(Roo.data.Tree, Roo.util.Observable, {
6604 proxyNodeEvent : function(){
6605 return this.fireEvent.apply(this, arguments);
6609 * Returns the root node for this tree.
6612 getRootNode : function(){
6617 * Sets the root node for this tree.
6618 * @param {Node} node
6621 setRootNode : function(node){
6623 node.ownerTree = this;
6625 this.registerNode(node);
6630 * Gets a node in this tree by its id.
6631 * @param {String} id
6634 getNodeById : function(id){
6635 return this.nodeHash[id];
6638 registerNode : function(node){
6639 this.nodeHash[node.id] = node;
6642 unregisterNode : function(node){
6643 delete this.nodeHash[node.id];
6646 toString : function(){
6647 return "[Tree"+(this.id?" "+this.id:"")+"]";
6652 * @class Roo.data.Node
6653 * @extends Roo.util.Observable
6654 * @cfg {Boolean} leaf true if this node is a leaf and does not have children
6655 * @cfg {String} id The id for this node. If one is not specified, one is generated.
6657 * @param {Object} attributes The attributes/config for the node
6659 Roo.data.Node = function(attributes){
6661 * The attributes supplied for the node. You can use this property to access any custom attributes you supplied.
6664 this.attributes = attributes || {};
6665 this.leaf = this.attributes.leaf;
6667 * The node id. @type String
6669 this.id = this.attributes.id;
6671 this.id = Roo.id(null, "ynode-");
6672 this.attributes.id = this.id;
6677 * All child nodes of this node. @type Array
6679 this.childNodes = [];
6680 if(!this.childNodes.indexOf){ // indexOf is a must
6681 this.childNodes.indexOf = function(o){
6682 for(var i = 0, len = this.length; i < len; i++){
6691 * The parent node for this node. @type Node
6693 this.parentNode = null;
6695 * The first direct child node of this node, or null if this node has no child nodes. @type Node
6697 this.firstChild = null;
6699 * The last direct child node of this node, or null if this node has no child nodes. @type Node
6701 this.lastChild = null;
6703 * The node immediately preceding this node in the tree, or null if there is no sibling node. @type Node
6705 this.previousSibling = null;
6707 * The node immediately following this node in the tree, or null if there is no sibling node. @type Node
6709 this.nextSibling = null;
6714 * Fires when a new child node is appended
6715 * @param {Tree} tree The owner tree
6716 * @param {Node} this This node
6717 * @param {Node} node The newly appended node
6718 * @param {Number} index The index of the newly appended node
6723 * Fires when a child node is removed
6724 * @param {Tree} tree The owner tree
6725 * @param {Node} this This node
6726 * @param {Node} node The removed node
6731 * Fires when this node is moved to a new location in the tree
6732 * @param {Tree} tree The owner tree
6733 * @param {Node} this This node
6734 * @param {Node} oldParent The old parent of this node
6735 * @param {Node} newParent The new parent of this node
6736 * @param {Number} index The index it was moved to
6741 * Fires when a new child node is inserted.
6742 * @param {Tree} tree The owner tree
6743 * @param {Node} this This node
6744 * @param {Node} node The child node inserted
6745 * @param {Node} refNode The child node the node was inserted before
6749 * @event beforeappend
6750 * Fires before a new child is appended, return false to cancel the append.
6751 * @param {Tree} tree The owner tree
6752 * @param {Node} this This node
6753 * @param {Node} node The child node to be appended
6755 "beforeappend" : true,
6757 * @event beforeremove
6758 * Fires before a child is removed, return false to cancel the remove.
6759 * @param {Tree} tree The owner tree
6760 * @param {Node} this This node
6761 * @param {Node} node The child node to be removed
6763 "beforeremove" : true,
6766 * Fires before this node is moved to a new location in the tree. Return false to cancel the move.
6767 * @param {Tree} tree The owner tree
6768 * @param {Node} this This node
6769 * @param {Node} oldParent The parent of this node
6770 * @param {Node} newParent The new parent this node is moving to
6771 * @param {Number} index The index it is being moved to
6773 "beforemove" : true,
6775 * @event beforeinsert
6776 * Fires before a new child is inserted, return false to cancel the insert.
6777 * @param {Tree} tree The owner tree
6778 * @param {Node} this This node
6779 * @param {Node} node The child node to be inserted
6780 * @param {Node} refNode The child node the node is being inserted before
6782 "beforeinsert" : true
6784 this.listeners = this.attributes.listeners;
6785 Roo.data.Node.superclass.constructor.call(this);
6788 Roo.extend(Roo.data.Node, Roo.util.Observable, {
6789 fireEvent : function(evtName){
6790 // first do standard event for this node
6791 if(Roo.data.Node.superclass.fireEvent.apply(this, arguments) === false){
6794 // then bubble it up to the tree if the event wasn't cancelled
6795 var ot = this.getOwnerTree();
6797 if(ot.proxyNodeEvent.apply(ot, arguments) === false){
6805 * Returns true if this node is a leaf
6808 isLeaf : function(){
6809 return this.leaf === true;
6813 setFirstChild : function(node){
6814 this.firstChild = node;
6818 setLastChild : function(node){
6819 this.lastChild = node;
6824 * Returns true if this node is the last child of its parent
6827 isLast : function(){
6828 return (!this.parentNode ? true : this.parentNode.lastChild == this);
6832 * Returns true if this node is the first child of its parent
6835 isFirst : function(){
6836 return (!this.parentNode ? true : this.parentNode.firstChild == this);
6839 hasChildNodes : function(){
6840 return !this.isLeaf() && this.childNodes.length > 0;
6844 * Insert node(s) as the last child node of this node.
6845 * @param {Node/Array} node The node or Array of nodes to append
6846 * @return {Node} The appended node if single append, or null if an array was passed
6848 appendChild : function(node){
6850 if(node instanceof Array){
6852 }else if(arguments.length > 1){
6855 // if passed an array or multiple args do them one by one
6857 for(var i = 0, len = multi.length; i < len; i++) {
6858 this.appendChild(multi[i]);
6861 if(this.fireEvent("beforeappend", this.ownerTree, this, node) === false){
6864 var index = this.childNodes.length;
6865 var oldParent = node.parentNode;
6866 // it's a move, make sure we move it cleanly
6868 if(node.fireEvent("beforemove", node.getOwnerTree(), node, oldParent, this, index) === false){
6871 oldParent.removeChild(node);
6873 index = this.childNodes.length;
6875 this.setFirstChild(node);
6877 this.childNodes.push(node);
6878 node.parentNode = this;
6879 var ps = this.childNodes[index-1];
6881 node.previousSibling = ps;
6882 ps.nextSibling = node;
6884 node.previousSibling = null;
6886 node.nextSibling = null;
6887 this.setLastChild(node);
6888 node.setOwnerTree(this.getOwnerTree());
6889 this.fireEvent("append", this.ownerTree, this, node, index);
6891 node.fireEvent("move", this.ownerTree, node, oldParent, this, index);
6898 * Removes a child node from this node.
6899 * @param {Node} node The node to remove
6900 * @return {Node} The removed node
6902 removeChild : function(node){
6903 var index = this.childNodes.indexOf(node);
6907 if(this.fireEvent("beforeremove", this.ownerTree, this, node) === false){
6911 // remove it from childNodes collection
6912 this.childNodes.splice(index, 1);
6915 if(node.previousSibling){
6916 node.previousSibling.nextSibling = node.nextSibling;
6918 if(node.nextSibling){
6919 node.nextSibling.previousSibling = node.previousSibling;
6922 // update child refs
6923 if(this.firstChild == node){
6924 this.setFirstChild(node.nextSibling);
6926 if(this.lastChild == node){
6927 this.setLastChild(node.previousSibling);
6930 node.setOwnerTree(null);
6931 // clear any references from the node
6932 node.parentNode = null;
6933 node.previousSibling = null;
6934 node.nextSibling = null;
6935 this.fireEvent("remove", this.ownerTree, this, node);
6940 * Inserts the first node before the second node in this nodes childNodes collection.
6941 * @param {Node} node The node to insert
6942 * @param {Node} refNode The node to insert before (if null the node is appended)
6943 * @return {Node} The inserted node
6945 insertBefore : function(node, refNode){
6946 if(!refNode){ // like standard Dom, refNode can be null for append
6947 return this.appendChild(node);
6950 if(node == refNode){
6954 if(this.fireEvent("beforeinsert", this.ownerTree, this, node, refNode) === false){
6957 var index = this.childNodes.indexOf(refNode);
6958 var oldParent = node.parentNode;
6959 var refIndex = index;
6961 // when moving internally, indexes will change after remove
6962 if(oldParent == this && this.childNodes.indexOf(node) < index){
6966 // it's a move, make sure we move it cleanly
6968 if(node.fireEvent("beforemove", node.getOwnerTree(), node, oldParent, this, index, refNode) === false){
6971 oldParent.removeChild(node);
6974 this.setFirstChild(node);
6976 this.childNodes.splice(refIndex, 0, node);
6977 node.parentNode = this;
6978 var ps = this.childNodes[refIndex-1];
6980 node.previousSibling = ps;
6981 ps.nextSibling = node;
6983 node.previousSibling = null;
6985 node.nextSibling = refNode;
6986 refNode.previousSibling = node;
6987 node.setOwnerTree(this.getOwnerTree());
6988 this.fireEvent("insert", this.ownerTree, this, node, refNode);
6990 node.fireEvent("move", this.ownerTree, node, oldParent, this, refIndex, refNode);
6996 * Returns the child node at the specified index.
6997 * @param {Number} index
7000 item : function(index){
7001 return this.childNodes[index];
7005 * Replaces one child node in this node with another.
7006 * @param {Node} newChild The replacement node
7007 * @param {Node} oldChild The node to replace
7008 * @return {Node} The replaced node
7010 replaceChild : function(newChild, oldChild){
7011 this.insertBefore(newChild, oldChild);
7012 this.removeChild(oldChild);
7017 * Returns the index of a child node
7018 * @param {Node} node
7019 * @return {Number} The index of the node or -1 if it was not found
7021 indexOf : function(child){
7022 return this.childNodes.indexOf(child);
7026 * Returns the tree this node is in.
7029 getOwnerTree : function(){
7030 // if it doesn't have one, look for one
7031 if(!this.ownerTree){
7035 this.ownerTree = p.ownerTree;
7041 return this.ownerTree;
7045 * Returns depth of this node (the root node has a depth of 0)
7048 getDepth : function(){
7051 while(p.parentNode){
7059 setOwnerTree : function(tree){
7060 // if it's move, we need to update everyone
7061 if(tree != this.ownerTree){
7063 this.ownerTree.unregisterNode(this);
7065 this.ownerTree = tree;
7066 var cs = this.childNodes;
7067 for(var i = 0, len = cs.length; i < len; i++) {
7068 cs[i].setOwnerTree(tree);
7071 tree.registerNode(this);
7077 * Returns the path for this node. The path can be used to expand or select this node programmatically.
7078 * @param {String} attr (optional) The attr to use for the path (defaults to the node's id)
7079 * @return {String} The path
7081 getPath : function(attr){
7082 attr = attr || "id";
7083 var p = this.parentNode;
7084 var b = [this.attributes[attr]];
7086 b.unshift(p.attributes[attr]);
7089 var sep = this.getOwnerTree().pathSeparator;
7090 return sep + b.join(sep);
7094 * Bubbles up the tree from this node, calling the specified function with each node. The scope (<i>this</i>) of
7095 * function call will be the scope provided or the current node. The arguments to the function
7096 * will be the args provided or the current node. If the function returns false at any point,
7097 * the bubble is stopped.
7098 * @param {Function} fn The function to call
7099 * @param {Object} scope (optional) The scope of the function (defaults to current node)
7100 * @param {Array} args (optional) The args to call the function with (default to passing the current node)
7102 bubble : function(fn, scope, args){
7105 if(fn.call(scope || p, args || p) === false){
7113 * Cascades down the tree from this node, calling the specified function with each node. The scope (<i>this</i>) of
7114 * function call will be the scope provided or the current node. The arguments to the function
7115 * will be the args provided or the current node. If the function returns false at any point,
7116 * the cascade is stopped on that branch.
7117 * @param {Function} fn The function to call
7118 * @param {Object} scope (optional) The scope of the function (defaults to current node)
7119 * @param {Array} args (optional) The args to call the function with (default to passing the current node)
7121 cascade : function(fn, scope, args){
7122 if(fn.call(scope || this, args || this) !== false){
7123 var cs = this.childNodes;
7124 for(var i = 0, len = cs.length; i < len; i++) {
7125 cs[i].cascade(fn, scope, args);
7131 * Interates the child nodes of this node, calling the specified function with each node. The scope (<i>this</i>) of
7132 * function call will be the scope provided or the current node. The arguments to the function
7133 * will be the args provided or the current node. If the function returns false at any point,
7134 * the iteration stops.
7135 * @param {Function} fn The function to call
7136 * @param {Object} scope (optional) The scope of the function (defaults to current node)
7137 * @param {Array} args (optional) The args to call the function with (default to passing the current node)
7139 eachChild : function(fn, scope, args){
7140 var cs = this.childNodes;
7141 for(var i = 0, len = cs.length; i < len; i++) {
7142 if(fn.call(scope || this, args || cs[i]) === false){
7149 * Finds the first child that has the attribute with the specified value.
7150 * @param {String} attribute The attribute name
7151 * @param {Mixed} value The value to search for
7152 * @return {Node} The found child or null if none was found
7154 findChild : function(attribute, value){
7155 var cs = this.childNodes;
7156 for(var i = 0, len = cs.length; i < len; i++) {
7157 if(cs[i].attributes[attribute] == value){
7165 * Finds the first child by a custom function. The child matches if the function passed
7167 * @param {Function} fn
7168 * @param {Object} scope (optional)
7169 * @return {Node} The found child or null if none was found
7171 findChildBy : function(fn, scope){
7172 var cs = this.childNodes;
7173 for(var i = 0, len = cs.length; i < len; i++) {
7174 if(fn.call(scope||cs[i], cs[i]) === true){
7182 * Sorts this nodes children using the supplied sort function
7183 * @param {Function} fn
7184 * @param {Object} scope (optional)
7186 sort : function(fn, scope){
7187 var cs = this.childNodes;
7188 var len = cs.length;
7190 var sortFn = scope ? function(){fn.apply(scope, arguments);} : fn;
7192 for(var i = 0; i < len; i++){
7194 n.previousSibling = cs[i-1];
7195 n.nextSibling = cs[i+1];
7197 this.setFirstChild(n);
7200 this.setLastChild(n);
7207 * Returns true if this node is an ancestor (at any point) of the passed node.
7208 * @param {Node} node
7211 contains : function(node){
7212 return node.isAncestor(this);
7216 * Returns true if the passed node is an ancestor (at any point) of this node.
7217 * @param {Node} node
7220 isAncestor : function(node){
7221 var p = this.parentNode;
7231 toString : function(){
7232 return "[Node"+(this.id?" "+this.id:"")+"]";
7236 * Ext JS Library 1.1.1
7237 * Copyright(c) 2006-2007, Ext JS, LLC.
7239 * Originally Released Under LGPL - original licence link has changed is not relivant.
7242 * <script type="text/javascript">
7247 * @class Roo.ComponentMgr
7248 * Provides a common registry of all components on a page so that they can be easily accessed by component id (see {@link Roo.getCmp}).
7251 Roo.ComponentMgr = function(){
7252 var all = new Roo.util.MixedCollection();
7256 * Registers a component.
7257 * @param {Roo.Component} c The component
7259 register : function(c){
7264 * Unregisters a component.
7265 * @param {Roo.Component} c The component
7267 unregister : function(c){
7272 * Returns a component by id
7273 * @param {String} id The component id
7280 * Registers a function that will be called when a specified component is added to ComponentMgr
7281 * @param {String} id The component id
7282 * @param {Funtction} fn The callback function
7283 * @param {Object} scope The scope of the callback
7285 onAvailable : function(id, fn, scope){
7286 all.on("add", function(index, o){
7288 fn.call(scope || o, o);
7289 all.un("add", fn, scope);
7296 * Ext JS Library 1.1.1
7297 * Copyright(c) 2006-2007, Ext JS, LLC.
7299 * Originally Released Under LGPL - original licence link has changed is not relivant.
7302 * <script type="text/javascript">
7306 * @class Roo.Component
7307 * @extends Roo.util.Observable
7308 * Base class for all major Roo components. All subclasses of Component can automatically participate in the standard
7309 * Roo component lifecycle of creation, rendering and destruction. They also have automatic support for basic hide/show
7310 * and enable/disable behavior. Component allows any subclass to be lazy-rendered into any {@link Roo.Container} and
7311 * to be automatically registered with the {@link Roo.ComponentMgr} so that it can be referenced at any time via {@link Roo.getCmp}.
7312 * All visual components (widgets) that require rendering into a layout should subclass Component.
7314 * @param {Roo.Element/String/Object} config The configuration options. If an element is passed, it is set as the internal
7315 * element and its id used as the component id. If a string is passed, it is assumed to be the id of an existing element
7316 * and is used as the component id. Otherwise, it is assumed to be a standard config object and is applied to the component.
7318 Roo.Component = function(config){
7319 config = config || {};
7320 if(config.tagName || config.dom || typeof config == "string"){ // element object
7321 config = {el: config, id: config.id || config};
7323 this.initialConfig = config;
7325 Roo.apply(this, config);
7329 * Fires after the component is disabled.
7330 * @param {Roo.Component} this
7335 * Fires after the component is enabled.
7336 * @param {Roo.Component} this
7341 * Fires before the component is shown. Return false to stop the show.
7342 * @param {Roo.Component} this
7347 * Fires after the component is shown.
7348 * @param {Roo.Component} this
7353 * Fires before the component is hidden. Return false to stop the hide.
7354 * @param {Roo.Component} this
7359 * Fires after the component is hidden.
7360 * @param {Roo.Component} this
7364 * @event beforerender
7365 * Fires before the component is rendered. Return false to stop the render.
7366 * @param {Roo.Component} this
7368 beforerender : true,
7371 * Fires after the component is rendered.
7372 * @param {Roo.Component} this
7376 * @event beforedestroy
7377 * Fires before the component is destroyed. Return false to stop the destroy.
7378 * @param {Roo.Component} this
7380 beforedestroy : true,
7383 * Fires after the component is destroyed.
7384 * @param {Roo.Component} this
7389 this.id = "ext-comp-" + (++Roo.Component.AUTO_ID);
7391 Roo.ComponentMgr.register(this);
7392 Roo.Component.superclass.constructor.call(this);
7393 this.initComponent();
7394 if(this.renderTo){ // not supported by all components yet. use at your own risk!
7395 this.render(this.renderTo);
7396 delete this.renderTo;
7401 Roo.Component.AUTO_ID = 1000;
7403 Roo.extend(Roo.Component, Roo.util.Observable, {
7405 * @scope Roo.Component.prototype
7407 * true if this component is hidden. Read-only.
7412 * true if this component is disabled. Read-only.
7417 * true if this component has been rendered. Read-only.
7421 /** @cfg {String} disableClass
7422 * CSS class added to the component when it is disabled (defaults to "x-item-disabled").
7424 disabledClass : "x-item-disabled",
7425 /** @cfg {Boolean} allowDomMove
7426 * Whether the component can move the Dom node when rendering (defaults to true).
7428 allowDomMove : true,
7429 /** @cfg {String} hideMode
7430 * How this component should hidden. Supported values are
7431 * "visibility" (css visibility), "offsets" (negative offset position) and
7432 * "display" (css display) - defaults to "display".
7434 hideMode: 'display',
7437 ctype : "Roo.Component",
7440 * @cfg {String} actionMode
7441 * which property holds the element that used for hide() / show() / disable() / enable()
7447 getActionEl : function(){
7448 return this[this.actionMode];
7451 initComponent : Roo.emptyFn,
7453 * If this is a lazy rendering component, render it to its container element.
7454 * @param {String/HTMLElement/Element} container (optional) The element this component should be rendered into. If it is being applied to existing markup, this should be left off.
7456 render : function(container, position){
7457 if(!this.rendered && this.fireEvent("beforerender", this) !== false){
7458 if(!container && this.el){
7459 this.el = Roo.get(this.el);
7460 container = this.el.dom.parentNode;
7461 this.allowDomMove = false;
7463 this.container = Roo.get(container);
7464 this.rendered = true;
7465 if(position !== undefined){
7466 if(typeof position == 'number'){
7467 position = this.container.dom.childNodes[position];
7469 position = Roo.getDom(position);
7472 this.onRender(this.container, position || null);
7474 this.el.addClass(this.cls);
7478 this.el.applyStyles(this.style);
7481 this.fireEvent("render", this);
7482 this.afterRender(this.container);
7494 // default function is not really useful
7495 onRender : function(ct, position){
7497 this.el = Roo.get(this.el);
7498 if(this.allowDomMove !== false){
7499 ct.dom.insertBefore(this.el.dom, position);
7505 getAutoCreate : function(){
7506 var cfg = typeof this.autoCreate == "object" ?
7507 this.autoCreate : Roo.apply({}, this.defaultAutoCreate);
7508 if(this.id && !cfg.id){
7515 afterRender : Roo.emptyFn,
7518 * Destroys this component by purging any event listeners, removing the component's element from the DOM,
7519 * removing the component from its {@link Roo.Container} (if applicable) and unregistering it from {@link Roo.ComponentMgr}.
7521 destroy : function(){
7522 if(this.fireEvent("beforedestroy", this) !== false){
7523 this.purgeListeners();
7524 this.beforeDestroy();
7526 this.el.removeAllListeners();
7528 if(this.actionMode == "container"){
7529 this.container.remove();
7533 Roo.ComponentMgr.unregister(this);
7534 this.fireEvent("destroy", this);
7539 beforeDestroy : function(){
7544 onDestroy : function(){
7549 * Returns the underlying {@link Roo.Element}.
7550 * @return {Roo.Element} The element
7557 * Returns the id of this component.
7565 * Try to focus this component.
7566 * @param {Boolean} selectText True to also select the text in this component (if applicable)
7567 * @return {Roo.Component} this
7569 focus : function(selectText){
7572 if(selectText === true){
7573 this.el.dom.select();
7588 * Disable this component.
7589 * @return {Roo.Component} this
7591 disable : function(){
7595 this.disabled = true;
7596 this.fireEvent("disable", this);
7601 onDisable : function(){
7602 this.getActionEl().addClass(this.disabledClass);
7603 this.el.dom.disabled = true;
7607 * Enable this component.
7608 * @return {Roo.Component} this
7610 enable : function(){
7614 this.disabled = false;
7615 this.fireEvent("enable", this);
7620 onEnable : function(){
7621 this.getActionEl().removeClass(this.disabledClass);
7622 this.el.dom.disabled = false;
7626 * Convenience function for setting disabled/enabled by boolean.
7627 * @param {Boolean} disabled
7629 setDisabled : function(disabled){
7630 this[disabled ? "disable" : "enable"]();
7634 * Show this component.
7635 * @return {Roo.Component} this
7638 if(this.fireEvent("beforeshow", this) !== false){
7639 this.hidden = false;
7643 this.fireEvent("show", this);
7649 onShow : function(){
7650 var ae = this.getActionEl();
7651 if(this.hideMode == 'visibility'){
7652 ae.dom.style.visibility = "visible";
7653 }else if(this.hideMode == 'offsets'){
7654 ae.removeClass('x-hidden');
7656 ae.dom.style.display = "";
7661 * Hide this component.
7662 * @return {Roo.Component} this
7665 if(this.fireEvent("beforehide", this) !== false){
7670 this.fireEvent("hide", this);
7676 onHide : function(){
7677 var ae = this.getActionEl();
7678 if(this.hideMode == 'visibility'){
7679 ae.dom.style.visibility = "hidden";
7680 }else if(this.hideMode == 'offsets'){
7681 ae.addClass('x-hidden');
7683 ae.dom.style.display = "none";
7688 * Convenience function to hide or show this component by boolean.
7689 * @param {Boolean} visible True to show, false to hide
7690 * @return {Roo.Component} this
7692 setVisible: function(visible){
7702 * Returns true if this component is visible.
7704 isVisible : function(){
7705 return this.getActionEl().isVisible();
7708 cloneConfig : function(overrides){
7709 overrides = overrides || {};
7710 var id = overrides.id || Roo.id();
7711 var cfg = Roo.applyIf(overrides, this.initialConfig);
7712 cfg.id = id; // prevent dup id
7713 return new this.constructor(cfg);
7717 * Ext JS Library 1.1.1
7718 * Copyright(c) 2006-2007, Ext JS, LLC.
7720 * Originally Released Under LGPL - original licence link has changed is not relivant.
7723 * <script type="text/javascript">
7728 * @extends Roo.Element
7729 * An extended {@link Roo.Element} object that supports a shadow and shim, constrain to viewport and
7730 * automatic maintaining of shadow/shim positions.
7731 * @cfg {Boolean} shim False to disable the iframe shim in browsers which need one (defaults to true)
7732 * @cfg {String/Boolean} shadow True to create a shadow element with default class "x-layer-shadow", or
7733 * you can pass a string with a CSS class name. False turns off the shadow.
7734 * @cfg {Object} dh DomHelper object config to create element with (defaults to {tag: "div", cls: "x-layer"}).
7735 * @cfg {Boolean} constrain False to disable constrain to viewport (defaults to true)
7736 * @cfg {String} cls CSS class to add to the element
7737 * @cfg {Number} zindex Starting z-index (defaults to 11000)
7738 * @cfg {Number} shadowOffset Number of pixels to offset the shadow (defaults to 3)
7740 * @param {Object} config An object with config options.
7741 * @param {String/HTMLElement} existingEl (optional) Uses an existing DOM element. If the element is not found it creates it.
7744 Roo.Layer = function(config, existingEl){
7745 config = config || {};
7746 var dh = Roo.DomHelper;
7747 var cp = config.parentEl, pel = cp ? Roo.getDom(cp) : document.body;
7749 this.dom = Roo.getDom(existingEl);
7752 var o = config.dh || {tag: "div", cls: "x-layer"};
7753 this.dom = dh.append(pel, o);
7756 this.addClass(config.cls);
7758 this.constrain = config.constrain !== false;
7759 this.visibilityMode = Roo.Element.VISIBILITY;
7761 this.id = this.dom.id = config.id;
7763 this.id = Roo.id(this.dom);
7765 this.zindex = config.zindex || this.getZIndex();
7766 this.position("absolute", this.zindex);
7768 this.shadowOffset = config.shadowOffset || 4;
7769 this.shadow = new Roo.Shadow({
7770 offset : this.shadowOffset,
7771 mode : config.shadow
7774 this.shadowOffset = 0;
7776 this.useShim = config.shim !== false && Roo.useShims;
7777 this.useDisplay = config.useDisplay;
7781 var supr = Roo.Element.prototype;
7783 // shims are shared among layer to keep from having 100 iframes
7786 Roo.extend(Roo.Layer, Roo.Element, {
7788 getZIndex : function(){
7789 return this.zindex || parseInt(this.getStyle("z-index"), 10) || 11000;
7792 getShim : function(){
7799 var shim = shims.shift();
7801 shim = this.createShim();
7802 shim.enableDisplayMode('block');
7803 shim.dom.style.display = 'none';
7804 shim.dom.style.visibility = 'visible';
7806 var pn = this.dom.parentNode;
7807 if(shim.dom.parentNode != pn){
7808 pn.insertBefore(shim.dom, this.dom);
7810 shim.setStyle('z-index', this.getZIndex()-2);
7815 hideShim : function(){
7817 this.shim.setDisplayed(false);
7818 shims.push(this.shim);
7823 disableShadow : function(){
7825 this.shadowDisabled = true;
7827 this.lastShadowOffset = this.shadowOffset;
7828 this.shadowOffset = 0;
7832 enableShadow : function(show){
7834 this.shadowDisabled = false;
7835 this.shadowOffset = this.lastShadowOffset;
7836 delete this.lastShadowOffset;
7844 // this code can execute repeatedly in milliseconds (i.e. during a drag) so
7845 // code size was sacrificed for effeciency (e.g. no getBox/setBox, no XY calls)
7846 sync : function(doShow){
7847 var sw = this.shadow;
7848 if(!this.updating && this.isVisible() && (sw || this.useShim)){
7849 var sh = this.getShim();
7851 var w = this.getWidth(),
7852 h = this.getHeight();
7854 var l = this.getLeft(true),
7855 t = this.getTop(true);
7857 if(sw && !this.shadowDisabled){
7858 if(doShow && !sw.isVisible()){
7861 sw.realign(l, t, w, h);
7867 // fit the shim behind the shadow, so it is shimmed too
7868 var a = sw.adjusts, s = sh.dom.style;
7869 s.left = (Math.min(l, l+a.l))+"px";
7870 s.top = (Math.min(t, t+a.t))+"px";
7871 s.width = (w+a.w)+"px";
7872 s.height = (h+a.h)+"px";
7879 sh.setLeftTop(l, t);
7886 destroy : function(){
7891 this.removeAllListeners();
7892 var pn = this.dom.parentNode;
7894 pn.removeChild(this.dom);
7896 Roo.Element.uncache(this.id);
7899 remove : function(){
7904 beginUpdate : function(){
7905 this.updating = true;
7909 endUpdate : function(){
7910 this.updating = false;
7915 hideUnders : function(negOffset){
7923 constrainXY : function(){
7925 var vw = Roo.lib.Dom.getViewWidth(),
7926 vh = Roo.lib.Dom.getViewHeight();
7927 var s = Roo.get(document).getScroll();
7929 var xy = this.getXY();
7930 var x = xy[0], y = xy[1];
7931 var w = this.dom.offsetWidth+this.shadowOffset, h = this.dom.offsetHeight+this.shadowOffset;
7932 // only move it if it needs it
7934 // first validate right/bottom
7935 if((x + w) > vw+s.left){
7936 x = vw - w - this.shadowOffset;
7939 if((y + h) > vh+s.top){
7940 y = vh - h - this.shadowOffset;
7943 // then make sure top/left isn't negative
7954 var ay = this.avoidY;
7955 if(y <= ay && (y+h) >= ay){
7961 supr.setXY.call(this, xy);
7967 isVisible : function(){
7968 return this.visible;
7972 showAction : function(){
7973 this.visible = true; // track visibility to prevent getStyle calls
7974 if(this.useDisplay === true){
7975 this.setDisplayed("");
7976 }else if(this.lastXY){
7977 supr.setXY.call(this, this.lastXY);
7978 }else if(this.lastLT){
7979 supr.setLeftTop.call(this, this.lastLT[0], this.lastLT[1]);
7984 hideAction : function(){
7985 this.visible = false;
7986 if(this.useDisplay === true){
7987 this.setDisplayed(false);
7989 this.setLeftTop(-10000,-10000);
7993 // overridden Element method
7994 setVisible : function(v, a, d, c, e){
7999 var cb = function(){
8004 }.createDelegate(this);
8005 supr.setVisible.call(this, true, true, d, cb, e);
8008 this.hideUnders(true);
8017 }.createDelegate(this);
8019 supr.setVisible.call(this, v, a, d, cb, e);
8028 storeXY : function(xy){
8033 storeLeftTop : function(left, top){
8035 this.lastLT = [left, top];
8039 beforeFx : function(){
8040 this.beforeAction();
8041 return Roo.Layer.superclass.beforeFx.apply(this, arguments);
8045 afterFx : function(){
8046 Roo.Layer.superclass.afterFx.apply(this, arguments);
8047 this.sync(this.isVisible());
8051 beforeAction : function(){
8052 if(!this.updating && this.shadow){
8057 // overridden Element method
8058 setLeft : function(left){
8059 this.storeLeftTop(left, this.getTop(true));
8060 supr.setLeft.apply(this, arguments);
8064 setTop : function(top){
8065 this.storeLeftTop(this.getLeft(true), top);
8066 supr.setTop.apply(this, arguments);
8070 setLeftTop : function(left, top){
8071 this.storeLeftTop(left, top);
8072 supr.setLeftTop.apply(this, arguments);
8076 setXY : function(xy, a, d, c, e){
8078 this.beforeAction();
8080 var cb = this.createCB(c);
8081 supr.setXY.call(this, xy, a, d, cb, e);
8088 createCB : function(c){
8099 // overridden Element method
8100 setX : function(x, a, d, c, e){
8101 this.setXY([x, this.getY()], a, d, c, e);
8104 // overridden Element method
8105 setY : function(y, a, d, c, e){
8106 this.setXY([this.getX(), y], a, d, c, e);
8109 // overridden Element method
8110 setSize : function(w, h, a, d, c, e){
8111 this.beforeAction();
8112 var cb = this.createCB(c);
8113 supr.setSize.call(this, w, h, a, d, cb, e);
8119 // overridden Element method
8120 setWidth : function(w, a, d, c, e){
8121 this.beforeAction();
8122 var cb = this.createCB(c);
8123 supr.setWidth.call(this, w, a, d, cb, e);
8129 // overridden Element method
8130 setHeight : function(h, a, d, c, e){
8131 this.beforeAction();
8132 var cb = this.createCB(c);
8133 supr.setHeight.call(this, h, a, d, cb, e);
8139 // overridden Element method
8140 setBounds : function(x, y, w, h, a, d, c, e){
8141 this.beforeAction();
8142 var cb = this.createCB(c);
8144 this.storeXY([x, y]);
8145 supr.setXY.call(this, [x, y]);
8146 supr.setSize.call(this, w, h, a, d, cb, e);
8149 supr.setBounds.call(this, x, y, w, h, a, d, cb, e);
8155 * Sets the z-index of this layer and adjusts any shadow and shim z-indexes. The layer z-index is automatically
8156 * incremented by two more than the value passed in so that it always shows above any shadow or shim (the shadow
8157 * element, if any, will be assigned z-index + 1, and the shim element, if any, will be assigned the unmodified z-index).
8158 * @param {Number} zindex The new z-index to set
8159 * @return {this} The Layer
8161 setZIndex : function(zindex){
8162 this.zindex = zindex;
8163 this.setStyle("z-index", zindex + 2);
8165 this.shadow.setZIndex(zindex + 1);
8168 this.shim.setStyle("z-index", zindex);
8174 * Ext JS Library 1.1.1
8175 * Copyright(c) 2006-2007, Ext JS, LLC.
8177 * Originally Released Under LGPL - original licence link has changed is not relivant.
8180 * <script type="text/javascript">
8186 * Simple class that can provide a shadow effect for any element. Note that the element MUST be absolutely positioned,
8187 * and the shadow does not provide any shimming. This should be used only in simple cases -- for more advanced
8188 * functionality that can also provide the same shadow effect, see the {@link Roo.Layer} class.
8190 * Create a new Shadow
8191 * @param {Object} config The config object
8193 Roo.Shadow = function(config){
8194 Roo.apply(this, config);
8195 if(typeof this.mode != "string"){
8196 this.mode = this.defaultMode;
8198 var o = this.offset, a = {h: 0};
8199 var rad = Math.floor(this.offset/2);
8200 switch(this.mode.toLowerCase()){ // all this hideous nonsense calculates the various offsets for shadows
8206 a.l -= this.offset + rad;
8207 a.t -= this.offset + rad;
8218 a.l -= (this.offset - rad);
8219 a.t -= this.offset + rad;
8221 a.w -= (this.offset - rad)*2;
8232 a.l -= (this.offset - rad);
8233 a.t -= (this.offset - rad);
8235 a.w -= (this.offset + rad + 1);
8236 a.h -= (this.offset + rad);
8245 Roo.Shadow.prototype = {
8247 * @cfg {String} mode
8248 * The shadow display mode. Supports the following options:<br />
8249 * sides: Shadow displays on both sides and bottom only<br />
8250 * frame: Shadow displays equally on all four sides<br />
8251 * drop: Traditional bottom-right drop shadow (default)
8254 * @cfg {String} offset
8255 * The number of pixels to offset the shadow from the element (defaults to 4)
8260 defaultMode: "drop",
8263 * Displays the shadow under the target element
8264 * @param {String/HTMLElement/Element} targetEl The id or element under which the shadow should display
8266 show : function(target){
8267 target = Roo.get(target);
8269 this.el = Roo.Shadow.Pool.pull();
8270 if(this.el.dom.nextSibling != target.dom){
8271 this.el.insertBefore(target);
8274 this.el.setStyle("z-index", this.zIndex || parseInt(target.getStyle("z-index"), 10)-1);
8276 this.el.dom.style.filter="progid:DXImageTransform.Microsoft.alpha(opacity=50) progid:DXImageTransform.Microsoft.Blur(pixelradius="+(this.offset)+")";
8279 target.getLeft(true),
8280 target.getTop(true),
8284 this.el.dom.style.display = "block";
8288 * Returns true if the shadow is visible, else false
8290 isVisible : function(){
8291 return this.el ? true : false;
8295 * Direct alignment when values are already available. Show must be called at least once before
8296 * calling this method to ensure it is initialized.
8297 * @param {Number} left The target element left position
8298 * @param {Number} top The target element top position
8299 * @param {Number} width The target element width
8300 * @param {Number} height The target element height
8302 realign : function(l, t, w, h){
8306 var a = this.adjusts, d = this.el.dom, s = d.style;
8308 s.left = (l+a.l)+"px";
8309 s.top = (t+a.t)+"px";
8310 var sw = (w+a.w), sh = (h+a.h), sws = sw +"px", shs = sh + "px";
8312 if(s.width != sws || s.height != shs){
8316 var cn = d.childNodes;
8317 var sww = Math.max(0, (sw-12))+"px";
8318 cn[0].childNodes[1].style.width = sww;
8319 cn[1].childNodes[1].style.width = sww;
8320 cn[2].childNodes[1].style.width = sww;
8321 cn[1].style.height = Math.max(0, (sh-12))+"px";
8331 this.el.dom.style.display = "none";
8332 Roo.Shadow.Pool.push(this.el);
8338 * Adjust the z-index of this shadow
8339 * @param {Number} zindex The new z-index
8341 setZIndex : function(z){
8344 this.el.setStyle("z-index", z);
8349 // Private utility class that manages the internal Shadow cache
8350 Roo.Shadow.Pool = function(){
8352 var markup = Roo.isIE ?
8353 '<div class="x-ie-shadow"></div>' :
8354 '<div class="x-shadow"><div class="xst"><div class="xstl"></div><div class="xstc"></div><div class="xstr"></div></div><div class="xsc"><div class="xsml"></div><div class="xsmc"></div><div class="xsmr"></div></div><div class="xsb"><div class="xsbl"></div><div class="xsbc"></div><div class="xsbr"></div></div></div>';
8359 sh = Roo.get(Roo.DomHelper.insertHtml("beforeBegin", document.body.firstChild, markup));
8360 sh.autoBoxAdjust = false;
8365 push : function(sh){
8371 * Ext JS Library 1.1.1
8372 * Copyright(c) 2006-2007, Ext JS, LLC.
8374 * Originally Released Under LGPL - original licence link has changed is not relivant.
8377 * <script type="text/javascript">
8381 * @class Roo.BoxComponent
8382 * @extends Roo.Component
8383 * Base class for any visual {@link Roo.Component} that uses a box container. BoxComponent provides automatic box
8384 * model adjustments for sizing and positioning and will work correctly withnin the Component rendering model. All
8385 * container classes should subclass BoxComponent so that they will work consistently when nested within other Ext
8386 * layout containers.
8388 * @param {Roo.Element/String/Object} config The configuration options.
8390 Roo.BoxComponent = function(config){
8391 Roo.Component.call(this, config);
8395 * Fires after the component is resized.
8396 * @param {Roo.Component} this
8397 * @param {Number} adjWidth The box-adjusted width that was set
8398 * @param {Number} adjHeight The box-adjusted height that was set
8399 * @param {Number} rawWidth The width that was originally specified
8400 * @param {Number} rawHeight The height that was originally specified
8405 * Fires after the component is moved.
8406 * @param {Roo.Component} this
8407 * @param {Number} x The new x position
8408 * @param {Number} y The new y position
8414 Roo.extend(Roo.BoxComponent, Roo.Component, {
8415 // private, set in afterRender to signify that the component has been rendered
8417 // private, used to defer height settings to subclasses
8419 /** @cfg {Number} width
8420 * width (optional) size of component
8422 /** @cfg {Number} height
8423 * height (optional) size of component
8427 * Sets the width and height of the component. This method fires the resize event. This method can accept
8428 * either width and height as separate numeric arguments, or you can pass a size object like {width:10, height:20}.
8429 * @param {Number/Object} width The new width to set, or a size object in the format {width, height}
8430 * @param {Number} height The new height to set (not required if a size object is passed as the first arg)
8431 * @return {Roo.BoxComponent} this
8433 setSize : function(w, h){
8434 // support for standard size objects
8435 if(typeof w == 'object'){
8446 // prevent recalcs when not needed
8447 if(this.lastSize && this.lastSize.width == w && this.lastSize.height == h){
8450 this.lastSize = {width: w, height: h};
8452 var adj = this.adjustSize(w, h);
8453 var aw = adj.width, ah = adj.height;
8454 if(aw !== undefined || ah !== undefined){ // this code is nasty but performs better with floaters
8455 var rz = this.getResizeEl();
8456 if(!this.deferHeight && aw !== undefined && ah !== undefined){
8458 }else if(!this.deferHeight && ah !== undefined){
8460 }else if(aw !== undefined){
8463 this.onResize(aw, ah, w, h);
8464 this.fireEvent('resize', this, aw, ah, w, h);
8470 * Gets the current size of the component's underlying element.
8471 * @return {Object} An object containing the element's size {width: (element width), height: (element height)}
8473 getSize : function(){
8474 return this.el.getSize();
8478 * Gets the current XY position of the component's underlying element.
8479 * @param {Boolean} local (optional) If true the element's left and top are returned instead of page XY (defaults to false)
8480 * @return {Array} The XY position of the element (e.g., [100, 200])
8482 getPosition : function(local){
8484 return [this.el.getLeft(true), this.el.getTop(true)];
8486 return this.xy || this.el.getXY();
8490 * Gets the current box measurements of the component's underlying element.
8491 * @param {Boolean} local (optional) If true the element's left and top are returned instead of page XY (defaults to false)
8492 * @returns {Object} box An object in the format {x, y, width, height}
8494 getBox : function(local){
8495 var s = this.el.getSize();
8497 s.x = this.el.getLeft(true);
8498 s.y = this.el.getTop(true);
8500 var xy = this.xy || this.el.getXY();
8508 * Sets the current box measurements of the component's underlying element.
8509 * @param {Object} box An object in the format {x, y, width, height}
8510 * @returns {Roo.BoxComponent} this
8512 updateBox : function(box){
8513 this.setSize(box.width, box.height);
8514 this.setPagePosition(box.x, box.y);
8519 getResizeEl : function(){
8520 return this.resizeEl || this.el;
8524 getPositionEl : function(){
8525 return this.positionEl || this.el;
8529 * Sets the left and top of the component. To set the page XY position instead, use {@link #setPagePosition}.
8530 * This method fires the move event.
8531 * @param {Number} left The new left
8532 * @param {Number} top The new top
8533 * @returns {Roo.BoxComponent} this
8535 setPosition : function(x, y){
8541 var adj = this.adjustPosition(x, y);
8542 var ax = adj.x, ay = adj.y;
8544 var el = this.getPositionEl();
8545 if(ax !== undefined || ay !== undefined){
8546 if(ax !== undefined && ay !== undefined){
8547 el.setLeftTop(ax, ay);
8548 }else if(ax !== undefined){
8550 }else if(ay !== undefined){
8553 this.onPosition(ax, ay);
8554 this.fireEvent('move', this, ax, ay);
8560 * Sets the page XY position of the component. To set the left and top instead, use {@link #setPosition}.
8561 * This method fires the move event.
8562 * @param {Number} x The new x position
8563 * @param {Number} y The new y position
8564 * @returns {Roo.BoxComponent} this
8566 setPagePosition : function(x, y){
8572 if(x === undefined || y === undefined){ // cannot translate undefined points
8575 var p = this.el.translatePoints(x, y);
8576 this.setPosition(p.left, p.top);
8581 onRender : function(ct, position){
8582 Roo.BoxComponent.superclass.onRender.call(this, ct, position);
8584 this.resizeEl = Roo.get(this.resizeEl);
8586 if(this.positionEl){
8587 this.positionEl = Roo.get(this.positionEl);
8592 afterRender : function(){
8593 Roo.BoxComponent.superclass.afterRender.call(this);
8594 this.boxReady = true;
8595 this.setSize(this.width, this.height);
8596 if(this.x || this.y){
8597 this.setPosition(this.x, this.y);
8599 if(this.pageX || this.pageY){
8600 this.setPagePosition(this.pageX, this.pageY);
8605 * Force the component's size to recalculate based on the underlying element's current height and width.
8606 * @returns {Roo.BoxComponent} this
8608 syncSize : function(){
8609 delete this.lastSize;
8610 this.setSize(this.el.getWidth(), this.el.getHeight());
8615 * Called after the component is resized, this method is empty by default but can be implemented by any
8616 * subclass that needs to perform custom logic after a resize occurs.
8617 * @param {Number} adjWidth The box-adjusted width that was set
8618 * @param {Number} adjHeight The box-adjusted height that was set
8619 * @param {Number} rawWidth The width that was originally specified
8620 * @param {Number} rawHeight The height that was originally specified
8622 onResize : function(adjWidth, adjHeight, rawWidth, rawHeight){
8627 * Called after the component is moved, this method is empty by default but can be implemented by any
8628 * subclass that needs to perform custom logic after a move occurs.
8629 * @param {Number} x The new x position
8630 * @param {Number} y The new y position
8632 onPosition : function(x, y){
8637 adjustSize : function(w, h){
8641 if(this.autoHeight){
8644 return {width : w, height: h};
8648 adjustPosition : function(x, y){
8649 return {x : x, y: y};
8653 * Ext JS Library 1.1.1
8654 * Copyright(c) 2006-2007, Ext JS, LLC.
8656 * Originally Released Under LGPL - original licence link has changed is not relivant.
8659 * <script type="text/javascript">
8664 * @class Roo.SplitBar
8665 * @extends Roo.util.Observable
8666 * Creates draggable splitter bar functionality from two elements (element to be dragged and element to be resized).
8670 var split = new Roo.SplitBar("elementToDrag", "elementToSize",
8671 Roo.SplitBar.HORIZONTAL, Roo.SplitBar.LEFT);
8672 split.setAdapter(new Roo.SplitBar.AbsoluteLayoutAdapter("container"));
8673 split.minSize = 100;
8674 split.maxSize = 600;
8675 split.animate = true;
8676 split.on('moved', splitterMoved);
8679 * Create a new SplitBar
8680 * @param {String/HTMLElement/Roo.Element} dragElement The element to be dragged and act as the SplitBar.
8681 * @param {String/HTMLElement/Roo.Element} resizingElement The element to be resized based on where the SplitBar element is dragged
8682 * @param {Number} orientation (optional) Either Roo.SplitBar.HORIZONTAL or Roo.SplitBar.VERTICAL. (Defaults to HORIZONTAL)
8683 * @param {Number} placement (optional) Either Roo.SplitBar.LEFT or Roo.SplitBar.RIGHT for horizontal or
8684 Roo.SplitBar.TOP or Roo.SplitBar.BOTTOM for vertical. (By default, this is determined automatically by the initial
8685 position of the SplitBar).
8687 Roo.SplitBar = function(dragElement, resizingElement, orientation, placement, existingProxy){
8690 this.el = Roo.get(dragElement, true);
8691 this.el.dom.unselectable = "on";
8693 this.resizingEl = Roo.get(resizingElement, true);
8697 * The orientation of the split. Either Roo.SplitBar.HORIZONTAL or Roo.SplitBar.VERTICAL. (Defaults to HORIZONTAL)
8698 * Note: If this is changed after creating the SplitBar, the placement property must be manually updated
8701 this.orientation = orientation || Roo.SplitBar.HORIZONTAL;
8704 * The minimum size of the resizing element. (Defaults to 0)
8710 * The maximum size of the resizing element. (Defaults to 2000)
8713 this.maxSize = 2000;
8716 * Whether to animate the transition to the new size
8719 this.animate = false;
8722 * Whether to create a transparent shim that overlays the page when dragging, enables dragging across iframes.
8725 this.useShim = false;
8732 this.proxy = Roo.SplitBar.createProxy(this.orientation);
8734 this.proxy = Roo.get(existingProxy).dom;
8737 this.dd = new Roo.dd.DDProxy(this.el.dom.id, "XSplitBars", {dragElId : this.proxy.id});
8740 this.dd.b4StartDrag = this.onStartProxyDrag.createDelegate(this);
8743 this.dd.endDrag = this.onEndProxyDrag.createDelegate(this);
8746 this.dragSpecs = {};
8749 * @private The adapter to use to positon and resize elements
8751 this.adapter = new Roo.SplitBar.BasicLayoutAdapter();
8752 this.adapter.init(this);
8754 if(this.orientation == Roo.SplitBar.HORIZONTAL){
8756 this.placement = placement || (this.el.getX() > this.resizingEl.getX() ? Roo.SplitBar.LEFT : Roo.SplitBar.RIGHT);
8757 this.el.addClass("x-splitbar-h");
8760 this.placement = placement || (this.el.getY() > this.resizingEl.getY() ? Roo.SplitBar.TOP : Roo.SplitBar.BOTTOM);
8761 this.el.addClass("x-splitbar-v");
8767 * Fires when the splitter is moved (alias for {@link #event-moved})
8768 * @param {Roo.SplitBar} this
8769 * @param {Number} newSize the new width or height
8774 * Fires when the splitter is moved
8775 * @param {Roo.SplitBar} this
8776 * @param {Number} newSize the new width or height
8780 * @event beforeresize
8781 * Fires before the splitter is dragged
8782 * @param {Roo.SplitBar} this
8784 "beforeresize" : true,
8786 "beforeapply" : true
8789 Roo.util.Observable.call(this);
8792 Roo.extend(Roo.SplitBar, Roo.util.Observable, {
8793 onStartProxyDrag : function(x, y){
8794 this.fireEvent("beforeresize", this);
8796 var o = Roo.DomHelper.insertFirst(document.body, {cls: "x-drag-overlay", html: " "}, true);
8798 o.enableDisplayMode("block");
8799 // all splitbars share the same overlay
8800 Roo.SplitBar.prototype.overlay = o;
8802 this.overlay.setSize(Roo.lib.Dom.getViewWidth(true), Roo.lib.Dom.getViewHeight(true));
8803 this.overlay.show();
8804 Roo.get(this.proxy).setDisplayed("block");
8805 var size = this.adapter.getElementSize(this);
8806 this.activeMinSize = this.getMinimumSize();;
8807 this.activeMaxSize = this.getMaximumSize();;
8808 var c1 = size - this.activeMinSize;
8809 var c2 = Math.max(this.activeMaxSize - size, 0);
8810 if(this.orientation == Roo.SplitBar.HORIZONTAL){
8811 this.dd.resetConstraints();
8812 this.dd.setXConstraint(
8813 this.placement == Roo.SplitBar.LEFT ? c1 : c2,
8814 this.placement == Roo.SplitBar.LEFT ? c2 : c1
8816 this.dd.setYConstraint(0, 0);
8818 this.dd.resetConstraints();
8819 this.dd.setXConstraint(0, 0);
8820 this.dd.setYConstraint(
8821 this.placement == Roo.SplitBar.TOP ? c1 : c2,
8822 this.placement == Roo.SplitBar.TOP ? c2 : c1
8825 this.dragSpecs.startSize = size;
8826 this.dragSpecs.startPoint = [x, y];
8827 Roo.dd.DDProxy.prototype.b4StartDrag.call(this.dd, x, y);
8831 * @private Called after the drag operation by the DDProxy
8833 onEndProxyDrag : function(e){
8834 Roo.get(this.proxy).setDisplayed(false);
8835 var endPoint = Roo.lib.Event.getXY(e);
8837 this.overlay.hide();
8840 if(this.orientation == Roo.SplitBar.HORIZONTAL){
8841 newSize = this.dragSpecs.startSize +
8842 (this.placement == Roo.SplitBar.LEFT ?
8843 endPoint[0] - this.dragSpecs.startPoint[0] :
8844 this.dragSpecs.startPoint[0] - endPoint[0]
8847 newSize = this.dragSpecs.startSize +
8848 (this.placement == Roo.SplitBar.TOP ?
8849 endPoint[1] - this.dragSpecs.startPoint[1] :
8850 this.dragSpecs.startPoint[1] - endPoint[1]
8853 newSize = Math.min(Math.max(newSize, this.activeMinSize), this.activeMaxSize);
8854 if(newSize != this.dragSpecs.startSize){
8855 if(this.fireEvent('beforeapply', this, newSize) !== false){
8856 this.adapter.setElementSize(this, newSize);
8857 this.fireEvent("moved", this, newSize);
8858 this.fireEvent("resize", this, newSize);
8864 * Get the adapter this SplitBar uses
8865 * @return The adapter object
8867 getAdapter : function(){
8868 return this.adapter;
8872 * Set the adapter this SplitBar uses
8873 * @param {Object} adapter A SplitBar adapter object
8875 setAdapter : function(adapter){
8876 this.adapter = adapter;
8877 this.adapter.init(this);
8881 * Gets the minimum size for the resizing element
8882 * @return {Number} The minimum size
8884 getMinimumSize : function(){
8885 return this.minSize;
8889 * Sets the minimum size for the resizing element
8890 * @param {Number} minSize The minimum size
8892 setMinimumSize : function(minSize){
8893 this.minSize = minSize;
8897 * Gets the maximum size for the resizing element
8898 * @return {Number} The maximum size
8900 getMaximumSize : function(){
8901 return this.maxSize;
8905 * Sets the maximum size for the resizing element
8906 * @param {Number} maxSize The maximum size
8908 setMaximumSize : function(maxSize){
8909 this.maxSize = maxSize;
8913 * Sets the initialize size for the resizing element
8914 * @param {Number} size The initial size
8916 setCurrentSize : function(size){
8917 var oldAnimate = this.animate;
8918 this.animate = false;
8919 this.adapter.setElementSize(this, size);
8920 this.animate = oldAnimate;
8924 * Destroy this splitbar.
8925 * @param {Boolean} removeEl True to remove the element
8927 destroy : function(removeEl){
8932 this.proxy.parentNode.removeChild(this.proxy);
8940 * @private static Create our own proxy element element. So it will be the same same size on all browsers, we won't use borders. Instead we use a background color.
8942 Roo.SplitBar.createProxy = function(dir){
8943 var proxy = new Roo.Element(document.createElement("div"));
8944 proxy.unselectable();
8945 var cls = 'x-splitbar-proxy';
8946 proxy.addClass(cls + ' ' + (dir == Roo.SplitBar.HORIZONTAL ? cls +'-h' : cls + '-v'));
8947 document.body.appendChild(proxy.dom);
8952 * @class Roo.SplitBar.BasicLayoutAdapter
8953 * Default Adapter. It assumes the splitter and resizing element are not positioned
8954 * elements and only gets/sets the width of the element. Generally used for table based layouts.
8956 Roo.SplitBar.BasicLayoutAdapter = function(){
8959 Roo.SplitBar.BasicLayoutAdapter.prototype = {
8960 // do nothing for now
8965 * Called before drag operations to get the current size of the resizing element.
8966 * @param {Roo.SplitBar} s The SplitBar using this adapter
8968 getElementSize : function(s){
8969 if(s.orientation == Roo.SplitBar.HORIZONTAL){
8970 return s.resizingEl.getWidth();
8972 return s.resizingEl.getHeight();
8977 * Called after drag operations to set the size of the resizing element.
8978 * @param {Roo.SplitBar} s The SplitBar using this adapter
8979 * @param {Number} newSize The new size to set
8980 * @param {Function} onComplete A function to be invoked when resizing is complete
8982 setElementSize : function(s, newSize, onComplete){
8983 if(s.orientation == Roo.SplitBar.HORIZONTAL){
8985 s.resizingEl.setWidth(newSize);
8987 onComplete(s, newSize);
8990 s.resizingEl.setWidth(newSize, true, .1, onComplete, 'easeOut');
8995 s.resizingEl.setHeight(newSize);
8997 onComplete(s, newSize);
9000 s.resizingEl.setHeight(newSize, true, .1, onComplete, 'easeOut');
9007 *@class Roo.SplitBar.AbsoluteLayoutAdapter
9008 * @extends Roo.SplitBar.BasicLayoutAdapter
9009 * Adapter that moves the splitter element to align with the resized sizing element.
9010 * Used with an absolute positioned SplitBar.
9011 * @param {String/HTMLElement/Roo.Element} container The container that wraps around the absolute positioned content. If it's
9012 * document.body, make sure you assign an id to the body element.
9014 Roo.SplitBar.AbsoluteLayoutAdapter = function(container){
9015 this.basic = new Roo.SplitBar.BasicLayoutAdapter();
9016 this.container = Roo.get(container);
9019 Roo.SplitBar.AbsoluteLayoutAdapter.prototype = {
9024 getElementSize : function(s){
9025 return this.basic.getElementSize(s);
9028 setElementSize : function(s, newSize, onComplete){
9029 this.basic.setElementSize(s, newSize, this.moveSplitter.createDelegate(this, [s]));
9032 moveSplitter : function(s){
9033 var yes = Roo.SplitBar;
9034 switch(s.placement){
9036 s.el.setX(s.resizingEl.getRight());
9039 s.el.setStyle("right", (this.container.getWidth() - s.resizingEl.getLeft()) + "px");
9042 s.el.setY(s.resizingEl.getBottom());
9045 s.el.setY(s.resizingEl.getTop() - s.el.getHeight());
9052 * Orientation constant - Create a vertical SplitBar
9056 Roo.SplitBar.VERTICAL = 1;
9059 * Orientation constant - Create a horizontal SplitBar
9063 Roo.SplitBar.HORIZONTAL = 2;
9066 * Placement constant - The resizing element is to the left of the splitter element
9070 Roo.SplitBar.LEFT = 1;
9073 * Placement constant - The resizing element is to the right of the splitter element
9077 Roo.SplitBar.RIGHT = 2;
9080 * Placement constant - The resizing element is positioned above the splitter element
9084 Roo.SplitBar.TOP = 3;
9087 * Placement constant - The resizing element is positioned under splitter element
9091 Roo.SplitBar.BOTTOM = 4;
9094 * Ext JS Library 1.1.1
9095 * Copyright(c) 2006-2007, Ext JS, LLC.
9097 * Originally Released Under LGPL - original licence link has changed is not relivant.
9100 * <script type="text/javascript">
9105 * @extends Roo.util.Observable
9106 * Create a "View" for an element based on a data model or UpdateManager and the supplied DomHelper template.
9107 * This class also supports single and multi selection modes. <br>
9108 * Create a data model bound view:
9110 var store = new Roo.data.Store(...);
9112 var view = new Roo.View({
9114 tpl : '<div id="{0}">{2} - {1}</div>', // auto create template
9117 selectedClass: "ydataview-selected",
9121 // listen for node click?
9122 view.on("click", function(vw, index, node, e){
9123 alert('Node "' + node.id + '" at index: ' + index + " was clicked.");
9127 dataModel.load("foobar.xml");
9129 For an example of creating a JSON/UpdateManager view, see {@link Roo.JsonView}.
9131 * <b>Note: The root of your template must be a single node. Table/row implementations may work but are not supported due to
9132 * IE"s limited insertion support with tables and Opera"s faulty event bubbling.</b>
9134 * Note: old style constructor is still suported (container, template, config)
9138 * @param {Object} config The config object
9141 Roo.View = function(config, depreciated_tpl, depreciated_config){
9143 if (typeof(depreciated_tpl) == 'undefined') {
9144 // new way.. - universal constructor.
9145 Roo.apply(this, config);
9146 this.el = Roo.get(this.el);
9149 this.el = Roo.get(config);
9150 this.tpl = depreciated_tpl;
9151 Roo.apply(this, depreciated_config);
9155 if(typeof(this.tpl) == "string"){
9156 this.tpl = new Roo.Template(this.tpl);
9158 // support xtype ctors..
9159 this.tpl = new Roo.factory(this.tpl, Roo);
9170 * @event beforeclick
9171 * Fires before a click is processed. Returns false to cancel the default action.
9172 * @param {Roo.View} this
9173 * @param {Number} index The index of the target node
9174 * @param {HTMLElement} node The target node
9175 * @param {Roo.EventObject} e The raw event object
9177 "beforeclick" : true,
9180 * Fires when a template node is clicked.
9181 * @param {Roo.View} this
9182 * @param {Number} index The index of the target node
9183 * @param {HTMLElement} node The target node
9184 * @param {Roo.EventObject} e The raw event object
9189 * Fires when a template node is double clicked.
9190 * @param {Roo.View} this
9191 * @param {Number} index The index of the target node
9192 * @param {HTMLElement} node The target node
9193 * @param {Roo.EventObject} e The raw event object
9197 * @event contextmenu
9198 * Fires when a template node is right clicked.
9199 * @param {Roo.View} this
9200 * @param {Number} index The index of the target node
9201 * @param {HTMLElement} node The target node
9202 * @param {Roo.EventObject} e The raw event object
9204 "contextmenu" : true,
9206 * @event selectionchange
9207 * Fires when the selected nodes change.
9208 * @param {Roo.View} this
9209 * @param {Array} selections Array of the selected nodes
9211 "selectionchange" : true,
9214 * @event beforeselect
9215 * Fires before a selection is made. If any handlers return false, the selection is cancelled.
9216 * @param {Roo.View} this
9217 * @param {HTMLElement} node The node to be selected
9218 * @param {Array} selections Array of currently selected nodes
9220 "beforeselect" : true,
9222 * @event preparedata
9223 * Fires on every row to render, to allow you to change the data.
9224 * @param {Roo.View} this
9225 * @param {Object} data to be rendered (change this)
9227 "preparedata" : true
9231 "click": this.onClick,
9232 "dblclick": this.onDblClick,
9233 "contextmenu": this.onContextMenu,
9237 this.selections = [];
9239 this.cmp = new Roo.CompositeElementLite([]);
9241 this.store = Roo.factory(this.store, Roo.data);
9242 this.setStore(this.store, true);
9244 Roo.View.superclass.constructor.call(this);
9247 Roo.extend(Roo.View, Roo.util.Observable, {
9250 * @cfg {Roo.data.Store} store Data store to load data from.
9255 * @cfg {String|Roo.Element} el The container element.
9260 * @cfg {String|Roo.Template} tpl The template used by this View
9265 * @cfg {String} selectedClass The css class to add to selected nodes
9267 selectedClass : "x-view-selected",
9269 * @cfg {String} emptyText The empty text to show when nothing is loaded.
9273 * @cfg {Boolean} multiSelect Allow multiple selection
9275 multiSelect : false,
9277 * @cfg {Boolean} singleSelect Allow single selection
9279 singleSelect: false,
9282 * @cfg {Boolean} toggleSelect - selecting
9284 toggleSelect : false,
9287 * Returns the element this view is bound to.
9288 * @return {Roo.Element}
9295 * Refreshes the view.
9297 refresh : function(){
9299 this.clearSelections();
9302 var records = this.store.getRange();
9303 if(records.length < 1){
9304 this.el.update(this.emptyText);
9307 for(var i = 0, len = records.length; i < len; i++){
9308 var data = this.prepareData(records[i].data, i, records[i]);
9309 this.fireEvent("preparedata", this, data, i, records[i]);
9310 html[html.length] = t.apply(data);
9312 this.el.update(html.join(""));
9313 this.nodes = this.el.dom.childNodes;
9314 this.updateIndexes(0);
9318 * Function to override to reformat the data that is sent to
9319 * the template for each node.
9320 * @param {Array/Object} data The raw data (array of colData for a data model bound view or
9321 * a JSON object for an UpdateManager bound view).
9323 prepareData : function(data){
9327 onUpdate : function(ds, record){
9328 this.clearSelections();
9329 var index = this.store.indexOf(record);
9330 var n = this.nodes[index];
9331 this.tpl.insertBefore(n, this.prepareData(record.data));
9332 n.parentNode.removeChild(n);
9333 this.updateIndexes(index, index);
9336 onAdd : function(ds, records, index){
9337 this.clearSelections();
9338 if(this.nodes.length == 0){
9342 var n = this.nodes[index];
9343 for(var i = 0, len = records.length; i < len; i++){
9344 var d = this.prepareData(records[i].data);
9346 this.tpl.insertBefore(n, d);
9348 this.tpl.append(this.el, d);
9351 this.updateIndexes(index);
9354 onRemove : function(ds, record, index){
9355 this.clearSelections();
9356 this.el.dom.removeChild(this.nodes[index]);
9357 this.updateIndexes(index);
9361 * Refresh an individual node.
9362 * @param {Number} index
9364 refreshNode : function(index){
9365 this.onUpdate(this.store, this.store.getAt(index));
9368 updateIndexes : function(startIndex, endIndex){
9369 var ns = this.nodes;
9370 startIndex = startIndex || 0;
9371 endIndex = endIndex || ns.length - 1;
9372 for(var i = startIndex; i <= endIndex; i++){
9373 ns[i].nodeIndex = i;
9378 * Changes the data store this view uses and refresh the view.
9379 * @param {Store} store
9381 setStore : function(store, initial){
9382 if(!initial && this.store){
9383 this.store.un("datachanged", this.refresh);
9384 this.store.un("add", this.onAdd);
9385 this.store.un("remove", this.onRemove);
9386 this.store.un("update", this.onUpdate);
9387 this.store.un("clear", this.refresh);
9391 store.on("datachanged", this.refresh, this);
9392 store.on("add", this.onAdd, this);
9393 store.on("remove", this.onRemove, this);
9394 store.on("update", this.onUpdate, this);
9395 store.on("clear", this.refresh, this);
9404 * Returns the template node the passed child belongs to or null if it doesn't belong to one.
9405 * @param {HTMLElement} node
9406 * @return {HTMLElement} The template node
9408 findItemFromChild : function(node){
9409 var el = this.el.dom;
9410 if(!node || node.parentNode == el){
9413 var p = node.parentNode;
9414 while(p && p != el){
9415 if(p.parentNode == el){
9424 onClick : function(e){
9425 var item = this.findItemFromChild(e.getTarget());
9427 var index = this.indexOf(item);
9428 if(this.onItemClick(item, index, e) !== false){
9429 this.fireEvent("click", this, index, item, e);
9432 this.clearSelections();
9437 onContextMenu : function(e){
9438 var item = this.findItemFromChild(e.getTarget());
9440 this.fireEvent("contextmenu", this, this.indexOf(item), item, e);
9445 onDblClick : function(e){
9446 var item = this.findItemFromChild(e.getTarget());
9448 this.fireEvent("dblclick", this, this.indexOf(item), item, e);
9452 onItemClick : function(item, index, e)
9454 if(this.fireEvent("beforeclick", this, index, item, e) === false){
9457 if (this.toggleSelect) {
9458 var m = this.isSelected(item) ? 'unselect' : 'select';
9461 _t[m](item, true, false);
9464 if(this.multiSelect || this.singleSelect){
9465 if(this.multiSelect && e.shiftKey && this.lastSelection){
9466 this.select(this.getNodes(this.indexOf(this.lastSelection), index), false);
9468 this.select(item, this.multiSelect && e.ctrlKey);
9469 this.lastSelection = item;
9477 * Get the number of selected nodes.
9480 getSelectionCount : function(){
9481 return this.selections.length;
9485 * Get the currently selected nodes.
9486 * @return {Array} An array of HTMLElements
9488 getSelectedNodes : function(){
9489 return this.selections;
9493 * Get the indexes of the selected nodes.
9496 getSelectedIndexes : function(){
9497 var indexes = [], s = this.selections;
9498 for(var i = 0, len = s.length; i < len; i++){
9499 indexes.push(s[i].nodeIndex);
9505 * Clear all selections
9506 * @param {Boolean} suppressEvent (optional) true to skip firing of the selectionchange event
9508 clearSelections : function(suppressEvent){
9509 if(this.nodes && (this.multiSelect || this.singleSelect) && this.selections.length > 0){
9510 this.cmp.elements = this.selections;
9511 this.cmp.removeClass(this.selectedClass);
9512 this.selections = [];
9514 this.fireEvent("selectionchange", this, this.selections);
9520 * Returns true if the passed node is selected
9521 * @param {HTMLElement/Number} node The node or node index
9524 isSelected : function(node){
9525 var s = this.selections;
9529 node = this.getNode(node);
9530 return s.indexOf(node) !== -1;
9535 * @param {Array/HTMLElement/String/Number} nodeInfo An HTMLElement template node, index of a template node, id of a template node or an array of any of those to select
9536 * @param {Boolean} keepExisting (optional) true to keep existing selections
9537 * @param {Boolean} suppressEvent (optional) true to skip firing of the selectionchange vent
9539 select : function(nodeInfo, keepExisting, suppressEvent){
9540 if(nodeInfo instanceof Array){
9542 this.clearSelections(true);
9544 for(var i = 0, len = nodeInfo.length; i < len; i++){
9545 this.select(nodeInfo[i], true, true);
9549 var node = this.getNode(nodeInfo);
9550 if(!node || this.isSelected(node)){
9551 return; // already selected.
9554 this.clearSelections(true);
9556 if(this.fireEvent("beforeselect", this, node, this.selections) !== false){
9557 Roo.fly(node).addClass(this.selectedClass);
9558 this.selections.push(node);
9560 this.fireEvent("selectionchange", this, this.selections);
9568 * @param {Array/HTMLElement/String/Number} nodeInfo An HTMLElement template node, index of a template node, id of a template node or an array of any of those to select
9569 * @param {Boolean} keepExisting (optional) true IGNORED (for campatibility with select)
9570 * @param {Boolean} suppressEvent (optional) true to skip firing of the selectionchange vent
9572 unselect : function(nodeInfo, keepExisting, suppressEvent)
9574 if(nodeInfo instanceof Array){
9575 Roo.each(this.selections, function(s) {
9576 this.unselect(s, nodeInfo);
9580 var node = this.getNode(nodeInfo);
9581 if(!node || !this.isSelected(node)){
9582 Roo.log("not selected");
9583 return; // not selected.
9587 Roo.each(this.selections, function(s) {
9589 Roo.fly(node).removeClass(this.selectedClass);
9596 this.selections= ns;
9597 this.fireEvent("selectionchange", this, this.selections);
9601 * Gets a template node.
9602 * @param {HTMLElement/String/Number} nodeInfo An HTMLElement template node, index of a template node or the id of a template node
9603 * @return {HTMLElement} The node or null if it wasn't found
9605 getNode : function(nodeInfo){
9606 if(typeof nodeInfo == "string"){
9607 return document.getElementById(nodeInfo);
9608 }else if(typeof nodeInfo == "number"){
9609 return this.nodes[nodeInfo];
9615 * Gets a range template nodes.
9616 * @param {Number} startIndex
9617 * @param {Number} endIndex
9618 * @return {Array} An array of nodes
9620 getNodes : function(start, end){
9621 var ns = this.nodes;
9623 end = typeof end == "undefined" ? ns.length - 1 : end;
9626 for(var i = start; i <= end; i++){
9630 for(var i = start; i >= end; i--){
9638 * Finds the index of the passed node
9639 * @param {HTMLElement/String/Number} nodeInfo An HTMLElement template node, index of a template node or the id of a template node
9640 * @return {Number} The index of the node or -1
9642 indexOf : function(node){
9643 node = this.getNode(node);
9644 if(typeof node.nodeIndex == "number"){
9645 return node.nodeIndex;
9647 var ns = this.nodes;
9648 for(var i = 0, len = ns.length; i < len; i++){
9658 * Ext JS Library 1.1.1
9659 * Copyright(c) 2006-2007, Ext JS, LLC.
9661 * Originally Released Under LGPL - original licence link has changed is not relivant.
9664 * <script type="text/javascript">
9668 * @class Roo.JsonView
9670 * Shortcut class to create a JSON + {@link Roo.UpdateManager} template view. Usage:
9672 var view = new Roo.JsonView({
9673 container: "my-element",
9674 tpl: '<div id="{id}">{foo} - {bar}</div>', // auto create template
9679 // listen for node click?
9680 view.on("click", function(vw, index, node, e){
9681 alert('Node "' + node.id + '" at index: ' + index + " was clicked.");
9684 // direct load of JSON data
9685 view.load("foobar.php");
9687 // Example from my blog list
9688 var tpl = new Roo.Template(
9689 '<div class="entry">' +
9690 '<a class="entry-title" href="{link}">{title}</a>' +
9691 "<h4>{date} by {author} | {comments} Comments</h4>{description}" +
9692 "</div><hr />"
9695 var moreView = new Roo.JsonView({
9696 container : "entry-list",
9700 moreView.on("beforerender", this.sortEntries, this);
9702 url: "/blog/get-posts.php",
9703 params: "allposts=true",
9704 text: "Loading Blog Entries..."
9708 * Note: old code is supported with arguments : (container, template, config)
9712 * Create a new JsonView
9714 * @param {Object} config The config object
9717 Roo.JsonView = function(config, depreciated_tpl, depreciated_config){
9720 Roo.JsonView.superclass.constructor.call(this, config, depreciated_tpl, depreciated_config);
9722 var um = this.el.getUpdateManager();
9723 um.setRenderer(this);
9724 um.on("update", this.onLoad, this);
9725 um.on("failure", this.onLoadException, this);
9728 * @event beforerender
9729 * Fires before rendering of the downloaded JSON data.
9730 * @param {Roo.JsonView} this
9731 * @param {Object} data The JSON data loaded
9735 * Fires when data is loaded.
9736 * @param {Roo.JsonView} this
9737 * @param {Object} data The JSON data loaded
9738 * @param {Object} response The raw Connect response object
9741 * @event loadexception
9742 * Fires when loading fails.
9743 * @param {Roo.JsonView} this
9744 * @param {Object} response The raw Connect response object
9747 'beforerender' : true,
9749 'loadexception' : true
9752 Roo.extend(Roo.JsonView, Roo.View, {
9754 * @type {String} The root property in the loaded JSON object that contains the data
9759 * Refreshes the view.
9761 refresh : function(){
9762 this.clearSelections();
9765 var o = this.jsonData;
9766 if(o && o.length > 0){
9767 for(var i = 0, len = o.length; i < len; i++){
9768 var data = this.prepareData(o[i], i, o);
9769 html[html.length] = this.tpl.apply(data);
9772 html.push(this.emptyText);
9774 this.el.update(html.join(""));
9775 this.nodes = this.el.dom.childNodes;
9776 this.updateIndexes(0);
9780 * Performs an async HTTP request, and loads the JSON from the response. If <i>params</i> are specified it uses POST, otherwise it uses GET.
9781 * @param {Object/String/Function} url The URL for this request, or a function to call to get the URL, or a config object containing any of the following options:
9784 url: "your-url.php",
9785 params: {param1: "foo", param2: "bar"}, // or a URL encoded string
9786 callback: yourFunction,
9787 scope: yourObject, //(optional scope)
9795 * The only required property is <i>url</i>. The optional properties <i>nocache</i>, <i>text</i> and <i>scripts</i>
9796 * are respectively shorthand for <i>disableCaching</i>, <i>indicatorText</i>, and <i>loadScripts</i> and are used to set their associated property on this UpdateManager instance.
9797 * @param {String/Object} params (optional) The parameters to pass, as either a URL encoded string "param1=1&param2=2" or an object {param1: 1, param2: 2}
9798 * @param {Function} callback (optional) Callback when transaction is complete - called with signature (oElement, bSuccess)
9799 * @param {Boolean} discardUrl (optional) By default when you execute an update the defaultUrl is changed to the last used URL. If true, it will not store the URL.
9802 var um = this.el.getUpdateManager();
9803 um.update.apply(um, arguments);
9806 render : function(el, response){
9807 this.clearSelections();
9811 o = Roo.util.JSON.decode(response.responseText);
9814 o = o[this.jsonRoot];
9819 * The current JSON data or null
9822 this.beforeRender();
9827 * Get the number of records in the current JSON dataset
9830 getCount : function(){
9831 return this.jsonData ? this.jsonData.length : 0;
9835 * Returns the JSON object for the specified node(s)
9836 * @param {HTMLElement/Array} node The node or an array of nodes
9837 * @return {Object/Array} If you pass in an array, you get an array back, otherwise
9838 * you get the JSON object for the node
9840 getNodeData : function(node){
9841 if(node instanceof Array){
9843 for(var i = 0, len = node.length; i < len; i++){
9844 data.push(this.getNodeData(node[i]));
9848 return this.jsonData[this.indexOf(node)] || null;
9851 beforeRender : function(){
9852 this.snapshot = this.jsonData;
9854 this.sort.apply(this, this.sortInfo);
9856 this.fireEvent("beforerender", this, this.jsonData);
9859 onLoad : function(el, o){
9860 this.fireEvent("load", this, this.jsonData, o);
9863 onLoadException : function(el, o){
9864 this.fireEvent("loadexception", this, o);
9868 * Filter the data by a specific property.
9869 * @param {String} property A property on your JSON objects
9870 * @param {String/RegExp} value Either string that the property values
9871 * should start with, or a RegExp to test against the property
9873 filter : function(property, value){
9876 var ss = this.snapshot;
9877 if(typeof value == "string"){
9878 var vlen = value.length;
9883 value = value.toLowerCase();
9884 for(var i = 0, len = ss.length; i < len; i++){
9886 if(o[property].substr(0, vlen).toLowerCase() == value){
9890 } else if(value.exec){ // regex?
9891 for(var i = 0, len = ss.length; i < len; i++){
9893 if(value.test(o[property])){
9900 this.jsonData = data;
9906 * Filter by a function. The passed function will be called with each
9907 * object in the current dataset. If the function returns true the value is kept,
9908 * otherwise it is filtered.
9909 * @param {Function} fn
9910 * @param {Object} scope (optional) The scope of the function (defaults to this JsonView)
9912 filterBy : function(fn, scope){
9915 var ss = this.snapshot;
9916 for(var i = 0, len = ss.length; i < len; i++){
9918 if(fn.call(scope || this, o)){
9922 this.jsonData = data;
9928 * Clears the current filter.
9930 clearFilter : function(){
9931 if(this.snapshot && this.jsonData != this.snapshot){
9932 this.jsonData = this.snapshot;
9939 * Sorts the data for this view and refreshes it.
9940 * @param {String} property A property on your JSON objects to sort on
9941 * @param {String} direction (optional) "desc" or "asc" (defaults to "asc")
9942 * @param {Function} sortType (optional) A function to call to convert the data to a sortable value.
9944 sort : function(property, dir, sortType){
9945 this.sortInfo = Array.prototype.slice.call(arguments, 0);
9948 var dsc = dir && dir.toLowerCase() == "desc";
9949 var f = function(o1, o2){
9950 var v1 = sortType ? sortType(o1[p]) : o1[p];
9951 var v2 = sortType ? sortType(o2[p]) : o2[p];
9954 return dsc ? +1 : -1;
9956 return dsc ? -1 : +1;
9961 this.jsonData.sort(f);
9963 if(this.jsonData != this.snapshot){
9964 this.snapshot.sort(f);
9970 * Ext JS Library 1.1.1
9971 * Copyright(c) 2006-2007, Ext JS, LLC.
9973 * Originally Released Under LGPL - original licence link has changed is not relivant.
9976 * <script type="text/javascript">
9981 * @class Roo.ColorPalette
9982 * @extends Roo.Component
9983 * Simple color palette class for choosing colors. The palette can be rendered to any container.<br />
9984 * Here's an example of typical usage:
9986 var cp = new Roo.ColorPalette({value:'993300'}); // initial selected color
9987 cp.render('my-div');
9989 cp.on('select', function(palette, selColor){
9990 // do something with selColor
9994 * Create a new ColorPalette
9995 * @param {Object} config The config object
9997 Roo.ColorPalette = function(config){
9998 Roo.ColorPalette.superclass.constructor.call(this, config);
10002 * Fires when a color is selected
10003 * @param {ColorPalette} this
10004 * @param {String} color The 6-digit color hex code (without the # symbol)
10010 this.on("select", this.handler, this.scope, true);
10013 Roo.extend(Roo.ColorPalette, Roo.Component, {
10015 * @cfg {String} itemCls
10016 * The CSS class to apply to the containing element (defaults to "x-color-palette")
10018 itemCls : "x-color-palette",
10020 * @cfg {String} value
10021 * The initial color to highlight (should be a valid 6-digit color hex code without the # symbol). Note that
10022 * the hex codes are case-sensitive.
10025 clickEvent:'click',
10027 ctype: "Roo.ColorPalette",
10030 * @cfg {Boolean} allowReselect If set to true then reselecting a color that is already selected fires the selection event
10032 allowReselect : false,
10035 * <p>An array of 6-digit color hex code strings (without the # symbol). This array can contain any number
10036 * of colors, and each hex code should be unique. The width of the palette is controlled via CSS by adjusting
10037 * the width property of the 'x-color-palette' class (or assigning a custom class), so you can balance the number
10038 * of colors with the width setting until the box is symmetrical.</p>
10039 * <p>You can override individual colors if needed:</p>
10041 var cp = new Roo.ColorPalette();
10042 cp.colors[0] = "FF0000"; // change the first box to red
10045 Or you can provide a custom array of your own for complete control:
10047 var cp = new Roo.ColorPalette();
10048 cp.colors = ["000000", "993300", "333300"];
10053 "000000", "993300", "333300", "003300", "003366", "000080", "333399", "333333",
10054 "800000", "FF6600", "808000", "008000", "008080", "0000FF", "666699", "808080",
10055 "FF0000", "FF9900", "99CC00", "339966", "33CCCC", "3366FF", "800080", "969696",
10056 "FF00FF", "FFCC00", "FFFF00", "00FF00", "00FFFF", "00CCFF", "993366", "C0C0C0",
10057 "FF99CC", "FFCC99", "FFFF99", "CCFFCC", "CCFFFF", "99CCFF", "CC99FF", "FFFFFF"
10061 onRender : function(container, position){
10062 var t = new Roo.MasterTemplate(
10063 '<tpl><a href="#" class="color-{0}" hidefocus="on"><em><span style="background:#{0}" unselectable="on"> </span></em></a></tpl>'
10065 var c = this.colors;
10066 for(var i = 0, len = c.length; i < len; i++){
10069 var el = document.createElement("div");
10070 el.className = this.itemCls;
10072 container.dom.insertBefore(el, position);
10073 this.el = Roo.get(el);
10074 this.el.on(this.clickEvent, this.handleClick, this, {delegate: "a"});
10075 if(this.clickEvent != 'click'){
10076 this.el.on('click', Roo.emptyFn, this, {delegate: "a", preventDefault:true});
10081 afterRender : function(){
10082 Roo.ColorPalette.superclass.afterRender.call(this);
10084 var s = this.value;
10091 handleClick : function(e, t){
10092 e.preventDefault();
10093 if(!this.disabled){
10094 var c = t.className.match(/(?:^|\s)color-(.{6})(?:\s|$)/)[1];
10095 this.select(c.toUpperCase());
10100 * Selects the specified color in the palette (fires the select event)
10101 * @param {String} color A valid 6-digit color hex code (# will be stripped if included)
10103 select : function(color){
10104 color = color.replace("#", "");
10105 if(color != this.value || this.allowReselect){
10108 el.child("a.color-"+this.value).removeClass("x-color-palette-sel");
10110 el.child("a.color-"+color).addClass("x-color-palette-sel");
10111 this.value = color;
10112 this.fireEvent("select", this, color);
10117 * Ext JS Library 1.1.1
10118 * Copyright(c) 2006-2007, Ext JS, LLC.
10120 * Originally Released Under LGPL - original licence link has changed is not relivant.
10123 * <script type="text/javascript">
10127 * @class Roo.DatePicker
10128 * @extends Roo.Component
10129 * Simple date picker class.
10131 * Create a new DatePicker
10132 * @param {Object} config The config object
10134 Roo.DatePicker = function(config){
10135 Roo.DatePicker.superclass.constructor.call(this, config);
10137 this.value = config && config.value ?
10138 config.value.clearTime() : new Date().clearTime();
10143 * Fires when a date is selected
10144 * @param {DatePicker} this
10145 * @param {Date} date The selected date
10149 * @event monthchange
10150 * Fires when the displayed month changes
10151 * @param {DatePicker} this
10152 * @param {Date} date The selected month
10154 'monthchange': true
10158 this.on("select", this.handler, this.scope || this);
10160 // build the disabledDatesRE
10161 if(!this.disabledDatesRE && this.disabledDates){
10162 var dd = this.disabledDates;
10164 for(var i = 0; i < dd.length; i++){
10166 if(i != dd.length-1) re += "|";
10168 this.disabledDatesRE = new RegExp(re + ")");
10172 Roo.extend(Roo.DatePicker, Roo.Component, {
10174 * @cfg {String} todayText
10175 * The text to display on the button that selects the current date (defaults to "Today")
10177 todayText : "Today",
10179 * @cfg {String} okText
10180 * The text to display on the ok button
10182 okText : " OK ", //   to give the user extra clicking room
10184 * @cfg {String} cancelText
10185 * The text to display on the cancel button
10187 cancelText : "Cancel",
10189 * @cfg {String} todayTip
10190 * The tooltip to display for the button that selects the current date (defaults to "{current date} (Spacebar)")
10192 todayTip : "{0} (Spacebar)",
10194 * @cfg {Date} minDate
10195 * Minimum allowable date (JavaScript date object, defaults to null)
10199 * @cfg {Date} maxDate
10200 * Maximum allowable date (JavaScript date object, defaults to null)
10204 * @cfg {String} minText
10205 * The error text to display if the minDate validation fails (defaults to "This date is before the minimum date")
10207 minText : "This date is before the minimum date",
10209 * @cfg {String} maxText
10210 * The error text to display if the maxDate validation fails (defaults to "This date is after the maximum date")
10212 maxText : "This date is after the maximum date",
10214 * @cfg {String} format
10215 * The default date format string which can be overriden for localization support. The format must be
10216 * valid according to {@link Date#parseDate} (defaults to 'm/d/y').
10220 * @cfg {Array} disabledDays
10221 * An array of days to disable, 0-based. For example, [0, 6] disables Sunday and Saturday (defaults to null).
10223 disabledDays : null,
10225 * @cfg {String} disabledDaysText
10226 * The tooltip to display when the date falls on a disabled day (defaults to "")
10228 disabledDaysText : "",
10230 * @cfg {RegExp} disabledDatesRE
10231 * JavaScript regular expression used to disable a pattern of dates (defaults to null)
10233 disabledDatesRE : null,
10235 * @cfg {String} disabledDatesText
10236 * The tooltip text to display when the date falls on a disabled date (defaults to "")
10238 disabledDatesText : "",
10240 * @cfg {Boolean} constrainToViewport
10241 * True to constrain the date picker to the viewport (defaults to true)
10243 constrainToViewport : true,
10245 * @cfg {Array} monthNames
10246 * An array of textual month names which can be overriden for localization support (defaults to Date.monthNames)
10248 monthNames : Date.monthNames,
10250 * @cfg {Array} dayNames
10251 * An array of textual day names which can be overriden for localization support (defaults to Date.dayNames)
10253 dayNames : Date.dayNames,
10255 * @cfg {String} nextText
10256 * The next month navigation button tooltip (defaults to 'Next Month (Control+Right)')
10258 nextText: 'Next Month (Control+Right)',
10260 * @cfg {String} prevText
10261 * The previous month navigation button tooltip (defaults to 'Previous Month (Control+Left)')
10263 prevText: 'Previous Month (Control+Left)',
10265 * @cfg {String} monthYearText
10266 * The header month selector tooltip (defaults to 'Choose a month (Control+Up/Down to move years)')
10268 monthYearText: 'Choose a month (Control+Up/Down to move years)',
10270 * @cfg {Number} startDay
10271 * Day index at which the week should begin, 0-based (defaults to 0, which is Sunday)
10275 * @cfg {Bool} showClear
10276 * Show a clear button (usefull for date form elements that can be blank.)
10282 * Sets the value of the date field
10283 * @param {Date} value The date to set
10285 setValue : function(value){
10286 var old = this.value;
10287 this.value = value.clearTime(true);
10289 this.update(this.value);
10294 * Gets the current selected value of the date field
10295 * @return {Date} The selected date
10297 getValue : function(){
10302 focus : function(){
10304 this.update(this.activeDate);
10309 onRender : function(container, position){
10311 '<table cellspacing="0">',
10312 '<tr><td class="x-date-left"><a href="#" title="', this.prevText ,'"> </a></td><td class="x-date-middle" align="center"></td><td class="x-date-right"><a href="#" title="', this.nextText ,'"> </a></td></tr>',
10313 '<tr><td colspan="3"><table class="x-date-inner" cellspacing="0"><thead><tr>'];
10314 var dn = this.dayNames;
10315 for(var i = 0; i < 7; i++){
10316 var d = this.startDay+i;
10320 m.push("<th><span>", dn[d].substr(0,1), "</span></th>");
10322 m[m.length] = "</tr></thead><tbody><tr>";
10323 for(var i = 0; i < 42; i++) {
10324 if(i % 7 == 0 && i != 0){
10325 m[m.length] = "</tr><tr>";
10327 m[m.length] = '<td><a href="#" hidefocus="on" class="x-date-date" tabIndex="1"><em><span></span></em></a></td>';
10329 m[m.length] = '</tr></tbody></table></td></tr><tr>'+
10330 '<td colspan="3" class="x-date-bottom" align="center"></td></tr></table><div class="x-date-mp"></div>';
10332 var el = document.createElement("div");
10333 el.className = "x-date-picker";
10334 el.innerHTML = m.join("");
10336 container.dom.insertBefore(el, position);
10338 this.el = Roo.get(el);
10339 this.eventEl = Roo.get(el.firstChild);
10341 new Roo.util.ClickRepeater(this.el.child("td.x-date-left a"), {
10342 handler: this.showPrevMonth,
10344 preventDefault:true,
10348 new Roo.util.ClickRepeater(this.el.child("td.x-date-right a"), {
10349 handler: this.showNextMonth,
10351 preventDefault:true,
10355 this.eventEl.on("mousewheel", this.handleMouseWheel, this);
10357 this.monthPicker = this.el.down('div.x-date-mp');
10358 this.monthPicker.enableDisplayMode('block');
10360 var kn = new Roo.KeyNav(this.eventEl, {
10361 "left" : function(e){
10363 this.showPrevMonth() :
10364 this.update(this.activeDate.add("d", -1));
10367 "right" : function(e){
10369 this.showNextMonth() :
10370 this.update(this.activeDate.add("d", 1));
10373 "up" : function(e){
10375 this.showNextYear() :
10376 this.update(this.activeDate.add("d", -7));
10379 "down" : function(e){
10381 this.showPrevYear() :
10382 this.update(this.activeDate.add("d", 7));
10385 "pageUp" : function(e){
10386 this.showNextMonth();
10389 "pageDown" : function(e){
10390 this.showPrevMonth();
10393 "enter" : function(e){
10394 e.stopPropagation();
10401 this.eventEl.on("click", this.handleDateClick, this, {delegate: "a.x-date-date"});
10403 this.eventEl.addKeyListener(Roo.EventObject.SPACE, this.selectToday, this);
10405 this.el.unselectable();
10407 this.cells = this.el.select("table.x-date-inner tbody td");
10408 this.textNodes = this.el.query("table.x-date-inner tbody span");
10410 this.mbtn = new Roo.Button(this.el.child("td.x-date-middle", true), {
10412 tooltip: this.monthYearText
10415 this.mbtn.on('click', this.showMonthPicker, this);
10416 this.mbtn.el.child(this.mbtn.menuClassTarget).addClass("x-btn-with-menu");
10419 var today = (new Date()).dateFormat(this.format);
10421 var baseTb = new Roo.Toolbar(this.el.child("td.x-date-bottom", true));
10422 if (this.showClear) {
10423 baseTb.add( new Roo.Toolbar.Fill());
10426 text: String.format(this.todayText, today),
10427 tooltip: String.format(this.todayTip, today),
10428 handler: this.selectToday,
10432 //var todayBtn = new Roo.Button(this.el.child("td.x-date-bottom", true), {
10435 if (this.showClear) {
10437 baseTb.add( new Roo.Toolbar.Fill());
10440 cls: 'x-btn-icon x-btn-clear',
10441 handler: function() {
10443 this.fireEvent("select", this, '');
10453 this.update(this.value);
10456 createMonthPicker : function(){
10457 if(!this.monthPicker.dom.firstChild){
10458 var buf = ['<table border="0" cellspacing="0">'];
10459 for(var i = 0; i < 6; i++){
10461 '<tr><td class="x-date-mp-month"><a href="#">', this.monthNames[i].substr(0, 3), '</a></td>',
10462 '<td class="x-date-mp-month x-date-mp-sep"><a href="#">', this.monthNames[i+6].substr(0, 3), '</a></td>',
10464 '<td class="x-date-mp-ybtn" align="center"><a class="x-date-mp-prev"></a></td><td class="x-date-mp-ybtn" align="center"><a class="x-date-mp-next"></a></td></tr>' :
10465 '<td class="x-date-mp-year"><a href="#"></a></td><td class="x-date-mp-year"><a href="#"></a></td></tr>'
10469 '<tr class="x-date-mp-btns"><td colspan="4"><button type="button" class="x-date-mp-ok">',
10471 '</button><button type="button" class="x-date-mp-cancel">',
10473 '</button></td></tr>',
10476 this.monthPicker.update(buf.join(''));
10477 this.monthPicker.on('click', this.onMonthClick, this);
10478 this.monthPicker.on('dblclick', this.onMonthDblClick, this);
10480 this.mpMonths = this.monthPicker.select('td.x-date-mp-month');
10481 this.mpYears = this.monthPicker.select('td.x-date-mp-year');
10483 this.mpMonths.each(function(m, a, i){
10486 m.dom.xmonth = 5 + Math.round(i * .5);
10488 m.dom.xmonth = Math.round((i-1) * .5);
10494 showMonthPicker : function(){
10495 this.createMonthPicker();
10496 var size = this.el.getSize();
10497 this.monthPicker.setSize(size);
10498 this.monthPicker.child('table').setSize(size);
10500 this.mpSelMonth = (this.activeDate || this.value).getMonth();
10501 this.updateMPMonth(this.mpSelMonth);
10502 this.mpSelYear = (this.activeDate || this.value).getFullYear();
10503 this.updateMPYear(this.mpSelYear);
10505 this.monthPicker.slideIn('t', {duration:.2});
10508 updateMPYear : function(y){
10510 var ys = this.mpYears.elements;
10511 for(var i = 1; i <= 10; i++){
10512 var td = ys[i-1], y2;
10514 y2 = y + Math.round(i * .5);
10515 td.firstChild.innerHTML = y2;
10518 y2 = y - (5-Math.round(i * .5));
10519 td.firstChild.innerHTML = y2;
10522 this.mpYears.item(i-1)[y2 == this.mpSelYear ? 'addClass' : 'removeClass']('x-date-mp-sel');
10526 updateMPMonth : function(sm){
10527 this.mpMonths.each(function(m, a, i){
10528 m[m.dom.xmonth == sm ? 'addClass' : 'removeClass']('x-date-mp-sel');
10532 selectMPMonth: function(m){
10536 onMonthClick : function(e, t){
10538 var el = new Roo.Element(t), pn;
10539 if(el.is('button.x-date-mp-cancel')){
10540 this.hideMonthPicker();
10542 else if(el.is('button.x-date-mp-ok')){
10543 this.update(new Date(this.mpSelYear, this.mpSelMonth, (this.activeDate || this.value).getDate()));
10544 this.hideMonthPicker();
10546 else if(pn = el.up('td.x-date-mp-month', 2)){
10547 this.mpMonths.removeClass('x-date-mp-sel');
10548 pn.addClass('x-date-mp-sel');
10549 this.mpSelMonth = pn.dom.xmonth;
10551 else if(pn = el.up('td.x-date-mp-year', 2)){
10552 this.mpYears.removeClass('x-date-mp-sel');
10553 pn.addClass('x-date-mp-sel');
10554 this.mpSelYear = pn.dom.xyear;
10556 else if(el.is('a.x-date-mp-prev')){
10557 this.updateMPYear(this.mpyear-10);
10559 else if(el.is('a.x-date-mp-next')){
10560 this.updateMPYear(this.mpyear+10);
10564 onMonthDblClick : function(e, t){
10566 var el = new Roo.Element(t), pn;
10567 if(pn = el.up('td.x-date-mp-month', 2)){
10568 this.update(new Date(this.mpSelYear, pn.dom.xmonth, (this.activeDate || this.value).getDate()));
10569 this.hideMonthPicker();
10571 else if(pn = el.up('td.x-date-mp-year', 2)){
10572 this.update(new Date(pn.dom.xyear, this.mpSelMonth, (this.activeDate || this.value).getDate()));
10573 this.hideMonthPicker();
10577 hideMonthPicker : function(disableAnim){
10578 if(this.monthPicker){
10579 if(disableAnim === true){
10580 this.monthPicker.hide();
10582 this.monthPicker.slideOut('t', {duration:.2});
10588 showPrevMonth : function(e){
10589 this.update(this.activeDate.add("mo", -1));
10593 showNextMonth : function(e){
10594 this.update(this.activeDate.add("mo", 1));
10598 showPrevYear : function(){
10599 this.update(this.activeDate.add("y", -1));
10603 showNextYear : function(){
10604 this.update(this.activeDate.add("y", 1));
10608 handleMouseWheel : function(e){
10609 var delta = e.getWheelDelta();
10611 this.showPrevMonth();
10613 } else if(delta < 0){
10614 this.showNextMonth();
10620 handleDateClick : function(e, t){
10622 if(t.dateValue && !Roo.fly(t.parentNode).hasClass("x-date-disabled")){
10623 this.setValue(new Date(t.dateValue));
10624 this.fireEvent("select", this, this.value);
10629 selectToday : function(){
10630 this.setValue(new Date().clearTime());
10631 this.fireEvent("select", this, this.value);
10635 update : function(date)
10637 var vd = this.activeDate;
10638 this.activeDate = date;
10640 var t = date.getTime();
10641 if(vd.getMonth() == date.getMonth() && vd.getFullYear() == date.getFullYear()){
10642 this.cells.removeClass("x-date-selected");
10643 this.cells.each(function(c){
10644 if(c.dom.firstChild.dateValue == t){
10645 c.addClass("x-date-selected");
10646 setTimeout(function(){
10647 try{c.dom.firstChild.focus();}catch(e){}
10656 var days = date.getDaysInMonth();
10657 var firstOfMonth = date.getFirstDateOfMonth();
10658 var startingPos = firstOfMonth.getDay()-this.startDay;
10660 if(startingPos <= this.startDay){
10664 var pm = date.add("mo", -1);
10665 var prevStart = pm.getDaysInMonth()-startingPos;
10667 var cells = this.cells.elements;
10668 var textEls = this.textNodes;
10669 days += startingPos;
10671 // convert everything to numbers so it's fast
10672 var day = 86400000;
10673 var d = (new Date(pm.getFullYear(), pm.getMonth(), prevStart)).clearTime();
10674 var today = new Date().clearTime().getTime();
10675 var sel = date.clearTime().getTime();
10676 var min = this.minDate ? this.minDate.clearTime() : Number.NEGATIVE_INFINITY;
10677 var max = this.maxDate ? this.maxDate.clearTime() : Number.POSITIVE_INFINITY;
10678 var ddMatch = this.disabledDatesRE;
10679 var ddText = this.disabledDatesText;
10680 var ddays = this.disabledDays ? this.disabledDays.join("") : false;
10681 var ddaysText = this.disabledDaysText;
10682 var format = this.format;
10684 var setCellClass = function(cal, cell){
10686 var t = d.getTime();
10687 cell.firstChild.dateValue = t;
10689 cell.className += " x-date-today";
10690 cell.title = cal.todayText;
10693 cell.className += " x-date-selected";
10694 setTimeout(function(){
10695 try{cell.firstChild.focus();}catch(e){}
10700 cell.className = " x-date-disabled";
10701 cell.title = cal.minText;
10705 cell.className = " x-date-disabled";
10706 cell.title = cal.maxText;
10710 if(ddays.indexOf(d.getDay()) != -1){
10711 cell.title = ddaysText;
10712 cell.className = " x-date-disabled";
10715 if(ddMatch && format){
10716 var fvalue = d.dateFormat(format);
10717 if(ddMatch.test(fvalue)){
10718 cell.title = ddText.replace("%0", fvalue);
10719 cell.className = " x-date-disabled";
10725 for(; i < startingPos; i++) {
10726 textEls[i].innerHTML = (++prevStart);
10727 d.setDate(d.getDate()+1);
10728 cells[i].className = "x-date-prevday";
10729 setCellClass(this, cells[i]);
10731 for(; i < days; i++){
10732 intDay = i - startingPos + 1;
10733 textEls[i].innerHTML = (intDay);
10734 d.setDate(d.getDate()+1);
10735 cells[i].className = "x-date-active";
10736 setCellClass(this, cells[i]);
10739 for(; i < 42; i++) {
10740 textEls[i].innerHTML = (++extraDays);
10741 d.setDate(d.getDate()+1);
10742 cells[i].className = "x-date-nextday";
10743 setCellClass(this, cells[i]);
10746 this.mbtn.setText(this.monthNames[date.getMonth()] + " " + date.getFullYear());
10747 this.fireEvent('monthchange', this, date);
10749 if(!this.internalRender){
10750 var main = this.el.dom.firstChild;
10751 var w = main.offsetWidth;
10752 this.el.setWidth(w + this.el.getBorderWidth("lr"));
10753 Roo.fly(main).setWidth(w);
10754 this.internalRender = true;
10755 // opera does not respect the auto grow header center column
10756 // then, after it gets a width opera refuses to recalculate
10757 // without a second pass
10758 if(Roo.isOpera && !this.secondPass){
10759 main.rows[0].cells[1].style.width = (w - (main.rows[0].cells[0].offsetWidth+main.rows[0].cells[2].offsetWidth)) + "px";
10760 this.secondPass = true;
10761 this.update.defer(10, this, [date]);