Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/LuckyJayce/ViewPagerIndicator
Indicator 取代 tabhost，实现网易顶部tab，新浪微博主页底部tab，引导页，无限轮播banner等效果，高度自定义tab和特效，LazyFragment
https://github.com/LuckyJayce/ViewPagerIndicator
Last synced: about 1 month ago
JSON representation
Indicator 取代 tabhost，实现网易顶部tab，新浪微博主页底部tab，引导页，无限轮播banner等效果，高度自定义tab和特效，LazyFragment
- Host: GitHub
- URL: https://github.com/LuckyJayce/ViewPagerIndicator
- Owner: LuckyJayce
- License: apache-2.0
- Created: 2014-10-11T15:28:43.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2019-12-17T12:50:40.000Z (almost 5 years ago)
- Last Synced: 2024-11-01T21:42:49.732Z (about 1 month ago)
- Language: Java
- Homepage:
- Size: 34.6 MB
- Stars: 2,586
- Watchers: 119
- Forks: 627
- Open Issues: 46
-
Metadata Files:
- Readme: README.md
- License: License.md
Awesome Lists containing this project
- awesome-github-android-ui - ViewPagerIndicator - 布局插件 (ViewPager)
README
ViewPagerIndicator
==================
### 1. 支持自定义tab样式
### 2. 支持自定义滑动块样式和位置
### 3. 支持自定义切换tab的过渡效果
### 4. 支持子界面的预加载和界面缓存
### 5. 支持设置界面是否可滑动
### 6. android:minSdkVersion="14"
### 7.导入方式
<1>gradle导入
implementation 'com.shizhefei:ViewPagerIndicator:1.1.9'
由于用到了v4和recyclerview所以也要导入他们
implementation 'com.android.support:support-v4:28.0.0'
implementation 'com.android.support:recyclerview-v7:28.0.0'
<1>androidx gradle导入
implementation 'com.shizhefei:ViewPagerIndicator:1.1.9.androidx'
由于用到了v4和recyclerview所以也要导入他们
implementation 'androidx.legacy:legacy-support-v4:1.0.0'
implementation 'androidx.recyclerview:recyclerview:1.0.0'
<2>jar包方式导入
Download Library [JAR](https://github.com/LuckyJayce/ViewPagerIndicator/releases)
Download sample [Apk](https://github.com/LuckyJayce/ViewPagerIndicator/blob/master/raw/ViewPagerIndicator_Demo.apk?raw=true)
### 8.历史版本和更新信息
https://github.com/LuckyJayce/ViewPagerIndicator/releases
# 使用方法
package com.shizhefei.indicator.guide;
import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import android.support.v4.view.ViewPager;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.view.ViewGroup.LayoutParams;
import com.shizhefei.indicator.R;
import com.shizhefei.view.indicator.Indicator;
import com.shizhefei.view.indicator.IndicatorViewPager;
import com.shizhefei.view.indicator.IndicatorViewPager.IndicatorPagerAdapter;
import com.shizhefei.view.indicator.IndicatorViewPager.IndicatorViewPagerAdapter;
public class GuideActivity extends FragmentActivity {
private IndicatorViewPager indicatorViewPager;
private LayoutInflater inflate;
@Override
protected void onCreate(Bundle arg0) {
super.onCreate(arg0);
setContentView(R.layout.activity_guide);
ViewPager viewPager = (ViewPager) findViewById(R.id.guide_viewPager);
Indicator indicator = (Indicator) findViewById(R.id.guide_indicator);
// 将viewPager和indicator使用
indicatorViewPager = new IndicatorViewPager(indicator, viewPager);
inflate = LayoutInflater.from(getApplicationContext());
// 设置indicatorViewPager的适配器
indicatorViewPager.setAdapter(adapter);
}
private IndicatorPagerAdapter adapter = new IndicatorViewPagerAdapter() {
private int[] images = { R.drawable.p1, R.drawable.p2, R.drawable.p3,
R.drawable.p4 };
/**
* 获取tab
*/
@Override
public View getViewForTab(int position, View convertView,
ViewGroup container) {
if (convertView == null) {
convertView = inflate.inflate(R.layout.tab_guide, container,
false);
}
return convertView;
}
/**
* 获取每一个界面
*/
@Override
public View getViewForPage(int position, View convertView,
ViewGroup container) {
if (convertView == null) {
convertView = new View(getApplicationContext());
convertView.setLayoutParams(new LayoutParams(
LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT));
}
convertView.setBackgroundResource(images[position]);
return convertView;
}
/**
* 获取界面数量
*/
@Override
public int getCount() {
return images.length;
}
};
}
# 效果图
有了该类库你可以实现以下布局
# 主要的类
## 1.ViewPager
这个版本以后 android-support-v4 可以用原生的了 没有重写ViewPager。
原先重写的ViewPager的setPrepareNumber 用 Fragment继承于LazyFragment代替实现懒加载
原先setCanScroll 转移到了 ViewPager的子类SViewPager上
2.使用ProxyLazyFragment或者继承LazyFragment来配合ViewPager的setOffscreenPageLimit进行懒加载界面和防止重新创建界面
## 2.Indicator
顾名思义是指示器的意思。有点像水平方向的listview 可以自定义item。
**Indicator**
setCurrentItem(int item, boolean anim) 设置当前项
setOnTransitionListener(OnTransitionListener onTransitionListener)设置tab过渡动画
setOnItemSelectListener(OnItemSelectedListener onItemSelectedListener)设置tab切换监听
setScrollBar(ScrollBar scrollBar)设置跟随tab滑动的滑动块
**1.FixedIndicatorView 主要用于固定大小来平均分配tab的情况。**
setSplitMethod(int splitMethod) 设置tab分割方式，平均分割，wrap分割，比重分割
setCenterView(View centerView, ViewGroup.LayoutParams layoutParams)设置显示在tab中心的View，用于实现新浪微博底部+号
getCenterView();
**2.ScrollIndicatorView 主要用于多个tab可以进行滑动。**
setSplitAuto(boolean splitAuto) 设置是否自动分割，当总tab宽度小于Indicator宽度就平均分割tab，或者比重分割。大于Indicator宽度就wrap分割
setPinnedTabView(boolean isPinnedTabView) 设置是否固定第一个tab
setPinnedShadow(Drawable shadowDrawable, int shadowWidth)设置固定tab的阴影
**3.RecyclerIndicatorView 主要用于无数个tab可以进行滑动。**
优点适用于tab很多的情况，缺点tab少的时候没有ScrollIndicatorVie的自动分割功能。
方法：
>**<1>setAdapter(IndicatorAdapter adapter)**
> 设置适配器
>注意：在使用indicatorViewPager后这个方法会被indicatorViewPager使用
>**<2> setOnItemSelectListener(OnItemSelectListener listener)**
>设置选中监听
>注意：在使用indicatorViewPager后这个方法会被indicatorViewPager使用
>**<3> setOnIndicatorItemClickListener(OnIndicatorItemClickListener listener)**
>设置Indicator tab项的点击事件，在Indicator 的 onItemSelectListener前触发和拦截处理
>**<4> setOnTransitionListener(OnTransitionListener listener)**
> 设置滑动变化的转换监听，tab在切换过程中会调用此监听
>设置它可以自定义实现在滑动过程中，tab项的字体变化，颜色变化等等效果
>**<5> setScrollBar(ScrollBar scrollBar)**
> 设置滑动块,设置它可以自定义滑动块的样式
>
## 3.indicatorViewPager
用于将ViewPager和Indicator 联合使用。
indicatorViewPager.setAdapter(IndicatorPagerAdapter adapter)
// 设置它可以自定义实现在滑动过程中，tab项的字体变化，颜色变化等等过渡效果
indicatorViewPager.setIndicatorOnTransitionListener(onTransitionListener);
// 设置它可以自定义滑动块的样式
indicatorViewPager.setIndicatorScrollBar(scrollBar);
// 设置page是否可滑动切换
indicatorViewPager.setPageCanScroll(false);
/*
* 设置缓存界面的个数，左右两边缓存界面的个数，不会被重新创建。 默认是1，表示左右两边
* 相连的1个界面和当前界面都会被缓存住，比如切换到左边的一个界面，那个界面是不会重新创建的。
*/
indicatorViewPager.setPageOffscreenLimit(1);
/*
* 设置预加载界面的个数。左右两边加载界面的个数 默认是1，表示左右两边 相连的1个界面会和当前界面同时加载
*/
indicatorViewPager.setPagePrepareNumber(1);
// 设置页面切换监听
indicatorViewPager.setOnIndicatorPageChangeListener(onIndicatorPageChangeListener);
// 设置page间的图片的宽度
indicatorViewPager.setPageMargin(1);
// 设置page间的图片
indicatorViewPager.setPageMarginDrawable(d);
## 4.BannerComponent （无限轮播Banner）
继承于IndicatorViewPager，所以使用方法和IndicatorViewPager一样
setAutoPlayTime(long time) 设置自动播放的间隔时间
startAutoPlay(); 开始播放
stopAutoPlay(); 停止播放
## 5.IndicatorPagerAdapter
子类IndicatorFragmentPagerAdapter 用于 界面是fragment的形式。
子类IndicatorViewPagerAdapter 用于 界面是View的形式.
indicatorViewPager.setOnIndicatorPageChangeListener(onIndicatorPageChangeListener)设置界面的切换监听。
Indicator 既可以单独使用。也可以通过indicatorViewPager的形式联合viewpager一起使用。
## 6.ScrollBar
tab的滑动块通过indicatorViewPager.setIndicatorScrollBar(scrollBar);进行设置
子类有
ColorBar 颜色的滑动块
DrawableBar 图片滑动块
LayoutBar 布局滑动块
TextWidthColorBar 大小同tab里的text一样宽的颜色的滑动块
SpringBar 实现拖拽效果的圆形滑动块 该类修改于https://github.com/chenupt/SpringIndicator
## 7.OnTransitionListener
子类有
OnTransitionTextListener tab的字体颜色变化，和字体大小变化效果
## 8.LazyFragment or ProxyLazyFragment 懒加载Fragment
#### 懒加载原理
一开始onCreateView的时候只是加载一个空的FrameLayout
当通过结合onCreateView和setUserVisibleHint两个方法进行判断是否需要加载真正的布局界面，需要的时候再把实际的布局加载上去
#### 继承 LazyFragment实现懒加载
Fragment继承该类实现 显示Framgment的时候才会去创建你自己的界面布局，否则不创建。
1. 继承于LazyFragment
2. 回调方法：
onCreateViewLazy 对应 onCreateView
onDestroyViewLazy 对应 onDestroyView
onResumeLazy 对应 onResume
onPauseLazy 对应 onPause
onDestroy 和 onCreate 方法不变
另外添加了onFragmentStartLazy fragment显示的时候调用，在ViewPager界面切换的时候你就可以通过这个判断是否显示
onFragmentStopLazy fragment不显示的时候调用
上面所有有lazy结尾的方法都意味着 真正的布局正在显示
3. 使用方法
放心在onCreateViewLazy 的时候创建布局，初始化数据。调用该方法的时候，界面已经要显示啦
在onDestroyViewLazy的方法里面做释放操作
#### 通过ProxyLazyFragment 代理 实际的Fragment实现懒加载
该代理LazyFragment的思想源于 https://github.com/shenguojun/LazyFragmentTest ，不过里面有些实现细节有点不一样
1. 调用 ProxyLazyFragment.lazy(BookFragment.class, arguments)，其中BookFragment不限制继承可以直接继承Fragment
```
Bundle arguments = new Bundle();
arguments.putInt(BookFragment.EXTRA_INT_POSITION, position);
ProxyLazyFragment fragment = ProxyLazyFragment.lazy(BookFragment.class, arguments);
```
## 主力类库
**1.https://github.com/LuckyJayce/ViewPagerIndicator**
Indicator 取代 tabhost，实现网易顶部tab，新浪微博主页底部tab，引导页，无限轮播banner等效果，高度自定义tab和特效
**2.https://github.com/LuckyJayce/MVCHelper**
实现下拉刷新，滚动底部自动加载更多，分页加载，自动切换显示网络失败布局，暂无数据布局，支持任意view，支持切换主流下拉刷新框架。
**3.https://github.com/LuckyJayce/EventBus-Apt**
事件总线，通过动态代理接口的形式发布,接收事件。定义一个接口把事件发给注册并实现接口的类
**4.https://github.com/LuckyJayce/LargeImage**
大图加载，可供学习
**5.https://github.com/LuckyJayce/GuideHelper**
新手引导页，轻松的实现对应的view上面的显示提示信息和展示功能给用户
**6.https://github.com/LuckyJayce/HVScrollView**
可以双向滚动的ScrollView，支持嵌套ScrollView联级滑动，支持设置支持的滚动方向
**7.https://github.com/LuckyJayce/CoolRefreshView**
下拉刷新RefreshView，支持任意View的刷新 ，支持自定义Header，支持NestedScrollingParent,NestedScrollingChild的事件分发，嵌套ViewPager不会有事件冲突
有了这些类库，让你6的飞起
## 说明
项目 ViewPagerIndicator_Demo 是示例代码。 看了这个例子你会惊奇的发现里面居然都是通过viewpager实现，没有使用tabhost，而所有形式的tab都是用Indicator实现。
项目 ViewPagerIndicator_Library 是类库
有什么建议可以发到我的邮箱 [email protected]
License
=======
Copyright 2014 shizhefei（LuckyJayce）
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.