目录— 个文件
⌕
目录加载中…
…/module/component/PageSnapDefine.ts
1/**
2 * 通用分页吸附组件定义
3 */
4
5/** 分页方向 */
6export enum PageSnapDirection {
7 Horizontal = 1,
8 Vertical = 2,
9}
10
11/** 分页手感预设 */
12export enum PageSnapTuningPreset {
13 Stable = 1,
14 Balanced = 2,
15 Snappy = 3,
16}
17
18/** 分页手感参数 */
19export interface PageSnapTuning {
20 horizontalLockStartDistance: number;
21 horizontalLockRatio: number;
22 verticalNoiseTolerance: number;
23 tapCancelDistance: number;
24 turnDistanceRatio: number;
25 flingVelocity: number;
26 flingMinDistance: number;
27 followSoftZoneRatio: number;
28 followDamping: number;
29 edgeResistance: number;
30 turnMinDuration: number;
31 turnMaxDuration: number;
32 snapBackDuration: number;
33}
34
35/** 外置分页手感参数表 */
36export const PAGE_SNAP_TUNING_TABLE: Record<PageSnapTuningPreset, PageSnapTuning> = {
37 [PageSnapTuningPreset.Stable]: {
38 horizontalLockStartDistance: 10,
39 horizontalLockRatio: 1.25,
40 verticalNoiseTolerance: 16,
41 tapCancelDistance: 18,
42 turnDistanceRatio: 0.2,
43 flingVelocity: 1250,
44 flingMinDistance: 42,
45 followSoftZoneRatio: 0.28,
46 followDamping: 0.38,
47 edgeResistance: 0.5,
48 turnMinDuration: 0.17,
49 turnMaxDuration: 0.28,
50 snapBackDuration: 0.15,
51 },
52 [PageSnapTuningPreset.Balanced]: {
53 horizontalLockStartDistance: 8,
54 horizontalLockRatio: 1.12,
55 verticalNoiseTolerance: 22,
56 tapCancelDistance: 18,
57 turnDistanceRatio: 0.18,
58 flingVelocity: 1100,
59 flingMinDistance: 36,
60 followSoftZoneRatio: 0.32,
61 followDamping: 0.42,
62 edgeResistance: 0.55,
63 turnMinDuration: 0.16,
64 turnMaxDuration: 0.26,
65 snapBackDuration: 0.14,
66 },
67 [PageSnapTuningPreset.Snappy]: {
68 horizontalLockStartDistance: 6,
69 horizontalLockRatio: 1.05,
70 verticalNoiseTolerance: 26,
71 tapCancelDistance: 20,
72 turnDistanceRatio: 0.15,
73 flingVelocity: 950,
74 flingMinDistance: 28,
75 followSoftZoneRatio: 0.36,
76 followDamping: 0.48,
77 edgeResistance: 0.58,
78 turnMinDuration: 0.14,
79 turnMaxDuration: 0.22,
80 snapBackDuration: 0.12,
81 },
82};
讲解83 行
分页参数人工通读
PageSnapDefine.ts
为 PageSnapComponent 提供方向枚举、三档手感枚举及完整参数表。参数按预设编号存放在导出的共享对象,分页器直接引用所选条目;字段名虽写横向和纵向,实际被当作主轴与副轴阈值复用于两种方向,没有运行时选择流程。
先核对两个枚举编号,再比较三档锁定阈值、甩动速度与动画时长。
特殊处理与易错点
- 设计预设从 Stable 到 Snappy 逐步降低方向锁距离与甩动门槛。
- 易错点表项是共享对象引用,修改内容会影响所有引用该预设的实例。
6注释通用分页吸附组件定义
12注释分页手感预设
19注释分页手感参数
20属性分页手感参数
21属性分页手感参数
22属性分页手感参数
23属性tap Cancel Distance(number):该模块的运行态字段。
24属性turn Distance Ratio(number):该模块的运行态字段。
25属性fling Velocity(number):该模块的运行态字段。
26属性fling 最小 Distance(number):该模块的运行态字段。
27属性follow Soft Zone Ratio(number):该模块的运行态字段。
28属性follow Damping(number):该模块的运行态字段。
29属性edge Resistance(number):该模块的运行态字段。
30属性turn 最小 Duration(number):该模块的运行态字段。
31属性turn 最大 Duration(number):该模块的运行态字段。
32属性snap Back Duration(number):该模块的运行态字段。
36注释外置分页手感参数表