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;
6675 * All child nodes of this node. @type Array
6677 this.childNodes = [];
6678 if(!this.childNodes.indexOf){ // indexOf is a must
6679 this.childNodes.indexOf = function(o){
6680 for(var i = 0, len = this.length; i < len; i++){
6689 * The parent node for this node. @type Node
6691 this.parentNode = null;
6693 * The first direct child node of this node, or null if this node has no child nodes. @type Node
6695 this.firstChild = null;
6697 * The last direct child node of this node, or null if this node has no child nodes. @type Node
6699 this.lastChild = null;
6701 * The node immediately preceding this node in the tree, or null if there is no sibling node. @type Node
6703 this.previousSibling = null;
6705 * The node immediately following this node in the tree, or null if there is no sibling node. @type Node
6707 this.nextSibling = null;
6712 * Fires when a new child node is appended
6713 * @param {Tree} tree The owner tree
6714 * @param {Node} this This node
6715 * @param {Node} node The newly appended node
6716 * @param {Number} index The index of the newly appended node
6721 * Fires when a child node is removed
6722 * @param {Tree} tree The owner tree
6723 * @param {Node} this This node
6724 * @param {Node} node The removed node
6729 * Fires when this node is moved to a new location in the tree
6730 * @param {Tree} tree The owner tree
6731 * @param {Node} this This node
6732 * @param {Node} oldParent The old parent of this node
6733 * @param {Node} newParent The new parent of this node
6734 * @param {Number} index The index it was moved to
6739 * Fires when a new child node is inserted.
6740 * @param {Tree} tree The owner tree
6741 * @param {Node} this This node
6742 * @param {Node} node The child node inserted
6743 * @param {Node} refNode The child node the node was inserted before
6747 * @event beforeappend
6748 * Fires before a new child is appended, return false to cancel the append.
6749 * @param {Tree} tree The owner tree
6750 * @param {Node} this This node
6751 * @param {Node} node The child node to be appended
6753 "beforeappend" : true,
6755 * @event beforeremove
6756 * Fires before a child is removed, return false to cancel the remove.
6757 * @param {Tree} tree The owner tree
6758 * @param {Node} this This node
6759 * @param {Node} node The child node to be removed
6761 "beforeremove" : true,
6764 * Fires before this node is moved to a new location in the tree. Return false to cancel the move.
6765 * @param {Tree} tree The owner tree
6766 * @param {Node} this This node
6767 * @param {Node} oldParent The parent of this node
6768 * @param {Node} newParent The new parent this node is moving to
6769 * @param {Number} index The index it is being moved to
6771 "beforemove" : true,
6773 * @event beforeinsert
6774 * Fires before a new child is inserted, return false to cancel the insert.
6775 * @param {Tree} tree The owner tree
6776 * @param {Node} this This node
6777 * @param {Node} node The child node to be inserted
6778 * @param {Node} refNode The child node the node is being inserted before
6780 "beforeinsert" : true
6782 this.listeners = this.attributes.listeners;
6783 Roo.data.Node.superclass.constructor.call(this);
6786 Roo.extend(Roo.data.Node, Roo.util.Observable, {
6787 fireEvent : function(evtName){
6788 // first do standard event for this node
6789 if(Roo.data.Node.superclass.fireEvent.apply(this, arguments) === false){
6792 // then bubble it up to the tree if the event wasn't cancelled
6793 var ot = this.getOwnerTree();
6795 if(ot.proxyNodeEvent.apply(ot, arguments) === false){
6803 * Returns true if this node is a leaf
6806 isLeaf : function(){
6807 return this.leaf === true;
6811 setFirstChild : function(node){
6812 this.firstChild = node;
6816 setLastChild : function(node){
6817 this.lastChild = node;
6822 * Returns true if this node is the last child of its parent
6825 isLast : function(){
6826 return (!this.parentNode ? true : this.parentNode.lastChild == this);
6830 * Returns true if this node is the first child of its parent
6833 isFirst : function(){
6834 return (!this.parentNode ? true : this.parentNode.firstChild == this);
6837 hasChildNodes : function(){
6838 return !this.isLeaf() && this.childNodes.length > 0;
6842 * Insert node(s) as the last child node of this node.
6843 * @param {Node/Array} node The node or Array of nodes to append
6844 * @return {Node} The appended node if single append, or null if an array was passed
6846 appendChild : function(node){
6848 if(node instanceof Array){
6850 }else if(arguments.length > 1){
6853 // if passed an array or multiple args do them one by one
6855 for(var i = 0, len = multi.length; i < len; i++) {
6856 this.appendChild(multi[i]);
6859 if(this.fireEvent("beforeappend", this.ownerTree, this, node) === false){
6862 var index = this.childNodes.length;
6863 var oldParent = node.parentNode;
6864 // it's a move, make sure we move it cleanly
6866 if(node.fireEvent("beforemove", node.getOwnerTree(), node, oldParent, this, index) === false){
6869 oldParent.removeChild(node);
6871 index = this.childNodes.length;
6873 this.setFirstChild(node);
6875 this.childNodes.push(node);
6876 node.parentNode = this;
6877 var ps = this.childNodes[index-1];
6879 node.previousSibling = ps;
6880 ps.nextSibling = node;
6882 node.previousSibling = null;
6884 node.nextSibling = null;
6885 this.setLastChild(node);
6886 node.setOwnerTree(this.getOwnerTree());
6887 this.fireEvent("append", this.ownerTree, this, node, index);
6889 node.fireEvent("move", this.ownerTree, node, oldParent, this, index);
6896 * Removes a child node from this node.
6897 * @param {Node} node The node to remove
6898 * @return {Node} The removed node
6900 removeChild : function(node){
6901 var index = this.childNodes.indexOf(node);
6905 if(this.fireEvent("beforeremove", this.ownerTree, this, node) === false){
6909 // remove it from childNodes collection
6910 this.childNodes.splice(index, 1);
6913 if(node.previousSibling){
6914 node.previousSibling.nextSibling = node.nextSibling;
6916 if(node.nextSibling){
6917 node.nextSibling.previousSibling = node.previousSibling;
6920 // update child refs
6921 if(this.firstChild == node){
6922 this.setFirstChild(node.nextSibling);
6924 if(this.lastChild == node){
6925 this.setLastChild(node.previousSibling);
6928 node.setOwnerTree(null);
6929 // clear any references from the node
6930 node.parentNode = null;
6931 node.previousSibling = null;
6932 node.nextSibling = null;
6933 this.fireEvent("remove", this.ownerTree, this, node);
6938 * Inserts the first node before the second node in this nodes childNodes collection.
6939 * @param {Node} node The node to insert
6940 * @param {Node} refNode The node to insert before (if null the node is appended)
6941 * @return {Node} The inserted node
6943 insertBefore : function(node, refNode){
6944 if(!refNode){ // like standard Dom, refNode can be null for append
6945 return this.appendChild(node);
6948 if(node == refNode){
6952 if(this.fireEvent("beforeinsert", this.ownerTree, this, node, refNode) === false){
6955 var index = this.childNodes.indexOf(refNode);
6956 var oldParent = node.parentNode;
6957 var refIndex = index;
6959 // when moving internally, indexes will change after remove
6960 if(oldParent == this && this.childNodes.indexOf(node) < index){
6964 // it's a move, make sure we move it cleanly
6966 if(node.fireEvent("beforemove", node.getOwnerTree(), node, oldParent, this, index, refNode) === false){
6969 oldParent.removeChild(node);
6972 this.setFirstChild(node);
6974 this.childNodes.splice(refIndex, 0, node);
6975 node.parentNode = this;
6976 var ps = this.childNodes[refIndex-1];
6978 node.previousSibling = ps;
6979 ps.nextSibling = node;
6981 node.previousSibling = null;
6983 node.nextSibling = refNode;
6984 refNode.previousSibling = node;
6985 node.setOwnerTree(this.getOwnerTree());
6986 this.fireEvent("insert", this.ownerTree, this, node, refNode);
6988 node.fireEvent("move", this.ownerTree, node, oldParent, this, refIndex, refNode);
6994 * Returns the child node at the specified index.
6995 * @param {Number} index
6998 item : function(index){
6999 return this.childNodes[index];
7003 * Replaces one child node in this node with another.
7004 * @param {Node} newChild The replacement node
7005 * @param {Node} oldChild The node to replace
7006 * @return {Node} The replaced node
7008 replaceChild : function(newChild, oldChild){
7009 this.insertBefore(newChild, oldChild);
7010 this.removeChild(oldChild);
7015 * Returns the index of a child node
7016 * @param {Node} node
7017 * @return {Number} The index of the node or -1 if it was not found
7019 indexOf : function(child){
7020 return this.childNodes.indexOf(child);
7024 * Returns the tree this node is in.
7027 getOwnerTree : function(){
7028 // if it doesn't have one, look for one
7029 if(!this.ownerTree){
7033 this.ownerTree = p.ownerTree;
7039 return this.ownerTree;
7043 * Returns depth of this node (the root node has a depth of 0)
7046 getDepth : function(){
7049 while(p.parentNode){
7057 setOwnerTree : function(tree){
7058 // if it's move, we need to update everyone
7059 if(tree != this.ownerTree){
7061 this.ownerTree.unregisterNode(this);
7063 this.ownerTree = tree;
7064 var cs = this.childNodes;
7065 for(var i = 0, len = cs.length; i < len; i++) {
7066 cs[i].setOwnerTree(tree);
7069 tree.registerNode(this);
7075 * Returns the path for this node. The path can be used to expand or select this node programmatically.
7076 * @param {String} attr (optional) The attr to use for the path (defaults to the node's id)
7077 * @return {String} The path
7079 getPath : function(attr){
7080 attr = attr || "id";
7081 var p = this.parentNode;
7082 var b = [this.attributes[attr]];
7084 b.unshift(p.attributes[attr]);
7087 var sep = this.getOwnerTree().pathSeparator;
7088 return sep + b.join(sep);
7092 * Bubbles up the tree from this node, calling the specified function with each node. The scope (<i>this</i>) of
7093 * function call will be the scope provided or the current node. The arguments to the function
7094 * will be the args provided or the current node. If the function returns false at any point,
7095 * the bubble is stopped.
7096 * @param {Function} fn The function to call
7097 * @param {Object} scope (optional) The scope of the function (defaults to current node)
7098 * @param {Array} args (optional) The args to call the function with (default to passing the current node)
7100 bubble : function(fn, scope, args){
7103 if(fn.call(scope || p, args || p) === false){
7111 * Cascades down the tree from this node, calling the specified function with each node. The scope (<i>this</i>) of
7112 * function call will be the scope provided or the current node. The arguments to the function
7113 * will be the args provided or the current node. If the function returns false at any point,
7114 * the cascade is stopped on that branch.
7115 * @param {Function} fn The function to call
7116 * @param {Object} scope (optional) The scope of the function (defaults to current node)
7117 * @param {Array} args (optional) The args to call the function with (default to passing the current node)
7119 cascade : function(fn, scope, args){
7120 if(fn.call(scope || this, args || this) !== false){
7121 var cs = this.childNodes;
7122 for(var i = 0, len = cs.length; i < len; i++) {
7123 cs[i].cascade(fn, scope, args);
7129 * Interates the child nodes of this node, calling the specified function with each node. The scope (<i>this</i>) of
7130 * function call will be the scope provided or the current node. The arguments to the function
7131 * will be the args provided or the current node. If the function returns false at any point,
7132 * the iteration stops.
7133 * @param {Function} fn The function to call
7134 * @param {Object} scope (optional) The scope of the function (defaults to current node)
7135 * @param {Array} args (optional) The args to call the function with (default to passing the current node)
7137 eachChild : function(fn, scope, args){
7138 var cs = this.childNodes;
7139 for(var i = 0, len = cs.length; i < len; i++) {
7140 if(fn.call(scope || this, args || cs[i]) === false){
7147 * Finds the first child that has the attribute with the specified value.
7148 * @param {String} attribute The attribute name
7149 * @param {Mixed} value The value to search for
7150 * @return {Node} The found child or null if none was found
7152 findChild : function(attribute, value){
7153 var cs = this.childNodes;
7154 for(var i = 0, len = cs.length; i < len; i++) {
7155 if(cs[i].attributes[attribute] == value){
7163 * Finds the first child by a custom function. The child matches if the function passed
7165 * @param {Function} fn
7166 * @param {Object} scope (optional)
7167 * @return {Node} The found child or null if none was found
7169 findChildBy : function(fn, scope){
7170 var cs = this.childNodes;
7171 for(var i = 0, len = cs.length; i < len; i++) {
7172 if(fn.call(scope||cs[i], cs[i]) === true){
7180 * Sorts this nodes children using the supplied sort function
7181 * @param {Function} fn
7182 * @param {Object} scope (optional)
7184 sort : function(fn, scope){
7185 var cs = this.childNodes;
7186 var len = cs.length;
7188 var sortFn = scope ? function(){fn.apply(scope, arguments);} : fn;
7190 for(var i = 0; i < len; i++){
7192 n.previousSibling = cs[i-1];
7193 n.nextSibling = cs[i+1];
7195 this.setFirstChild(n);
7198 this.setLastChild(n);
7205 * Returns true if this node is an ancestor (at any point) of the passed node.
7206 * @param {Node} node
7209 contains : function(node){
7210 return node.isAncestor(this);
7214 * Returns true if the passed node is an ancestor (at any point) of this node.
7215 * @param {Node} node
7218 isAncestor : function(node){
7219 var p = this.parentNode;
7229 toString : function(){
7230 return "[Node"+(this.id?" "+this.id:"")+"]";
7234 * Ext JS Library 1.1.1
7235 * Copyright(c) 2006-2007, Ext JS, LLC.
7237 * Originally Released Under LGPL - original licence link has changed is not relivant.
7240 * <script type="text/javascript">
7245 * @class Roo.ComponentMgr
7246 * Provides a common registry of all components on a page so that they can be easily accessed by component id (see {@link Roo.getCmp}).
7249 Roo.ComponentMgr = function(){
7250 var all = new Roo.util.MixedCollection();
7254 * Registers a component.
7255 * @param {Roo.Component} c The component
7257 register : function(c){
7262 * Unregisters a component.
7263 * @param {Roo.Component} c The component
7265 unregister : function(c){
7270 * Returns a component by id
7271 * @param {String} id The component id
7278 * Registers a function that will be called when a specified component is added to ComponentMgr
7279 * @param {String} id The component id
7280 * @param {Funtction} fn The callback function
7281 * @param {Object} scope The scope of the callback
7283 onAvailable : function(id, fn, scope){
7284 all.on("add", function(index, o){
7286 fn.call(scope || o, o);
7287 all.un("add", fn, scope);
7294 * Ext JS Library 1.1.1
7295 * Copyright(c) 2006-2007, Ext JS, LLC.
7297 * Originally Released Under LGPL - original licence link has changed is not relivant.
7300 * <script type="text/javascript">
7304 * @class Roo.Component
7305 * @extends Roo.util.Observable
7306 * Base class for all major Roo components. All subclasses of Component can automatically participate in the standard
7307 * Roo component lifecycle of creation, rendering and destruction. They also have automatic support for basic hide/show
7308 * and enable/disable behavior. Component allows any subclass to be lazy-rendered into any {@link Roo.Container} and
7309 * to be automatically registered with the {@link Roo.ComponentMgr} so that it can be referenced at any time via {@link Roo.getCmp}.
7310 * All visual components (widgets) that require rendering into a layout should subclass Component.
7312 * @param {Roo.Element/String/Object} config The configuration options. If an element is passed, it is set as the internal
7313 * 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
7314 * and is used as the component id. Otherwise, it is assumed to be a standard config object and is applied to the component.
7316 Roo.Component = function(config){
7317 config = config || {};
7318 if(config.tagName || config.dom || typeof config == "string"){ // element object
7319 config = {el: config, id: config.id || config};
7321 this.initialConfig = config;
7323 Roo.apply(this, config);
7327 * Fires after the component is disabled.
7328 * @param {Roo.Component} this
7333 * Fires after the component is enabled.
7334 * @param {Roo.Component} this
7339 * Fires before the component is shown. Return false to stop the show.
7340 * @param {Roo.Component} this
7345 * Fires after the component is shown.
7346 * @param {Roo.Component} this
7351 * Fires before the component is hidden. Return false to stop the hide.
7352 * @param {Roo.Component} this
7357 * Fires after the component is hidden.
7358 * @param {Roo.Component} this
7362 * @event beforerender
7363 * Fires before the component is rendered. Return false to stop the render.
7364 * @param {Roo.Component} this
7366 beforerender : true,
7369 * Fires after the component is rendered.
7370 * @param {Roo.Component} this
7374 * @event beforedestroy
7375 * Fires before the component is destroyed. Return false to stop the destroy.
7376 * @param {Roo.Component} this
7378 beforedestroy : true,
7381 * Fires after the component is destroyed.
7382 * @param {Roo.Component} this
7387 this.id = "ext-comp-" + (++Roo.Component.AUTO_ID);
7389 Roo.ComponentMgr.register(this);
7390 Roo.Component.superclass.constructor.call(this);
7391 this.initComponent();
7392 if(this.renderTo){ // not supported by all components yet. use at your own risk!
7393 this.render(this.renderTo);
7394 delete this.renderTo;
7399 Roo.Component.AUTO_ID = 1000;
7401 Roo.extend(Roo.Component, Roo.util.Observable, {
7403 * @scope Roo.Component.prototype
7405 * true if this component is hidden. Read-only.
7410 * true if this component is disabled. Read-only.
7415 * true if this component has been rendered. Read-only.
7419 /** @cfg {String} disableClass
7420 * CSS class added to the component when it is disabled (defaults to "x-item-disabled").
7422 disabledClass : "x-item-disabled",
7423 /** @cfg {Boolean} allowDomMove
7424 * Whether the component can move the Dom node when rendering (defaults to true).
7426 allowDomMove : true,
7427 /** @cfg {String} hideMode
7428 * How this component should hidden. Supported values are
7429 * "visibility" (css visibility), "offsets" (negative offset position) and
7430 * "display" (css display) - defaults to "display".
7432 hideMode: 'display',
7435 ctype : "Roo.Component",
7438 * @cfg {String} actionMode
7439 * which property holds the element that used for hide() / show() / disable() / enable()
7445 getActionEl : function(){
7446 return this[this.actionMode];
7449 initComponent : Roo.emptyFn,
7451 * If this is a lazy rendering component, render it to its container element.
7452 * @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.
7454 render : function(container, position){
7455 if(!this.rendered && this.fireEvent("beforerender", this) !== false){
7456 if(!container && this.el){
7457 this.el = Roo.get(this.el);
7458 container = this.el.dom.parentNode;
7459 this.allowDomMove = false;
7461 this.container = Roo.get(container);
7462 this.rendered = true;
7463 if(position !== undefined){
7464 if(typeof position == 'number'){
7465 position = this.container.dom.childNodes[position];
7467 position = Roo.getDom(position);
7470 this.onRender(this.container, position || null);
7472 this.el.addClass(this.cls);
7476 this.el.applyStyles(this.style);
7479 this.fireEvent("render", this);
7480 this.afterRender(this.container);
7492 // default function is not really useful
7493 onRender : function(ct, position){
7495 this.el = Roo.get(this.el);
7496 if(this.allowDomMove !== false){
7497 ct.dom.insertBefore(this.el.dom, position);
7503 getAutoCreate : function(){
7504 var cfg = typeof this.autoCreate == "object" ?
7505 this.autoCreate : Roo.apply({}, this.defaultAutoCreate);
7506 if(this.id && !cfg.id){
7513 afterRender : Roo.emptyFn,
7516 * Destroys this component by purging any event listeners, removing the component's element from the DOM,
7517 * removing the component from its {@link Roo.Container} (if applicable) and unregistering it from {@link Roo.ComponentMgr}.
7519 destroy : function(){
7520 if(this.fireEvent("beforedestroy", this) !== false){
7521 this.purgeListeners();
7522 this.beforeDestroy();
7524 this.el.removeAllListeners();
7526 if(this.actionMode == "container"){
7527 this.container.remove();
7531 Roo.ComponentMgr.unregister(this);
7532 this.fireEvent("destroy", this);
7537 beforeDestroy : function(){
7542 onDestroy : function(){
7547 * Returns the underlying {@link Roo.Element}.
7548 * @return {Roo.Element} The element
7555 * Returns the id of this component.
7563 * Try to focus this component.
7564 * @param {Boolean} selectText True to also select the text in this component (if applicable)
7565 * @return {Roo.Component} this
7567 focus : function(selectText){
7570 if(selectText === true){
7571 this.el.dom.select();
7586 * Disable this component.
7587 * @return {Roo.Component} this
7589 disable : function(){
7593 this.disabled = true;
7594 this.fireEvent("disable", this);
7599 onDisable : function(){
7600 this.getActionEl().addClass(this.disabledClass);
7601 this.el.dom.disabled = true;
7605 * Enable this component.
7606 * @return {Roo.Component} this
7608 enable : function(){
7612 this.disabled = false;
7613 this.fireEvent("enable", this);
7618 onEnable : function(){
7619 this.getActionEl().removeClass(this.disabledClass);
7620 this.el.dom.disabled = false;
7624 * Convenience function for setting disabled/enabled by boolean.
7625 * @param {Boolean} disabled
7627 setDisabled : function(disabled){
7628 this[disabled ? "disable" : "enable"]();
7632 * Show this component.
7633 * @return {Roo.Component} this
7636 if(this.fireEvent("beforeshow", this) !== false){
7637 this.hidden = false;
7641 this.fireEvent("show", this);
7647 onShow : function(){
7648 var ae = this.getActionEl();
7649 if(this.hideMode == 'visibility'){
7650 ae.dom.style.visibility = "visible";
7651 }else if(this.hideMode == 'offsets'){
7652 ae.removeClass('x-hidden');
7654 ae.dom.style.display = "";
7659 * Hide this component.
7660 * @return {Roo.Component} this
7663 if(this.fireEvent("beforehide", this) !== false){
7668 this.fireEvent("hide", this);
7674 onHide : function(){
7675 var ae = this.getActionEl();
7676 if(this.hideMode == 'visibility'){
7677 ae.dom.style.visibility = "hidden";
7678 }else if(this.hideMode == 'offsets'){
7679 ae.addClass('x-hidden');
7681 ae.dom.style.display = "none";
7686 * Convenience function to hide or show this component by boolean.
7687 * @param {Boolean} visible True to show, false to hide
7688 * @return {Roo.Component} this
7690 setVisible: function(visible){
7700 * Returns true if this component is visible.
7702 isVisible : function(){
7703 return this.getActionEl().isVisible();
7706 cloneConfig : function(overrides){
7707 overrides = overrides || {};
7708 var id = overrides.id || Roo.id();
7709 var cfg = Roo.applyIf(overrides, this.initialConfig);
7710 cfg.id = id; // prevent dup id
7711 return new this.constructor(cfg);
7715 * Ext JS Library 1.1.1
7716 * Copyright(c) 2006-2007, Ext JS, LLC.
7718 * Originally Released Under LGPL - original licence link has changed is not relivant.
7721 * <script type="text/javascript">
7726 * @extends Roo.Element
7727 * An extended {@link Roo.Element} object that supports a shadow and shim, constrain to viewport and
7728 * automatic maintaining of shadow/shim positions.
7729 * @cfg {Boolean} shim False to disable the iframe shim in browsers which need one (defaults to true)
7730 * @cfg {String/Boolean} shadow True to create a shadow element with default class "x-layer-shadow", or
7731 * you can pass a string with a CSS class name. False turns off the shadow.
7732 * @cfg {Object} dh DomHelper object config to create element with (defaults to {tag: "div", cls: "x-layer"}).
7733 * @cfg {Boolean} constrain False to disable constrain to viewport (defaults to true)
7734 * @cfg {String} cls CSS class to add to the element
7735 * @cfg {Number} zindex Starting z-index (defaults to 11000)
7736 * @cfg {Number} shadowOffset Number of pixels to offset the shadow (defaults to 3)
7738 * @param {Object} config An object with config options.
7739 * @param {String/HTMLElement} existingEl (optional) Uses an existing DOM element. If the element is not found it creates it.
7742 Roo.Layer = function(config, existingEl){
7743 config = config || {};
7744 var dh = Roo.DomHelper;
7745 var cp = config.parentEl, pel = cp ? Roo.getDom(cp) : document.body;
7747 this.dom = Roo.getDom(existingEl);
7750 var o = config.dh || {tag: "div", cls: "x-layer"};
7751 this.dom = dh.append(pel, o);
7754 this.addClass(config.cls);
7756 this.constrain = config.constrain !== false;
7757 this.visibilityMode = Roo.Element.VISIBILITY;
7759 this.id = this.dom.id = config.id;
7761 this.id = Roo.id(this.dom);
7763 this.zindex = config.zindex || this.getZIndex();
7764 this.position("absolute", this.zindex);
7766 this.shadowOffset = config.shadowOffset || 4;
7767 this.shadow = new Roo.Shadow({
7768 offset : this.shadowOffset,
7769 mode : config.shadow
7772 this.shadowOffset = 0;
7774 this.useShim = config.shim !== false && Roo.useShims;
7775 this.useDisplay = config.useDisplay;
7779 var supr = Roo.Element.prototype;
7781 // shims are shared among layer to keep from having 100 iframes
7784 Roo.extend(Roo.Layer, Roo.Element, {
7786 getZIndex : function(){
7787 return this.zindex || parseInt(this.getStyle("z-index"), 10) || 11000;
7790 getShim : function(){
7797 var shim = shims.shift();
7799 shim = this.createShim();
7800 shim.enableDisplayMode('block');
7801 shim.dom.style.display = 'none';
7802 shim.dom.style.visibility = 'visible';
7804 var pn = this.dom.parentNode;
7805 if(shim.dom.parentNode != pn){
7806 pn.insertBefore(shim.dom, this.dom);
7808 shim.setStyle('z-index', this.getZIndex()-2);
7813 hideShim : function(){
7815 this.shim.setDisplayed(false);
7816 shims.push(this.shim);
7821 disableShadow : function(){
7823 this.shadowDisabled = true;
7825 this.lastShadowOffset = this.shadowOffset;
7826 this.shadowOffset = 0;
7830 enableShadow : function(show){
7832 this.shadowDisabled = false;
7833 this.shadowOffset = this.lastShadowOffset;
7834 delete this.lastShadowOffset;
7842 // this code can execute repeatedly in milliseconds (i.e. during a drag) so
7843 // code size was sacrificed for effeciency (e.g. no getBox/setBox, no XY calls)
7844 sync : function(doShow){
7845 var sw = this.shadow;
7846 if(!this.updating && this.isVisible() && (sw || this.useShim)){
7847 var sh = this.getShim();
7849 var w = this.getWidth(),
7850 h = this.getHeight();
7852 var l = this.getLeft(true),
7853 t = this.getTop(true);
7855 if(sw && !this.shadowDisabled){
7856 if(doShow && !sw.isVisible()){
7859 sw.realign(l, t, w, h);
7865 // fit the shim behind the shadow, so it is shimmed too
7866 var a = sw.adjusts, s = sh.dom.style;
7867 s.left = (Math.min(l, l+a.l))+"px";
7868 s.top = (Math.min(t, t+a.t))+"px";
7869 s.width = (w+a.w)+"px";
7870 s.height = (h+a.h)+"px";
7877 sh.setLeftTop(l, t);
7884 destroy : function(){
7889 this.removeAllListeners();
7890 var pn = this.dom.parentNode;
7892 pn.removeChild(this.dom);
7894 Roo.Element.uncache(this.id);
7897 remove : function(){
7902 beginUpdate : function(){
7903 this.updating = true;
7907 endUpdate : function(){
7908 this.updating = false;
7913 hideUnders : function(negOffset){
7921 constrainXY : function(){
7923 var vw = Roo.lib.Dom.getViewWidth(),
7924 vh = Roo.lib.Dom.getViewHeight();
7925 var s = Roo.get(document).getScroll();
7927 var xy = this.getXY();
7928 var x = xy[0], y = xy[1];
7929 var w = this.dom.offsetWidth+this.shadowOffset, h = this.dom.offsetHeight+this.shadowOffset;
7930 // only move it if it needs it
7932 // first validate right/bottom
7933 if((x + w) > vw+s.left){
7934 x = vw - w - this.shadowOffset;
7937 if((y + h) > vh+s.top){
7938 y = vh - h - this.shadowOffset;
7941 // then make sure top/left isn't negative
7952 var ay = this.avoidY;
7953 if(y <= ay && (y+h) >= ay){
7959 supr.setXY.call(this, xy);
7965 isVisible : function(){
7966 return this.visible;
7970 showAction : function(){
7971 this.visible = true; // track visibility to prevent getStyle calls
7972 if(this.useDisplay === true){
7973 this.setDisplayed("");
7974 }else if(this.lastXY){
7975 supr.setXY.call(this, this.lastXY);
7976 }else if(this.lastLT){
7977 supr.setLeftTop.call(this, this.lastLT[0], this.lastLT[1]);
7982 hideAction : function(){
7983 this.visible = false;
7984 if(this.useDisplay === true){
7985 this.setDisplayed(false);
7987 this.setLeftTop(-10000,-10000);
7991 // overridden Element method
7992 setVisible : function(v, a, d, c, e){
7997 var cb = function(){
8002 }.createDelegate(this);
8003 supr.setVisible.call(this, true, true, d, cb, e);
8006 this.hideUnders(true);
8015 }.createDelegate(this);
8017 supr.setVisible.call(this, v, a, d, cb, e);
8026 storeXY : function(xy){
8031 storeLeftTop : function(left, top){
8033 this.lastLT = [left, top];
8037 beforeFx : function(){
8038 this.beforeAction();
8039 return Roo.Layer.superclass.beforeFx.apply(this, arguments);
8043 afterFx : function(){
8044 Roo.Layer.superclass.afterFx.apply(this, arguments);
8045 this.sync(this.isVisible());
8049 beforeAction : function(){
8050 if(!this.updating && this.shadow){
8055 // overridden Element method
8056 setLeft : function(left){
8057 this.storeLeftTop(left, this.getTop(true));
8058 supr.setLeft.apply(this, arguments);
8062 setTop : function(top){
8063 this.storeLeftTop(this.getLeft(true), top);
8064 supr.setTop.apply(this, arguments);
8068 setLeftTop : function(left, top){
8069 this.storeLeftTop(left, top);
8070 supr.setLeftTop.apply(this, arguments);
8074 setXY : function(xy, a, d, c, e){
8076 this.beforeAction();
8078 var cb = this.createCB(c);
8079 supr.setXY.call(this, xy, a, d, cb, e);
8086 createCB : function(c){
8097 // overridden Element method
8098 setX : function(x, a, d, c, e){
8099 this.setXY([x, this.getY()], a, d, c, e);
8102 // overridden Element method
8103 setY : function(y, a, d, c, e){
8104 this.setXY([this.getX(), y], a, d, c, e);
8107 // overridden Element method
8108 setSize : function(w, h, a, d, c, e){
8109 this.beforeAction();
8110 var cb = this.createCB(c);
8111 supr.setSize.call(this, w, h, a, d, cb, e);
8117 // overridden Element method
8118 setWidth : function(w, a, d, c, e){
8119 this.beforeAction();
8120 var cb = this.createCB(c);
8121 supr.setWidth.call(this, w, a, d, cb, e);
8127 // overridden Element method
8128 setHeight : function(h, a, d, c, e){
8129 this.beforeAction();
8130 var cb = this.createCB(c);
8131 supr.setHeight.call(this, h, a, d, cb, e);
8137 // overridden Element method
8138 setBounds : function(x, y, w, h, a, d, c, e){
8139 this.beforeAction();
8140 var cb = this.createCB(c);
8142 this.storeXY([x, y]);
8143 supr.setXY.call(this, [x, y]);
8144 supr.setSize.call(this, w, h, a, d, cb, e);
8147 supr.setBounds.call(this, x, y, w, h, a, d, cb, e);
8153 * Sets the z-index of this layer and adjusts any shadow and shim z-indexes. The layer z-index is automatically
8154 * incremented by two more than the value passed in so that it always shows above any shadow or shim (the shadow
8155 * element, if any, will be assigned z-index + 1, and the shim element, if any, will be assigned the unmodified z-index).
8156 * @param {Number} zindex The new z-index to set
8157 * @return {this} The Layer
8159 setZIndex : function(zindex){
8160 this.zindex = zindex;
8161 this.setStyle("z-index", zindex + 2);
8163 this.shadow.setZIndex(zindex + 1);
8166 this.shim.setStyle("z-index", zindex);
8172 * Ext JS Library 1.1.1
8173 * Copyright(c) 2006-2007, Ext JS, LLC.
8175 * Originally Released Under LGPL - original licence link has changed is not relivant.
8178 * <script type="text/javascript">
8184 * Simple class that can provide a shadow effect for any element. Note that the element MUST be absolutely positioned,
8185 * and the shadow does not provide any shimming. This should be used only in simple cases -- for more advanced
8186 * functionality that can also provide the same shadow effect, see the {@link Roo.Layer} class.
8188 * Create a new Shadow
8189 * @param {Object} config The config object
8191 Roo.Shadow = function(config){
8192 Roo.apply(this, config);
8193 if(typeof this.mode != "string"){
8194 this.mode = this.defaultMode;
8196 var o = this.offset, a = {h: 0};
8197 var rad = Math.floor(this.offset/2);
8198 switch(this.mode.toLowerCase()){ // all this hideous nonsense calculates the various offsets for shadows
8204 a.l -= this.offset + rad;
8205 a.t -= this.offset + rad;
8216 a.l -= (this.offset - rad);
8217 a.t -= this.offset + rad;
8219 a.w -= (this.offset - rad)*2;
8230 a.l -= (this.offset - rad);
8231 a.t -= (this.offset - rad);
8233 a.w -= (this.offset + rad + 1);
8234 a.h -= (this.offset + rad);
8243 Roo.Shadow.prototype = {
8245 * @cfg {String} mode
8246 * The shadow display mode. Supports the following options:<br />
8247 * sides: Shadow displays on both sides and bottom only<br />
8248 * frame: Shadow displays equally on all four sides<br />
8249 * drop: Traditional bottom-right drop shadow (default)
8252 * @cfg {String} offset
8253 * The number of pixels to offset the shadow from the element (defaults to 4)
8258 defaultMode: "drop",
8261 * Displays the shadow under the target element
8262 * @param {String/HTMLElement/Element} targetEl The id or element under which the shadow should display
8264 show : function(target){
8265 target = Roo.get(target);
8267 this.el = Roo.Shadow.Pool.pull();
8268 if(this.el.dom.nextSibling != target.dom){
8269 this.el.insertBefore(target);
8272 this.el.setStyle("z-index", this.zIndex || parseInt(target.getStyle("z-index"), 10)-1);
8274 this.el.dom.style.filter="progid:DXImageTransform.Microsoft.alpha(opacity=50) progid:DXImageTransform.Microsoft.Blur(pixelradius="+(this.offset)+")";
8277 target.getLeft(true),
8278 target.getTop(true),
8282 this.el.dom.style.display = "block";
8286 * Returns true if the shadow is visible, else false
8288 isVisible : function(){
8289 return this.el ? true : false;
8293 * Direct alignment when values are already available. Show must be called at least once before
8294 * calling this method to ensure it is initialized.
8295 * @param {Number} left The target element left position
8296 * @param {Number} top The target element top position
8297 * @param {Number} width The target element width
8298 * @param {Number} height The target element height
8300 realign : function(l, t, w, h){
8304 var a = this.adjusts, d = this.el.dom, s = d.style;
8306 s.left = (l+a.l)+"px";
8307 s.top = (t+a.t)+"px";
8308 var sw = (w+a.w), sh = (h+a.h), sws = sw +"px", shs = sh + "px";
8310 if(s.width != sws || s.height != shs){
8314 var cn = d.childNodes;
8315 var sww = Math.max(0, (sw-12))+"px";
8316 cn[0].childNodes[1].style.width = sww;
8317 cn[1].childNodes[1].style.width = sww;
8318 cn[2].childNodes[1].style.width = sww;
8319 cn[1].style.height = Math.max(0, (sh-12))+"px";
8329 this.el.dom.style.display = "none";
8330 Roo.Shadow.Pool.push(this.el);
8336 * Adjust the z-index of this shadow
8337 * @param {Number} zindex The new z-index
8339 setZIndex : function(z){
8342 this.el.setStyle("z-index", z);
8347 // Private utility class that manages the internal Shadow cache
8348 Roo.Shadow.Pool = function(){
8350 var markup = Roo.isIE ?
8351 '<div class="x-ie-shadow"></div>' :
8352 '<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>';
8357 sh = Roo.get(Roo.DomHelper.insertHtml("beforeBegin", document.body.firstChild, markup));
8358 sh.autoBoxAdjust = false;
8363 push : function(sh){
8369 * Ext JS Library 1.1.1
8370 * Copyright(c) 2006-2007, Ext JS, LLC.
8372 * Originally Released Under LGPL - original licence link has changed is not relivant.
8375 * <script type="text/javascript">
8379 * @class Roo.BoxComponent
8380 * @extends Roo.Component
8381 * Base class for any visual {@link Roo.Component} that uses a box container. BoxComponent provides automatic box
8382 * model adjustments for sizing and positioning and will work correctly withnin the Component rendering model. All
8383 * container classes should subclass BoxComponent so that they will work consistently when nested within other Ext
8384 * layout containers.
8386 * @param {Roo.Element/String/Object} config The configuration options.
8388 Roo.BoxComponent = function(config){
8389 Roo.Component.call(this, config);
8393 * Fires after the component is resized.
8394 * @param {Roo.Component} this
8395 * @param {Number} adjWidth The box-adjusted width that was set
8396 * @param {Number} adjHeight The box-adjusted height that was set
8397 * @param {Number} rawWidth The width that was originally specified
8398 * @param {Number} rawHeight The height that was originally specified
8403 * Fires after the component is moved.
8404 * @param {Roo.Component} this
8405 * @param {Number} x The new x position
8406 * @param {Number} y The new y position
8412 Roo.extend(Roo.BoxComponent, Roo.Component, {
8413 // private, set in afterRender to signify that the component has been rendered
8415 // private, used to defer height settings to subclasses
8417 /** @cfg {Number} width
8418 * width (optional) size of component
8420 /** @cfg {Number} height
8421 * height (optional) size of component
8425 * Sets the width and height of the component. This method fires the resize event. This method can accept
8426 * either width and height as separate numeric arguments, or you can pass a size object like {width:10, height:20}.
8427 * @param {Number/Object} width The new width to set, or a size object in the format {width, height}
8428 * @param {Number} height The new height to set (not required if a size object is passed as the first arg)
8429 * @return {Roo.BoxComponent} this
8431 setSize : function(w, h){
8432 // support for standard size objects
8433 if(typeof w == 'object'){
8444 // prevent recalcs when not needed
8445 if(this.lastSize && this.lastSize.width == w && this.lastSize.height == h){
8448 this.lastSize = {width: w, height: h};
8450 var adj = this.adjustSize(w, h);
8451 var aw = adj.width, ah = adj.height;
8452 if(aw !== undefined || ah !== undefined){ // this code is nasty but performs better with floaters
8453 var rz = this.getResizeEl();
8454 if(!this.deferHeight && aw !== undefined && ah !== undefined){
8456 }else if(!this.deferHeight && ah !== undefined){
8458 }else if(aw !== undefined){
8461 this.onResize(aw, ah, w, h);
8462 this.fireEvent('resize', this, aw, ah, w, h);
8468 * Gets the current size of the component's underlying element.
8469 * @return {Object} An object containing the element's size {width: (element width), height: (element height)}
8471 getSize : function(){
8472 return this.el.getSize();
8476 * Gets the current XY position of the component's underlying element.
8477 * @param {Boolean} local (optional) If true the element's left and top are returned instead of page XY (defaults to false)
8478 * @return {Array} The XY position of the element (e.g., [100, 200])
8480 getPosition : function(local){
8482 return [this.el.getLeft(true), this.el.getTop(true)];
8484 return this.xy || this.el.getXY();
8488 * Gets the current box measurements of the component's underlying element.
8489 * @param {Boolean} local (optional) If true the element's left and top are returned instead of page XY (defaults to false)
8490 * @returns {Object} box An object in the format {x, y, width, height}
8492 getBox : function(local){
8493 var s = this.el.getSize();
8495 s.x = this.el.getLeft(true);
8496 s.y = this.el.getTop(true);
8498 var xy = this.xy || this.el.getXY();
8506 * Sets the current box measurements of the component's underlying element.
8507 * @param {Object} box An object in the format {x, y, width, height}
8508 * @returns {Roo.BoxComponent} this
8510 updateBox : function(box){
8511 this.setSize(box.width, box.height);
8512 this.setPagePosition(box.x, box.y);
8517 getResizeEl : function(){
8518 return this.resizeEl || this.el;
8522 getPositionEl : function(){
8523 return this.positionEl || this.el;
8527 * Sets the left and top of the component. To set the page XY position instead, use {@link #setPagePosition}.
8528 * This method fires the move event.
8529 * @param {Number} left The new left
8530 * @param {Number} top The new top
8531 * @returns {Roo.BoxComponent} this
8533 setPosition : function(x, y){
8539 var adj = this.adjustPosition(x, y);
8540 var ax = adj.x, ay = adj.y;
8542 var el = this.getPositionEl();
8543 if(ax !== undefined || ay !== undefined){
8544 if(ax !== undefined && ay !== undefined){
8545 el.setLeftTop(ax, ay);
8546 }else if(ax !== undefined){
8548 }else if(ay !== undefined){
8551 this.onPosition(ax, ay);
8552 this.fireEvent('move', this, ax, ay);
8558 * Sets the page XY position of the component. To set the left and top instead, use {@link #setPosition}.
8559 * This method fires the move event.
8560 * @param {Number} x The new x position
8561 * @param {Number} y The new y position
8562 * @returns {Roo.BoxComponent} this
8564 setPagePosition : function(x, y){
8570 if(x === undefined || y === undefined){ // cannot translate undefined points
8573 var p = this.el.translatePoints(x, y);
8574 this.setPosition(p.left, p.top);
8579 onRender : function(ct, position){
8580 Roo.BoxComponent.superclass.onRender.call(this, ct, position);
8582 this.resizeEl = Roo.get(this.resizeEl);
8584 if(this.positionEl){
8585 this.positionEl = Roo.get(this.positionEl);
8590 afterRender : function(){
8591 Roo.BoxComponent.superclass.afterRender.call(this);
8592 this.boxReady = true;
8593 this.setSize(this.width, this.height);
8594 if(this.x || this.y){
8595 this.setPosition(this.x, this.y);
8597 if(this.pageX || this.pageY){
8598 this.setPagePosition(this.pageX, this.pageY);
8603 * Force the component's size to recalculate based on the underlying element's current height and width.
8604 * @returns {Roo.BoxComponent} this
8606 syncSize : function(){
8607 delete this.lastSize;
8608 this.setSize(this.el.getWidth(), this.el.getHeight());
8613 * Called after the component is resized, this method is empty by default but can be implemented by any
8614 * subclass that needs to perform custom logic after a resize occurs.
8615 * @param {Number} adjWidth The box-adjusted width that was set
8616 * @param {Number} adjHeight The box-adjusted height that was set
8617 * @param {Number} rawWidth The width that was originally specified
8618 * @param {Number} rawHeight The height that was originally specified
8620 onResize : function(adjWidth, adjHeight, rawWidth, rawHeight){
8625 * Called after the component is moved, this method is empty by default but can be implemented by any
8626 * subclass that needs to perform custom logic after a move occurs.
8627 * @param {Number} x The new x position
8628 * @param {Number} y The new y position
8630 onPosition : function(x, y){
8635 adjustSize : function(w, h){
8639 if(this.autoHeight){
8642 return {width : w, height: h};
8646 adjustPosition : function(x, y){
8647 return {x : x, y: y};
8651 * Ext JS Library 1.1.1
8652 * Copyright(c) 2006-2007, Ext JS, LLC.
8654 * Originally Released Under LGPL - original licence link has changed is not relivant.
8657 * <script type="text/javascript">
8662 * @class Roo.SplitBar
8663 * @extends Roo.util.Observable
8664 * Creates draggable splitter bar functionality from two elements (element to be dragged and element to be resized).
8668 var split = new Roo.SplitBar("elementToDrag", "elementToSize",
8669 Roo.SplitBar.HORIZONTAL, Roo.SplitBar.LEFT);
8670 split.setAdapter(new Roo.SplitBar.AbsoluteLayoutAdapter("container"));
8671 split.minSize = 100;
8672 split.maxSize = 600;
8673 split.animate = true;
8674 split.on('moved', splitterMoved);
8677 * Create a new SplitBar
8678 * @param {String/HTMLElement/Roo.Element} dragElement The element to be dragged and act as the SplitBar.
8679 * @param {String/HTMLElement/Roo.Element} resizingElement The element to be resized based on where the SplitBar element is dragged
8680 * @param {Number} orientation (optional) Either Roo.SplitBar.HORIZONTAL or Roo.SplitBar.VERTICAL. (Defaults to HORIZONTAL)
8681 * @param {Number} placement (optional) Either Roo.SplitBar.LEFT or Roo.SplitBar.RIGHT for horizontal or
8682 Roo.SplitBar.TOP or Roo.SplitBar.BOTTOM for vertical. (By default, this is determined automatically by the initial
8683 position of the SplitBar).
8685 Roo.SplitBar = function(dragElement, resizingElement, orientation, placement, existingProxy){
8688 this.el = Roo.get(dragElement, true);
8689 this.el.dom.unselectable = "on";
8691 this.resizingEl = Roo.get(resizingElement, true);
8695 * The orientation of the split. Either Roo.SplitBar.HORIZONTAL or Roo.SplitBar.VERTICAL. (Defaults to HORIZONTAL)
8696 * Note: If this is changed after creating the SplitBar, the placement property must be manually updated
8699 this.orientation = orientation || Roo.SplitBar.HORIZONTAL;
8702 * The minimum size of the resizing element. (Defaults to 0)
8708 * The maximum size of the resizing element. (Defaults to 2000)
8711 this.maxSize = 2000;
8714 * Whether to animate the transition to the new size
8717 this.animate = false;
8720 * Whether to create a transparent shim that overlays the page when dragging, enables dragging across iframes.
8723 this.useShim = false;
8730 this.proxy = Roo.SplitBar.createProxy(this.orientation);
8732 this.proxy = Roo.get(existingProxy).dom;
8735 this.dd = new Roo.dd.DDProxy(this.el.dom.id, "XSplitBars", {dragElId : this.proxy.id});
8738 this.dd.b4StartDrag = this.onStartProxyDrag.createDelegate(this);
8741 this.dd.endDrag = this.onEndProxyDrag.createDelegate(this);
8744 this.dragSpecs = {};
8747 * @private The adapter to use to positon and resize elements
8749 this.adapter = new Roo.SplitBar.BasicLayoutAdapter();
8750 this.adapter.init(this);
8752 if(this.orientation == Roo.SplitBar.HORIZONTAL){
8754 this.placement = placement || (this.el.getX() > this.resizingEl.getX() ? Roo.SplitBar.LEFT : Roo.SplitBar.RIGHT);
8755 this.el.addClass("x-splitbar-h");
8758 this.placement = placement || (this.el.getY() > this.resizingEl.getY() ? Roo.SplitBar.TOP : Roo.SplitBar.BOTTOM);
8759 this.el.addClass("x-splitbar-v");
8765 * Fires when the splitter is moved (alias for {@link #event-moved})
8766 * @param {Roo.SplitBar} this
8767 * @param {Number} newSize the new width or height
8772 * Fires when the splitter is moved
8773 * @param {Roo.SplitBar} this
8774 * @param {Number} newSize the new width or height
8778 * @event beforeresize
8779 * Fires before the splitter is dragged
8780 * @param {Roo.SplitBar} this
8782 "beforeresize" : true,
8784 "beforeapply" : true
8787 Roo.util.Observable.call(this);
8790 Roo.extend(Roo.SplitBar, Roo.util.Observable, {
8791 onStartProxyDrag : function(x, y){
8792 this.fireEvent("beforeresize", this);
8794 var o = Roo.DomHelper.insertFirst(document.body, {cls: "x-drag-overlay", html: " "}, true);
8796 o.enableDisplayMode("block");
8797 // all splitbars share the same overlay
8798 Roo.SplitBar.prototype.overlay = o;
8800 this.overlay.setSize(Roo.lib.Dom.getViewWidth(true), Roo.lib.Dom.getViewHeight(true));
8801 this.overlay.show();
8802 Roo.get(this.proxy).setDisplayed("block");
8803 var size = this.adapter.getElementSize(this);
8804 this.activeMinSize = this.getMinimumSize();;
8805 this.activeMaxSize = this.getMaximumSize();;
8806 var c1 = size - this.activeMinSize;
8807 var c2 = Math.max(this.activeMaxSize - size, 0);
8808 if(this.orientation == Roo.SplitBar.HORIZONTAL){
8809 this.dd.resetConstraints();
8810 this.dd.setXConstraint(
8811 this.placement == Roo.SplitBar.LEFT ? c1 : c2,
8812 this.placement == Roo.SplitBar.LEFT ? c2 : c1
8814 this.dd.setYConstraint(0, 0);
8816 this.dd.resetConstraints();
8817 this.dd.setXConstraint(0, 0);
8818 this.dd.setYConstraint(
8819 this.placement == Roo.SplitBar.TOP ? c1 : c2,
8820 this.placement == Roo.SplitBar.TOP ? c2 : c1
8823 this.dragSpecs.startSize = size;
8824 this.dragSpecs.startPoint = [x, y];
8825 Roo.dd.DDProxy.prototype.b4StartDrag.call(this.dd, x, y);
8829 * @private Called after the drag operation by the DDProxy
8831 onEndProxyDrag : function(e){
8832 Roo.get(this.proxy).setDisplayed(false);
8833 var endPoint = Roo.lib.Event.getXY(e);
8835 this.overlay.hide();
8838 if(this.orientation == Roo.SplitBar.HORIZONTAL){
8839 newSize = this.dragSpecs.startSize +
8840 (this.placement == Roo.SplitBar.LEFT ?
8841 endPoint[0] - this.dragSpecs.startPoint[0] :
8842 this.dragSpecs.startPoint[0] - endPoint[0]
8845 newSize = this.dragSpecs.startSize +
8846 (this.placement == Roo.SplitBar.TOP ?
8847 endPoint[1] - this.dragSpecs.startPoint[1] :
8848 this.dragSpecs.startPoint[1] - endPoint[1]
8851 newSize = Math.min(Math.max(newSize, this.activeMinSize), this.activeMaxSize);
8852 if(newSize != this.dragSpecs.startSize){
8853 if(this.fireEvent('beforeapply', this, newSize) !== false){
8854 this.adapter.setElementSize(this, newSize);
8855 this.fireEvent("moved", this, newSize);
8856 this.fireEvent("resize", this, newSize);
8862 * Get the adapter this SplitBar uses
8863 * @return The adapter object
8865 getAdapter : function(){
8866 return this.adapter;
8870 * Set the adapter this SplitBar uses
8871 * @param {Object} adapter A SplitBar adapter object
8873 setAdapter : function(adapter){
8874 this.adapter = adapter;
8875 this.adapter.init(this);
8879 * Gets the minimum size for the resizing element
8880 * @return {Number} The minimum size
8882 getMinimumSize : function(){
8883 return this.minSize;
8887 * Sets the minimum size for the resizing element
8888 * @param {Number} minSize The minimum size
8890 setMinimumSize : function(minSize){
8891 this.minSize = minSize;
8895 * Gets the maximum size for the resizing element
8896 * @return {Number} The maximum size
8898 getMaximumSize : function(){
8899 return this.maxSize;
8903 * Sets the maximum size for the resizing element
8904 * @param {Number} maxSize The maximum size
8906 setMaximumSize : function(maxSize){
8907 this.maxSize = maxSize;
8911 * Sets the initialize size for the resizing element
8912 * @param {Number} size The initial size
8914 setCurrentSize : function(size){
8915 var oldAnimate = this.animate;
8916 this.animate = false;
8917 this.adapter.setElementSize(this, size);
8918 this.animate = oldAnimate;
8922 * Destroy this splitbar.
8923 * @param {Boolean} removeEl True to remove the element
8925 destroy : function(removeEl){
8930 this.proxy.parentNode.removeChild(this.proxy);
8938 * @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.
8940 Roo.SplitBar.createProxy = function(dir){
8941 var proxy = new Roo.Element(document.createElement("div"));
8942 proxy.unselectable();
8943 var cls = 'x-splitbar-proxy';
8944 proxy.addClass(cls + ' ' + (dir == Roo.SplitBar.HORIZONTAL ? cls +'-h' : cls + '-v'));
8945 document.body.appendChild(proxy.dom);
8950 * @class Roo.SplitBar.BasicLayoutAdapter
8951 * Default Adapter. It assumes the splitter and resizing element are not positioned
8952 * elements and only gets/sets the width of the element. Generally used for table based layouts.
8954 Roo.SplitBar.BasicLayoutAdapter = function(){
8957 Roo.SplitBar.BasicLayoutAdapter.prototype = {
8958 // do nothing for now
8963 * Called before drag operations to get the current size of the resizing element.
8964 * @param {Roo.SplitBar} s The SplitBar using this adapter
8966 getElementSize : function(s){
8967 if(s.orientation == Roo.SplitBar.HORIZONTAL){
8968 return s.resizingEl.getWidth();
8970 return s.resizingEl.getHeight();
8975 * Called after drag operations to set the size of the resizing element.
8976 * @param {Roo.SplitBar} s The SplitBar using this adapter
8977 * @param {Number} newSize The new size to set
8978 * @param {Function} onComplete A function to be invoked when resizing is complete
8980 setElementSize : function(s, newSize, onComplete){
8981 if(s.orientation == Roo.SplitBar.HORIZONTAL){
8983 s.resizingEl.setWidth(newSize);
8985 onComplete(s, newSize);
8988 s.resizingEl.setWidth(newSize, true, .1, onComplete, 'easeOut');
8993 s.resizingEl.setHeight(newSize);
8995 onComplete(s, newSize);
8998 s.resizingEl.setHeight(newSize, true, .1, onComplete, 'easeOut');
9005 *@class Roo.SplitBar.AbsoluteLayoutAdapter
9006 * @extends Roo.SplitBar.BasicLayoutAdapter
9007 * Adapter that moves the splitter element to align with the resized sizing element.
9008 * Used with an absolute positioned SplitBar.
9009 * @param {String/HTMLElement/Roo.Element} container The container that wraps around the absolute positioned content. If it's
9010 * document.body, make sure you assign an id to the body element.
9012 Roo.SplitBar.AbsoluteLayoutAdapter = function(container){
9013 this.basic = new Roo.SplitBar.BasicLayoutAdapter();
9014 this.container = Roo.get(container);
9017 Roo.SplitBar.AbsoluteLayoutAdapter.prototype = {
9022 getElementSize : function(s){
9023 return this.basic.getElementSize(s);
9026 setElementSize : function(s, newSize, onComplete){
9027 this.basic.setElementSize(s, newSize, this.moveSplitter.createDelegate(this, [s]));
9030 moveSplitter : function(s){
9031 var yes = Roo.SplitBar;
9032 switch(s.placement){
9034 s.el.setX(s.resizingEl.getRight());
9037 s.el.setStyle("right", (this.container.getWidth() - s.resizingEl.getLeft()) + "px");
9040 s.el.setY(s.resizingEl.getBottom());
9043 s.el.setY(s.resizingEl.getTop() - s.el.getHeight());
9050 * Orientation constant - Create a vertical SplitBar
9054 Roo.SplitBar.VERTICAL = 1;
9057 * Orientation constant - Create a horizontal SplitBar
9061 Roo.SplitBar.HORIZONTAL = 2;
9064 * Placement constant - The resizing element is to the left of the splitter element
9068 Roo.SplitBar.LEFT = 1;
9071 * Placement constant - The resizing element is to the right of the splitter element
9075 Roo.SplitBar.RIGHT = 2;
9078 * Placement constant - The resizing element is positioned above the splitter element
9082 Roo.SplitBar.TOP = 3;
9085 * Placement constant - The resizing element is positioned under splitter element
9089 Roo.SplitBar.BOTTOM = 4;
9092 * Ext JS Library 1.1.1
9093 * Copyright(c) 2006-2007, Ext JS, LLC.
9095 * Originally Released Under LGPL - original licence link has changed is not relivant.
9098 * <script type="text/javascript">
9103 * @extends Roo.util.Observable
9104 * Create a "View" for an element based on a data model or UpdateManager and the supplied DomHelper template.
9105 * This class also supports single and multi selection modes. <br>
9106 * Create a data model bound view:
9108 var store = new Roo.data.Store(...);
9110 var view = new Roo.View({
9112 tpl : '<div id="{0}">{2} - {1}</div>', // auto create template
9115 selectedClass: "ydataview-selected",
9119 // listen for node click?
9120 view.on("click", function(vw, index, node, e){
9121 alert('Node "' + node.id + '" at index: ' + index + " was clicked.");
9125 dataModel.load("foobar.xml");
9127 For an example of creating a JSON/UpdateManager view, see {@link Roo.JsonView}.
9129 * <b>Note: The root of your template must be a single node. Table/row implementations may work but are not supported due to
9130 * IE"s limited insertion support with tables and Opera"s faulty event bubbling.</b>
9132 * Note: old style constructor is still suported (container, template, config)
9136 * @param {Object} config The config object
9139 Roo.View = function(config, depreciated_tpl, depreciated_config){
9141 if (typeof(depreciated_tpl) == 'undefined') {
9142 // new way.. - universal constructor.
9143 Roo.apply(this, config);
9144 this.el = Roo.get(this.el);
9147 this.el = Roo.get(config);
9148 this.tpl = depreciated_tpl;
9149 Roo.apply(this, depreciated_config);
9153 if(typeof(this.tpl) == "string"){
9154 this.tpl = new Roo.Template(this.tpl);
9156 // support xtype ctors..
9157 this.tpl = new Roo.factory(this.tpl, Roo);
9168 * @event beforeclick
9169 * Fires before a click is processed. Returns false to cancel the default action.
9170 * @param {Roo.View} this
9171 * @param {Number} index The index of the target node
9172 * @param {HTMLElement} node The target node
9173 * @param {Roo.EventObject} e The raw event object
9175 "beforeclick" : true,
9178 * Fires when a template node is clicked.
9179 * @param {Roo.View} this
9180 * @param {Number} index The index of the target node
9181 * @param {HTMLElement} node The target node
9182 * @param {Roo.EventObject} e The raw event object
9187 * Fires when a template node is double clicked.
9188 * @param {Roo.View} this
9189 * @param {Number} index The index of the target node
9190 * @param {HTMLElement} node The target node
9191 * @param {Roo.EventObject} e The raw event object
9195 * @event contextmenu
9196 * Fires when a template node is right clicked.
9197 * @param {Roo.View} this
9198 * @param {Number} index The index of the target node
9199 * @param {HTMLElement} node The target node
9200 * @param {Roo.EventObject} e The raw event object
9202 "contextmenu" : true,
9204 * @event selectionchange
9205 * Fires when the selected nodes change.
9206 * @param {Roo.View} this
9207 * @param {Array} selections Array of the selected nodes
9209 "selectionchange" : true,
9212 * @event beforeselect
9213 * Fires before a selection is made. If any handlers return false, the selection is cancelled.
9214 * @param {Roo.View} this
9215 * @param {HTMLElement} node The node to be selected
9216 * @param {Array} selections Array of currently selected nodes
9218 "beforeselect" : true,
9220 * @event preparedata
9221 * Fires on every row to render, to allow you to change the data.
9222 * @param {Roo.View} this
9223 * @param {Object} data to be rendered (change this)
9225 "preparedata" : true
9229 "click": this.onClick,
9230 "dblclick": this.onDblClick,
9231 "contextmenu": this.onContextMenu,
9235 this.selections = [];
9237 this.cmp = new Roo.CompositeElementLite([]);
9239 this.store = Roo.factory(this.store, Roo.data);
9240 this.setStore(this.store, true);
9242 Roo.View.superclass.constructor.call(this);
9245 Roo.extend(Roo.View, Roo.util.Observable, {
9248 * @cfg {Roo.data.Store} store Data store to load data from.
9253 * @cfg {String|Roo.Element} el The container element.
9258 * @cfg {String|Roo.Template} tpl The template used by this View
9263 * @cfg {String} selectedClass The css class to add to selected nodes
9265 selectedClass : "x-view-selected",
9267 * @cfg {String} emptyText The empty text to show when nothing is loaded.
9271 * @cfg {Boolean} multiSelect Allow multiple selection
9273 multiSelect : false,
9275 * @cfg {Boolean} singleSelect Allow single selection
9277 singleSelect: false,
9280 * @cfg {Boolean} toggleSelect - selecting
9282 toggleSelect : false,
9285 * Returns the element this view is bound to.
9286 * @return {Roo.Element}
9293 * Refreshes the view.
9295 refresh : function(){
9297 this.clearSelections();
9300 var records = this.store.getRange();
9301 if(records.length < 1){
9302 this.el.update(this.emptyText);
9305 for(var i = 0, len = records.length; i < len; i++){
9306 var data = this.prepareData(records[i].data, i, records[i]);
9307 this.fireEvent("preparedata", this, data, i, records[i]);
9308 html[html.length] = t.apply(data);
9310 this.el.update(html.join(""));
9311 this.nodes = this.el.dom.childNodes;
9312 this.updateIndexes(0);
9316 * Function to override to reformat the data that is sent to
9317 * the template for each node.
9318 * @param {Array/Object} data The raw data (array of colData for a data model bound view or
9319 * a JSON object for an UpdateManager bound view).
9321 prepareData : function(data){
9325 onUpdate : function(ds, record){
9326 this.clearSelections();
9327 var index = this.store.indexOf(record);
9328 var n = this.nodes[index];
9329 this.tpl.insertBefore(n, this.prepareData(record.data));
9330 n.parentNode.removeChild(n);
9331 this.updateIndexes(index, index);
9334 onAdd : function(ds, records, index){
9335 this.clearSelections();
9336 if(this.nodes.length == 0){
9340 var n = this.nodes[index];
9341 for(var i = 0, len = records.length; i < len; i++){
9342 var d = this.prepareData(records[i].data);
9344 this.tpl.insertBefore(n, d);
9346 this.tpl.append(this.el, d);
9349 this.updateIndexes(index);
9352 onRemove : function(ds, record, index){
9353 this.clearSelections();
9354 this.el.dom.removeChild(this.nodes[index]);
9355 this.updateIndexes(index);
9359 * Refresh an individual node.
9360 * @param {Number} index
9362 refreshNode : function(index){
9363 this.onUpdate(this.store, this.store.getAt(index));
9366 updateIndexes : function(startIndex, endIndex){
9367 var ns = this.nodes;
9368 startIndex = startIndex || 0;
9369 endIndex = endIndex || ns.length - 1;
9370 for(var i = startIndex; i <= endIndex; i++){
9371 ns[i].nodeIndex = i;
9376 * Changes the data store this view uses and refresh the view.
9377 * @param {Store} store
9379 setStore : function(store, initial){
9380 if(!initial && this.store){
9381 this.store.un("datachanged", this.refresh);
9382 this.store.un("add", this.onAdd);
9383 this.store.un("remove", this.onRemove);
9384 this.store.un("update", this.onUpdate);
9385 this.store.un("clear", this.refresh);
9389 store.on("datachanged", this.refresh, this);
9390 store.on("add", this.onAdd, this);
9391 store.on("remove", this.onRemove, this);
9392 store.on("update", this.onUpdate, this);
9393 store.on("clear", this.refresh, this);
9402 * Returns the template node the passed child belongs to or null if it doesn't belong to one.
9403 * @param {HTMLElement} node
9404 * @return {HTMLElement} The template node
9406 findItemFromChild : function(node){
9407 var el = this.el.dom;
9408 if(!node || node.parentNode == el){
9411 var p = node.parentNode;
9412 while(p && p != el){
9413 if(p.parentNode == el){
9422 onClick : function(e){
9423 var item = this.findItemFromChild(e.getTarget());
9425 var index = this.indexOf(item);
9426 if(this.onItemClick(item, index, e) !== false){
9427 this.fireEvent("click", this, index, item, e);
9430 this.clearSelections();
9435 onContextMenu : function(e){
9436 var item = this.findItemFromChild(e.getTarget());
9438 this.fireEvent("contextmenu", this, this.indexOf(item), item, e);
9443 onDblClick : function(e){
9444 var item = this.findItemFromChild(e.getTarget());
9446 this.fireEvent("dblclick", this, this.indexOf(item), item, e);
9450 onItemClick : function(item, index, e)
9452 if(this.fireEvent("beforeclick", this, index, item, e) === false){
9455 if (this.toggleSelect) {
9456 var m = this.isSelected(item) ? 'unselect' : 'select';
9459 _t[m](item, true, false);
9462 if(this.multiSelect || this.singleSelect){
9463 if(this.multiSelect && e.shiftKey && this.lastSelection){
9464 this.select(this.getNodes(this.indexOf(this.lastSelection), index), false);
9466 this.select(item, this.multiSelect && e.ctrlKey);
9467 this.lastSelection = item;
9475 * Get the number of selected nodes.
9478 getSelectionCount : function(){
9479 return this.selections.length;
9483 * Get the currently selected nodes.
9484 * @return {Array} An array of HTMLElements
9486 getSelectedNodes : function(){
9487 return this.selections;
9491 * Get the indexes of the selected nodes.
9494 getSelectedIndexes : function(){
9495 var indexes = [], s = this.selections;
9496 for(var i = 0, len = s.length; i < len; i++){
9497 indexes.push(s[i].nodeIndex);
9503 * Clear all selections
9504 * @param {Boolean} suppressEvent (optional) true to skip firing of the selectionchange event
9506 clearSelections : function(suppressEvent){
9507 if(this.nodes && (this.multiSelect || this.singleSelect) && this.selections.length > 0){
9508 this.cmp.elements = this.selections;
9509 this.cmp.removeClass(this.selectedClass);
9510 this.selections = [];
9512 this.fireEvent("selectionchange", this, this.selections);
9518 * Returns true if the passed node is selected
9519 * @param {HTMLElement/Number} node The node or node index
9522 isSelected : function(node){
9523 var s = this.selections;
9527 node = this.getNode(node);
9528 return s.indexOf(node) !== -1;
9533 * @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
9534 * @param {Boolean} keepExisting (optional) true to keep existing selections
9535 * @param {Boolean} suppressEvent (optional) true to skip firing of the selectionchange vent
9537 select : function(nodeInfo, keepExisting, suppressEvent){
9538 if(nodeInfo instanceof Array){
9540 this.clearSelections(true);
9542 for(var i = 0, len = nodeInfo.length; i < len; i++){
9543 this.select(nodeInfo[i], true, true);
9547 var node = this.getNode(nodeInfo);
9548 if(!node || this.isSelected(node)){
9549 return; // already selected.
9552 this.clearSelections(true);
9554 if(this.fireEvent("beforeselect", this, node, this.selections) !== false){
9555 Roo.fly(node).addClass(this.selectedClass);
9556 this.selections.push(node);
9558 this.fireEvent("selectionchange", this, this.selections);
9566 * @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
9567 * @param {Boolean} keepExisting (optional) true IGNORED (for campatibility with select)
9568 * @param {Boolean} suppressEvent (optional) true to skip firing of the selectionchange vent
9570 unselect : function(nodeInfo, keepExisting, suppressEvent)
9572 if(nodeInfo instanceof Array){
9573 Roo.each(this.selections, function(s) {
9574 this.unselect(s, nodeInfo);
9578 var node = this.getNode(nodeInfo);
9579 if(!node || !this.isSelected(node)){
9580 Roo.log("not selected");
9581 return; // not selected.
9585 Roo.each(this.selections, function(s) {
9587 Roo.fly(node).removeClass(this.selectedClass);
9594 this.selections= ns;
9595 this.fireEvent("selectionchange", this, this.selections);
9599 * Gets a template node.
9600 * @param {HTMLElement/String/Number} nodeInfo An HTMLElement template node, index of a template node or the id of a template node
9601 * @return {HTMLElement} The node or null if it wasn't found
9603 getNode : function(nodeInfo){
9604 if(typeof nodeInfo == "string"){
9605 return document.getElementById(nodeInfo);
9606 }else if(typeof nodeInfo == "number"){
9607 return this.nodes[nodeInfo];
9613 * Gets a range template nodes.
9614 * @param {Number} startIndex
9615 * @param {Number} endIndex
9616 * @return {Array} An array of nodes
9618 getNodes : function(start, end){
9619 var ns = this.nodes;
9621 end = typeof end == "undefined" ? ns.length - 1 : end;
9624 for(var i = start; i <= end; i++){
9628 for(var i = start; i >= end; i--){
9636 * Finds the index of the passed node
9637 * @param {HTMLElement/String/Number} nodeInfo An HTMLElement template node, index of a template node or the id of a template node
9638 * @return {Number} The index of the node or -1
9640 indexOf : function(node){
9641 node = this.getNode(node);
9642 if(typeof node.nodeIndex == "number"){
9643 return node.nodeIndex;
9645 var ns = this.nodes;
9646 for(var i = 0, len = ns.length; i < len; i++){