Table Of Contents

Previous topic


Next topic



class GeoExt.MapPanel(config)
Create a panel container for a map. The map contained by this panel will initially be zoomed to either the center and zoom level configured by the center and zoom configuration options, or the configured extent, or - if neither are provided - the extent returned by the map’s getExtent() method.

Example Use

Sample code to create a panel with a new map:

var mapPanel = new GeoExt.MapPanel({
    border: false,
    renderTo: "div-id",
    map: {
        maxExtent: new OpenLayers.Bounds(-90, -45, 90, 45)

Sample code to create a map panel with a bottom toolbar in a Window:

var win = new Ext.Window({
    title: "My Map",
    items: [{
        xtype: "gx_mappanel",
        bbar: new Ext.Toolbar()

Config Options

Configuration properties in addition to those listed for Ext.Panel.

OpenLayers.LonLat or Array(Number) A location for the initial map center. If an array is provided, the first two items should represent x & y coordinates.
OpenLayers.Bounds or Array(Number) An initial extent for the map (used if center and zoom are not provided. If an array, the first four items should be minx, miny, maxx, maxy.
layers or or Array(OpenLayers.Layer) A store holding records. The layers provided here will be added to this MapPanel’s map when it is rendered.
OpenLayers.Map or Object A configured map or a configuration object for the map constructor. A configured map will be available after construction through the map property.
Boolean Set this to true if you want pretty strings in the MapPanel’s state keys. More specifically, instead of will be used in the state keys if this option is set to true. But in that case you have to make sure you don’t have two layers with the same name. Defaults to false.
Number An initial zoom level for the map.

Public Properties

Public properties in addition to those listed for Ext.Panel.

MapPanel.layers A store containing objects.
OpenLayers.Map or Object A map or map configuration.