List列表

通用列表。

何时使用

最基础的列表展示，可承载文字、列表、图片、段落，常用于后台数据展示页面。

单独引入此组件

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

  1. import { NzListModule } from 'ng-zorro-antd/list';

代码演示

List列表 - 图1

简单列表

列表拥有大、中、小三种尺寸。

通过设置 size 为 largesmall 分别把按钮设为大、小尺寸。若不设置 size，则尺寸为中。

可通过设置 nzHeader 和 nzFooter，来自定义列表头部和尾部。

  1. import { Component } from '@angular/core';
  2. import { NzMessageService } from 'ng-zorro-antd';
  4. @Component({
  5.   selector: 'nz-demo-list-simple',
  6.   template: `
  7.     <h3 [ngStyle]="{ 'margin-bottom.px': 16 }">Default Size</h3>
  8.     <nz-list [nzDataSource]="data" nzBordered [nzHeader]="'Header'" [nzFooter]="'Footer'" [nzRenderItem]="defaultItem">
  9.       <ng-template #defaultItem let-item>
  10.         <nz-list-item>
  11.           <span class="ant-typography"><mark>[ITEM]</mark></span>
  12.           {{ item }}
  13.         </nz-list-item>
  14.       </ng-template>
  15.     </nz-list>
  16.     <h3 [ngStyle]="{ margin: '16px 0' }">Small Size</h3>
  17.     <nz-list
  18.       [nzDataSource]="data"
  19.       nzBordered
  20.       nzSize="small"
  21.       [nzHeader]="'Header'"
  22.       [nzFooter]="'Footer'"
  23.       [nzRenderItem]="smallItem"
  24.     >
  25.       <ng-template #smallItem let-item><nz-list-item [nzContent]="item"></nz-list-item></ng-template>
  26.     </nz-list>
  27.     <h3 [ngStyle]="{ margin: '16px 0' }">Large Size</h3>
  28.     <ul
  29.       nz-list
  30.       [nzDataSource]="data"
  31.       nzBordered
  32.       nzSize="large"
  33.       [nzHeader]="'Header'"
  34.       [nzFooter]="'Footer'"
  35.       [nzRenderItem]="largeItem"
  36.     >
  37.       <ng-template #largeItem let-item>
  38.         <li nz-list-item [nzActions]="[opAction]" [nzContent]="item" nzNoFlex></li>
  39.         <ng-template #opAction><a (click)="msg.info('edit')">edit</a></ng-template>
  40.       </ng-template>
  41.     </ul>
  42.   `
  43. })
  44. export class NzDemoListSimpleComponent {
  45.   data = [
  46.     'Racing car sprays burning fuel into crowd.',
  47.     'Japanese princess to wed commoner.',
  48.     'Australian walks 100km after outback crash.',
  49.     'Man charged over missing wedding girl.',
  50.     'Los Angeles battles huge wildfires.'
  51.   ];
  53.   constructor(public msg: NzMessageService) {}
  54. }

List列表 - 图2

基础列表

基础列表。

  1. import { Component } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-list-basic',
  5.   template: `
  6.     <div style="margin-bottom: 8px;"><button nz-button (click)="change()">Switch Data</button></div>
  7.     <nz-list [nzDataSource]="data" [nzRenderItem]="item" [nzItemLayout]="'horizontal'" [nzLoading]="loading">
  8.       <ng-template #item let-item>
  9.         <nz-list-item>
  10.           <nz-list-item-meta
  11.             [nzTitle]="nzTitle"
  12.             nzAvatar="https://zos.alipayobjects.com/rmsportal/ODTLcjxAfvqbxHnVXCYX.png"
  13.             nzDescription="Ant Design, a design language for background applications, is refined by Ant UED Team"
  14.           >
  15.             <ng-template #nzTitle>
  16.               <a href="https://ng.ant.design">{{ item.title }}</a>
  17.             </ng-template>
  18.           </nz-list-item-meta>
  19.         </nz-list-item>
  20.       </ng-template>
  21.     </nz-list>
  22.   `
  23. })
  24. export class NzDemoListBasicComponent {
  25.   loading = false;
  26.   data = [
  27.     {
  28.       title: 'Ant Design Title 1'
  29.     },
  30.     {
  31.       title: 'Ant Design Title 2'
  32.     },
  33.     {
  34.       title: 'Ant Design Title 3'
  35.     },
  36.     {
  37.       title: 'Ant Design Title 4'
  38.     }
  39.   ];
  41.   change(): void {
  42.     this.loading = true;
  43.     if (this.data.length > 0) {
  44.       setTimeout(() => {
  45.         this.data = [];
  46.         this.loading = false;
  47.       }, 1000);
  48.     } else {
  49.       setTimeout(() => {
  50.         this.data = [
  51.           {
  52.             title: 'Ant Design Title 1'
  53.           },
  54.           {
  55.             title: 'Ant Design Title 2'
  56.           },
  57.           {
  58.             title: 'Ant Design Title 3'
  59.           },
  60.           {
  61.             title: 'Ant Design Title 4'
  62.           }
  63.         ];
  64.         this.loading = false;
  65.       }, 1000);
  66.     }
  67.   }
  68. }

List列表 - 图3

加载更多

可通过 loadMore 属性实现加载更多功能。

  1. // tslint:disable:no-any
  2. import { HttpClient } from '@angular/common/http';
  3. import { Component, OnInit } from '@angular/core';
  4. import { NzMessageService } from 'ng-zorro-antd';
  6. const count = 5;
  7. const fakeDataUrl = 'https://randomuser.me/api/?results=5&inc=name,gender,email,nat&noinfo';
  9. @Component({
  10.   selector: 'nz-demo-list-loadmore',
  11.   template: `
  12.     <nz-list
  13.       class="demo-loadmore-list"
  14.       [nzDataSource]="list"
  15.       [nzItemLayout]="'horizontal'"
  16.       [nzLoading]="initLoading"
  17.       [nzRenderItem]="item"
  18.       [nzLoadMore]="loadMore"
  19.     >
  20.       <ng-template #item let-item>
  21.         <nz-list-item
  22.           [nzContent]="item.loading ? '' : 'content'"
  23.           [nzActions]="item.loading ? [] : [editAction, moreAction]"
  24.         >
  25.           <nz-skeleton [nzAvatar]="true" [nzActive]="true" [nzTitle]="false" [nzLoading]="item.loading">
  26.             <ng-template #editAction><a (click)="edit(item)">edit</a></ng-template>
  27.             <ng-template #moreAction><a (click)="edit(item)">more</a></ng-template>
  28.             <nz-list-item-meta
  29.               [nzTitle]="nzTitle"
  30.               nzAvatar="https://zos.alipayobjects.com/rmsportal/ODTLcjxAfvqbxHnVXCYX.png"
  31.               nzDescription="Ant Design, a design language for background applications, is refined by Ant UED Team"
  32.             >
  33.               <ng-template #nzTitle>
  34.                 <a href="https://ng.ant.design">{{ item.name.last }}</a>
  35.               </ng-template>
  36.             </nz-list-item-meta>
  37.           </nz-skeleton>
  38.         </nz-list-item>
  39.       </ng-template>
  40.       <ng-template #loadMore>
  41.         <div class="loadmore">
  42.           <button nz-button *ngIf="!loadingMore" (click)="onLoadMore()">loading more</button>
  43.         </div>
  44.       </ng-template>
  45.     </nz-list>
  46.   `,
  47.   styles: [
  48.     `
  49.       .demo-loadmore-list {
  50.         min-height: 350px;
  51.       }
  52.       .loadmore {
  53.         text-align: center;
  54.         margin-top: 12px;
  55.         height: 32px;
  56.         line-height: 32px;
  57.       }
  58.     `
  59.   ]
  60. })
  61. export class NzDemoListLoadmoreComponent implements OnInit {
  62.   initLoading = true; // bug
  63.   loadingMore = false;
  64.   data: any[] = [];
  65.   list: Array<{ loading: boolean; name: any }> = [];
  67.   constructor(private http: HttpClient, private msg: NzMessageService) {}
  69.   ngOnInit(): void {
  70.     this.getData((res: any) => {
  71.       this.data = res.results;
  72.       this.list = res.results;
  73.       this.initLoading = false;
  74.     });
  75.   }
  77.   getData(callback: (res: any) => void): void {
  78.     this.http.get(fakeDataUrl).subscribe((res: any) => callback(res));
  79.   }
  81.   onLoadMore(): void {
  82.     this.loadingMore = true;
  83.     this.list = this.data.concat([...Array(count)].fill({}).map(() => ({ loading: true, name: {} })));
  84.     this.http.get(fakeDataUrl).subscribe((res: any) => {
  85.       this.data = this.data.concat(res.results);
  86.       this.list = [...this.data];
  87.       this.loadingMore = false;
  88.     });
  89.   }
  91.   edit(item: any): void {
  92.     this.msg.success(item.email);
  93.   }
  94. }

List列表 - 图4

竖排列表样式

通过设置 nzItemLayout 属性为 vertical 可实现竖排列表样式。

  1. import { Component, OnInit } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-list-vertical',
  5.   template: `
  6.     <nz-list
  7.       [nzDataSource]="data"
  8.       [nzItemLayout]="'vertical'"
  9.       [nzRenderItem]="item"
  10.       [nzPagination]="pagination"
  11.       [nzFooter]="footer"
  12.     >
  13.       <ng-template #item let-item>
  14.         <nz-list-item [nzContent]="item.content" [nzActions]="[starAction, likeAction, msgAction]" [nzExtra]="extra">
  15.           <ng-template #starAction><i nz-icon nzType="star-o" style="margin-right: 8px;"></i> 156</ng-template>
  16.           <ng-template #likeAction><i nz-icon nzType="like-o" style="margin-right: 8px;"></i> 156</ng-template>
  17.           <ng-template #msgAction><i nz-icon nzType="message" style="margin-right: 8px;"></i> 2</ng-template>
  18.           <nz-list-item-meta [nzAvatar]="item.avatar" [nzTitle]="nzTitle" [nzDescription]="item.description">
  19.             <ng-template #nzTitle
  20.               ><a href="{{ item.href }}">{{ item.title }}</a></ng-template
  21.             >
  22.           </nz-list-item-meta>
  23.           <ng-template #extra>
  24.             <img width="272" alt="logo" src="https://gw.alipayobjects.com/zos/rmsportal/mqaQswcyDLcXyDKnZfES.png" />
  25.           </ng-template>
  26.         </nz-list-item>
  27.       </ng-template>
  28.       <ng-template #footer>
  29.         <div><b>ant design</b> footer part</div>
  30.       </ng-template>
  31.       <ng-template #pagination>
  32.         <nz-pagination [nzPageIndex]="1" [nzTotal]="50" (nzPageIndexChange)="loadData($event)"></nz-pagination>
  33.       </ng-template>
  34.     </nz-list>
  35.   `
  36. })
  37. export class NzDemoListVerticalComponent implements OnInit {
  38.   // tslint:disable-next-line:no-any
  39.   data: any[] = [];
  41.   ngOnInit(): void {
  42.     this.loadData(1);
  43.   }
  45.   loadData(pi: number): void {
  46.     this.data = new Array(5).fill({}).map((_, index) => {
  47.       return {
  48.         href: 'http://ant.design',
  49.         title: `ant design part ${index} (page: ${pi})`,
  50.         avatar: 'https://zos.alipayobjects.com/rmsportal/ODTLcjxAfvqbxHnVXCYX.png',
  51.         description: 'Ant Design, a design language for background applications, is refined by Ant UED Team.',
  52.         content:
  53.           'We supply a series of design principles, practical patterns and high quality design resources (Sketch and Axure), to help people create their product prototypes beautifully and efficiently.'
  54.       };
  55.     });
  56.   }
  57. }

List列表 - 图5

栅格列表

可以通过设置 nz-list 的 grid 属性来实现栅格列表，column 可设置期望显示的列数。

  1. import { Component } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-list-grid',
  5.   template: `
  6.     <nz-list [nzDataSource]="data" [nzRenderItem]="item" [nzGrid]="{ gutter: 16, span: 6 }">
  7.       <ng-template #item let-item>
  8.         <nz-list-item [nzContent]="nzContent">
  9.           <ng-template #nzContent>
  10.             <nz-card [nzTitle]="item.title">
  11.               Card content
  12.             </nz-card>
  13.           </ng-template>
  14.         </nz-list-item>
  15.       </ng-template>
  16.     </nz-list>
  17.   `
  18. })
  19. export class NzDemoListGridComponent {
  20.   data = [
  21.     {
  22.       title: 'Title 1'
  23.     },
  24.     {
  25.       title: 'Title 2'
  26.     },
  27.     {
  28.       title: 'Title 3'
  29.     },
  30.     {
  31.       title: 'Title 4'
  32.     }
  33.   ];
  34. }

List列表 - 图6

响应式的栅格列表

响应式的栅格列表。尺寸与 Layout Grid 保持一致。

  1. import { Component } from '@angular/core';
  3. @Component({
  4.   selector: 'nz-demo-list-resposive',
  5.   template: `
  6.     <nz-list [nzDataSource]="data" [nzRenderItem]="item" [nzGrid]="{ gutter: 16, xs: 24, sm: 12, md: 6, lg: 6, xl: 4 }">
  7.       <ng-template #item let-item>
  8.         <nz-list-item [nzContent]="nzContent">
  9.           <ng-template #nzContent>
  10.             <nz-card [nzTitle]="item.title">
  11.               Card content
  12.             </nz-card>
  13.           </ng-template>
  14.         </nz-list-item>
  15.       </ng-template>
  16.     </nz-list>
  17.   `
  18. })
  19. export class NzDemoListResposiveComponent {
  20.   data = [
  21.     {
  22.       title: 'Title 1'
  23.     },
  24.     {
  25.       title: 'Title 2'
  26.     },
  27.     {
  28.       title: 'Title 3'
  29.     },
  30.     {
  31.       title: 'Title 4'
  32.     },
  33.     {
  34.       title: 'Title 5'
  35.     },
  36.     {
  37.       title: 'Title 6'
  38.     }
  39.   ];
  40. }

List列表 - 图7

滚动加载无限长列表

结合 cdk-virtual-scroll 实现滚动加载无限长列表，带有虚拟化 virtualization 功能，能够提高数据量大时候长列表的性能。

Virtualized 是在大数据列表中应用的一种技术，主要是为了减少不可见区域不必要的渲染从而提高性能，特别是数据量在成千上万条效果尤为明显。

  1. // tslint:disable:no-any
  2. import { CollectionViewer, DataSource } from '@angular/cdk/collections';
  3. import { HttpClient } from '@angular/common/http';
  4. import { ChangeDetectionStrategy, Component } from '@angular/core';
  5. import { BehaviorSubject, Observable, Subscription } from 'rxjs';
  7. @Component({
  8.   selector: 'nz-demo-list-infinite-load',
  9.   template: `
  10.     <div>
  11.       <cdk-virtual-scroll-viewport itemSize="73" class="demo-infinite-container">
  12.         <nz-list>
  13.           <nz-list-item *cdkVirtualFor="let item of ds">
  14.             <nz-skeleton *ngIf="!item" [nzAvatar]="true" [nzParagraph]="{ rows: 1 }"></nz-skeleton>
  15.             <nz-list-item-meta
  16.               *ngIf="item"
  17.               [nzTitle]="nzTitle"
  18.               nzAvatar="https://zos.alipayobjects.com/rmsportal/ODTLcjxAfvqbxHnVXCYX.png"
  19.               [nzDescription]="item.email"
  20.             >
  21.               <ng-template #nzTitle>
  22.                 <a href="https://ng.ant.design">{{ item.name.last }}</a>
  23.               </ng-template>
  24.             </nz-list-item-meta>
  25.           </nz-list-item>
  26.         </nz-list>
  27.       </cdk-virtual-scroll-viewport>
  28.     </div>
  29.   `,
  30.   styles: [
  31.     `
  32.       .demo-infinite-container {
  33.         height: 300px;
  34.         border: 1px solid #e8e8e8;
  35.         border-radius: 4px;
  36.       }
  38.       nz-list {
  39.         padding: 24px;
  40.       }
  41.     `
  42.   ],
  43.   changeDetection: ChangeDetectionStrategy.OnPush
  44. })
  45. export class NzDemoListInfiniteLoadComponent {
  46.   ds = new MyDataSource(this.http);
  48.   constructor(private http: HttpClient) {}
  49. }
  51. class MyDataSource extends DataSource<string | undefined> {
  52.   private length = 100000;
  53.   private pageSize = 10;
  54.   private cachedData = Array.from<any>({ length: this.length });
  55.   private fetchedPages = new Set<number>();
  56.   private dataStream = new BehaviorSubject<any[]>(this.cachedData);
  57.   private subscription = new Subscription();
  59.   constructor(private http: HttpClient) {
  60.     super();
  61.   }
  63.   connect(collectionViewer: CollectionViewer): Observable<any[]> {
  64.     this.subscription.add(
  65.       collectionViewer.viewChange.subscribe(range => {
  66.         const startPage = this.getPageForIndex(range.start);
  67.         const endPage = this.getPageForIndex(range.end - 1);
  68.         for (let i = startPage; i <= endPage; i++) {
  69.           this.fetchPage(i);
  70.         }
  71.       })
  72.     );
  73.     return this.dataStream;
  74.   }
  76.   disconnect(): void {
  77.     this.subscription.unsubscribe();
  78.   }
  80.   private getPageForIndex(index: number): number {
  81.     return Math.floor(index / this.pageSize);
  82.   }
  84.   private fetchPage(page: number): void {
  85.     if (this.fetchedPages.has(page)) {
  86.       return;
  87.     }
  88.     this.fetchedPages.add(page);
  90.     this.http
  91.       .get(`https://randomuser.me/api/?results=${this.pageSize}&inc=name,gender,email,nat&noinfo`)
  92.       .subscribe((res: any) => {
  93.         this.cachedData.splice(page * this.pageSize, this.pageSize, ...res.results);
  94.         this.dataStream.next(this.cachedData);
  95.       });
  96.   }
  97. }

API

nz-listcomponent

参数说明类型默认值
[nzDataSource]列表数据源any[]-
[nzRenderItem]自定义列表项TemplateRef<void>-
[nzBordered]是否展示边框booleanfalse
[nzFooter]列表底部string | TemplateRef<void>-
[nzGrid]列表栅格配置object-
[nzHeader]列表头部string | TemplateRef<void>-
[nzItemLayout]设置 nz-list-item 布局, 设置成 vertical 则竖直样式显示, 默认横排'vertical' | 'horizontal''horizontal'
[nzLoading]当卡片内容还在加载中时，可以用 loading 展示一个占位booleanfalse
[nzLoadMore]加载更多TemplateRef<void>-
[nzNoResult]当列表为空时加载的内容string | TemplateRef<void>-
[nzPagination]对应的 pagination 配置TemplateRef<void>-
[nzSize]list 的尺寸'large' | 'small' | 'default''default'
[nzSplit]是否展示分割线booleantrue

nzGrid

参数说明类型默认值
column列数number-
gutter栅格间隔number0
xs<576px 展示的列数number-
sm≥576px 展示的列数number-
md≥768px 展示的列数number-
lg≥992px 展示的列数number-
xl≥1200px 展示的列数number-
xxl≥1600px 展示的列数number-

nz-list-itemcomponent

参数说明类型默认值
[nzContent]内容项string | TemplateRef<void>-
[nzActions]列表操作组，根据 nzItemLayout 的不同, 位置在卡片底部或者最右侧。Array<TemplateRef<void><void>>-
[nzExtra]额外内容, 通常用在 nzItemLayout 为 vertical 的情况下, 展示右侧内容; horizontal 展示在列表元素最右侧TemplateRef<void>-
[nzNoFlex]是否非 flex 布局渲染booleanfalse

nz-list-item-metacomponent

参数说明类型默认值
[nzAvatar]列表元素的图标string | TemplateRef<void>-
[nzDescription]列表元素的描述内容string | TemplateRef<void>-
[nzTitle]列表元素的标题string | TemplateRef<void>-