ListView.js
上传用户:shuoshiled
上传日期:2018-01-28
资源大小:10124k
文件大小:13k
源码类别:

中间件编程

开发平台:

JavaScript

  1. /*!  * Ext JS Library 3.0.0  * Copyright(c) 2006-2009 Ext JS, LLC  * licensing@extjs.com  * http://www.extjs.com/license  */ /**
  2.  * @class Ext.ListView
  3.  * @extends Ext.DataView
  4.  * <p>Ext.ListView is a fast and light-weight implentation of a
  5.  * {@link Ext.grid.GridPanel Grid} like view with the following characteristics:</p>
  6.  * <div class="mdetail-params"><ul>
  7.  * <li>resizable columns</li>
  8.  * <li>selectable</li>
  9.  * <li>column widths are initially proportioned by percentage based on the container
  10.  * width and number of columns</li>
  11.  * <li>uses templates to render the data in any required format</li>
  12.  * <li>no horizontal scrolling</li>
  13.  * <li>no editing</li>
  14.  * </ul></div>
  15.  * <p>Example usage:</p>
  16.  * <pre><code>
  17. // consume JSON of this form:
  18. {
  19.    "images":[
  20.       {
  21.          "name":"dance_fever.jpg",
  22.          "size":2067,
  23.          "lastmod":1236974993000,
  24.          "url":"images/thumbs/dance_fever.jpg"
  25.       },
  26.       {
  27.          "name":"zack_sink.jpg",
  28.          "size":2303,
  29.          "lastmod":1236974993000,
  30.          "url":"images/thumbs/zack_sink.jpg"
  31.       }
  32.    ]
  33. var store = new Ext.data.JsonStore({
  34.     url: 'get-images.php',
  35.     root: 'images',
  36.     fields: [
  37.         'name', 'url',
  38.         {name:'size', type: 'float'},
  39.         {name:'lastmod', type:'date', dateFormat:'timestamp'}
  40.     ]
  41. });
  42. store.load();
  43. var listView = new Ext.ListView({
  44.     store: store,
  45.     multiSelect: true,
  46.     emptyText: 'No images to display',
  47.     reserveScrollOffset: true,
  48.     columns: [{
  49.         header: 'File',
  50.         width: .5,
  51.         dataIndex: 'name'
  52.     },{
  53.         header: 'Last Modified',
  54.         width: .35, 
  55.         dataIndex: 'lastmod',
  56.         tpl: '{lastmod:date("m-d h:i a")}'
  57.     },{
  58.         header: 'Size',
  59.         dataIndex: 'size',
  60.         tpl: '{size:fileSize}', // format using Ext.util.Format.fileSize()
  61.         align: 'right'
  62.     }]
  63. });
  64. // put it in a Panel so it looks pretty
  65. var panel = new Ext.Panel({
  66.     id:'images-view',
  67.     width:425,
  68.     height:250,
  69.     collapsible:true,
  70.     layout:'fit',
  71.     title:'Simple ListView <i>(0 items selected)</i>',
  72.     items: listView
  73. });
  74. panel.render(document.body);
  75. // little bit of feedback
  76. listView.on('selectionchange', function(view, nodes){
  77.     var l = nodes.length;
  78.     var s = l != 1 ? 's' : '';
  79.     panel.setTitle('Simple ListView <i>('+l+' item'+s+' selected)</i>');
  80. });
  81.  * </code></pre>
  82.  * @constructor
  83.  * @param {Object} config
  84.  * @xtype listview
  85.  */
  86. Ext.ListView = Ext.extend(Ext.DataView, {
  87.     /**
  88.      * Set this property to <tt>true</tt> to disable the header click handler disabling sort
  89.      * (defaults to <tt>false</tt>).
  90.      * @type Boolean
  91.      * @property disableHeaders
  92.      */
  93.     /**
  94.      * @cfg {Boolean} hideHeaders
  95.      * <tt>true</tt> to hide the {@link #internalTpl header row} (defaults to <tt>false</tt> so
  96.      * the {@link #internalTpl header row} will be shown).
  97.      */
  98.     /**
  99.      * @cfg {String} itemSelector
  100.      * Defaults to <tt>'dl'</tt> to work with the preconfigured <b><tt>{@link Ext.DataView#tpl tpl}</tt></b>.
  101.      * This setting specifies the CSS selector (e.g. <tt>div.some-class</tt> or <tt>span:first-child</tt>)
  102.      * that will be used to determine what nodes the ListView will be working with.   
  103.      */
  104.     itemSelector: 'dl',
  105.     /**
  106.      * @cfg {String} selectedClass The CSS class applied to a selected row (defaults to
  107.      * <tt>'x-list-selected'</tt>). An example overriding the default styling:
  108.     <pre><code>
  109.     .x-list-selected {background-color: yellow;}
  110.     </code></pre>
  111.      * @type String
  112.      */
  113.     selectedClass:'x-list-selected',
  114.     /**
  115.      * @cfg {String} overClass The CSS class applied when over a row (defaults to
  116.      * <tt>'x-list-over'</tt>). An example overriding the default styling:
  117.     <pre><code>
  118.     .x-list-over {background-color: orange;}
  119.     </code></pre>
  120.      * @type String
  121.      */
  122.     overClass:'x-list-over',
  123.     /**
  124.      * @cfg {Boolean} reserveScrollOffset
  125.      * By default will defer accounting for the configured <b><tt>{@link #scrollOffset}</tt></b>
  126.      * for 10 milliseconds.  Specify <tt>true</tt> to account for the configured
  127.      * <b><tt>{@link #scrollOffset}</tt></b> immediately.
  128.      */
  129.     /**
  130.      * @cfg {Number} scrollOffset The amount of space to reserve for the scrollbar (defaults to
  131.      * <tt>19</tt> pixels)
  132.      */
  133.     scrollOffset : 19,
  134.     /**
  135.      * @cfg {Boolean/Object} columnResize
  136.      * Specify <tt>true</tt> or specify a configuration object for {@link Ext.ListView.ColumnResizer}
  137.      * to enable the columns to be resizable (defaults to <tt>true</tt>).
  138.      */
  139.     columnResize: true,
  140.     /**
  141.      * @cfg {Array} columns An array of column configuration objects, for example:
  142.      * <pre><code>
  143. {
  144.     align: 'right',
  145.     dataIndex: 'size',
  146.     header: 'Size',
  147.     tpl: '{size:fileSize}',
  148.     width: .35
  149. }
  150.      * </code></pre> 
  151.      * Acceptable properties for each column configuration object are:
  152.      * <div class="mdetail-params"><ul>
  153.      * <li><b><tt>align</tt></b> : String<div class="sub-desc">Set the CSS text-align property
  154.      * of the column. Defaults to <tt>'left'</tt>.</div></li>
  155.      * <li><b><tt>dataIndex</tt></b> : String<div class="sub-desc">See {@link Ext.grid.Column}.
  156.      * {@link Ext.grid.Column#dataIndex dataIndex} for details.</div></li>
  157.      * <li><b><tt>header</tt></b> : String<div class="sub-desc">See {@link Ext.grid.Column}.
  158.      * {@link Ext.grid.Column#header header} for details.</div></li>
  159.      * <li><b><tt>tpl</tt></b> : String<div class="sub-desc">Specify a string to pass as the
  160.      * configuration string for {@link Ext.XTemplate}.  By default an {@link Ext.XTemplate}
  161.      * will be implicitly created using the <tt>dataIndex</tt>.</div></li>
  162.      * <li><b><tt>width</tt></b> : Number<div class="sub-desc">Percentage of the container width
  163.      * this column should be allocated.  Columns that have no width specified will be
  164.      * allocated with an equal percentage to fill 100% of the container width.  To easily take
  165.      * advantage of the full container width, leave the width of at least one column undefined.
  166.      * Note that if you do not want to take up the full width of the container, the width of
  167.      * every column needs to be explicitly defined.</div></li>
  168.      * </ul></div>
  169.      */
  170.     /**
  171.      * @cfg {Boolean/Object} columnSort
  172.      * Specify <tt>true</tt> or specify a configuration object for {@link Ext.ListView.Sorter}
  173.      * to enable the columns to be sortable (defaults to <tt>true</tt>).
  174.      */
  175.     columnSort: true,
  176.     /**
  177.      * @cfg {String/Array} internalTpl
  178.      * The template to be used for the header row.  See {@link #tpl} for more details.
  179.      */
  180.     initComponent : function(){
  181.         if(this.columnResize){
  182.             this.colResizer = new Ext.ListView.ColumnResizer(this.colResizer);
  183.             this.colResizer.init(this);
  184.         }
  185.         if(this.columnSort){
  186.             this.colSorter = new Ext.ListView.Sorter(this.columnSort);
  187.             this.colSorter.init(this);
  188.         }
  189.         if(!this.internalTpl){
  190.             this.internalTpl = new Ext.XTemplate(
  191.                 '<div class="x-list-header"><div class="x-list-header-inner">',
  192.                     '<tpl for="columns">',
  193.                     '<div style="width:{width}%;text-align:{align};"><em unselectable="on" id="',this.id, '-xlhd-{#}">',
  194.                         '{header}',
  195.                     '</em></div>',
  196.                     '</tpl>',
  197.                     '<div class="x-clear"></div>',
  198.                 '</div></div>',
  199.                 '<div class="x-list-body"><div class="x-list-body-inner">',
  200.                 '</div></div>'
  201.             );
  202.         }
  203.         if(!this.tpl){
  204.             this.tpl = new Ext.XTemplate(
  205.                 '<tpl for="rows">',
  206.                     '<dl>',
  207.                         '<tpl for="parent.columns">',
  208.                         '<dt style="width:{width}%;text-align:{align};"><em unselectable="on">',
  209.                             '{[values.tpl.apply(parent)]}',
  210.                         '</em></dt>',
  211.                         '</tpl>',
  212.                         '<div class="x-clear"></div>',
  213.                     '</dl>',
  214.                 '</tpl>'
  215.             );
  216.         };
  217.         var cs = this.columns, allocatedWidth = 0, colsWithWidth = 0, len = cs.length;
  218.         for(var i = 0; i < len; i++){
  219.             var c = cs[i];
  220.             if(!c.tpl){
  221.                 c.tpl = new Ext.XTemplate('{' + c.dataIndex + '}');
  222.             }else if(Ext.isString(c.tpl)){
  223.                 c.tpl = new Ext.XTemplate(c.tpl);
  224.             }
  225.             c.align = c.align || 'left';
  226.             if(Ext.isNumber(c.width)){
  227.                 c.width *= 100;
  228.                 allocatedWidth += c.width;
  229.                 colsWithWidth++;
  230.             }
  231.         }
  232.         // auto calculate missing column widths
  233.         if(colsWithWidth < len){
  234.             var remaining = len - colsWithWidth;
  235.             if(allocatedWidth < 100){
  236.                 var perCol = ((100-allocatedWidth) / remaining);
  237.                 for(var j = 0; j < len; j++){
  238.                     var c = cs[j];
  239.                     if(!Ext.isNumber(c.width)){
  240.                         c.width = perCol;
  241.                     }
  242.                 }
  243.             }
  244.         }
  245.         Ext.ListView.superclass.initComponent.call(this);
  246.     },
  247.     onRender : function(){
  248.         Ext.ListView.superclass.onRender.apply(this, arguments);
  249.         this.internalTpl.overwrite(this.el, {columns: this.columns});
  250.         
  251.         this.innerBody = Ext.get(this.el.dom.childNodes[1].firstChild);
  252.         this.innerHd = Ext.get(this.el.dom.firstChild.firstChild);
  253.         if(this.hideHeaders){
  254.             this.el.dom.firstChild.style.display = 'none';
  255.         }
  256.     },
  257.     getTemplateTarget : function(){
  258.         return this.innerBody;
  259.     },
  260.     /**
  261.      * <p>Function which can be overridden which returns the data object passed to this
  262.      * view's {@link #tpl template} to render the whole ListView. The returned object 
  263.      * shall contain the following properties:</p>
  264.      * <div class="mdetail-params"><ul>
  265.      * <li><b>columns</b> : String<div class="sub-desc">See <tt>{@link #columns}</tt></div></li>
  266.      * <li><b>rows</b> : String<div class="sub-desc">See
  267.      * <tt>{@link Ext.DataView}.{@link Ext.DataView#collectData collectData}</div></li>
  268.      * </ul></div>
  269.      * @param {Array} records An Array of {@link Ext.data.Record}s to be rendered into the DataView.
  270.      * @param {Number} startIndex the index number of the Record being prepared for rendering.
  271.      * @return {Object} A data object containing properties to be processed by a repeating
  272.      * XTemplate as described above.
  273.      */
  274.     collectData : function(){
  275.         var rs = Ext.ListView.superclass.collectData.apply(this, arguments);
  276.         return {
  277.             columns: this.columns,
  278.             rows: rs
  279.         }
  280.     },
  281.     verifyInternalSize : function(){
  282.         if(this.lastSize){
  283.             this.onResize(this.lastSize.width, this.lastSize.height);
  284.         }
  285.     },
  286.     // private
  287.     onResize : function(w, h){
  288.         var bd = this.innerBody.dom;
  289.         var hd = this.innerHd.dom
  290.         if(!bd){
  291.             return;
  292.         }
  293.         var bdp = bd.parentNode;
  294.         if(Ext.isNumber(w)){
  295.             var sw = w - this.scrollOffset;
  296.             if(this.reserveScrollOffset || ((bdp.offsetWidth - bdp.clientWidth) > 10)){
  297.                 bd.style.width = sw + 'px';
  298.                 hd.style.width = sw + 'px';
  299.             }else{
  300.                 bd.style.width = w + 'px';
  301.                 hd.style.width = w + 'px';
  302.                 setTimeout(function(){
  303.                     if((bdp.offsetWidth - bdp.clientWidth) > 10){
  304.                         bd.style.width = sw + 'px';
  305.                         hd.style.width = sw + 'px';
  306.                     }
  307.                 }, 10);
  308.             }
  309.         }
  310.         if(Ext.isNumber(h == 'number')){
  311.             bdp.style.height = (h - hd.parentNode.offsetHeight) + 'px';
  312.         }
  313.     },
  314.     updateIndexes : function(){
  315.         Ext.ListView.superclass.updateIndexes.apply(this, arguments);
  316.         this.verifyInternalSize();
  317.     },
  318.     findHeaderIndex : function(hd){
  319.         hd = hd.dom || hd;
  320.         var pn = hd.parentNode, cs = pn.parentNode.childNodes;
  321.         for(var i = 0, c; c = cs[i]; i++){
  322.             if(c == pn){
  323.                 return i;
  324.             }
  325.         }
  326.         return -1;
  327.     },
  328.     setHdWidths : function(){
  329.         var els = this.innerHd.dom.getElementsByTagName('div');
  330.         for(var i = 0, cs = this.columns, len = cs.length; i < len; i++){
  331.             els[i].style.width = cs[i].width + '%';
  332.         }
  333.     }
  334. });
  335. Ext.reg('listview', Ext.ListView);