@g9tm/lynxcontrols - 进度覆盖
一个用于长期业务的共享重叠 G9MAUIControls.ProgressOverlay租赁、进度、取消、,
最小化到可拖动的气泡、成功和失败终端。 取决于 @g9tm/lynxcontrols-foundation 财务报告和审定财务报表
@g9tm/lynxcontrols 只有这个 移徙表: docs/migration/ProgressOverlay.md。 。 。 .
import { g9ProgressReport, useG9ProgressOverlay } from '@g9tm/lynxcontrols-progress-overlay';
const progress = useG9ProgressOverlay(); // or g9ProgressOverlay() outside components (active host)
const lease = await progress.show('Uploading samples', 'bottom');
try {
progress.report(0.048, 'Uploading', '12 of 250');
progress.report(g9ProgressReport.indeterminate('Connecting'));
progress.reportQueued(3); // "+3 waiting"
await upload();
await progress.tryShowCurrentSuccess('250 samples uploaded');
} catch (error) {
await progress.tryShowCurrentFailure('Server unreachable', 'Retry', () => upload());
} finally {
await lease.dispose(); // the last lease waits until the terminal state was seen
}
const off = progress.onCancelRequested(() => uploader.cancel());
// The host decides where an overlay shown without a position sits (MAUI 1.3.0), and moves a live one on a screen change.
progress.placementProvider = () => (mapTabShown ? { position: 'top', offset: mapTopBarHeight } : null);
onTabChanged(() => void progress.refreshPlacement());
行为
- 租赁. 并行操作每个都有一个可视化的租赁;最古老的是运行中的(其上下文文本) 显示),其余部分被排队. 将正在运行的租借权将视图交到下一个; 上一个时, 覆盖关闭 租借是在看到其终点状态后解除的.
- 报告 被连接到 ~ 10 Hz , 并且只驱动运行状态; 不确定的报告不会移动栏.
- 取消 (a44×44目标) 立即切换到取消和广播到
onCancelRequested听众 A 类 取消绝不是一个错误: 当运行停止时, 覆盖关闭, 并且中立的“ 取消” 土司显示; 如果 步骤不能被中断,通知出现在 5 s 之后. - 终端 总是强迫满卡。 成功记录为2.2 s(倒计时栏)。 失败等待用户: 重试
重排为运行并运行一次动作( 第二次水龙头加入它); 关闭确认.
showStandaloneFailure显示一个没有运行的失败 . - 尽量减少. 把运行中的卡片压到72×72泡(Lynx-ui)
Draggable); 敲打气泡声 复还之. - 放置. 下( 默认) 或上, 位于主机下方的内置值上方( O)
bottomWithTabBar或在其顶部内置, 14 px入;土司起于下方上方. 打电话refreshBottomInset()在标签栏隐藏或返回(它)之后 滑翔机220毫秒). - 主机放置 (马来语: 1.3.0). 正确的位置取决于屏幕,而不是谁开始工作:设置
服务
placementProvider(它接收主机并返回){ position, offset },边缘加额外距离 从那个边缘的陷入,或null默认g9ProgressOverlayPlacement.default) (中文(简体) ). 显示覆盖 无 后面有一个位置:在覆盖上架时会读取提供者,以及refreshPlacement()移动活页 当它下面的屏幕改变时(一个标签开关,一个全屏幕工作表). 同一边滑翔的相抵变化 边缘变化在旧边缘和新边缘逐渐消失(滑翔会把牌扫到整个屏幕上);refreshPlacement(false)跳跃。 显示覆盖 与 一个能维持生命的姿势 一个最小的气泡 永远不会移动。 抛出提供者倒回默认值(带有控制台警告).
桌面上泡泡拖曳是一个设备检查(ledger N-047);放置运动为N-060.