source: Dev/trunk/src/client/dojox/mobile/PageIndicator.js @ 532

define([
        "dojo/_base/connect",
        "dojo/_base/declare",
        "dojo/dom",
        "dojo/dom-class",
        "dojo/dom-construct",
        "dijit/registry",
        "dijit/_Contained",
        "dijit/_WidgetBase"
], function(connect, declare, dom, domClass, domConstruct, registry, Contained, WidgetBase){

        // module:
        //              dojox/mobile/PageIndicator

        return declare("dojox.mobile.PageIndicator", [WidgetBase, Contained],{
                // summary:
                //              A current page indicator.
                // description:
                //              PageIndicator displays a series of gray and white dots to
                //              indicate which page is currently being viewed. It can typically
                //              be used with dojox/mobile/SwapView. It is also internally used
                //              in dojox/mobile/Carousel.

                // refId: String
                //              An ID of a DOM node to be searched. Siblings of the reference
                //              node will be searched for views. If not specified, this.domNode
                //              will be the reference node.
                refId: "",

                // baseClass: String
                //              The name of the CSS class of this widget.
                baseClass: "mblPageIndicator",

                buildRendering: function(){
                        this.inherited(arguments);
                        this._tblNode = domConstruct.create("table", {className:"mblPageIndicatorContainer"}, this.domNode);
                        this._tblNode.insertRow(-1);
                        this.connect(this.domNode, "onclick", "_onClick");
                        this.subscribe("/dojox/mobile/viewChanged", function(view){
                                this.reset();
                        });
                },

                startup: function(){
                        var _this = this;
                        _this.defer(function(){ // to wait until views' visibility is determined
                                _this.reset();
                        });
                },

                reset: function(){
                        // summary:
                        //              Updates the indicator.
                        var r = this._tblNode.rows[0];
                        var i, c, a = [], dot;
                        var refNode = (this.refId && dom.byId(this.refId)) || this.domNode;
                        var children = refNode.parentNode.childNodes;
                        for(i = 0; i < children.length; i++){
                                c = children[i];
                                if(this.isView(c)){
                                        a.push(c);
                                }
                        }
                        if(r.cells.length !== a.length){
                                domConstruct.empty(r);
                                for(i = 0; i < a.length; i++){
                                        c = a[i];
                                        dot = domConstruct.create("div", {className:"mblPageIndicatorDot"});
                                        r.insertCell(-1).appendChild(dot);
                                }
                        }
                        if(a.length === 0){ return; }
                        var currentView = registry.byNode(a[0]).getShowingView();
                        for(i = 0; i < r.cells.length; i++){
                                dot = r.cells[i].firstChild;
                                if(a[i] === currentView.domNode){
                                        domClass.add(dot, "mblPageIndicatorDotSelected");
                                }else{
                                        domClass.remove(dot, "mblPageIndicatorDotSelected");
                                }
                        }
                },

                isView: function(node){
                        // summary:
                        //              Returns true if the given node is a view.
                        return (node && node.nodeType === 1 && domClass.contains(node, "mblView")); // Boolean
                },

                _onClick: function(e){
                        // summary:
                        //              Internal handler for click events.
                        // tags:
                        //              private
                        if(this.onClick(e) === false){ return; } // user's click action
                        if(e.target !== this.domNode){ return; }
                        if(e.layerX < this._tblNode.offsetLeft){
                                connect.publish("/dojox/mobile/prevPage", [this]);
                        }else if(e.layerX > this._tblNode.offsetLeft + this._tblNode.offsetWidth){
                                connect.publish("/dojox/mobile/nextPage", [this]);
                        }
                },

                onClick: function(/*Event*/ /*===== e =====*/){
                        // summary:
                        //              User-defined function to handle clicks.
                        // tags:
                        //              callback
                }
        });
});