circleIndicator4cj Titles指示器彩色翻转与渐变文字效果实现指南【免费下载链接】circle-indicator-cj圆形指示器归一化UI组件项目地址: https://gitcode.com/Cangjie-TPC/circle-indicator-cjcircleIndicator4cj 是一款面向仓颉Cangjie开发者的 Tabs/Swiper 指示器 UI 组件库本文重点讲解其中的Titles 指示器以及彩色翻转文字与渐变文字两种动效的开启方法帮助新手快速做出丝滑的标签页切换体验。一、circleIndicator4cj 是什么一句话它为 Tabs / Swiper 容器提供多种指示器样式——圆形小点、长条、横幅、图标、底部导航、可滑动 Tabs、Titles 标题栏等。每个指示器都由两部分组成指示器组件负责绘制如 title_indicator.cj数据模型Model负责配置颜色、尺寸、动画行为如 title_model.cj这种组件 模型分离的设计贯穿整个库你只要找到对应的 Model 调用链式方法即可定制样式非常易上手。二、Titles 指示器标题跟随手指滑动 Titles 指示器TitleIndicator是一排可横向滑动的文字标签手指在内容区滑动时文字会跟随移动选中项高亮底部还有下划线或三角游标指示当前页。下方的图片正是示例应用中作为 Tabs 页面内容的素材 Titles 指示器就悬停在它上方随手指左右滑动它的核心机制无需你实现组件已内置文字测量组件内部通过 measurable_text.cj 测量每个标题的实际宽度据此计算每帧位移触摸联动通过Tabs的onTouch事件把触摸转发给model.notifyTouch(...)指示器与页面手感完全同步惯性补间松手后通过定时器逐帧补全滑块的 fling 惯性动画见 title_indicator.cj 中的refreshOffsetForFling。官方还贴心提供了两个回调setChangeListener页码变化和setOnCenterItemClickListener点击中心标题在 title_sample_default.cj 中可以看到典型用法。三、三步接入快速上手 Titles 指示器第 1 步克隆项目并引入模块git clone https://gitcode.com/Cangjie-TPC/circle-indicator-cj把circleIndicator目录拷入你的应用工程然后在entry/oh-package.json5的dependencies中添加circleIndicator: file:../circleIndicator并在entry/src/main/cangjie/cjpm.toml的[dependencies]中声明依赖路径详见 README.md 的使用说明章节。第 2 步引入组件import circleIndicator.*第 3 步组装页面关键结构只有三块TitleIndicatorTabs 触摸事件转发TitleIndicator(titles: this.titles, itemIndex: this.index, model: this.model) Tabs(this.tabsController) { // ...你的 TabContent }.onChange({ index this.index Int64(index) }) .onTouch({ event: TouchEvent this.model.notifyTouch(event, this.index) // 触摸转发联动灵魂所在 }) 记得用model.setController(tabsController)把控制器交给 Model点击标题即可自动切页。四、彩色翻转文字过程过半才变色 彩色翻转TitleMode.COLOR_FLIP的效果是滑动标签时文字颜色保持原样直到滑动越过一半的瞬间文字才翻转成选中色字号同步切换干脆利落类似开关弹跳的手感。实现逻辑在 color_flip_text.cjcomFontColor方法以offset 0.5 / -0.5作为翻转阈值命中即返回选中色否则返回未选中色。开启方式只需一行TitleMode枚举定义见 magic_scroll_tabs_model.cjthis.model.setTitleMode(TitleMode.COLOR_FLIP)五、渐变文字颜色与字号全程平滑过渡 ✨渐变模式TitleMode.COLOR_GRADIENT则走柔顺路线滑动过程中文字颜色与字号随偏移量连续插值当前项逐渐变深变大相邻项反向变浅变小整个过程没有突变。核心实现在 color_gradient_text.cjcomFontSize用offset对选中/未选中字号做线性加权comHalfFontColor把两个颜色按 ARGB 四通道逐分量做加权混合得到中间色。开启同样一行搞定this.model.setTitleMode(TitleMode.COLOR_GRADIENT)文字模式与游标类型线条 / 贝塞尔 / 三角可自由组合全部渲染逻辑位于 magic_scroll_tabs_indicator.cj 的TabItem构建器中完整参数参见 doc/feature_api.md。另一张示例页面素材图可感受标题栏下方承载的富内容场景六、翻转 vs 渐变怎么选对比项COLOR_FLIP 彩色翻转COLOR_GRADIENT 渐变变化时机越过 50% 阈值瞬间切换全程连续插值视觉感受干脆、弹跳感柔和、高级感典型场景强品牌色、强调选中态弱视觉干扰、长标题栏小结 Titles 指示器 TitleIndicatorTitleModel 触摸转发三步接入想要啪地变色用COLOR_FLIP想要渐地过渡用COLOR_GRADIENT更多样式下划线/三角游标、顶/底位置都在 title_model.cj 的链式 API 中示例代码可逛 entry/src/main/cangjie/titleindicator/ 目录。现在就打开项目给你的 Tabs 换上会变色的标题栏吧【免费下载链接】circle-indicator-cj圆形指示器归一化UI组件项目地址: https://gitcode.com/Cangjie-TPC/circle-indicator-cj创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考