Refresher
下拉刷新是在移动设备和友好的接口中常见的模式，而 Refresher 组件将其引入到 webforJ 的可滚动容器中。当用户向下滑动超过可配置的阈值时，它会通过视觉状态进行转换：pull、release 和 refreshing，每个状态都有可自定义的图标和本地化文本。它与 InfiniteScroll 配合良好，通过手势输入来重新加载或重置内容。
实例化和国际化
通过实例化 Refresher 并注册一个刷新监听器来添加一个 Refresher。当刷新操作完成时，调用 finish() 将组件重置为闲置状态。
Refresher要激活 Refresher，点击并向下拖动可滚动区域的顶部。虽然这一手势在移动设备上是常见的，但在桌面上并不那么常见—请确保用鼠标按住并拉动。
显示代码
- RefresherView.java
- refresher.css
这种方法通常用于刷新分页列表或重新启动无限滚动加载。
国际化
每个状态标签也可以使用 RefresherI18n 对象进行本地化。这三个状态是：
- Pull: 初始手势文本（例如，“向下拉以刷新”）
- Release: 达到触发阈值（例如，“释放以 刷新”）
- Refresh: 加载状态（例如，“正在刷新”）
这允许多语言支持和需要时的品牌调整。
显示代码
- RefresherI18nView.java
- refresher.css
图标自定义
您可以使用预定义的 Icon 或 图标 URL 来更改 pull/release 和 refreshing 阶段使用的图标。这在您想要应用品牌或自定义动画时非常有用。
显示代码
- RefresherIconView.java
- refresher.css
下拉行为配置
阈值
设置用户必须下拉的距离（以像素为单位），以触发刷新：
refresher.setThreshold(80); // 默认: 80px
阈值最大值
要定义允许的最大下拉距离，请使用 setThresholdMax() 方法：
refresher.setThresholdMax(160);
这些阈值控制手势的灵敏度和阻力曲线。
状态管理
Refresher 组件维护自己的内部状态，并通过事件传递状态变化。当用户下拉超过定义的阈值时，Refresher 会发出一个刷新事件，您可以通过注册 onRefresh() 监听器来响应。
在这个监听器中，您可以执行所需的操作，例如获取新数据或重置列表，然后明确调用：
refresher.finish();
finish()如果您忘记调用 finish()，刷新器将无限期保持在加载状态。
您还可以在任何时候程序性地禁用 Refresher，以防止用户触发刷新行为：
refresher.setEnabled(false);
这在需要临时禁止刷新时非常有用，例如，在加载屏幕上或当另一个关键过程正在运行时。
样式
主题
Refresher 组件支持多种主题，以便在视觉上区分不同状态或与您应用的外观和感觉相匹配。可以使用 setTheme() 方法应用主题。
以下示例每次您下拉以刷新时都会循环访问所有可用主题，给您提供 Refresher 在不同主题下的实时预览：
显示代码
- RefresherThemesView.java
- refresher.css