文章目录前言真正值得先看的不是细节代码分页吸附的重点是让滚动有“翻页感”代码别平均看先抓关键方法第一段关键代码页面是怎么被带起来的第二段关键代码真正决定交互手感的地方不是只看最好按这个顺序动手拿去项目里之前我通常会做这些调整这页不复杂但很适合当模板完整代码收个尾前言分页吸附和普通吸附最大的区别是它更强调“翻页感”而不是“滚动感”。用户会明显感觉自己从一页切到下一页。这个案例很适合做沉浸式浏览效果练习。 真到项目里很多问题都不是“会不会用组件”而是“这个组件放在当前页面里顺不顺手”。所以这篇不会只盯 API而是把页面结构、交互反馈和后续扩展一起看。如果把这页当成练习材料我会优先看它怎样围绕 snapPagination 分页停靠与整屏切换 组织页面。因为这一层想清楚了后面的代码基本就不会散。这类写法尤其适合落在 全屏卡片、图文翻页、专题页浏览 这些场景里所以我下面不会只讲“组件怎么写”而是更关心“放进页面之后为什么这样组织”。真正值得先看的不是细节代码如果你已经打开运行效果会更容易理解这一段。因为这页并不是靠某一个孤立控件撑起来的而是几个区域互相配合才成立。页面区域主要职责在代码里的典型表现| 头部说明区 | 交代当前案例在演示什么 |Text标题、补充说明、标签文案 || 核心展示区 | 承载组件能力的主要效果 |Column、Row、业务组件本体 || 辅助信息区 | 补充状态、标签、分组或统计信息 | 次级文本、角标、分组标题、描述块 || 交互入口区 | 负责切换、返回、定位、选择等动作 | 点击事件、按钮、索引条、导航入口 |页面里额外定义的数据模型包括Item。如果后面准备接接口我更建议把这些类型继续收口成更直白的业务命名。如果你不是只想看懂而是准备拿去改这篇更关注哪些区域适合抽离、复用和替换。分页吸附的重点是让滚动有“翻页感”这页的状态很少isShow也不是重点。真正影响体验的是snapPaginationtrue它会让用户感觉自己不是随意滑动而是在一页一页地切换内容。这类页面要特别关注三件事每页内容要完整page、desc、背景色一起构成一个独立页面不适合放太碎的信息。宽度要接近视口只有每项足够像“一页”分页吸附才自然。滑动反馈要明确用户松手后停在下一页而不是停在半截位置。所以snapPagination更适合专题页、图文翻页、沉浸式卡片不适合信息密度很高的普通列表。代码别平均看先抓关键方法如果你想更快进入状态可以把这些方法当成页面的控制台。哪个方法被触发页面就往哪个方向走。这个案例没有太多额外方法核心价值主要集中在页面结构和组件组合方式。我自己读这类方法时通常只抓一条线谁触发、谁被改、页面哪里立刻有反馈。把这三件事连起来很多交互代码一下就顺了。第一段关键代码页面是怎么被带起来的这一段建议慢一点看。它通常决定了页面初始状态也决定了后续哪些区域会跟着刷新。StateisShow:booleantruebuild(){Column(){if(this.isShow){Column(){Text(snapPagination 分页吸附).fontSize(18).fontWeight(FontWeight.Bold).fontColor(#E67E22).margin({bottom:4})Text(snapPaginationtrue整页翻页效果).fontSize(12).fontColor(DEMO_SUBTEXT_COLOR).margin({bottom:12})}.width(100%).alignItems(HorizontalAlign.Start)Scroll(){Row(){ForEach([{page:A,color:#FF6B6B,desc:第一页内容},{page:B,color:#4ECDC4,desc:第二页内容},{page:C,color:#FFD93D,desc:第三页内容},{page:D,color:#6BCB77,desc:第四页内容},{page:E,color:#4D96FF,desc:第五页内容}],(item:ScrollsnapPaginationModeItem,index:number){Column(){Text(item.page).fontSize(64).fontWeight(FontWeight.Bold).fontColor(#FFFFFF)这一段我通常不会一下翻过去而是先确认下面这几个判断点State字段到底在控制显示、选择、跳转结果还是模式切换。默认值是不是合理页面一打开会不会就落在一个可理解的状态上。字段命名能不能让后来的人一眼看懂用途而不是还要翻半天 UI。第二段关键代码真正决定交互手感的地方这段代码的核心是把每一项都设计成一张“页面”。page是主视觉desc是说明背景色负责区分页面再由分页吸附把它们串成连续翻页体验。/** * 分页吸附滚动页 */import{PRESET_COLORS,generateListItems,DEMO_BG_COLOR,DEMO_CARD_COLOR,DEMO_THEME_COLOR,DEMO_SUBTEXT_COLOR}from./typesinterfaceScrollsnapPaginationModeItem{page:stringcolor:stringdesc:string}EntryComponentstruct ScrollsnapPaginationMode{StateisShow:booleantruebuild(){Column(){if(this.isShow){Column(){Text(snapPagination 分页吸附).fontSize(18).fontWeight(FontWeight.Bold).fontColor(#E67E22).margin({bottom:4})Text(snapPaginationtrue整页翻页效果).fontSize(12).fontColor(DEMO_SUBTEXT_COLOR).margin({bottom:12})代码读到这里我通常会顺手补三件事不然后面很容易只看热闹这个交互入口接收的到底是什么输入。输入进来之后代码改了哪个状态或者触发了哪次导航。变化发生后用户最先感知到的反馈会落在哪个区域。这三个问题串起来之后这一页基本就不只是“看过”而是真的读懂了。不是只看最好按这个顺序动手我比较推荐用“观察 - 触发 - 对照源码”的方式学这个页面。先看到效果再回去找原因记得会更牢。先进入页面确认首屏是不是把分页吸附滚动页的主题交代清楚。盯住核心展示区观察默认状态下最醒目的内容是什么。主动触发一次关键交互比如点击、滑动、跳转、返回、切换或者选择。回头检查状态区、提示区、标题区或者附属信息有没有跟着变化。最后再打开源码对照刚才那次交互把状态变化链路串起来。如果这五步你能边操作边说清楚页面发生了什么后面再换成自己的数据和交互心里会稳很多。拿去项目里之前我通常会做这些调整如果只把这页当 demo 看它的价值其实只发挥了一半。更值得做的是顺手想一遍放进项目之后哪里该抽哪里该换哪里该收口。吸附滚动别只调参数子项尺寸、容器留白和预览区域通常比 API 本身更影响体感。如果页面同时存在自由浏览和精准停靠两种需求最好把吸附开关当成正式状态来设计。只要页面里有重复块就别硬撑着手写到底早点抽成小组件后面改样式和改交互都会轻松很多。示例数据最好和布局代码分开放不然后面一接接口页面文件很容易立刻变臃肿。这页不复杂但很适合当模板如果你经常做业务页会发现这种案例特别适合复用思路。它不像单纯 API 示例那样看完就过去。页面结构比较稳后续不管是换数据还是换皮肤成本都不会特别高。状态数量总体可控适合拿来练“一个页面里如何分配职责”这件事。组件参数和页面目标之间关系比较直观不太会出现“能跑但看不懂为什么这么配”的情况。完整代码下面保留整理过命名的完整 ArkTS 代码方便你直接对照学习。这里已经去掉原始的 Demo 命名改成了更贴近当前案例语义的名称。/** * 分页吸附滚动页 */import{PRESET_COLORS,generateListItems,DEMO_BG_COLOR,DEMO_CARD_COLOR,DEMO_THEME_COLOR,DEMO_SUBTEXT_COLOR}from./typesinterfaceScrollsnapPaginationModeItem{page:stringcolor:stringdesc:string}EntryComponentstruct ScrollsnapPaginationMode{StateisShow:booleantruebuild(){Column(){if(this.isShow){Column(){Text(snapPagination 分页吸附).fontSize(18).fontWeight(FontWeight.Bold).fontColor(#E67E22).margin({bottom:4})Text(snapPaginationtrue整页翻页效果).fontSize(12).fontColor(DEMO_SUBTEXT_COLOR).margin({bottom:12})}.width(100%).alignItems(HorizontalAlign.Start)Scroll(){Row(){ForEach([{page:A,color:#FF6B6B,desc:第一页内容},{page:B,color:#4ECDC4,desc:第二页内容},{page:C,color:#FFD93D,desc:第三页内容},{page:D,color:#6BCB77,desc:第四页内容},{page:E,color:#4D96FF,desc:第五页内容}],(item:ScrollsnapPaginationModeItem,index:number){Column(){Text(item.page).fontSize(64).fontWeight(FontWeight.Bold).fontColor(#FFFFFF)Text(item.desc).fontSize(14).fontColor(rgba(255,255,255,0.9)).margin({top:16})Text(\\${index1}/5\).fontSize(11).fontColor(rgba(255,255,255,0.5)).margin({top:12})Row(){ForEach([0,1,2,3,4],(dot:number){Circle().width(dotindex?10:6).height(dotindex?10:6).fill(dotindex?#FFFFFF:rgba(255,255,255,0.3)).margin({left:4,right:4})})}.margin({top:16})}.width(92%).height(220).backgroundColor(item.color).borderRadius(20).padding(24).justifyContent(FlexAlign.Center).margin({left:4%,right:4%})})}}.width(100%).height(250).scrollable(ScrollDirection.Horizontal).scrollBar(BarState.Off).scrollSnap({snapAlign:ScrollSnapAlign.START,snapPagination:100%}).backgroundColor(DEMO_CARD_COLOR).borderRadius(12).padding({top:16,bottom:16,left:0,right:0})}Text(分页吸附滚动页 - snapPagination 分页整页翻页吸附).fontSize(12).fontColor(#999999).margin({top:12})}.width(100%).height(100%).backgroundColor(#F5F6FA).padding(16)}}收个尾看完这一页如果你能说清楚它的结构、状态和交互分别承担什么职责那它的核心价值你基本就拿到了。后面无非就是换成你自己的数据和页面语义。