评分条控件MaterialRatingBar Sample

MaterialRatingBar——为Android 3.0及以上版本打造的统一评分条控件，严格遵循Material Design规范。

本库在框架原生RatingBar的基础上进行深度扩展，不仅保证了从API 11到最新版本的一致视觉体验，更通过一系列功能增强，提升了控件在实际场景中的表现力与灵活性。

技术特性分析

标准化视觉设计

2dp 星形边框：与 Google Material Icons 保持完全一致的视觉规范，确保图标比例与间距符合设计语言。

自适应尺寸：支持 match_parent 宽度模式（如 Google Play 商店效果），并能根据 layout_height 自动缩放，避免变形。

精准评分显示

小数点支持：准确显示如 4.3 分的半星效果，修复原生 RatingBar 中 4.3 被误判为 4.5 的填充 bug。

半星视觉优化：消除原生控件在半星状态下的“下沉”或“错位”视觉缺陷。

跨版本兼容性

在 Android 4.x ~ 14.x 各版本中保持一致的渲染效果与交互行为，解决系统原生控件在低版本中的不一致问题。

应用场景

电商应用：商品星级评价（如淘宝、京东商品详情页）

内容平台：电影/书籍/音乐评分（如豆瓣、IMDb）

服务评价：外卖/打车/住宿服务评级

用户反馈：应用内满意度调查、功能评分

游戏系统：成就评级、关卡评分、道具星级等

核心功能亮点

Material Design 一致性：严格遵循 Google MD3 设计指南，提供现代 UI 体验。

即插即用：继承自原生 RatingBar，只需替换控件名即可完成迁移。

8 项自定义属性：支持填充色、边框色、背景色、渐变模式等深度定制（如 app:starFillColor、app:starBackgroundTint）。

实时拖动反馈：支持手指滑动时实时更新评分，提升交互流畅度。

布局自适应：完美适配 wrap_content、固定尺寸及 match_parent 场景。

集成方式

在项目 build.gradle（Module: app）中添加依赖：

gradle

编辑

1dependencies {2    implementation 'me.zhanghai.android.materialratingbar:library:1.4.0'3}

在 XML 布局文件中替换原生 RatingBar：

xml

编辑

1<me.zhanghai.android.materialratingbar.MaterialRatingBar2    android:id="@+id/rating_bar"3    android:layout_width="wrap_content"4    android:layout_height="wrap_content"5    android:numStars="5"6    android:stepSize="0.1"7    android:rating="4.3"8    app:starFillColor="@color/gold"9    app:starBackgroundTint="@color/light_gray" />

使用示例

kotlin

编辑

1val ratingBar = findViewById<MaterialRatingBar>(R.id.rating_bar)2ratingBar.rating = 4.5f // 设置评分3ratingBar.setOnRatingBarChangeListener { _, rating, _ ->4    Log.d("Rating", "User rated: $rating")5}

推荐理由

视觉统一：解决原生控件在不同 Android 版本中的视觉差异。

功能完善：支持精确半星、拖动评分、自定义颜色等高级功能。

维护活跃：开源项目，持续更新，社区支持良好。

体积轻量：AAR 包大小约 20KB，对 APK 影响微乎其微。