Upgrade to ExtJS 3.2.0 - Released 03/30/2010
[extjs.git] / docs / source / ListView.html
index 449be7a..dd60008 100644 (file)
-<html>\r
-<head>\r
-  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    \r
-  <title>The source code</title>\r
-    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />\r
-    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>\r
-</head>\r
-<body  onload="prettyPrint();">\r
-    <pre class="prettyprint lang-js"><div id="cls-Ext.list.ListView"></div>/**\r
- * @class Ext.list.ListView\r
- * @extends Ext.DataView\r
- * <p>Ext.list.ListView is a fast and light-weight implentation of a\r
- * {@link Ext.grid.GridPanel Grid} like view with the following characteristics:</p>\r
- * <div class="mdetail-params"><ul>\r
- * <li>resizable columns</li>\r
- * <li>selectable</li>\r
- * <li>column widths are initially proportioned by percentage based on the container\r
- * width and number of columns</li>\r
- * <li>uses templates to render the data in any required format</li>\r
- * <li>no horizontal scrolling</li>\r
- * <li>no editing</li>\r
- * </ul></div>\r
- * <p>Example usage:</p>\r
- * <pre><code>\r
-// consume JSON of this form:\r
-{\r
-   "images":[\r
-      {\r
-         "name":"dance_fever.jpg",\r
-         "size":2067,\r
-         "lastmod":1236974993000,\r
-         "url":"images\/thumbs\/dance_fever.jpg"\r
-      },\r
-      {\r
-         "name":"zack_sink.jpg",\r
-         "size":2303,\r
-         "lastmod":1236974993000,\r
-         "url":"images\/thumbs\/zack_sink.jpg"\r
-      }\r
-   ]\r
-} \r
-var store = new Ext.data.JsonStore({\r
-    url: 'get-images.php',\r
-    root: 'images',\r
-    fields: [\r
-        'name', 'url',\r
-        {name:'size', type: 'float'},\r
-        {name:'lastmod', type:'date', dateFormat:'timestamp'}\r
-    ]\r
-});\r
-store.load();\r
-\r
-var listView = new Ext.list.ListView({\r
-    store: store,\r
-    multiSelect: true,\r
-    emptyText: 'No images to display',\r
-    reserveScrollOffset: true,\r
-    columns: [{\r
-        header: 'File',\r
-        width: .5,\r
-        dataIndex: 'name'\r
-    },{\r
-        header: 'Last Modified',\r
-        width: .35, \r
-        dataIndex: 'lastmod',\r
-        tpl: '{lastmod:date("m-d h:i a")}'\r
-    },{\r
-        header: 'Size',\r
-        dataIndex: 'size',\r
-        tpl: '{size:fileSize}', // format using Ext.util.Format.fileSize()\r
-        align: 'right'\r
-    }]\r
-});\r
-\r
-// put it in a Panel so it looks pretty\r
-var panel = new Ext.Panel({\r
-    id:'images-view',\r
-    width:425,\r
-    height:250,\r
-    collapsible:true,\r
-    layout:'fit',\r
-    title:'Simple ListView <i>(0 items selected)</i>',\r
-    items: listView\r
-});\r
-panel.render(document.body);\r
-\r
-// little bit of feedback\r
-listView.on('selectionchange', function(view, nodes){\r
-    var l = nodes.length;\r
-    var s = l != 1 ? 's' : '';\r
-    panel.setTitle('Simple ListView <i>('+l+' item'+s+' selected)</i>');\r
-});\r
- * </code></pre>\r
- * @constructor\r
- * @param {Object} config\r
- * @xtype listview\r
- */\r
-Ext.list.ListView = Ext.extend(Ext.DataView, {\r
-    <div id="prop-Ext.list.ListView-disableHeaders"></div>/**\r
-     * Set this property to <tt>true</tt> to disable the header click handler disabling sort\r
-     * (defaults to <tt>false</tt>).\r
-     * @type Boolean\r
-     * @property disableHeaders\r
-     */\r
-    <div id="cfg-Ext.list.ListView-hideHeaders"></div>/**\r
-     * @cfg {Boolean} hideHeaders\r
-     * <tt>true</tt> to hide the {@link #internalTpl header row} (defaults to <tt>false</tt> so\r
-     * the {@link #internalTpl header row} will be shown).\r
-     */\r
-    <div id="cfg-Ext.list.ListView-itemSelector"></div>/**\r
-     * @cfg {String} itemSelector\r
-     * Defaults to <tt>'dl'</tt> to work with the preconfigured <b><tt>{@link Ext.DataView#tpl tpl}</tt></b>.\r
-     * This setting specifies the CSS selector (e.g. <tt>div.some-class</tt> or <tt>span:first-child</tt>)\r
-     * that will be used to determine what nodes the ListView will be working with.   \r
-     */\r
-    itemSelector: 'dl',\r
-    <div id="cfg-Ext.list.ListView-selectedClass"></div>/**\r
-     * @cfg {String} selectedClass The CSS class applied to a selected row (defaults to\r
-     * <tt>'x-list-selected'</tt>). An example overriding the default styling:\r
-    <pre><code>\r
-    .x-list-selected {background-color: yellow;}\r
-    </code></pre>\r
-     * @type String\r
-     */\r
-    selectedClass:'x-list-selected',\r
-    <div id="cfg-Ext.list.ListView-overClass"></div>/**\r
-     * @cfg {String} overClass The CSS class applied when over a row (defaults to\r
-     * <tt>'x-list-over'</tt>). An example overriding the default styling:\r
-    <pre><code>\r
-    .x-list-over {background-color: orange;}\r
-    </code></pre>\r
-     * @type String\r
-     */\r
-    overClass:'x-list-over',\r
-    <div id="cfg-Ext.list.ListView-reserveScrollOffset"></div>/**\r
-     * @cfg {Boolean} reserveScrollOffset\r
-     * By default will defer accounting for the configured <b><tt>{@link #scrollOffset}</tt></b>\r
-     * for 10 milliseconds.  Specify <tt>true</tt> to account for the configured\r
-     * <b><tt>{@link #scrollOffset}</tt></b> immediately.\r
-     */\r
-    <div id="cfg-Ext.list.ListView-scrollOffset"></div>/**\r
-     * @cfg {Number} scrollOffset The amount of space to reserve for the scrollbar (defaults to\r
-     * <tt>undefined</tt>). If an explicit value isn't specified, this will be automatically\r
-     * calculated.\r
-     */\r
-    scrollOffset : undefined,\r
-    <div id="cfg-Ext.list.ListView-columnResize"></div>/**\r
-     * @cfg {Boolean/Object} columnResize\r
-     * Specify <tt>true</tt> or specify a configuration object for {@link Ext.list.ListView.ColumnResizer}\r
-     * to enable the columns to be resizable (defaults to <tt>true</tt>).\r
-     */\r
-    columnResize: true,\r
-    <div id="cfg-Ext.list.ListView-columns"></div>/**\r
-     * @cfg {Array} columns An array of column configuration objects, for example:\r
-     * <pre><code>\r
-{\r
-    align: 'right',\r
-    dataIndex: 'size',\r
-    header: 'Size',\r
-    tpl: '{size:fileSize}',\r
-    width: .35\r
-}\r
-     * </code></pre> \r
-     * Acceptable properties for each column configuration object are:\r
-     * <div class="mdetail-params"><ul>\r
-     * <li><b><tt>align</tt></b> : String<div class="sub-desc">Set the CSS text-align property\r
-     * of the column. Defaults to <tt>'left'</tt>.</div></li>\r
-     * <li><b><tt>dataIndex</tt></b> : String<div class="sub-desc">See {@link Ext.grid.Column}.\r
-     * {@link Ext.grid.Column#dataIndex dataIndex} for details.</div></li>\r
-     * <li><b><tt>header</tt></b> : String<div class="sub-desc">See {@link Ext.grid.Column}.\r
-     * {@link Ext.grid.Column#header header} for details.</div></li>\r
-     * <li><b><tt>tpl</tt></b> : String<div class="sub-desc">Specify a string to pass as the\r
-     * configuration string for {@link Ext.XTemplate}.  By default an {@link Ext.XTemplate}\r
-     * will be implicitly created using the <tt>dataIndex</tt>.</div></li>\r
-     * <li><b><tt>width</tt></b> : Number<div class="sub-desc">Percentage of the container width\r
-     * this column should be allocated.  Columns that have no width specified will be\r
-     * allocated with an equal percentage to fill 100% of the container width.  To easily take\r
-     * advantage of the full container width, leave the width of at least one column undefined.\r
-     * Note that if you do not want to take up the full width of the container, the width of\r
-     * every column needs to be explicitly defined.</div></li>\r
-     * </ul></div>\r
-     */\r
-    <div id="cfg-Ext.list.ListView-columnSort"></div>/**\r
-     * @cfg {Boolean/Object} columnSort\r
-     * Specify <tt>true</tt> or specify a configuration object for {@link Ext.list.ListView.Sorter}\r
-     * to enable the columns to be sortable (defaults to <tt>true</tt>).\r
-     */\r
-    columnSort: true,\r
-    <div id="cfg-Ext.list.ListView-internalTpl"></div>/**\r
-     * @cfg {String/Array} internalTpl\r
-     * The template to be used for the header row.  See {@link #tpl} for more details.\r
-     */\r
-\r
-    /*\r
-     * IE has issues when setting percentage based widths to 100%. Default to 99.\r
-     */\r
-    maxWidth: Ext.isIE ? 99 : 100,\r
-    \r
-    initComponent : function(){\r
-        if(this.columnResize){\r
-            this.colResizer = new Ext.list.ColumnResizer(this.colResizer);\r
-            this.colResizer.init(this);\r
-        }\r
-        if(this.columnSort){\r
-            this.colSorter = new Ext.list.Sorter(this.columnSort);\r
-            this.colSorter.init(this);\r
-        }\r
-        if(!this.internalTpl){\r
-            this.internalTpl = new Ext.XTemplate(\r
-                '<div class="x-list-header"><div class="x-list-header-inner">',\r
-                    '<tpl for="columns">',\r
-                    '<div style="width:{[values.width*100]}%;text-align:{align};"><em unselectable="on" id="',this.id, '-xlhd-{#}">',\r
-                        '{header}',\r
-                    '</em></div>',\r
-                    '</tpl>',\r
-                    '<div class="x-clear"></div>',\r
-                '</div></div>',\r
-                '<div class="x-list-body"><div class="x-list-body-inner">',\r
-                '</div></div>'\r
-            );\r
-        }\r
-        if(!this.tpl){\r
-            this.tpl = new Ext.XTemplate(\r
-                '<tpl for="rows">',\r
-                    '<dl>',\r
-                        '<tpl for="parent.columns">',\r
-                        '<dt style="width:{[values.width*100]}%;text-align:{align};">',\r
-                        '<em unselectable="on"<tpl if="cls"> class="{cls}</tpl>">',\r
-                            '{[values.tpl.apply(parent)]}',\r
-                        '</em></dt>',\r
-                        '</tpl>',\r
-                        '<div class="x-clear"></div>',\r
-                    '</dl>',\r
-                '</tpl>'\r
-            );\r
-        };\r
-        \r
-        var cs = this.columns, \r
-            allocatedWidth = 0, \r
-            colsWithWidth = 0, \r
-            len = cs.length, \r
-            columns = [];\r
-            \r
-        for(var i = 0; i < len; i++){\r
-            var c = cs[i];\r
-            if(!c.isColumn) {\r
-                c.xtype = c.xtype ? (/^lv/.test(c.xtype) ? c.xtype : 'lv' + c.xtype) : 'lvcolumn';\r
-                c = Ext.create(c);\r
-            }\r
-            if(c.width) {\r
-                allocatedWidth += c.width*100;\r
-                colsWithWidth++;\r
-            }\r
-            columns.push(c);\r
-        }\r
-        \r
-        cs = this.columns = columns;\r
-        \r
-        // auto calculate missing column widths\r
-        if(colsWithWidth < len){\r
-            var remaining = len - colsWithWidth;\r
-            if(allocatedWidth < this.maxWidth){\r
-                var perCol = ((this.maxWidth-allocatedWidth) / remaining)/100;\r
-                for(var j = 0; j < len; j++){\r
-                    var c = cs[j];\r
-                    if(!c.width){\r
-                        c.width = perCol;\r
-                    }\r
-                }\r
-            }\r
-        }\r
-        Ext.list.ListView.superclass.initComponent.call(this);\r
-    },\r
-\r
-    onRender : function(){\r
-        this.autoEl = {\r
-            cls: 'x-list-wrap'  \r
-        };\r
-        Ext.list.ListView.superclass.onRender.apply(this, arguments);\r
-\r
-        this.internalTpl.overwrite(this.el, {columns: this.columns});\r
-        \r
-        this.innerBody = Ext.get(this.el.dom.childNodes[1].firstChild);\r
-        this.innerHd = Ext.get(this.el.dom.firstChild.firstChild);\r
-\r
-        if(this.hideHeaders){\r
-            this.el.dom.firstChild.style.display = 'none';\r
-        }\r
-    },\r
-\r
-    getTemplateTarget : function(){\r
-        return this.innerBody;\r
-    },\r
-\r
-    <div id="method-Ext.list.ListView-collectData"></div>/**\r
-     * <p>Function which can be overridden which returns the data object passed to this\r
-     * view's {@link #tpl template} to render the whole ListView. The returned object \r
-     * shall contain the following properties:</p>\r
-     * <div class="mdetail-params"><ul>\r
-     * <li><b>columns</b> : String<div class="sub-desc">See <tt>{@link #columns}</tt></div></li>\r
-     * <li><b>rows</b> : String<div class="sub-desc">See\r
-     * <tt>{@link Ext.DataView}.{@link Ext.DataView#collectData collectData}</div></li>\r
-     * </ul></div>\r
-     * @param {Array} records An Array of {@link Ext.data.Record}s to be rendered into the DataView.\r
-     * @param {Number} startIndex the index number of the Record being prepared for rendering.\r
-     * @return {Object} A data object containing properties to be processed by a repeating\r
-     * XTemplate as described above.\r
-     */\r
-    collectData : function(){\r
-        var rs = Ext.list.ListView.superclass.collectData.apply(this, arguments);\r
-        return {\r
-            columns: this.columns,\r
-            rows: rs\r
-        }\r
-    },\r
-\r
-    verifyInternalSize : function(){\r
-        if(this.lastSize){\r
-            this.onResize(this.lastSize.width, this.lastSize.height);\r
-        }\r
-    },\r
-\r
-    // private\r
-    onResize : function(w, h){\r
-        var bd = this.innerBody.dom;\r
-        var hd = this.innerHd.dom\r
-        if(!bd){\r
-            return;\r
-        }\r
-        var bdp = bd.parentNode;\r
-        if(Ext.isNumber(w)){\r
-            var sw = w - Ext.num(this.scrollOffset, Ext.getScrollBarWidth());\r
-            if(this.reserveScrollOffset || ((bdp.offsetWidth - bdp.clientWidth) > 10)){\r
-                bd.style.width = sw + 'px';\r
-                hd.style.width = sw + 'px';\r
-            }else{\r
-                bd.style.width = w + 'px';\r
-                hd.style.width = w + 'px';\r
-                setTimeout(function(){\r
-                    if((bdp.offsetWidth - bdp.clientWidth) > 10){\r
-                        bd.style.width = sw + 'px';\r
-                        hd.style.width = sw + 'px';\r
-                    }\r
-                }, 10);\r
-            }\r
-        }\r
-        if(Ext.isNumber(h)){\r
-            bdp.style.height = (h - hd.parentNode.offsetHeight) + 'px';\r
-        }\r
-    },\r
-\r
-    updateIndexes : function(){\r
-        Ext.list.ListView.superclass.updateIndexes.apply(this, arguments);\r
-        this.verifyInternalSize();\r
-    },\r
-\r
-    findHeaderIndex : function(hd){\r
-        hd = hd.dom || hd;\r
-        var pn = hd.parentNode, cs = pn.parentNode.childNodes;\r
-        for(var i = 0, c; c = cs[i]; i++){\r
-            if(c == pn){\r
-                return i;\r
-            }\r
-        }\r
-        return -1;\r
-    },\r
-\r
-    setHdWidths : function(){\r
-        var els = this.innerHd.dom.getElementsByTagName('div');\r
-        for(var i = 0, cs = this.columns, len = cs.length; i < len; i++){\r
-            els[i].style.width = (cs[i].width*100) + '%';\r
-        }\r
-    }\r
-});\r
-\r
-Ext.reg('listview', Ext.list.ListView);\r
-\r
-// Backwards compatibility alias\r
-Ext.ListView = Ext.list.ListView;</pre>    \r
-</body>\r
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    
+  <title>The source code</title>
+    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
+    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
+</head>
+<body  onload="prettyPrint();">
+    <pre class="prettyprint lang-js">/*!
+ * Ext JS Library 3.2.0
+ * Copyright(c) 2006-2010 Ext JS, Inc.
+ * licensing@extjs.com
+ * http://www.extjs.com/license
+ */
+<div id="cls-Ext.list.ListView"></div>/**
+ * @class Ext.list.ListView
+ * @extends Ext.DataView
+ * <p>Ext.list.ListView is a fast and light-weight implentation of a
+ * {@link Ext.grid.GridPanel Grid} like view with the following characteristics:</p>
+ * <div class="mdetail-params"><ul>
+ * <li>resizable columns</li>
+ * <li>selectable</li>
+ * <li>column widths are initially proportioned by percentage based on the container
+ * width and number of columns</li>
+ * <li>uses templates to render the data in any required format</li>
+ * <li>no horizontal scrolling</li>
+ * <li>no editing</li>
+ * </ul></div>
+ * <p>Example usage:</p>
+ * <pre><code>
+// consume JSON of this form:
+{
+   "images":[
+      {
+         "name":"dance_fever.jpg",
+         "size":2067,
+         "lastmod":1236974993000,
+         "url":"images\/thumbs\/dance_fever.jpg"
+      },
+      {
+         "name":"zack_sink.jpg",
+         "size":2303,
+         "lastmod":1236974993000,
+         "url":"images\/thumbs\/zack_sink.jpg"
+      }
+   ]
+}
+var store = new Ext.data.JsonStore({
+    url: 'get-images.php',
+    root: 'images',
+    fields: [
+        'name', 'url',
+        {name:'size', type: 'float'},
+        {name:'lastmod', type:'date', dateFormat:'timestamp'}
+    ]
+});
+store.load();
+
+var listView = new Ext.list.ListView({
+    store: store,
+    multiSelect: true,
+    emptyText: 'No images to display',
+    reserveScrollOffset: true,
+    columns: [{
+        header: 'File',
+        width: .5,
+        dataIndex: 'name'
+    },{
+        header: 'Last Modified',
+        width: .35,
+        dataIndex: 'lastmod',
+        tpl: '{lastmod:date("m-d h:i a")}'
+    },{
+        header: 'Size',
+        dataIndex: 'size',
+        tpl: '{size:fileSize}', // format using Ext.util.Format.fileSize()
+        align: 'right'
+    }]
+});
+
+// put it in a Panel so it looks pretty
+var panel = new Ext.Panel({
+    id:'images-view',
+    width:425,
+    height:250,
+    collapsible:true,
+    layout:'fit',
+    title:'Simple ListView <i>(0 items selected)</i>',
+    items: listView
+});
+panel.render(document.body);
+
+// little bit of feedback
+listView.on('selectionchange', function(view, nodes){
+    var l = nodes.length;
+    var s = l != 1 ? 's' : '';
+    panel.setTitle('Simple ListView <i>('+l+' item'+s+' selected)</i>');
+});
+ * </code></pre>
+ * @constructor
+ * @param {Object} config
+ * @xtype listview
+ */
+Ext.list.ListView = Ext.extend(Ext.DataView, {
+    <div id="prop-Ext.list.ListView-disableHeaders"></div>/**
+     * Set this property to <tt>true</tt> to disable the header click handler disabling sort
+     * (defaults to <tt>false</tt>).
+     * @type Boolean
+     * @property disableHeaders
+     */
+    <div id="cfg-Ext.list.ListView-hideHeaders"></div>/**
+     * @cfg {Boolean} hideHeaders
+     * <tt>true</tt> to hide the {@link #internalTpl header row} (defaults to <tt>false</tt> so
+     * the {@link #internalTpl header row} will be shown).
+     */
+    <div id="cfg-Ext.list.ListView-itemSelector"></div>/**
+     * @cfg {String} itemSelector
+     * Defaults to <tt>'dl'</tt> to work with the preconfigured <b><tt>{@link Ext.DataView#tpl tpl}</tt></b>.
+     * This setting specifies the CSS selector (e.g. <tt>div.some-class</tt> or <tt>span:first-child</tt>)
+     * that will be used to determine what nodes the ListView will be working with.
+     */
+    itemSelector: 'dl',
+    <div id="cfg-Ext.list.ListView-selectedClass"></div>/**
+     * @cfg {String} selectedClass The CSS class applied to a selected row (defaults to
+     * <tt>'x-list-selected'</tt>). An example overriding the default styling:
+    <pre><code>
+    .x-list-selected {background-color: yellow;}
+    </code></pre>
+     * @type String
+     */
+    selectedClass:'x-list-selected',
+    <div id="cfg-Ext.list.ListView-overClass"></div>/**
+     * @cfg {String} overClass The CSS class applied when over a row (defaults to
+     * <tt>'x-list-over'</tt>). An example overriding the default styling:
+    <pre><code>
+    .x-list-over {background-color: orange;}
+    </code></pre>
+     * @type String
+     */
+    overClass:'x-list-over',
+    <div id="cfg-Ext.list.ListView-reserveScrollOffset"></div>/**
+     * @cfg {Boolean} reserveScrollOffset
+     * By default will defer accounting for the configured <b><tt>{@link #scrollOffset}</tt></b>
+     * for 10 milliseconds.  Specify <tt>true</tt> to account for the configured
+     * <b><tt>{@link #scrollOffset}</tt></b> immediately.
+     */
+    <div id="cfg-Ext.list.ListView-scrollOffset"></div>/**
+     * @cfg {Number} scrollOffset The amount of space to reserve for the scrollbar (defaults to
+     * <tt>undefined</tt>). If an explicit value isn't specified, this will be automatically
+     * calculated.
+     */
+    scrollOffset : undefined,
+    <div id="cfg-Ext.list.ListView-columnResize"></div>/**
+     * @cfg {Boolean/Object} columnResize
+     * Specify <tt>true</tt> or specify a configuration object for {@link Ext.list.ListView.ColumnResizer}
+     * to enable the columns to be resizable (defaults to <tt>true</tt>).
+     */
+    columnResize: true,
+    <div id="cfg-Ext.list.ListView-columns"></div>/**
+     * @cfg {Array} columns An array of column configuration objects, for example:
+     * <pre><code>
+{
+    align: 'right',
+    dataIndex: 'size',
+    header: 'Size',
+    tpl: '{size:fileSize}',
+    width: .35
+}
+     * </code></pre>
+     * Acceptable properties for each column configuration object are:
+     * <div class="mdetail-params"><ul>
+     * <li><b><tt>align</tt></b> : String<div class="sub-desc">Set the CSS text-align property
+     * of the column. Defaults to <tt>'left'</tt>.</div></li>
+     * <li><b><tt>dataIndex</tt></b> : String<div class="sub-desc">See {@link Ext.grid.Column}.
+     * {@link Ext.grid.Column#dataIndex dataIndex} for details.</div></li>
+     * <li><b><tt>header</tt></b> : String<div class="sub-desc">See {@link Ext.grid.Column}.
+     * {@link Ext.grid.Column#header header} for details.</div></li>
+     * <li><b><tt>tpl</tt></b> : String<div class="sub-desc">Specify a string to pass as the
+     * configuration string for {@link Ext.XTemplate}.  By default an {@link Ext.XTemplate}
+     * will be implicitly created using the <tt>dataIndex</tt>.</div></li>
+     * <li><b><tt>width</tt></b> : Number<div class="sub-desc">Percentage of the container width
+     * this column should be allocated.  Columns that have no width specified will be
+     * allocated with an equal percentage to fill 100% of the container width.  To easily take
+     * advantage of the full container width, leave the width of at least one column undefined.
+     * Note that if you do not want to take up the full width of the container, the width of
+     * every column needs to be explicitly defined.</div></li>
+     * </ul></div>
+     */
+    <div id="cfg-Ext.list.ListView-columnSort"></div>/**
+     * @cfg {Boolean/Object} columnSort
+     * Specify <tt>true</tt> or specify a configuration object for {@link Ext.list.ListView.Sorter}
+     * to enable the columns to be sortable (defaults to <tt>true</tt>).
+     */
+    columnSort: true,
+    <div id="cfg-Ext.list.ListView-internalTpl"></div>/**
+     * @cfg {String/Array} internalTpl
+     * The template to be used for the header row.  See {@link #tpl} for more details.
+     */
+
+    /*
+     * IE has issues when setting percentage based widths to 100%. Default to 99.
+     */
+    maxWidth: Ext.isIE ? 99 : 100,
+
+    initComponent : function(){
+        if(this.columnResize){
+            this.colResizer = new Ext.list.ColumnResizer(this.colResizer);
+            this.colResizer.init(this);
+        }
+        if(this.columnSort){
+            this.colSorter = new Ext.list.Sorter(this.columnSort);
+            this.colSorter.init(this);
+        }
+        if(!this.internalTpl){
+            this.internalTpl = new Ext.XTemplate(
+                '<div class="x-list-header"><div class="x-list-header-inner">',
+                    '<tpl for="columns">',
+                    '<div style="width:{[values.width*100]}%;text-align:{align};"><em unselectable="on" id="',this.id, '-xlhd-{#}">',
+                        '{header}',
+                    '</em></div>',
+                    '</tpl>',
+                    '<div class="x-clear"></div>',
+                '</div></div>',
+                '<div class="x-list-body"><div class="x-list-body-inner">',
+                '</div></div>'
+            );
+        }
+        if(!this.tpl){
+            this.tpl = new Ext.XTemplate(
+                '<tpl for="rows">',
+                    '<dl>',
+                        '<tpl for="parent.columns">',
+                        '<dt style="width:{[values.width*100]}%;text-align:{align};">',
+                        '<em unselectable="on"<tpl if="cls"> class="{cls}</tpl>">',
+                            '{[values.tpl.apply(parent)]}',
+                        '</em></dt>',
+                        '</tpl>',
+                        '<div class="x-clear"></div>',
+                    '</dl>',
+                '</tpl>'
+            );
+        };
+
+        var cs = this.columns,
+            allocatedWidth = 0,
+            colsWithWidth = 0,
+            len = cs.length,
+            columns = [];
+
+        for(var i = 0; i < len; i++){
+            var c = cs[i];
+            if(!c.isColumn) {
+                c.xtype = c.xtype ? (/^lv/.test(c.xtype) ? c.xtype : 'lv' + c.xtype) : 'lvcolumn';
+                c = Ext.create(c);
+            }
+            if(c.width) {
+                allocatedWidth += c.width*100;
+                colsWithWidth++;
+            }
+            columns.push(c);
+        }
+
+        cs = this.columns = columns;
+
+        // auto calculate missing column widths
+        if(colsWithWidth < len){
+            var remaining = len - colsWithWidth;
+            if(allocatedWidth < this.maxWidth){
+                var perCol = ((this.maxWidth-allocatedWidth) / remaining)/100;
+                for(var j = 0; j < len; j++){
+                    var c = cs[j];
+                    if(!c.width){
+                        c.width = perCol;
+                    }
+                }
+            }
+        }
+        Ext.list.ListView.superclass.initComponent.call(this);
+    },
+
+    onRender : function(){
+        this.autoEl = {
+            cls: 'x-list-wrap'
+        };
+        Ext.list.ListView.superclass.onRender.apply(this, arguments);
+
+        this.internalTpl.overwrite(this.el, {columns: this.columns});
+
+        this.innerBody = Ext.get(this.el.dom.childNodes[1].firstChild);
+        this.innerHd = Ext.get(this.el.dom.firstChild.firstChild);
+
+        if(this.hideHeaders){
+            this.el.dom.firstChild.style.display = 'none';
+        }
+    },
+
+    getTemplateTarget : function(){
+        return this.innerBody;
+    },
+
+    <div id="method-Ext.list.ListView-collectData"></div>/**
+     * <p>Function which can be overridden which returns the data object passed to this
+     * view's {@link #tpl template} to render the whole ListView. The returned object
+     * shall contain the following properties:</p>
+     * <div class="mdetail-params"><ul>
+     * <li><b>columns</b> : String<div class="sub-desc">See <tt>{@link #columns}</tt></div></li>
+     * <li><b>rows</b> : String<div class="sub-desc">See
+     * <tt>{@link Ext.DataView}.{@link Ext.DataView#collectData collectData}</div></li>
+     * </ul></div>
+     * @param {Array} records An Array of {@link Ext.data.Record}s to be rendered into the DataView.
+     * @param {Number} startIndex the index number of the Record being prepared for rendering.
+     * @return {Object} A data object containing properties to be processed by a repeating
+     * XTemplate as described above.
+     */
+    collectData : function(){
+        var rs = Ext.list.ListView.superclass.collectData.apply(this, arguments);
+        return {
+            columns: this.columns,
+            rows: rs
+        }
+    },
+
+    verifyInternalSize : function(){
+        if(this.lastSize){
+            this.onResize(this.lastSize.width, this.lastSize.height);
+        }
+    },
+
+    // private
+    onResize : function(w, h){
+        var bd = this.innerBody.dom;
+        var hd = this.innerHd.dom;
+        if(!bd){
+            return;
+        }
+        var bdp = bd.parentNode;
+        if(Ext.isNumber(w)){
+            var sw = w - Ext.num(this.scrollOffset, Ext.getScrollBarWidth());
+            if(this.reserveScrollOffset || ((bdp.offsetWidth - bdp.clientWidth) > 10)){
+                bd.style.width = sw + 'px';
+                hd.style.width = sw + 'px';
+            }else{
+                bd.style.width = w + 'px';
+                hd.style.width = w + 'px';
+                setTimeout(function(){
+                    if((bdp.offsetWidth - bdp.clientWidth) > 10){
+                        bd.style.width = sw + 'px';
+                        hd.style.width = sw + 'px';
+                    }
+                }, 10);
+            }
+        }
+        if(Ext.isNumber(h)){
+            bdp.style.height = (h - hd.parentNode.offsetHeight) + 'px';
+        }
+    },
+
+    updateIndexes : function(){
+        Ext.list.ListView.superclass.updateIndexes.apply(this, arguments);
+        this.verifyInternalSize();
+    },
+
+    findHeaderIndex : function(hd){
+        hd = hd.dom || hd;
+        var pn = hd.parentNode, cs = pn.parentNode.childNodes;
+        for(var i = 0, c; c = cs[i]; i++){
+            if(c == pn){
+                return i;
+            }
+        }
+        return -1;
+    },
+
+    setHdWidths : function(){
+        var els = this.innerHd.dom.getElementsByTagName('div');
+        for(var i = 0, cs = this.columns, len = cs.length; i < len; i++){
+            els[i].style.width = (cs[i].width*100) + '%';
+        }
+    }
+});
+
+Ext.reg('listview', Ext.list.ListView);
+
+// Backwards compatibility alias
+Ext.ListView = Ext.list.ListView;</pre>    
+</body>
 </html>
\ No newline at end of file