Navigator
Navigator 组件添加用于在数据集之间进行导航的分页控件。它可以显示首页、末页、下一页和上一页按钮，以及页面数字或快速跳转字段，并在不适用时自动禁用控件。它绑定到 Paginator 实例，以管理底层分页逻辑。
绑定到仓库
通常，Navigator 组件显示绑定到 Repository 的信息。这个绑定使得 Navigator 能够自动分页管理由仓库管理的数据，并根据导航的数据刷新其他可绑定的组件，例如表格。
为此，只需将所需的 Repository 对象传递给相应的 Navigator 对象的构造函数：
显示代码
- NavigatorTableView.java
此示例创建 Navigator 和 Table，并使用相同的 Repository 实例。这意味着当导航到新页面时，Navigator 会识别此更改并重新渲染 Table。
分页
Navigator 组件与 Paginator 模型类紧密相关，计算分页元数据，例如总页数、当前页的项目起始/结束索引，以及用于导航的页码数组。
虽然不是绝对必要，使用 Paginator 能够增强导航背后的逻辑。当与 Paginator 集成时，导航器会响应 Paginator 内的任何更改。Navigator 对象可以通过使用 getPaginator() 方法访问内置的 Paginator，也可以通过 setPaginator() 方法接受 Paginator 实例，或利用其中一个适用的构造函数。
本节包含实用代码示例，以说明此集成在实践中是如何工作的。
项目
术语“项目”指的是单个分页元素或数据条目。这些可以是记录、条目或数据集中的任何离散单位。您可以使用 setTotalItems() 方法来设置总项目数。
navigator.getPaginator().setTotalItems(totalItems);
与 Paginator 实例关联的仓库具有由仓库直接管理的总项目数，不能直接设置。
最大页面
setMax() 方法允许您定义在分页导航中显示的最大页面链接数。当处理大量页面时，这非常有用，因为它控制用户在任何给定时间可以看到的页面链接数量。
navigator.getPaginator().setMax(maxPages);
显示代码
- NavigatorPagesView.java
该程序在 Navigator 上最多显示五个页面，使用 getPaginator() 方法检索与 Navigator 对象关联的 Paginator，并使用 setMax() 方法指定期望的最大显示页面数量。
页面大小
setSize() 方法允许您指定在每个分页页面上显示的项目数量。当您调用此方法并提供一个新的页面大小时，它会相应地调整分页。
navigator.getPaginator().setSize(pageSize);
自定义按钮、文本和工具提示
Navigator 组件提供了广泛的按钮、文本和工具提示自定义选项。要更改 Navigator 组件上显示的文本，请使用 setText() 方法。此方法接受文本以及所需的 Navigator 部件。
在下面的示例中，setText() 方法向用户显示一个数字值。点击按钮会触发 Navigator 的 onChange 方法，该方法带有被点击按钮的 Direction 值。
显示代码
- NavigatorBasicView.java
按钮和组件文本
setText() 方法将文本参数评估为 JavaScript 表达式，使用以下参数：
page- 当前页码current- 当前选定的页码x- 当前页面的别名startIndex- 当前页面的起始索引。endIndex- 当前页面的结束索引。totalItems- 项目总数。startPage- 起始页码。endPage- 结束页码。component- Navigator 客户端组件。
例如，要在具有 10 页的 Navigator 中将最后一页按钮的文本设置为“转到第 10 页”，使用以下代码片段：
navigator.setText("'Go to page ' + endPage", Navigator.Part.LAST_BUTTON);
工具提示文本
您可以使用 setTooltipText() 方法自定义 Navigator 组件各部分的工具提示。当用户悬停在导航元素上时，工具提示为用户提供有用的提示。
与 setText() 方法使用的文本不同，工具提示文本不评估为 JavaScript。
例如，要将 Navigator 中最后一页按钮的工具提示文本设置为“转到最后一页”，使用以下代码片段：
navigator.setTooltipText("Go to the last page", Navigator.Part.LAST_BUTTON);
布局
Navigator 组件有多种布局选项，可用于提供灵活的分页控件显示。要访问这些布局，请使用 Navigator.Layout 枚举的值。选项如下：
显示代码
- NavigatorLayoutView.java
1. 无布局
NONE 布局在 Navigator 中不渲染任何文本，仅显示导航按钮而没有默认的文本显示。要激活此布局，请使用：
navigator.setLayout(Navigator.Layout.NONE);
2. 编号布局
编号布局显示与 Navigator 的显示区域中的每一页相对应的编号芯片。使用此布局非常适合用户希望直接导航到特定页面的场景。要激活此布局，请使用：
navigator.setLayout(Navigator.Layout.PAGES);
3. 预览布局
预览布局显示当前页码和总页数，适用于空间有限的紧凑型分页界面。
预览是默认的 Navigator 布局。
要激活此布局，请使用：
navigator.setLayout(Navigator.Layout.PREVIEW);
4. 快速跳转布局
快速跳转布局提供了一个 NumberField，供用户输入页面号码以进行快速导航。当用户需要快速导航到特定页面时，特别是对于大型数据集非常有用。要激活此布局，请使用：
navigator.setLayout(Navigator.Layout.QUICK_JUMP);
样式
最佳实践
为确保使用 Navigator 组件时获得最佳用户体验，请考虑以下最佳实践：
-
理解数据集：在将
Navigator组件集成到您的应用程序之前，全面了解用户的数据浏览需求。考虑数据集的大小、典型用户交互和首选导航模式等因素。 -
选择适当的布局：选择一个与用户体验目标和可用屏幕空间相符的
Navigator组件布局。 -
自定义文本和工具提示：自定义
Navigator组件的文本和工具提示，以匹配您应用程序中使用的语言和术语。提供描述性标签和有用的提示以帮助用户有效导航数据集。