简介这份资源面向Android中高级开发者聚焦自定义View实战围绕字母导航栏这一常见交互组件展开适用于联系人列表、商店分类等需要按首字母快速定位的场景。压缩包共977个文件以462个xml布局与资源、302个png图片、126个json配置为主另含40个class、12个jar、11个java源码及aidl、apk等构建产物整体约6.66MB结构完整便于对照工程理解视图创建、事件监听与列表联动。已有423人学习下载说明其在自定义View学习中具有一定参考价值。资源完整呈现了从继承LinearLayout搭建导航栏、动态生成字母按钮到点击回调更新选中态、借助Adapter的getPositionForSection与smoothScrollToPosition实现列表平滑滚动的实现链路并涉及悬浮提示、触摸滑动选字母等体验优化思路适合开发者拆解复用、查漏补缺。1. 字母导航栏这个需求到底难在哪通讯录、城市选择、商品分类页里右侧那条竖着的 A–Z 索引条几乎是标配。用户拇指按住字母列表跟着跳到对应分组松手回弹中间浮出一个当前字母的提示气泡。看起来是个小控件真动手写才发现坑不少字母条要自己测量、自己绘制、自己处理触摸事件还要和 RecyclerView 的滚动位置双向同步稍不注意就出现「点了没反应」「跳错分组」「滑动时字母条跟着乱跳」这类玄学问题。这套方案要解决的就是把字母导航栏做成一个可复用、可独立测试的自定义 View而不是散落在 Activity 里的一堆监听器。适合正在做课程设计、毕设里带通讯录或城市选择模块的同学也适合需要给现有列表页补一个索引控件的开发者。下面从需求拆解、架构设计、核心实现到验收答辩按一条能直接照搬的路线走完。2. 需求拆解与技术选型为什么是自定义 View 而不是第三方库2.1 先把功能边界划清楚字母导航栏的功能看着简单拆开至少有五件事绘制 26 个字母外加#或「↑」这类特殊项、响应按下/移动/抬起三种触摸状态、把触摸的 Y 坐标换算成字母索引、把索引回调给外部列表、在按下时显示一个居中的字母提示浮层。这五件事里前四件属于控件自身职责第五件浮层可以放在控件内部画也可以交给外部我一般倾向内部画因为浮层位置依赖字母条的触摸坐标放外面反而要多传一堆状态。边界划清楚之后哪些不做也要明确不做拼音首字母提取那是数据层的事、不做列表分组吸顶那是 ItemDecoration 的事、不做搜索框联动。一个控件只干一件事后面复用和测试都轻松。很多同学翻车就翻在「一个 View 什么都想管」最后代码八百行改一个字母颜色要翻半天。数据侧需要一个约定列表数据必须已经按首字母排好序并且能提供「每个字母分组的起始位置」。这个信息通常由外部构造一个MapString, Integer或者一个int[]位置数组传进来控件只负责「字母 → 位置」的查表不负责排序。这个分工是整套方案的地基后面所有实现都围绕它展开。2.2 三种实现路线的取舍实现字母导航栏常见三条路用LinearLayout动态 add 26 个TextView、用RecyclerView竖向排列、直接继承View自己onDraw。前两种写起来快但问题明显26 个 View 的测量和布局有开销触摸事件要逐个处理字母间距还得靠layout_weight硬凑遇到不同屏幕高度容易挤成一团或者留白过多。自己画则完全掌控绘制和触摸性能好适配任意高度代价是要自己算坐标。方案绘制方式触摸处理适配性适用场景动态 TextView26 个子 View逐个子 View 监听差依赖布局权重字母数量固定且少RecyclerView子项复用Item 点击中需处理滚动字母项带复杂内容自定义 ViewonDraw 一次画完onTouchEvent 统一处理好按高度均分纯字母索引条选自定义 View 的另一个理由是「可测试」绘制逻辑和索引换算逻辑可以抽成纯函数单元测试直接断言「Y0 时返回索引 0」「Y高度时返回最后一个索引」不用起模拟器。这对要写毕设文档、要答辩讲清楚设计思路的人很友好。2.3 关键参数先定下来动手前把可配置项列出来避免写死。通常的做法是暴露一组自定义属性字母文字大小、选中态颜色、默认态颜色、字母条背景、浮层背景、浮层文字大小、字母间距。这些用attrs.xml声明代码里通过TypedArray读取外部在布局 XML 里就能配。参数定好之后onMeasure里按「宽度 字母最大宽度 左右内边距高度 父容器给的高度」处理高度用MeasureSpec.getSize拿这样字母条能撑满列表右侧。提示字母条宽度不要写死 dp用Paint.measureText(W)量一下最宽字母再留 padding换字体或换字号都不会被裁切。3. 总体架构设计一个控件、三层职责、两条数据流3.1 三层职责划分整套方案按职责分三层。第一层是绘制层负责在onDraw里把字母按等分高度画出来选中项换颜色第二层是交互层在onTouchEvent里把触摸坐标换算成索引处理按下、移动、抬起并触发回调第三层是通信层通过一个接口把「当前选中索引」和「是否正在触摸」告诉外部外部据此滚动列表或显示/隐藏浮层。三层之间只通过索引这一个整数通信耦合极低。绘制层不知道列表存在交互层不知道浮层怎么画通信层只转发事件。这种划分的好处是想换浮层样式只改绘制层想换滚动策略只改外部回调互不影响。写毕设文档时这三层正好对应「视图绘制」「事件处理」「组件通信」三个小节结构清晰。3.2 两条数据流的走向第一条是触摸 → 列表手指按下字母条onTouchEvent拿到event.getY()除以单个字母高度得到索引通过OnLetterSelectedListener.onLetterSelected(index, letter)回调出去外部拿到字母后查位置表调RecyclerView.scrollToPosition(pos)或LinearLayoutManager.scrollToPositionWithOffset(pos, 0)。第二条是列表 → 字母条用户手动滑动列表时字母条的选中态要跟着变。这条流通常由外部在RecyclerView.OnScrollListener里算当前第一个可见项属于哪个分组再调控件的setCurrentIndex(index)刷新高亮。注意这条流是「外部驱动控件」不是控件自己监听列表控件保持被动职责才干净。两条流方向相反但都只传索引不会打架。唯一要小心的是「程序滚动触发滚动监听再回写索引」造成的循环解决办法是在程序滚动时加一个标志位滚动监听里判断标志位跳过回写这个细节在第 5 章避坑里展开。3.3 接口与回调的签名设计通信接口设计成两个方法比一个方法好public interface OnLetterSelectedListener { // 手指按下或移动到新字母时触发index 为字母在数组中的下标 void onLetterSelected(int index, String letter); // 手指抬起时触发外部据此隐藏浮层、恢复列表惯性 void onLetterTouchFinished(); }拆成两个方法的原因是「选中」和「结束」语义不同选中要滚动列表结束要收尾。如果合成一个方法靠参数区分外部每次都要写 if容易漏。参数里同时给index和letter是照顾两种外部用法用位置表的拿 index 查用字母直接匹配的拿 letter。多给一个参数成本很低省得外部再反查一次。4. 核心模块实现绘制、触摸换算与浮层4.1 onDraw 里怎么把 26 个字母画匀绘制核心是「等分高度」。控件高度除以字母数量得到每个字母的格子高度每个字母在自己的格子里垂直居中。基线计算用Paint.FontMetrics不要用height()/2硬凑否则不同字体下字母会偏上或偏下。Override protected void onDraw(Canvas canvas) { super.onDraw(canvas); // 每个字母占据的格子高度 float cellHeight getHeight() * 1f / letters.length; for (int i 0; i letters.length; i) { // 选中项用高亮色其余用默认色 paint.setColor(i currentIndex ? selectedColor : normalColor); // 字母水平居中控件宽度一半减去文字宽度一半 float textWidth paint.measureText(letters[i]); float x getWidth() / 2f - textWidth / 2f; // 垂直居中格子中心 基线偏移 Paint.FontMetrics fm paint.getFontMetrics(); float baseline i * cellHeight cellHeight / 2f - (fm.ascent fm.descent) / 2f; canvas.drawText(letters[i], x, baseline, paint); } }cellHeight是浮点数不要取整否则 26 个格子累计误差会让最后一个字母被裁掉。baseline的算法是「格子中心减去文字视觉中心偏移」(fm.ascent fm.descent) / 2f就是文字视觉中心相对基线的偏移这个公式比getHeight()/2稳。currentIndex默认 -1 表示无选中绘制时全部用默认色。字母数组建议做成常量{#, A, B, ..., Z}#放最前对应「其他」分组。数组长度决定格子数外部想加「↑」置顶项也只需改数组绘制逻辑不用动。4.2 触摸坐标到索引的换算onTouchEvent里三件事按下和移动都算「选中」抬起算「结束」。换算公式是index (int)(y / cellHeight)但要夹紧到[0, letters.length - 1]因为手指滑出控件边界时y可能为负或超过高度。Override public boolean onTouchEvent(MotionEvent event) { switch (event.getAction()) { case MotionEvent.ACTION_DOWN: case MotionEvent.ACTION_MOVE: float cellHeight getHeight() * 1f / letters.length; // 夹紧边界防止滑出控件时数组越界 int index (int) (event.getY() / cellHeight); index Math.max(0, Math.min(index, letters.length - 1)); if (index ! currentIndex) { currentIndex index; invalidate(); // 刷新高亮 if (listener ! null) { listener.onLetterSelected(index, letters[index]); } } return true; // 必须消费否则收不到后续 MOVE case MotionEvent.ACTION_UP: case MotionEvent.ACTION_CANCEL: if (listener ! null) { listener.onLetterTouchFinished(); } return true; } return super.onTouchEvent(event); }关键点在index ! currentIndex这个判断手指在同一个字母格子里移动会连续触发 MOVE不去重的话回调会被刷爆列表反复滚动表现就是「卡顿」。ACTION_DOWN必须返回true否则系统认为你不处理这个手势后续 MOVE 和 UP 都收不到这是自定义 View 触摸处理最常见的翻车点。ACTION_CANCEL也要当抬起处理否则来电、弹窗打断手势时浮层收不回去。4.3 字母提示浮层的绘制时机浮层有两种做法在控件内部用onDraw画一个居中的圆角矩形加字母或者用一个独立的TextView由外部控制显隐。内部画的好处是位置和字母条天然对齐坏处是浮层会盖在字母条上需要处理层级。我一般用内部画因为浮层本质是「当前选中字母的放大提示」和字母条是同一个视觉整体。实现上在onDraw末尾判断「是否正在触摸」是则画浮层一个居中的圆角矩形宽高按文字大小算背景色用半透明深色字母用白色。浮层位置固定在控件中心不跟随手指这样视觉稳定。触摸结束时把「正在触摸」标志置 false 并invalidate()浮层消失。浮层的圆角半径、背景色、文字大小都走自定义属性和字母条样式解耦。注意浮层绘制在onDraw里意味着每次触摸移动都会重绘整个控件26 个字母加一个浮层的绘制量很小不用担心性能但如果字母条上还叠了别的复杂内容就要考虑用invalidate(Rect)局部刷新。4.4 和 RecyclerView 的联动外部拿到onLetterSelected回调后用字母查位置表调scrollToPositionWithOffset(pos, 0)。用scrollToPosition也行但它会把目标项滚到屏幕顶部或底部取决于当前方向体验不如scrollToPositionWithOffset稳定。位置表在数据构造时生成// 数据已按首字母排序遍历一遍记录每个字母首次出现的位置 MapString, Integer positionMap new HashMap(); for (int i 0; i dataList.size(); i) { String letter dataList.get(i).getFirstLetter(); if (!positionMap.containsKey(letter)) { positionMap.put(letter, i); } }回调里Integer pos positionMap.get(letter); if (pos ! null) layoutManager.scrollToPositionWithOffset(pos, 0);。注意#分组可能不存在get返回 null 要判空否则空指针。反向同步列表滑动更新字母条高亮放在OnScrollListener里用findFirstVisibleItemPosition反查该位置属于哪个字母调letterBar.setCurrentIndex(index)setCurrentIndex内部判等后invalidate避免无谓重绘。5. 避坑与排查五个最容易翻车的点5.1 点了字母列表不动现象是手指按下去字母高亮变了但列表纹丝不动。原因通常是ACTION_DOWN没返回true或者返回了super.onTouchEvent(event)而父类返回 false导致后续事件根本没进来回调只在 DOWN 时触发一次且外部没接住。解决是把 DOWN 分支明确return true并检查setOnLetterSelectedListener是否在setAdapter之后调用监听器为 null 时回调静默失败加一行日志就能定位。5.2 滑动列表时字母条高亮乱跳现象是手动滑列表字母条高亮在几个字母之间来回闪。原因是程序滚动点字母触发的scrollToPosition也会触发OnScrollListener监听器回写索引回写又可能触发新的滚动形成循环。解决办法是加一个isProgrammaticScroll标志点字母滚动前置 trueonScrolled里判断为 true 就跳过回写并复位。这个标志位是血泪经验不加的话在快速连点时尤其明显。5.3 最后一个字母被裁掉或挤在一起现象是 Z 显示不全或者字母间距上疏下密。原因是cellHeight取了整26 个格子累计误差几十像素或者onMeasure里高度用了wrap_content导致控件高度不够。解决是cellHeight用浮点、onMeasure里高度取父容器给的MeasureSpec.getSize并在布局里给字母条match_parent高度。如果字母条放在LinearLayout里记得给它layout_heightmatch_parent且父容器高度确定。5.4 浮层收不回去现象是手指抬起后浮层一直挂着。原因是只处理了ACTION_UP没处理ACTION_CANCEL手势被系统打断来电、下拉通知栏、父容器拦截时收不到 UP。解决是 UP 和 CANCEL 走同一段收尾逻辑把「正在触摸」置 false 并invalidate。另外如果父容器是ScrollView它可能拦截竖直滑动需要在字母条上调getParent().requestDisallowInterceptTouchEvent(true)在 DOWN 时请求父容器别抢事件。5.5 换字体后字母偏上偏下现象是默认字体正常换成某个自定义字体后字母整体偏移。原因是基线计算用了固定值或者getHeight()/2没考虑FontMetrics随字体变化。解决是统一用(fm.ascent fm.descent) / 2f算视觉中心偏移并且Paint开setAntiAlias(true)、setTextAlign(Paint.Align.LEFT)自己算 x不用 CENTER 对齐避免测量和绘制不一致。改完字体后跑一遍 26 个字母的截图对比肉眼确认没有裁切。6. 验收与答辩怎么证明这个控件是「对的」验收分三层从下往上。第一层是纯逻辑单测把「Y 坐标 → 索引」的换算抽成静态方法indexOfY(float y, int height, int count)用 JUnit 断言边界值——y0返回 0yheight返回count-1y-10返回 0yheight10返回count-1y落在第 3 格中间返回 3。这组用例跑通触摸换算的正确性就有底了答辩时直接展示测试报告比口头说「我测过了」有说服力。第二层是交互验收清单逐条过验收项操作预期按下高亮按住字母 MM 变高亮色浮层显示 M滑动切换按住从 A 滑到 Z高亮跟随列表逐组滚动抬起收尾松手浮层消失列表停住反向同步手动滑列表到 G 组字母条 G 高亮边界手指滑出控件上下边界不崩溃索引夹在首尾打断按住时下拉通知栏浮层收回无残留第三层是异常场景空数据位置表为空点字母不崩、单分组数据只有一个字母格子高度等于控件高度、#分组不存在点#无滚动但不崩。这三条是答辩时老师最爱问的「边界情况你考虑了吗」提前准备好答案。答辩讲设计时按「为什么自定义 View → 三层职责 → 两条数据流 → 关键代码 → 验收结果」的顺序讲控制在五分钟内。重点讲清楚「索引换算」和「双向同步防循环」这两个设计决策前者体现你对坐标系统的理解后者体现你踩过坑。代码不用逐行念挑onTouchEvent的去重判断和OnScrollListener的标志位讲这两处最能体现工程思维。我自己的习惯是每写完一个自定义 View先在纸上把「触摸事件从 DOWN 到 UP 的完整路径」画一遍标出每个分支的返回值再对照代码检查。这个笨办法帮我拦下过好几次「DOWN 返回 false」的低级错误。从那以后我每次做触摸类控件都强制走一遍这条路径图希望帮到你。本文还有配套的精品资源点击获取