CircleIndicator:轻量级的圆形指示器,为你的应用添加灵动体验

CircleIndicator:轻量级的圆形指示器,为你的应用添加灵动体验

CircleIndicatorA lightweight indicator like in nexus 5 launcher项目地址:https://gitcode.com/gh_mirrors/ci/CircleIndicator

在追求极致用户体验的今天,细微的交互设计往往能成为吸引用户的点睛之笔。针对这一点,CircleIndicator 应运而生——一款灵感源自Nexus 5启动器的轻量级指示器库,它为你的ViewPager、RecyclerView或ViewPager2增添了灵活的导航视觉效果。

项目技术分析

CircleIndicator以简洁高效为核心,提供了高度可定制化的API,使得开发者能够轻松集成并自定义其外观和行为。该库支持AndroidX和传统的Android Support Library,保证了广泛的兼容性。通过Java或Kotlin进行调用,无论是ViewPager的经典滑动场景,还是RecyclerView和ViewPager2更现代的应用,CircleIndicator都能完美适配,满足从简单的页面切换到复杂的视图平移动画的各种需求。

项目及技术应用场景

幻灯片展示

  • 应用程序启动引导页:利用CircleIndicator为用户导航,提升引导过程的互动性和吸引力。
  • 图片轮播:电商、新闻应用中常用的功能,CircleIndicator确保用户清晰地知道当前显示的是哪一张图片以及总共有多少张。

多面板切换

  • 设置界面:在拥有多个选项卡的应用设置页面,CircleIndicator提供直观的当前页面指示,增强用户操作的逻辑性和便利性。
  • 社交应用: 对于多消息流切换(如聊天记录与动态之间),CircleIndicator使状态转换更加自然流畅。

项目特点

  • 轻量级:不增加应用负担,启动速度快,资源消耗小。
  • 高度可定制:从大小、颜色、动画到布局方向,几乎每个细节都可配置,满足个性化需求。
  • 全面兼容:支持ViewPager2以及向后兼容至传统ViewPager,同时支持RecyclerView实现卡片式滑动效果。
  • 简单易用:不论是新手还是经验丰富的开发者,都能够快速上手,并且文档齐全,示例丰富。
  • 活跃维护:基于社区反馈持续更新,确保稳定性和新功能的加入。

快速入门

添加依赖至你的build.gradle文件,选择适合你的版本:

dependencies {
    // 对于AndroidX支持
    implementation 'me.relex:circleindicator:2.1.6'

    // 若使用旧版Support Library
    implementation 'me.relex:circleindicator:1.3.2'
}

随后,在布局XML中定义指示器,并通过几行代码即可实现功能:

<me.relex.circleindicator.CircleIndicator
    android:id="@+id/indicator"
    android:layout_width="match_parent"
    android:layout_height="48dp"/>

Java示例:

CircleIndicator indicator = findViewById(R.id.indicator);
indicator.setViewPager(viewpager);

如此一来,一个富有活力的导航指示器就轻松集成到你的应用之中了。

总的来说,CircleIndicator是一个强大而又易于集成的组件,无论你是想要打造优雅的导航体验,还是希望为现有应用增添一丝灵动的气息,它都是不可多得的选择。立即尝试,让你的App界面焕然一新吧!

CircleIndicatorA lightweight indicator like in nexus 5 launcher项目地址:https://gitcode.com/gh_mirrors/ci/CircleIndicator

一个轻量级的viewpager指示器 ,类似于nexus5 启动器的效果。它可以自定义指示器上小圆点的样式和动画效果。可以用于引导页。项目地址:https://github.com/ongakuer/CircleIndicator 效果图:如何使用1. xml布局中创建CircleIndicator是配合ViewPager使用的,一般如下布局:<RelativeLayout         android:layout_width="match_parent"         android:layout_height="match_parent">         <android.support.v4.view.ViewPager             android:id="@ id/viewpager_default"             android:layout_width="match_parent"             android:layout_height="match_parent"/>         <me.relex.circleindicator.CircleIndicator             android:id="@ id/indicator_default"             android:layout_centerInParent="true"             android:layout_width="fill_parent"             android:layout_height="40dp"/>     </RelativeLayout>2. java代码中// DEFAULT ViewPager defaultViewpager = (ViewPager) findViewById(R.id.viewpager_default); CircleIndicator defaultIndicator = (CircleIndicator) findViewById(R.id.indicator_default); DemoPagerAdapter defaultPagerAdapter = new DemoPagerAdapter(getSupportFragmentManager()); defaultViewpager.setAdapter(defaultPagerAdapter);//为ViewPager设置适配器 defaultIndicator.setViewPager(defaultViewpager);//将ViewPager添加CircleIndicator中,以便监听ViewPager的滚动等事件DemoPagerAdapter是ViewPager的适配器,这个需要你去实现。属性说明属性名称类型说明ci_widthdimension小圆点的宽度ci_heightdimension小圆点的高度ci_margindimension小圆点间的间距ci_animatorreferenceViewPager页面切换时,给小圆点设置动画。设置当前的小圆点恢复到未选中时的状态的动画。例如:当前正从a切换到b,那么该属性设置的是a的动画。ci_animator_reversereference和"ci_animator"属性一样,只不过该属性设置的是b的动画。ci_drawablereference设置当前或选中的小圆点的样式,如颜色、圆角等。ci_drawable_unselectedreference和"ci_drawable"一样,只是该属性设置的是未选中的小圆点的样式。点击上面的"下载源码"下载完整的demo工程。demo简要说明xml布局:<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"     xmlns:app="http://schemas.android.com/apk/res-auto"     android:layout_width="match_parent"     android:layout_height="match_parent"     android:orientation="vertical">     <RelativeLayout         android:layout_width="match_parent"         android:layout_height="0dp"         android:layout_weight="1">         <android.support.v4.view.ViewPager             android:id="@ id/viewpager_default"             android:layout_width="match_parent"             android:layout_height="match_parent"/>         <me.relex.circleindicator.CircleIndicator             android:id="@ id/indicator_default"             android:layout_centerInParent="true"             android:layout_width="fill_parent"             android:layout_height="40dp"/>     </RelativeLayout>     <RelativeLayout         android:layout_width="match_parent"         android:layout_height="0dp"         android:layout_weight="1">         <android.support.v4.view.ViewPager             android:id="@ id/viewpager_custom"             android:layout_width="match_parent"             android:layout_height="match_parent"/>         <me.relex.circleindicator.CircleIndicator             android:id="@ id/indicator_custom"             app:ci_width="10dp"             app:ci_height="4dp"             app:ci_margin="6dp"             app:ci_animator="@animator/indicator_animator"             app:ci_animator_reverse="@animator/indicator_animator_reverse"             app:ci_drawable="@drawable/black_radius_square"             android:layout_centerInParent="true"             android:layout_width="fill_parent"             android:layout_height="40dp"/>     </RelativeLayout>     <RelativeLayout         android:layout_width="match_parent"         android:layout_height="0dp"         android:layout_weight="1">         <android.support.v4.view.ViewPager             android:id="@ id/viewpager_unselected_background"             android:layout_width="match_parent"             android:layout_height="match_parent"/>         <me.relex.circleindicator.CircleIndicator             android:id="@ id/indicator_unselected_background"             android:layout_centerInParent="true"             android:layout_width="fill_parent"             app:ci_width="6dp"             app:ci_height="6dp"             app:ci_animator="@animator/indicator_no_animator"             app:ci_drawable="@drawable/white_radius"             app:ci_drawable_unselected="@drawable/black_radius"             android:layout_height="40dp"             />     </RelativeLayout> </LinearLayout>定义了3组ViewPager和指示器。第一组是采用默认样式的,被选中的小圆点带有放大的动画。第2组比较全,既定义了动画又修改了样式。第3组是取消动画的同时使用了ci_drawable_unselected属性。适配器Adapter:public class DemoPagerAdapter extends FragmentPagerAdapter {         private int pagerCount = 5;         private Random random = new Random();         public DemoPagerAdapter(FragmentManager fm) {             super(fm);         }         @Override public Fragment getItem(int i) {             return ColorFragment.newInstance(0xff000000 | random.nextInt(0x00ffffff));         }         @Override public int getCount() {             return pagerCount;         }     }定义了5个页面或Fragment,通过ColorFragment生成Fragment。Fragment:public class ColorFragment extends Fragment {     private static final String ARG_COLOR = "color";     private int mColor;     public static ColorFragment newInstance(int param1) {         ColorFragment fragment = new ColorFragment();         Bundle args = new Bundle();         args.putInt(ARG_COLOR, param1);         fragment.setArguments(args);         return fragment;     }     public ColorFragment() {     }     @Override     public void onCreate(Bundle savedInstanceState) {         super.onCreate(savedInstanceState);         if (getArguments() != null) {             mColor = getArguments().getInt(ARG_COLOR);         }     }     @Override     public View onCreateView(LayoutInflater inflater, ViewGroup container,             Bundle savedInstanceState) {         View v = inflater.inflate(R.layout.color_fragment, container, false);         v.setBackgroundColor(mColor);         return v;     } }生成空的页面,没有任何控件,只是设置了页面的背景色。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

邵金庆Peaceful

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值