{"id":13641062,"url":"https://github.com/hackware1993/MagicIndicator","last_synced_at":"2025-04-20T07:31:55.218Z","repository":{"id":37668000,"uuid":"61980073","full_name":"hackware1993/MagicIndicator","owner":"hackware1993","description":"A powerful, customizable and extensible ViewPager indicator framework. As the best alternative of ViewPagerIndicator, TabLayout and PagerSlidingTabStrip   ——   强大、可定制、易扩展的 ViewPager 指示器框架。是ViewPagerIndicator、TabLayout、PagerSlidingTabStrip的最佳替代品。支持角标，更支持在非ViewPager场景下使用（使用hide()、show()切换Fragment或使用setVisibility切换FrameLayout里的View等），http://www.jianshu.com/p/f3022211821c","archived":false,"fork":false,"pushed_at":"2024-08-26T05:42:08.000Z","size":54748,"stargazers_count":9732,"open_issues_count":186,"forks_count":1545,"subscribers_count":156,"default_branch":"main","last_synced_at":"2024-10-29T11:46:17.898Z","etag":null,"topics":["indicator","pagerslidingtabstrip","tablayout","viewpager","viewpagerindicator"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hackware1993.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-06-26T08:20:43.000Z","updated_at":"2024-10-28T07:34:55.000Z","dependencies_parsed_at":"2024-09-30T15:40:47.627Z","dependency_job_id":"ff939bd5-5ceb-4fa6-b458-9e4cf057f874","html_url":"https://github.com/hackware1993/MagicIndicator","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackware1993%2FMagicIndicator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackware1993%2FMagicIndicator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackware1993%2FMagicIndicator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hackware1993%2FMagicIndicator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hackware1993","download_url":"https://codeload.github.com/hackware1993/MagicIndicator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223822029,"owners_count":17208788,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["indicator","pagerslidingtabstrip","tablayout","viewpager","viewpagerindicator"],"created_at":"2024-08-02T01:01:17.377Z","updated_at":"2025-04-20T07:31:55.209Z","avatar_url":"https://github.com/hackware1993.png","language":"Java","readme":"# MagicIndicator\n\nA powerful, customizable and extensible ViewPager indicator framework. As the best alternative of ViewPagerIndicator, TabLayout and PagerSlidingTabStrip.\n\n[Flutter_ConstraintLayout](https://github.com/hackware1993/Flutter_ConstraintLayout) Another very good open source project of mine.\n\n**I have developed the world's fastest general purpose sorting algorithm, which is on average 3 times faster than Quicksort and up to 20 times faster**, [ChenSort](https://github.com/hackware1993/ChenSort)\n\n[![](https://jitpack.io/v/hackware1993/MagicIndicator.svg)](https://jitpack.io/#hackware1993/MagicIndicator)\n[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-MagicIndicator-green.svg?style=true)](https://android-arsenal.com/details/1/4252)\n[![Codewake](https://www.codewake.com/badges/ask_question.svg)](https://www.codewake.com/p/magicindicator)\n\n![magicindicaotor.gif](https://github.com/hackware1993/MagicIndicator/blob/main/magicindicator.gif)\n\n# Usage\n\nSimple steps, you can integrate **MagicIndicator**:\n\n1. checkout out **MagicIndicator**, which contains source code and demo\n2. import module **magicindicator** and add dependency:\n\n  ```groovy\n  implementation project(':magicindicator')\n  ```\n  \n  **or**\n  \n  ```groovy\n  repositories {\n      ...\n      maven {\n          url \"https://jitpack.io\"\n      }\n  }\n  \n  dependencies {\n      ...\n      implementation 'com.github.hackware1993:MagicIndicator:1.6.0' // for support lib\n      implementation 'com.github.hackware1993:MagicIndicator:1.7.0' // for androidx\n  }\n  ```\n  \n3. add **MagicIndicator** to your layout xml:\n\n  ```xml\n  \u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n  \u003cLinearLayout xmlns:android=\"http://schemas.android.com/apk/res/android\"\n      xmlns:tools=\"http://schemas.android.com/tools\"\n      android:layout_width=\"match_parent\"\n      android:layout_height=\"match_parent\"\n      android:orientation=\"vertical\"\n      tools:context=\"net.lucode.hackware.magicindicatordemo.MainActivity\"\u003e\n  \n      \u003cnet.lucode.hackware.magicindicator.MagicIndicator\n          android:id=\"@+id/magic_indicator\"\n          android:layout_width=\"match_parent\"\n          android:layout_height=\"40dp\" /\u003e\n  \n      \u003candroid.support.v4.view.ViewPager\n          android:id=\"@+id/view_pager\"\n          android:layout_width=\"match_parent\"\n          android:layout_height=\"0dp\"\n          android:layout_weight=\"1\" /\u003e\n  \n  \u003c/LinearLayout\u003e\n  ```\n\n4. find **MagicIndicator** through code, initialize it:\n\n  ```java\n  MagicIndicator magicIndicator = (MagicIndicator) findViewById(R.id.magic_indicator);\n  CommonNavigator commonNavigator = new CommonNavigator(this);\n  commonNavigator.setAdapter(new CommonNavigatorAdapter() {\n  \n      @Override\n      public int getCount() {\n          return mTitleDataList == null ? 0 : mTitleDataList.size();\n      }\n  \n      @Override\n      public IPagerTitleView getTitleView(Context context, final int index) {\n          ColorTransitionPagerTitleView colorTransitionPagerTitleView = new ColorTransitionPagerTitleView(context);\n          colorTransitionPagerTitleView.setNormalColor(Color.GRAY);\n          colorTransitionPagerTitleView.setSelectedColor(Color.BLACK);\n          colorTransitionPagerTitleView.setText(mTitleDataList.get(index));\n          colorTransitionPagerTitleView.setOnClickListener(new View.OnClickListener() {\n              @Override\n              public void onClick(View view) {\n                  mViewPager.setCurrentItem(index);\n              }\n          });\n          return colorTransitionPagerTitleView;\n      }\n  \n      @Override\n      public IPagerIndicator getIndicator(Context context) {\n          LinePagerIndicator indicator = new LinePagerIndicator(context);\n          indicator.setMode(LinePagerIndicator.MODE_WRAP_CONTENT);\n          return indicator;\n      }\n  });\n  magicIndicator.setNavigator(commonNavigator);\n  ```\n  \n5. work with ViewPager:\n\n  ```java\n  ViewPagerHelper.bind(magicIndicator, mViewPager);\n  ```\n\n  **or**\n  \n  work with Fragment Container(switch Fragment by hide()、show()):\n  ```java\n  mFramentContainerHelper = new FragmentContainerHelper(magicIndicator);\n  \n  // ...\n  \n  mFragmentContainerHelper.handlePageSelected(pageIndex);   // invoke when switch Fragment\n  ```\n  \n# Extend\n\n**MagicIndicator** can be easily extended:\n\n1. implement **IPagerTitleView** to customize tab:\n\n  ```java\n  public class MyPagerTitleView extends View implements IPagerTitleView {\n  \n      public MyPagerTitleView(Context context) {\n          super(context);\n      }\n  \n      @Override\n      public void onLeave(int index, int totalCount, float leavePercent, boolean leftToRight) {\n      }\n  \n      @Override\n      public void onEnter(int index, int totalCount, float enterPercent, boolean leftToRight) {\n      }\n  \n      @Override\n      public void onSelected(int index, int totalCount) {\n      }\n  \n      @Override\n      public void onDeselected(int index, int totalCount) {\n      }\n  }\n  ```\n\n2. implement **IPagerIndicator** to customize indicator:\n\n  ```java\n  public class MyPagerIndicator extends View implements IPagerIndicator {\n  \n      public MyPagerIndicator(Context context) {\n          super(context);\n      }\n  \n      @Override\n      public void onPageSelected(int position) {\n      }\n  \n      @Override\n      public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {\n      }\n  \n      @Override\n      public void onPageScrollStateChanged(int state) {\n      }\n  \n      @Override\n      public void onPositionDataProvide(List\u003cPositionData\u003e dataList) {\n      }\n  }\n  ```\n\n3. use **CommonPagerTitleView** to load custom layout xml.\n\nNow, enjoy yourself!\n\nSee extensions in [*app/src/main/java/net/lucode/hackware/magicindicatordemo/ext*](https://github.com/hackware1993/MagicIndicator/tree/master/app/src/main/java/net/lucode/hackware/magicindicatordemo/ext)，more extensions adding...\n\n# Who developed?\n\nhackware1993@gmail.com\n\ncfb1993@163.com\n\nQ\u0026A \u003ca target=\"_blank\" href=\"http://shang.qq.com/wpa/qunwpa?idkey=7ac5bef0321c7afa7e9fc4e94175fa36f413e3330c82e828b1743274af8a64d7\"\u003e\u003cimg border=\"0\" src=\"http://pub.idqqimg.com/wpa/images/group.png\" alt=\"MagicIndicator交流群\" title=\"MagicIndicator交流群\"\u003e\u003c/a\u003e\n\nAn intermittent perfectionist.\n\nVisit [My Blog](http://hackware.lucode.net) for more articles about MagicIndicator.\n\n订阅我的微信公众号以及时获取 MagicIndicator 的最新动态。后续也会分享一些高质量的、独特的、有思想的 Flutter 和 Android 技术文章。\n\n![official_account.webp](https://github.com/hackware1993/weiV/blob/master/official_account.webp?raw=true)\n\n# License\n\n  ```\n  MIT License\n  \n  Copyright (c) 2016 hackware1993\n  \n  Permission is hereby granted, free of charge, to any person obtaining a copy\n  of this software and associated documentation files (the \"Software\"), to deal\n  in the Software without restriction, including without limitation the rights\n  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n  copies of the Software, and to permit persons to whom the Software is\n  furnished to do so, subject to the following conditions:\n  \n  The above copyright notice and this permission notice shall be included in all\n  copies or substantial portions of the Software.\n  \n  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n  SOFTWARE.\n  ```\n\n# More\n\nHave seen here, give a star?（都看到这儿了，何不给个...，哎，别走啊，star还没...）\n","funding_links":[],"categories":["TabLayout"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackware1993%2FMagicIndicator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhackware1993%2FMagicIndicator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackware1993%2FMagicIndicator/lists"}