Extjs4 API文档阅读（三）——布局和容器

extjs4.0布局和容器（Layouts and Containers）是Ext JS中最强大的部分之一。它负责控制你应用程序中每个组件的尺寸和定位。本文内容包括了如何运用布局的基础。

一、容器

一个Ext JS应用程序的图形用户界面(UI)是由许多组件（查看组件指南(Components Guide)获取更多关于组件的信息）构成的。容器是一种可以容纳一些其他组件的特殊类型组件。

典型的Ext JS应用程序是由一些嵌套的组件构成不同的层来组成的。如下图：

 

最通用的容器就是Panel。让我们看下如何创建一个容器以允许一个Panel包含其他的组件：

Ext.create('Ext.panel.Panel', {
    renderTo: Ext.getBody(),
    width: 400,
    height: 300,
    title: 'Container Panel',
    items: [
        {
            xtype: 'panel',
            title: 'Child Panel 1',
            height: 100,
            width: '75%'
        },
        {
            xtype: 'panel',
            title: 'Child Panel 2',
            height: 100,
            width: '75%'
        }
    ]
});

 

我们刚刚创建了一个Panel，并把它渲染到DOM的body中，然后我们使用items配置项添加两个子Panel到我们的Panel容器中。

二、布局

每个容器都拥有一个布局来管理它子组件的尺寸和定位。

下面我们将讨论如何使用指定类型的布局来配置容器，以及布局系统是如何使每个组件都保持协调的。

使用布局：上面例子中我们没有为Panel容器指定布局。可以看到子Panel是一个接着一个被放置的，正如DOM中标准的块元素一样。

之所以这样是因为所有容器的默认布局为自动布局。自动布局并不为子元素指定任何特殊的定位和尺寸规则。

例如，我们假定想让两个子Panel并排放置，并且每个占据父容器宽度的50%，我们可以简单

地使用一个列布局(Column Layout)，通过在父容器中配置layout选项来实现。

代码：

Ext.create('Ext.panel.Panel', {
    renderTo: Ext.getBody(),
    width: 400,
    height: 200,
    title: 'Container Panel',
    layout: 'column',
    items: [
        {
            xtype: 'panel',
            title: 'Child Panel 1',
            height: 100,
            width: '50%'
        },
        {
            xtype: 'panel',
            title: 'Child Panel 2',
            height: 100,
            width: '50%'
        }
    ]
});

 

Ext JS拥有一整套可用的布局，几乎容纳了你能想象到的任何一种布局。可以查看布局的例子(Layout Examples)以了解那些布局是可行的。

 

布局系统是如何工作的呢？

父容器的布局负责其所有子元素的初始定位和尺寸大小。框架内部调用了容器的doLayout方法，
该方法触发布局为父容器的所有子元素计算得到正确的尺寸和定位并更新DOM。doLayout方法
是递归调用的，所以父容器的任何子元素同样也将会调用它们的doLayout方法。这种调用将持续到到达组件层次的末端。通常你一般不会在你的应用程序代码中调用doLayout方法，因为框架已为你调用了。

父容器的改变尺寸时，或当添加或删除子组件的items时，重新布局将被触发。通常，我们仅依赖框架为我们管理以更新布局，但是有时我们想阻止框架自动更新布局，这样我们一次可以批量
地处理多个操作，完成时，我们手动地触发布局。

为了到达这个目的，我们在容器中使用延缓布局(suspendLayout)标志以阻止它自动布局，当我们执行那些通常会触发布局的操作时（例如添加或移除items）。

当我们做完这些操作时，我们必须把延缓布局标志关闭，并且手动地调用容器的doLayout方法以触发布局：

var containerPanel = Ext.create('Ext.panel.Panel', {
    renderTo: Ext.getBody(),
    width: 400,
    height: 200,
    title: 'Container Panel',
    layout: 'column',
suspendLayout: true // Suspend automatic layouts while we do several different things that could trigger a layout on their own
//当我们做一些能触发其自动布局的操作时，保证延缓其能自动布局。
});
// Add a couple of child items.  We could add these both at the same time by passing an array to add(),
//添加一对子items。我们可以通过调用add()并传递一个数组一次性添加这两个子组件，
// but lets pretend we needed to add them separately for some reason.
//但是我们假定需要分别地添加它们是因为其他原因。
containerPanel.add({
    xtype: 'panel',
    title: 'Child Panel 1',
    height: 100,
    width: '50%'
});
containerPanel.add({
    xtype: 'panel',
    title: 'Child Panel 2',
    height: 100,
    width: '50%'
});
// Turn the suspendLayout flag off.
//关闭延缓布局标志
containerPanel.suspendLayout = false;
// Trigger a layout.
//触发布局
containerPanel.doLayout();

 

组件布局

如容器的布局定义了一个容器如何设定尺寸和定位它的组件items，组件的布局同样也定义了
其如何设定尺寸和定位它内部的子items。

组件的布局通过使用组件布局(componentLayout)来设置配置选项。一般你不需要使用该配置项，除非你正在编写一个自定义的组件，因为所有提供的组件其内部元素的大小调整和定位都拥有它们自己的布局管理器。

大多数组件使用自动布局(Auto Layout)，但是更多复杂的组件需要自定义的组件布局方式（例如一个有header，footer，toolbars的Panel）

自此，我们了解了容器及布局，并且掌握了基本的布局方式和容器的布局方法。下章，我们将详细介绍组件的一些使用方法。