Layout布局

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

    • 顶部导航（大部分系统）：一级导航高度 ，二级导航 48px。
    • 顶部导航（展示类页面）：一级导航高度 80px，二级导航 56px。
    • 顶部导航高度的范围计算公式为：48+8n。
    • 侧边导航宽度的范围计算公式：200+8n。
    • 一级导航和末级的导航需要在可视化的层面被强调出来；
    • 当前项应该在呈现上优先级最高；
    • 当导航收起的时候，当前项的样式自动赋予给它的上一个层级；
    • 左侧导航栏的收放交互同时支持手风琴和全展开的样式，根据业务的要求进行适当的选择。

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

    • 大色块强调

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

    • 高亮火柴棍

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

    • 字体高亮变色

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

    • 字体放大

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

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

    基本结构

    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布局 - 图4

    上中下布局

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

    一般主导航放置于页面的顶端，从左自右依次为：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 ©2020 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 {}

    顶部-侧边布局-通栏

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

    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-layout class="inner-layout">
    44.           <nz-breadcrumb>
    45.             <nz-breadcrumb-item>Home</nz-breadcrumb-item>
    46.             <nz-breadcrumb-item>List</nz-breadcrumb-item>
    47.             <nz-breadcrumb-item>App</nz-breadcrumb-item>
    48.           </nz-breadcrumb>
    49.           <nz-content>Content</nz-content>
    50.         </nz-layout>
    51.       </nz-layout>
    52.     </nz-layout>
    53.   `,
    54.   styles: [
    55.     `
    56.       .logo {
    57.         width: 120px;
    58.         height: 31px;
    60.         margin: 16px 30px 16px 0;
    61.         float: left;
    62.       }
    64.       .header-menu {
    65.         line-height: 64px;
    66.       }
    68.       .sider-menu {
    69.         height: 100%;
    70.         border-right: 0;
    71.       }
    73.       .inner-layout {
    74.         padding: 0 24px 24px;
    75.       }
    77.       nz-breadcrumb {
    78.         margin: 16px 0;
    79.       }
    81.       nz-content {
    82.         background: #fff;
    83.         padding: 24px;
    84.         min-height: 280px;
    85.       }
    86.     `
    87.   ]
    88. })
    89. export class NzDemoLayoutTopSide2Component {}

    Layout布局 - 图6

    顶部-侧边布局

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

    侧边布局

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

    1. import { Component } from '@angular/core';
    3. @Component({
    4.   selector: 'nz-demo-layout-side',
    5.   template: `
    6.     <nz-layout>
    7.       <nz-sider nzCollapsible nzWidth="200px">
    8.         <div class="logo"></div>
    9.         <ul nz-menu nzTheme="dark" nzMode="inline">
    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 ©2020 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 {}

    Layout布局 - 图8

    自定义触发器

    要使用自定义触发器，可以设置 [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">
    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 class="trigger" nz-icon [nzType]="isCollapsed ? 'menu-unfold' : 'menu-fold'" (click)="isCollapsed = !isCollapsed"></i>
    32.         </nz-header>
    33.         <nz-content>
    34.           <nz-breadcrumb>
    35.             <nz-breadcrumb-item>User</nz-breadcrumb-item>
    36.             <nz-breadcrumb-item>Bill</nz-breadcrumb-item>
    37.           </nz-breadcrumb>
    38.           <div class="inner-content">
    39.             Bill is a cat.
    40.           </div>
    41.         </nz-content>
    42.         <nz-footer>Ant Design ©2020 Implement By Angular</nz-footer>
    43.       </nz-layout>
    44.     </nz-layout>
    45.   `,
    46.   styles: [
    47.     `
    48.       .trigger {
    49.         font-size: 18px;
    50.         line-height: 64px;
    51.         padding: 0 24px;
    52.         cursor: pointer;
    53.         transition: color 0.3s;
    54.       }
    56.       .trigger:hover {
    57.         color: #1890ff;
    58.       }
    60.       .logo {
    61.         height: 32px;
    62.         background: rgba(255, 255, 255, 0.2);
    63.         margin: 16px;
    64.       }
    66.       nz-header {
    67.         background: #fff;
    68.         padding: 0;
    69.       }
    71.       nz-content {
    72.         margin: 0 16px;
    73.       }
    75.       nz-breadcrumb {
    76.         margin: 16px 0;
    77.       }
    79.       .inner-content {
    80.         padding: 24px;
    81.         background: #fff;
    82.         min-height: 360px;
    84.       nz-footer {
    85.         text-align: center;
    86.       }
    87.     `
    88.   ]
    89. })
    90. export class NzDemoLayoutCustomTriggerComponent {
    91.   isCollapsed = false;
    92. }

    响应式布局

    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 nzCollapsible nzBreakpoint="lg" [nzCollapsedWidth]="0">
    8.         <div class="logo"></div>
    9.         <ul nz-menu nzTheme="dark" nzMode="inline">
    11.             <i nz-icon nzType="user"></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="user"></i>
    24.             <span>nav 4</span>
    25.           </li>
    26.         </ul>
    27.       </nz-sider>
    28.       <nz-layout>
    29.         <nz-header></nz-header>
    30.         <nz-content>
    31.           <div class="inner-content">
    32.             Content
    33.           </div>
    34.         </nz-content>
    35.         <nz-footer>Ant Design ©2020 Implement By Angular</nz-footer>
    36.       </nz-layout>
    37.     </nz-layout>
    38.   `,
    39.   styles: [
    40.     `
    41.       .layout {
    42.         min-height: 100vh;
    43.       }
    45.       .logo {
    46.         height: 32px;
    47.         background: rgba(255, 255, 255, 0.2);
    48.         margin: 16px;
    49.       }
    51.       nz-header {
    52.         background: #fff;
    53.         padding: 0;
    54.       }
    56.       nz-content {
    57.         margin: 24px 16px 0;
    58.       }
    60.       .inner-content {
    61.         padding: 24px;
    62.         background: #fff;
    63.         min-height: 360px;
    64.       }
    66.       nz-footer {
    67.         text-align: center;
    68.       }
    69.     `
    70.   ]
    71. })
    72. export class NzDemoLayoutResponsiveComponent {}

    Layout布局 - 图10

    固定头部

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

    固定侧边栏

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

    1. import { Component } from '@angular/core';
    3. @Component({
    4.   selector: 'nz-demo-layout-fixed-sider',
    5.   template: `
    6.     <nz-layout class="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 />... <br />...<br />...<br />...<br />...<br />...<br />...
    54.             <br />...<br />...<br />...<br />...<br />...<br />... <br />...<br />...<br />...<br />...<br />...<br />...
    55.             <br />...<br />...<br />...<br />...<br />...<br />... <br />...<br />...<br />...<br />...<br />...<br />...
    56.             <br />...<br />...<br />...<br />...<br />...<br />
    57.             content
    58.           </div>
    59.         </nz-content>
    60.         <nz-footer>Ant Design ©2020 Implement By Angular</nz-footer>
    61.       </nz-layout>
    62.     </nz-layout>
    63.   `,
    64.   styles: [
    65.     `
    66.       .logo {
    67.         height: 32px;
    68.         background: rgba(255, 255, 255, 0.2);
    69.         margin: 16px;
    70.       }
    72.       .layout {
    73.         min-height: 100vh;
    74.       }
    76.       nz-sider {
    77.         overflow: auto;
    78.         height: 100%;
    79.         position: fixed;
    80.         left: 0;
    81.       }
    83.       .right-layout {
    84.         margin-left: 200px;
    85.       }
    87.       nz-header {
    88.         background: #fff;
    89.         padding: 0;
    90.       }
    92.       nz-content {
    93.         margin: 24px 16px 0;
    94.         overflow: initial;
    95.       }
    97.       .inner-content {
    98.         padding: 24px;
    99.         background: #fff;
    100.         text-align: center;
    101.       }
    103.       nz-footer {
    104.         text-align: center;
    105.       }
    106.     `
    107.   ]
    108. })
    109. export class NzDemoLayoutFixedSiderComponent {}
    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>

    breakpoint width

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