Layout布局

协助进行页面级整体布局。

单独引入此组件

想要了解更多关于单独引入组件的内容，可以在快速上手页面进行查看。

  1. import { NzLayoutModule } from 'ng-zorro-antd/layout';

设计规则

尺寸

一级导航项偏左靠近 logo 放置，辅助菜单偏右放置。

  • 顶部导航（大部分系统）：一级导航高度 64px，二级导航 48px。
  • 顶部导航（展示类页面）：一级导航高度 80px，二级导航 56px。
  • 顶部导航高度的范围计算公式为：48+8n。
  • 侧边导航宽度的范围计算公式：200+8n。

交互

  • 一级导航和末级的导航需要在可视化的层面被强调出来；
  • 当前项应该在呈现上优先级最高；
  • 当导航收起的时候，当前项的样式自动赋予给它的上一个层级；
  • 左侧导航栏的收放交互同时支持手风琴和全展开的样式，根据业务的要求进行适当的选择。

视觉

导航样式上需要根据信息层级合理的选择样式：

  • 大色块强调

建议用于底色为深色系时，当前页面父级的导航项。

  • 高亮火柴棍

当导航栏底色为浅色系时使用，可用于当前页面对应导航项，建议尽量在导航路径的最终项使用。

  • 字体高亮变色

从可视化层面，字体高亮的视觉强化力度低于大色块，通常在当前项的上一级使用。

  • 字体放大

12px、14px 是导航的标准字号，14 号字体用在一、二级导航中。字号可以考虑导航项的等级做相应选择。

组件概述

  • nz-layout：布局容器，其下可嵌套 nz-headernz-sidernz-contentnz-footer 或 nz-layout 本身，可以放在任何父容器中。
  • nz-header：顶部布局，自带默认样式，其下可嵌套任何元素，只能放在 nz-layout 中。
  • nz-sider：侧边栏，自带默认样式及基本功能，其下可嵌套任何元素，只能放在 nz-layout 中。
  • nz-content：内容部分，自带默认样式，其下可嵌套任何元素，只能放在 nz-layout 中。
  • nz-footer：底部布局，自带默认样式，其下可嵌套任何元素，只能放在 nz-layout 中。

注意：采用 flex 布局实现，请注意浏览器兼容性问题。

代码演示

Layout布局 - 图1

基本结构

典型的页面布局。

  1. import { Component } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-layout-basic',
  5.   template: `
  6.     <nz-layout>
  7.       <nz-header>Header</nz-header>
  8.       <nz-content>Content</nz-content>
  9.       <nz-footer>Footer</nz-footer>
  10.     </nz-layout>
  12.     <nz-layout>
  13.       <nz-header>Header</nz-header>
  14.       <nz-layout>
  15.         <nz-sider>Sider</nz-sider>
  16.         <nz-content>Content</nz-content>
  17.       </nz-layout>
  18.       <nz-footer>Footer</nz-footer>
  19.     </nz-layout>
  21.     <nz-layout>
  22.       <nz-header>Header</nz-header>
  23.       <nz-layout>
  24.         <nz-content>Content</nz-content>
  25.         <nz-sider>Sider</nz-sider>
  26.       </nz-layout>
  27.       <nz-footer>Footer</nz-footer>
  28.     </nz-layout>
  30.     <nz-layout>
  31.       <nz-sider>Sider</nz-sider>
  32.       <nz-layout>
  33.         <nz-header>Header</nz-header>
  34.         <nz-content>Content</nz-content>
  35.         <nz-footer>Footer</nz-footer>
  36.       </nz-layout>
  37.     </nz-layout>
  38.   `,
  39.   styles: [
  40.     `
  41.       :host {
  42.         text-align: center;
  43.       }
  45.       nz-header,
  46.       nz-footer {
  47.         background: #7dbcea;
  48.         color: #fff;
  49.       }
  51.       nz-footer {
  52.         line-height: 1.5;
  53.       }
  55.       nz-sider {
  56.         background: #3ba0e9;
  57.         color: #fff;
  58.         line-height: 120px;
  59.       }
  61.       nz-content {
  62.         background: rgba(16, 142, 233, 1);
  63.         color: #fff;
  64.         min-height: 120px;
  65.         line-height: 120px;
  66.       }
  68.       nz-layout {
  69.         margin-bottom: 48px;
  70.       }
  72.       nz-layout:last-child {
  73.         margin: 0;
  74.       }
  75.     `
  76.   ]
  77. })
  78. export class NzDemoLayoutBasicComponent {}

Layout布局 - 图2

上中下布局

最基本的『上-中-下』布局。

一般主导航放置于页面的顶端，从左自右依次为：logo、一级导航项、辅助菜单（用户、设置、通知等）。通常将内容放在固定尺寸（例如：1200px）内，整个页面排版稳定，不受用户终端显示器影响；上下级的结构符合用户上下浏览的习惯，也是较为经典的网站导航模式。页面上下切分的方式提高了主工作区域的信息展示效率，但在纵向空间上会有一些牺牲。此外，由于导航栏水平空间的限制，不适合那些一级导航项很多的信息结构。

  1. import { Component } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-layout-top',
  5.   template: `
  6.     <nz-layout>
  7.       <nz-header>
  8.         <div class="logo"></div>
  9.         <ul nz-menu nzTheme="dark" nzMode="horizontal">
  10.           <li nz-menu-item>nav 1</li>
  11.           <li nz-menu-item>nav 2</li>
  12.           <li nz-menu-item>nav 3</li>
  13.         </ul>
  14.       </nz-header>
  15.       <nz-content>
  16.         <nz-breadcrumb>
  17.           <nz-breadcrumb-item>Home</nz-breadcrumb-item>
  18.           <nz-breadcrumb-item>List</nz-breadcrumb-item>
  19.           <nz-breadcrumb-item>App</nz-breadcrumb-item>
  20.         </nz-breadcrumb>
  21.         <div class="inner-content">Content</div>
  22.       </nz-content>
  23.       <nz-footer>Ant Design ©2019 Implement By Angular</nz-footer>
  24.     </nz-layout>
  25.   `,
  26.   styles: [
  27.     `
  28.       .logo {
  29.         width: 120px;
  30.         height: 31px;
  31.         background: rgba(255, 255, 255, 0.2);
  32.         margin: 16px 24px 16px 0;
  33.         float: left;
  34.       }
  36.       [nz-menu] {
  37.         line-height: 64px;
  38.       }
  40.       nz-breadcrumb {
  41.         margin: 16px 0;
  42.       }
  44.       nz-content {
  45.         padding: 0 50px;
  46.       }
  48.       nz-footer {
  49.         text-align: center;
  50.       }
  52.       .inner-content {
  53.         background: #fff;
  54.         padding: 24px;
  55.         min-height: 280px;
  56.       }
  57.     `
  58.   ]
  59. })
  60. export class NzDemoLayoutTopComponent {}

Layout布局 - 图3

顶部-侧边布局-通栏

同样拥有顶部导航及侧边栏，区别是两边未留边距，多用于应用型的网站。

  1. import { Component } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-layout-top-side-2',
  5.   template: `
  6.     <nz-layout>
  7.       <nz-header>
  8.         <div class="logo"></div>
  9.         <ul nz-menu nzTheme="dark" nzMode="horizontal" class="header-menu">
  10.           <li nz-menu-item nzSelected>nav 1</li>
  11.           <li nz-menu-item>nav 2</li>
  12.           <li nz-menu-item>nav 3</li>
  13.         </ul>
  14.       </nz-header>
  15.       <nz-layout>
  16.         <nz-sider nzWidth="200px" nzTheme="light">
  17.           <ul nz-menu nzMode="inline" class="sider-menu">
  18.             <li nz-submenu nzOpen nzIcon="user" nzTitle="subnav 1">
  19.               <ul>
  20.                 <li nz-menu-item nzSelected>option1</li>
  21.                 <li nz-menu-item>option2</li>
  22.                 <li nz-menu-item>option3</li>
  23.                 <li nz-menu-item>option4</li>
  24.               </ul>
  25.             </li>
  26.             <li nz-submenu nzTitle="subnav 2" nzIcon="laptop">
  27.               <ul>
  28.                 <li nz-menu-item>option5</li>
  29.                 <li nz-menu-item>option6</li>
  30.                 <li nz-menu-item>option7</li>
  31.                 <li nz-menu-item>option8</li>
  32.               </ul>
  33.             </li>
  34.             <li nz-submenu nzTitle="subnav 3" nzIcon="notification">
  35.               <ul>
  36.                 <li nz-menu-item>option9</li>
  37.                 <li nz-menu-item>option10</li>
  38.                 <li nz-menu-item>option11</li>
  39.                 <li nz-menu-item>option12</li>
  40.               </ul>
  41.             </li>
  42.           </ul>
  43.         </nz-sider>
  44.         <nz-layout class="inner-layout">
  45.           <nz-breadcrumb>
  46.             <nz-breadcrumb-item>Home</nz-breadcrumb-item>
  47.             <nz-breadcrumb-item>List</nz-breadcrumb-item>
  48.             <nz-breadcrumb-item>App</nz-breadcrumb-item>
  49.           </nz-breadcrumb>
  50.           <nz-content>Content</nz-content>
  51.         </nz-layout>
  52.       </nz-layout>
  53.     </nz-layout>
  54.   `,
  55.   styles: [
  56.     `
  57.       .logo {
  58.         width: 120px;
  59.         height: 31px;
  60.         background: rgba(255, 255, 255, 0.2);
  61.         margin: 16px 30px 16px 0;
  62.         float: left;
  63.       }
  65.       .header-menu {
  66.         line-height: 64px;
  67.       }
  69.       .sider-menu {
  70.         height: 100%;
  71.         border-right: 0;
  72.       }
  74.       .inner-layout {
  75.         padding: 0 24px 24px;
  76.       }
  78.       nz-breadcrumb {
  79.         margin: 16px 0;
  80.       }
  82.       nz-content {
  83.         background: #fff;
  84.         padding: 24px;
  85.         min-height: 280px;
  86.       }
  87.     `
  88.   ]
  89. })
  90. export class NzDemoLayoutTopSide2Component {}

Layout布局 - 图4

顶部-侧边布局

拥有顶部导航及侧边栏的页面，多用于展示类网站。

  1. import { Component } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-layout-top-side',
  5.   template: `
  6.     <nz-layout>
  7.       <nz-header>
  8.         <div class="logo"></div>
  9.         <ul nz-menu [nzTheme]="'dark'" [nzMode]="'horizontal'" class="header-menu">
  10.           <li nz-menu-item>nav 1</li>
  11.           <li nz-menu-item nzSelected>nav 2</li>
  12.           <li nz-menu-item>nav 3</li>
  13.         </ul>
  14.       </nz-header>
  15.       <nz-content class="outer-content">
  16.         <nz-breadcrumb>
  17.           <nz-breadcrumb-item>Home</nz-breadcrumb-item>
  18.           <nz-breadcrumb-item>List</nz-breadcrumb-item>
  19.           <nz-breadcrumb-item>App</nz-breadcrumb-item>
  20.         </nz-breadcrumb>
  21.         <nz-layout class="inner-layout">
  22.           <nz-sider nzWidth="200px" nzTheme="light">
  23.             <ul nz-menu nzMode="inline" class="sider-menu">
  24.               <li nz-submenu nzOpen nzTitle="subnav 1" nzIcon="user">
  25.                 <ul>
  26.                   <li nz-menu-item nzSelected>option1</li>
  27.                   <li nz-menu-item>option2</li>
  28.                   <li nz-menu-item>option3</li>
  29.                   <li nz-menu-item>option4</li>
  30.                 </ul>
  31.               </li>
  32.               <li nz-submenu nzTitle="subnav 2" nzIcon="laptop">
  33.                 <ul>
  34.                   <li nz-menu-item>option5</li>
  35.                   <li nz-menu-item>option6</li>
  36.                   <li nz-menu-item>option7</li>
  37.                   <li nz-menu-item>option8</li>
  38.                 </ul>
  39.               </li>
  40.               <li nz-submenu nzTitle="subnav 3" nzIcon="notification">
  41.                 <ul>
  42.                   <li nz-menu-item>option9</li>
  43.                   <li nz-menu-item>option10</li>
  44.                   <li nz-menu-item>option11</li>
  45.                   <li nz-menu-item>option12</li>
  46.                 </ul>
  47.               </li>
  48.             </ul>
  49.           </nz-sider>
  50.           <nz-content class="inner-content">Content</nz-content>
  51.         </nz-layout>
  52.         <nz-footer>Ant Design ©2019 Implement By Angular</nz-footer>
  53.       </nz-content>
  54.     </nz-layout>
  55.   `,
  56.   styles: [
  57.     `
  58.       .logo {
  59.         width: 120px;
  60.         height: 31px;
  61.         background: rgba(255, 255, 255, 0.2);
  62.         margin: 16px 28px 16px 0;
  63.         float: left;
  64.       }
  66.       .header-menu {
  67.         line-height: 64px;
  68.       }
  70.       .outer-content {
  71.         padding: 0 50px;
  72.       }
  74.       nz-breadcrumb {
  75.         margin: 16px 0;
  76.       }
  78.       .inner-layout {
  79.         padding: 24px 0;
  80.         background: #fff;
  81.       }
  83.       .sider-menu {
  84.         height: 100%;
  85.       }
  87.       .inner-content {
  88.         padding: 0 24px;
  89.         min-height: 280px;
  90.       }
  92.       nz-footer {
  93.         text-align: center;
  94.       }
  95.     `
  96.   ]
  97. })
  98. export class NzDemoLayoutTopSideComponent {}

Layout布局 - 图5

侧边布局

侧边两列式布局。页面横向空间有限时，侧边导航可收起。

侧边导航在页面布局上采用的是左右的结构，一般主导航放置于页面的左侧固定位置，辅助菜单放置于工作区顶部。内容根据浏览器终端进行自适应，能提高横向空间的使用率，但是整个页面排版不稳定。侧边导航的模式层级扩展性强，一、二、三级导航项目可以更为顺畅且具关联性的被展示，同时侧边导航可以固定，使得用户在操作和浏览中可以快速的定位和切换当前位置，有很高的操作效率。但这类导航横向页面内容的空间会被牺牲一部份。

  1. import { Component } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-layout-side',
  5.   template: `
  6.     <nz-layout>
  7.       <nz-sider nzCollapsible [(nzCollapsed)]="isCollapsed" nzWidth="200px">
  8.         <div class="logo"></div>
  9.         <ul nz-menu nzTheme="dark" nzMode="inline" [nzInlineCollapsed]="isCollapsed">
  10.           <li nz-submenu nzTitle="User" nzIcon="user">
  11.             <ul>
  12.               <li nz-menu-item>Tom</li>
  13.               <li nz-menu-item>Bill</li>
  14.               <li nz-menu-item>Alex</li>
  15.             </ul>
  16.           </li>
  17.           <li nz-submenu nzTitle="Team" nzIcon="team">
  18.             <ul>
  19.               <li nz-menu-item>Team 1</li>
  20.               <li nz-menu-item>Team 2</li>
  21.             </ul>
  22.           </li>
  23.           <li nz-menu-item>
  24.             <i nz-icon nzType="file"></i>
  25.             <span>File</span>
  26.           </li>
  27.         </ul>
  28.       </nz-sider>
  29.       <nz-layout>
  30.         <nz-header></nz-header>
  31.         <nz-content>
  32.           <nz-breadcrumb>
  33.             <nz-breadcrumb-item>User</nz-breadcrumb-item>
  34.             <nz-breadcrumb-item>Bill</nz-breadcrumb-item>
  35.           </nz-breadcrumb>
  36.           <div class="inner-content">
  37.             Bill is a cat.
  38.           </div>
  39.         </nz-content>
  40.         <nz-footer>Ant Design ©2019 Implement By Angular</nz-footer>
  41.       </nz-layout>
  42.     </nz-layout>
  43.   `,
  44.   styles: [
  45.     `
  46.       .logo {
  47.         height: 32px;
  48.         background: rgba(255, 255, 255, 0.2);
  49.         margin: 16px;
  50.       }
  52.       nz-header {
  53.         background: #fff;
  54.         padding: 0;
  55.       }
  57.       nz-content {
  58.         margin: 0 16px;
  59.       }
  61.       nz-breadcrumb {
  62.         margin: 16px 0;
  63.       }
  65.       .inner-content {
  66.         padding: 24px;
  67.         background: #fff;
  68.         min-height: 360px;
  69.       }
  71.       nz-footer {
  72.         text-align: center;
  73.       }
  74.     `
  75.   ]
  76. })
  77. export class NzDemoLayoutSideComponent {
  78.   isCollapsed = false;
  79. }

Layout布局 - 图6

自定义触发器

要使用自定义触发器，可以设置 [nzTrigger]="null" 来隐藏默认设定。

  1. import { Component } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-layout-custom-trigger',
  5.   template: `
  6.     <nz-layout>
  7.       <nz-sider nzCollapsible [(nzCollapsed)]="isCollapsed" [nzTrigger]="null">
  8.         <div class="logo"></div>
  9.         <ul nz-menu nzTheme="dark" nzMode="inline" [nzInlineCollapsed]="isCollapsed">
  10.           <li nz-submenu nzTitle="User" nzIcon="user">
  11.             <ul>
  12.               <li nz-menu-item>Tom</li>
  13.               <li nz-menu-item>Bill</li>
  14.               <li nz-menu-item>Alex</li>
  15.             </ul>
  16.           </li>
  17.           <li nz-submenu nzTitle="Team" nzIcon="team">
  18.             <ul>
  19.               <li nz-menu-item>Team 1</li>
  20.               <li nz-menu-item>Team 2</li>
  21.             </ul>
  22.           </li>
  23.           <li nz-menu-item>
  24.             <i nz-icon nzType="file"></i>
  25.             <span>File</span>
  26.           </li>
  27.         </ul>
  28.       </nz-sider>
  29.       <nz-layout>
  30.         <nz-header>
  31.           <i
  32.             class="trigger"
  33.             nz-icon
  34.             [nzType]="isCollapsed ? 'menu-unfold' : 'menu-fold'"
  35.             (click)="isCollapsed = !isCollapsed"
  36.           ></i>
  37.         </nz-header>
  38.         <nz-content>
  39.           <nz-breadcrumb>
  40.             <nz-breadcrumb-item>User</nz-breadcrumb-item>
  41.             <nz-breadcrumb-item>Bill</nz-breadcrumb-item>
  42.           </nz-breadcrumb>
  43.           <div class="inner-content">
  44.             Bill is a cat.
  45.           </div>
  46.         </nz-content>
  47.         <nz-footer>Ant Design ©2019 Implement By Angular</nz-footer>
  48.       </nz-layout>
  49.     </nz-layout>
  50.   `,
  51.   styles: [
  52.     `
  53.       .trigger {
  54.         font-size: 18px;
  55.         line-height: 64px;
  56.         padding: 0 24px;
  57.         cursor: pointer;
  58.         transition: color 0.3s;
  59.       }
  61.       .trigger:hover {
  62.         color: #1890ff;
  63.       }
  65.       .logo {
  66.         height: 32px;
  67.         background: rgba(255, 255, 255, 0.2);
  68.         margin: 16px;
  69.       }
  71.       nz-header {
  72.         background: #fff;
  73.         padding: 0;
  74.       }
  76.       nz-content {
  77.         margin: 0 16px;
  78.       }
  80.       nz-breadcrumb {
  81.         margin: 16px 0;
  82.       }
  84.       .inner-content {
  85.         padding: 24px;
  86.         background: #fff;
  87.         min-height: 360px;
  88.       }
  90.       nz-footer {
  91.         text-align: center;
  92.       }
  93.     `
  94.   ]
  95. })
  96. export class NzDemoLayoutCustomTriggerComponent {
  97.   isCollapsed = false;
  98. }

Layout布局 - 图7

响应式布局

nz-sider 支持响应式布局。

说明：配置 nzBreakpoint 属性即生效，视窗宽度小于 nzBreakpoint 时 nz-sider 缩小为 nzCollapsedWidth 宽度，若将 nzCollapsedWidth 设置为零，会出现特殊 trigger。

  1. import { Component } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-layout-responsive',
  5.   template: `
  6.     <nz-layout class="layout">
  7.       <nz-sider
  8.         nzCollapsible
  9.         [(nzCollapsed)]="isCollapsed"
  10.         [nzBreakpoint]="'lg'"
  11.         [nzCollapsedWidth]="0"
  12.         [nzZeroTrigger]="zeroTrigger"
  13.       >
  14.         <div class="logo"></div>
  15.         <ul nz-menu nzTheme="dark" nzMode="inline" [nzInlineCollapsed]="isCollapsed">
  16.           <li nz-menu-item>
  17.             <i nz-icon nzType="user"></i>
  18.             <span>nav 1</span>
  19.           </li>
  20.           <li nz-menu-item>
  21.             <i nz-icon nzType="video-camera"></i>
  22.             <span>nav 2</span>
  23.           </li>
  24.           <li nz-menu-item>
  25.             <i nz-icon nzType="upload"></i>
  26.             <span>nav 3</span>
  27.           </li>
  28.           <li nz-menu-item>
  29.             <i nz-icon nzType="user"></i>
  30.             <span>nav 4</span>
  31.           </li>
  32.         </ul>
  33.       </nz-sider>
  34.       <nz-layout>
  35.         <nz-header></nz-header>
  36.         <nz-content>
  37.           <div class="inner-content">
  38.             Content
  39.           </div>
  40.         </nz-content>
  41.         <nz-footer>Ant Design ©2019 Implement By Angular</nz-footer>
  42.       </nz-layout>
  43.     </nz-layout>
  44.     <ng-template #zeroTrigger>
  45.       <i nz-icon nzType="menu-fold" nzTheme="outline"></i>
  46.     </ng-template>
  47.   `,
  48.   styles: [
  49.     `
  50.       .layout {
  51.         height: 100vh;
  52.       }
  54.       .logo {
  55.         height: 32px;
  56.         background: rgba(255, 255, 255, 0.2);
  57.         margin: 16px;
  58.       }
  60.       nz-header {
  61.         background: #fff;
  62.         padding: 0;
  63.       }
  65.       nz-content {
  66.         margin: 24px 16px 0;
  67.       }
  69.       .inner-content {
  70.         padding: 24px;
  71.         background: #fff;
  72.         min-height: 360px;
  73.       }
  75.       nz-footer {
  76.         text-align: center;
  77.       }
  78.     `
  79.   ]
  80. })
  81. export class NzDemoLayoutResponsiveComponent {
  82.   isCollapsed = false;
  83. }

Layout布局 - 图8

固定头部

一般用于固定顶部导航，方便页面切换。

  1. import { Component } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-layout-fixed',
  5.   template: `
  6.     <nz-layout class="layout">
  7.       <nz-header>
  8.         <div class="logo"></div>
  9.         <ul nz-menu nzTheme="dark" nzMode="horizontal">
  10.           <li nz-menu-item>nav 1</li>
  11.           <li nz-menu-item>nav 2</li>
  12.           <li nz-menu-item>nav 3</li>
  13.         </ul>
  14.       </nz-header>
  15.       <nz-content>
  16.         <nz-breadcrumb>
  17.           <nz-breadcrumb-item>Home</nz-breadcrumb-item>
  18.           <nz-breadcrumb-item>List</nz-breadcrumb-item>
  19.           <nz-breadcrumb-item>App</nz-breadcrumb-item>
  20.         </nz-breadcrumb>
  21.         <div class="inner-content">Content</div>
  22.       </nz-content>
  23.       <nz-footer>Ant Design ©2019 Implement By Angular</nz-footer>
  24.     </nz-layout>
  25.   `,
  26.   styles: [
  27.     `
  28.       .layout {
  29.         height: 100vh;
  30.       }
  32.       .logo {
  33.         width: 120px;
  34.         height: 31px;
  35.         background: rgba(255, 255, 255, 0.2);
  36.         margin: 16px 24px 16px 0;
  37.         float: left;
  38.       }
  40.       nz-header {
  41.         position: fixed;
  42.         width: 100%;
  43.       }
  45.       [nz-menu] {
  46.         line-height: 64px;
  47.       }
  49.       nz-content {
  50.         padding: 0 50px;
  51.         margin-top: 64px;
  52.       }
  54.       nz-breadcrumb {
  55.         margin: 16px 0;
  56.       }
  58.       .inner-content {
  59.         background: #fff;
  60.         padding: 24px;
  61.         min-height: 380px;
  62.       }
  64.       nz-footer {
  65.         text-align: center;
  66.       }
  67.     `
  68.   ]
  69. })
  70. export class NzDemoLayoutFixedComponent {}

Layout布局 - 图9

固定侧边栏

当内容较长时，使用固定侧边栏可以提供更好的体验。

  1. import { Component } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-layout-fixed-sider',
  5.   template: `
  6.     <nz-layout class="left-layout">
  7.       <nz-sider>
  8.         <div class="logo"></div>
  9.         <ul nz-menu nzTheme="dark" nzMode="inline">
  10.           <li nz-menu-item>
  11.             <i nz-icon nzType="file"></i>
  12.             <span>nav 1</span>
  13.           </li>
  14.           <li nz-menu-item>
  15.             <i nz-icon nzType="video-camera"></i>
  16.             <span>nav 2</span>
  17.           </li>
  18.           <li nz-menu-item>
  19.             <i nz-icon nzType="upload"></i>
  20.             <span>nav 3</span>
  21.           </li>
  22.           <li nz-menu-item>
  23.             <i nz-icon nzType="bar-chart"></i>
  24.             <span>nav 4</span>
  25.           </li>
  26.           <li nz-menu-item>
  27.             <i nz-icon nzType="cloud-o"></i>
  28.             <span>nav 5</span>
  29.           </li>
  30.           <li nz-menu-item>
  31.             <i nz-icon nzType="appstore-o"></i>
  32.             <span>nav 6</span>
  33.           </li>
  34.           <li nz-menu-item>
  35.             <i nz-icon nzType="team"></i>
  36.             <span>nav 7</span>
  37.           </li>
  38.           <li nz-menu-item>
  39.             <i nz-icon nzType="shop"></i>
  40.             <span>nav 8</span>
  41.           </li>
  42.         </ul>
  43.       </nz-sider>
  44.       <nz-layout class="right-layout">
  45.         <nz-header></nz-header>
  46.         <nz-content>
  47.           <div class="inner-content">
  48.             ...
  49.             <br />
  50.             Really
  51.             <br />...<br />...<br />...<br />
  52.             long
  53.             <br />...<br />...<br />...<br />...<br />...<br />...
  54.             <br />...<br />...<br />...<br />...<br />...<br />...
  55.             <br />...<br />...<br />...<br />...<br />...<br />...
  56.             <br />...<br />...<br />...<br />...<br />...<br />...
  57.             <br />...<br />...<br />...<br />...<br />...<br />...
  58.             <br />...<br />...<br />...<br />...<br />...<br />... <br />...<br />...<br />...<br />...<br />...<br />
  59.             content
  60.           </div>
  61.         </nz-content>
  62.         <nz-footer>Ant Design ©2019 Implement By Angular</nz-footer>
  63.       </nz-layout>
  64.     </nz-layout>
  65.   `,
  66.   styles: [
  67.     `
  68.       .logo {
  69.         height: 32px;
  70.         background: rgba(255, 255, 255, 0.2);
  71.         margin: 16px;
  72.       }
  74.       .left-layout {
  75.         height: 100vh;
  76.       }
  78.       nz-sider {
  79.         overflow: auto;
  80.         height: 100%;
  81.         position: fixed;
  82.         left: 0;
  83.       }
  85.       .right-layout {
  86.         margin-left: 200px;
  87.       }
  89.       nz-header {
  90.         background: #fff;
  91.         padding: 0;
  92.       }
  94.       nz-content {
  95.         margin: 24px 16px 0;
  96.         overflow: initial;
  97.       }
  99.       .inner-content {
  100.         padding: 24px;
  101.         background: #fff;
  102.         text-align: center;
  103.       }
  105.       nz-footer {
  106.         text-align: center;
  107.       }
  108.     `
  109.   ]
  110. })
  111. export class NzDemoLayoutFixedSiderComponent {}

API

  1. <nz-layout>
  2.   <nz-header>header</nz-header>
  3.   <nz-layout>
  4.     <nz-sider>left sidebar</nz-sider>
  5.     <nz-content>main content</nz-content>
  6.     <nz-sider>right sidebar</nz-sider>
  7.   </nz-layout>
  8.   <nz-footer>footer</nz-footer>
  9. </nz-layout>

nz-sidercomponent

侧边栏。

参数说明类型默认值
[nzBreakpoint]触发响应式布局的断点'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl'-
[nzCollapsed]当前收起状态boolean-
[nzCollapsedWidth]收缩宽度，设置为 0 会出现特殊 triggernumber64
[nzCollapsible]是否可收起booleanfalse
[nzCollapsed]当前收起状态，可双向绑定booleanfalse
[nzReverseArrow]翻转折叠提示箭头的方向，当 Sider 在右边时可以使用booleanfalse
[nzTrigger]自定义 trigger，设置为 null 时隐藏 triggerTemplateRef<void>-
[nzZeroTrigger]自定义 nzCollapsedWidth 为 0 时的 特殊triggerTemplateRef<void>-
[nzWidth]宽度number | string200
[nzTheme]主题颜色'light' | 'dark'dark
(nzCollapsedChange)展开-收起时的回调函数EventEmitter<boolean>-

breakpoint width

  1. {
  2.   xs: '480px',
  3.   sm: '768px',
  4.   md: '992px',
  5.   lg: '1200px',
  6.   xl: '1600px',
  7.   xxl: '1600px'
  8. }