# GeoExt

### Navigation

- GeoExt »
- API Reference »
- Widgets »
- `GeoExt.MapPanel`

# `GeoExt.MapPanel`

Extends
  - Ext.Panel
xtype
  `gx_mappanel`

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.

`center`
  `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.

`extent`
  `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`
  `GeoExt.data.LayerStore or GeoExt.data.GroupingStore or Array(OpenLayers.Layer)` A store holding records. The layers provided here will be added to this MapPanel’s map when it is rendered.

`map`
  `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.

`prettyStateKeys`
  `Boolean` Set this to true if you want pretty strings in the MapPanel’s state keys. More specifically, layer.name instead of layer.id 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.

`zoom`
  `Number` An initial zoom level for the map.

## Public Properties

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

`MapPanel.``layers`
  `GeoExt.data.LayerStore` A store containing `GeoExt.data.LayerRecord` objects.

`MapPanel.``map`
  `OpenLayers.Map` or `Object` A map or map configuration.

### Navigation

- index
- modules |
- next |
- previous |
- GeoExt »
- API Reference »
- Widgets »
- `GeoExt.MapPanel`