Angular Material 分页器测试的 API 参考

import {MatPaginatorModule} from '@angular/material/paginator';

要修改显示的标签和文本,就要创建一个新的 MatPaginatorIntl 实例,并把它包含在自定义提供者中

属性
名称 描述

changes: Subject<void>

当标签发生变化时,要触发这个流。当初始化之后标签再发生变化时,用它来通知组件。

firstPageLabel: string

移动到第一页按钮的标签。

getRangeLabel: (page: number, pageSize: number, length: number) => string

当前分页当中条目范围的标签,以及整个列表的长度。

itemsPerPageLabel: string

分页大小选择器的标签。

lastPageLabel: string

移动到最后一页按钮的标签。

nextPageLabel: string

用于增加当前分页按钮的标签。

previousPageLabel: string

用于减小当前分页按钮的标签。

用于提供分页式信息导航的组件。显示当前分页的大小、用户可选的改变分页大小的选项、要显示的条目以及用于转到上一页或下一页的导航按钮。

选择器: mat-paginator

Exported as: matPaginator
属性
名称 描述
@Input()

color: ThemePalette

要用于底层表单的主题颜色。

@Input({ transform: booleanAttribute })

disabled: boolean

分页器是否被禁用。

@Input({ transform: booleanAttribute })

hidePageSize: boolean

是否隐藏用户的分页大小选择器界面。

@Input({ transform: numberAttribute })

length: number

被分页的条目总长度。默认为 0。

@Input({ transform: numberAttribute })

pageIndex: number

显示的条目列表中从零开始的分页索引。默认为 0。

@Input({ transform: numberAttribute })

pageSize: number

每页显示的条目数。默认情况下,设置为 50。

@Input()

pageSizeOptions: number[]

要显示给用户的分页大小选项的集合。

@Input()

selectConfig: MatPaginatorSelectConfig

用于配置分页器内部的底层 MatSelect

@Input({ transform: booleanAttribute })

showFirstLastButtons: boolean

是否要向用户显示第一个/最后一个按钮界面。

@Output()

page: EventEmitter<PageEvent>

当分页器改变分页大小或分页索引时会发生事件。

initialized: Observable<void>

分页器初始化时发出。

方法
firstPage

如果不在第一页,请移动到第一页。

getNumberOfPages

计算页数

返回值
number

hasNextPage

是否有下一页。

返回值
boolean

hasPreviousPage

是否有上一页。

返回值
boolean

lastPage

如果不在最后一页,就移动到最后一页。

nextPage

如果存在,就进入下一页。

previousPage

如果存在,就回到上一页。

当用户选择不同的分页大小或导航到另一个分页时,会改变这个事件对象。

属性
名称 描述

length: number

当前正被分页的条目总数。

pageIndex: number

当前的分页索引。

pageSize: number

当前分页大小。

previousPageIndex: number

以前选择过的分页索引。

可用于在 MatPaginator 中配置底层 MatSelectMatPaginator

属性
名称 描述

disableOptionCentering: boolean

是否要把活动选项置于触发器的中心位置。

panelClass: string | string[] | Set<string> | { [key: string]: any; }

要传递给选择器面板的类。

可用于配置分页器模块默认选项的对象。

属性
名称 描述

formFieldAppearance: MatFormFieldAppearance

要应用于分页大小选项选择器的默认表单字段外观。

hidePageSize: boolean

是否隐藏用户的分页大小选择器界面。

pageSize: number

每页显示的条目数。默认情况下,设置为 50。

pageSizeOptions: number[]

要显示给用户的分页大小选项的集合。

showFirstLastButtons: boolean

是否要向用户显示第一个/最后一个按钮界面。

这个注入令牌可以用来为分页器模块提供默认选项。

const MAT_PAGINATOR_DEFAULT_OPTIONS: InjectionToken<MatPaginatorDefaultOptions>;