Cleveroad介绍了滑动教程库为Android
嘿,伙计们,希望你还没有开始开发Android应用教程然而,当我们已经完成了自己的工作的一部分。别担心,我们只从良好的动机行事。我们的目标是帮助您创建在一个快速和简单的方式滑动教程。因此,我们已经做了一些工作,瞧!一个简单的Android滑动教程库为您服务。
本发明是要缓解结构设计问题,但不能在同一时间限制你的想象力的舒展。我们采取了适应性方面的照顾。所以,你的应用程序是不会看其他Android元素之间的外星人。
请阅读我们的案例分析:由Cleveroad滑动教程为Android以确保您不会错过任何一个细节
应用视差效果会让你的产品介绍样子谷歌应用程式教程。
所有你需要做的是:
1.您的教程的每个屏幕创建背景设计(与移动设计协助)
2.您的教程的每个屏幕创建图标
3.按照下面的说明
运用
首先,添加依赖的gradle到您的build.gradle:
dependencies
{
compile
'com.cleveroad:slidingtutorial:1.0.3'
}
有利用图书馆的两种常见的变种:通过TutorialPageProvider并通过TutorialPageOptionsProvider。
通过教程PageProvider
你必须创建页面片段,每个片段必须从扩大PageFragment,覆盖PageFragment#getLayoutResId()和PageFragment#getTransformItems()。你也需要创建图像布局的xml文件。
public
classFirstCustomPageFragment
extendsPageFragment
{
@Override
protected
int
getLayoutResId()
{
return
R.layout.fragment_page_first;
}
@Override
protected
TransformItem[]
provideTransformItems()
{
return
new
TransformItem[]{
//
TransformItem.create(viewfortransform,movingdirection,shift
coefficient)
TransformItem.create(R.id.ivFirstImage,
Direction.LEFT_TO_RIGHT,
0.2f),
TransformItem.create(R.id.ivSecondImage,
Direction.RIGHT_TO_LEFT,
0.06f),
TransformItem.create(R.id.ivThirdImage,
Direction.LEFT_TO_RIGHT,
0.08f),
TransformItem.create(R.id.ivFourthImage,
Direction.RIGHT_TO_LEFT,
0.1f),
TransformItem.create(R.id.ivFifthImage,
Direction.RIGHT_TO_LEFT,
0.03f),
TransformItem.create(R.id.ivSixthImage,
Direction.RIGHT_TO_LEFT,
0.09f),
TransformItem.create(R.id.ivSeventhImage,
Direction.RIGHT_TO_LEFT,
0.14f),
TransformItem.create(R.id.ivEighthImage,
Direction.RIGHT_TO_LEFT,
0.07f)
};
}
}
通过TutorialPageProvider实例TutorialOptions.Builder#setTutorialPageProvider(TutorialPageProvider).
public
classCustomTutorialFragment
extendsTutorialFragment
{
private
static
final
int
TOTAL_PAGES
=
3;
private
final
TutorialPageProvider<Fragment>
mTutorialPageProvider=
new
TutorialPageProvider<Fragment>()
{
@NonNull
@Override
public
FragmentprovidePage(int
position)
{
switch
(position){
case
0:
return
new
FirstCustomPageFragment();
case
1:
return
new
SecondCustomPageFragment();
case
2:
return
new
ThirdCustomPageFragment();
default:
throw
new
IllegalArgumentException("Unknown
position:"
+
position);
}
}
};
@Override
protected
TutorialOptionsprovideTutorialOptions()
{
return
newTutorialOptionsBuilder(getContext())
.setPagesCount(TOTAL_PAGES)
.setTutorialPageProvider(mTutorialPageProvider)
.build();
}
}
通过教程页面OptionsProvider
或者你也可以创建TutorialPageOptionsProvider并将它传递给TutorialOptions.Builder#setTutorialPageProvider(TutorialPageOptionsProvider)。它会自动提供PageFragment实例指定PageOptions组态。
public
classCustomTutorialFragment
extendsTutorialFragment
{
private
static
final
int
TOTAL_PAGES
=
3;
private
final
TutorialPageOptionsProvidermTutorialPageOptionsProvider=
new
TutorialPageOptionsProvider(){
@NonNull
@Override
public
PageOptionsprovide(int
position)
{
@LayoutRes
int
pageLayoutResId;
TransformItem[]
tutorialItems;
switch
(position){
case
0:
{
pageLayoutResId
=
R.layout.fragment_page_first;
tutorialItems
=
new
TransformItem[]{
TransformItem.create(R.id.ivFirstImage,
Direction.LEFT_TO_RIGHT,
0.2f),
TransformItem.create(R.id.ivSecondImage,
Direction.RIGHT_TO_LEFT,
0.06f),
TransformItem.create(R.id.ivThirdImage,
Direction.LEFT_TO_RIGHT,
0.08f),
TransformItem.create(R.id.ivFourthImage,
Direction.RIGHT_TO_LEFT,
0.1f),
TransformItem.create(R.id.ivFifthImage,
Direction.RIGHT_TO_LEFT,
0.03f),
TransformItem.create(R.id.ivSixthImage,
Direction.RIGHT_TO_LEFT,
0.09f),
TransformItem.create(R.id.ivSeventhImage,
Direction.RIGHT_TO_LEFT,
0.14f),
TransformItem.create(R.id.ivEighthImage,
Direction.RIGHT_TO_LEFT,
0.07f)
};
break;
}
case
1:
{
pageLayoutResId
=
R.layout.fragment_page_second;
tutorialItems
=
new
TransformItem[]{
TransformItem.create(R.id.ivFirstImage,
Direction.RIGHT_TO_LEFT,
0.2f),
TransformItem.create(R.id.ivSecondImage,
Direction.LEFT_TO_RIGHT,
0.06f),
TransformItem.create(R.id.ivThirdImage,
Direction.RIGHT_TO_LEFT,
0.08f),
TransformItem.create(R.id.ivFourthImage,
Direction.LEFT_TO_RIGHT,
0.1f),
TransformItem.create(R.id.ivFifthImage,
Direction.LEFT_TO_RIGHT,
0.03f),
TransformItem.create(R.id.ivSixthImage,
Direction.LEFT_TO_RIGHT,
0.09f),
TransformItem.create(R.id.ivSeventhImage,
Direction.LEFT_TO_RIGHT,
0.14f),
TransformItem.create(R.id.ivEighthImage,
Direction.LEFT_TO_RIGHT,
0.07f)
};
break;
}
case
2:
{
pageLayoutResId
=
R.layout.fragment_page_third;
tutorialItems
=
new
TransformItem[]{
TransformItem.create(R.id.ivFirstImage,
Direction.RIGHT_TO_LEFT,
0.2f),
TransformItem.create(R.id.ivSecondImage,
Direction.LEFT_TO_RIGHT,
0.06f),
TransformItem.create(R.id.ivThirdImage,
Direction.RIGHT_TO_LEFT,
0.08f),
TransformItem.create(R.id.ivFourthImage,
Direction.LEFT_TO_RIGHT,
0.1f),
TransformItem.create(R.id.ivFifthImage,
Direction.LEFT_TO_RIGHT,
0.03f),
TransformItem.create(R.id.ivSixthImage,
Direction.LEFT_TO_RIGHT,
0.09f),
TransformItem.create(R.id.ivSeventhImage,
Direction.LEFT_TO_RIGHT,
0.14f)
};
break;
}
default:
{
throw
new
IllegalArgumentException("Unknown
position:"
+
position);
}
}
return
PageOptions.create(pageLayoutResId,
position,tutorialItems);
}
};
@Override
protected
TutorialOptionsprovideTutorialOptions()
{
return
newTutorialOptionsBuilder(getContext())
.setPagesCount(TOTAL_PAGES)
.setTutorialPageProvider(mTutorialPageOptionsProvider)
.build();
}
}
与应用程序兼容性库(推荐方式)使用
下面是在代码中使用更改列表SlidingTutorial库AppCompat图书馆:
您的片段页必须扩展PageSupportFragment。
您的教程片段必须扩展TutorialSupportFragment.
TutorialPageProvider必须提供[b]android.support.v4.app.Fragment[/b]实例。就这样。
定制
设置跳过按钮点击监听器
你必须实现View.OnClickListener接口,并提供给TutorialOptions.Builder#setOnSkipClickListener(OnClickListener).例:
public
classCustomTutorialFragment
extendsTutorialFragment
{
@Override
protected
TutorialOptionsprovideTutorialOptions()
{
return
newTutorialOptionsBuilder(getContext())
.setOnSkipClickListener(new
View.OnClickListener(){
@Override
public
void
onClick(View
v)
{
Toast.makeText(getContext(),
"Skip
buttonclicked",
Toast.LENGTH_SHORT).show();
}
})
//
setupotherconfiguration...
.build();
}
}
设置页面颜色
只需提供颜色值的数组TutorialOptions.Builder#setPagesColors(intarray).颜色数组的长度必须等于页面数。
public
classCustomTutorialFragment
extendsTutorialFragment
{
private
static
final
int
TOTAL_PAGES
=
3;
private
int[]
pagesColors=
new
int[]{Color.RED,
Color.BLUE,
Color.DKGRAY
};
@Override
protected
TutorialOptionsprovideTutorialOptions()
{
return
newTutorialOptionsBuilder(getContext())
.setPagesCount(TOTAL_PAGES)
.setPagesColors(pagesColors)
//
setupotherconfiguration...
.build();
}
}
无限滚动
要循环教程页面已设置TutorialOptions.Builder#setUseInfiniteScroll(boolean)至
true
从去年的教程页面滚动到你的内容–自动删除片段教程
如果你想提供从去年的教程页面平滑过渡到内容–只是设置TutorialOptions.Builder#setUseAutoRemoveTutorialFragment(boolean)至true
指标视图定制
有IndicatorOptions类配置指标视图。这里的例子:
public
classCustomTutorialFragment
extendsTutorialFragment
{
@Override
protected
TutorialOptionsprovideTutorialOptions()
{
return
newTutorialOptionsBuilder(getContext())
.setIndicatorOptions(IndicatorOptions.newBuilder(getContext())
.setElementSizeRes(R.dimen.indicator_size)
.setElementSpacingRes(R.dimen.indicator_spacing)
.setElementColorRes(android.R.color.darker_gray)
.setSelectedElementColor(android.R.color.white)
.setRenderer(Drawable.create(getContext()))
.build())
//
setupotherconfiguration...
.build();
}
}
正如你所看到的,您可以指定元素大小,元间距(即填充),元素的颜色,选择元素颜色和实施Renderer接口。里面有2默认实现Renderer.Factory:
Renderer.Factory#newCircleRenderer()-绘制圆形指标
Renderer.Factory#newSquareRenderer()-绘制方形指标
此外样品模块中有两种实现方式:
DrawableRenderer-绘制绘制背景指标
RhombusRenderer-绘制菱形指标
添加OnTutorialPageChangeListener
你可以听的改变页面事件–只是实现OnTutorialPageChangeListener并通过添加监听器TutorialFragment#addOnTutorialPageChangeListener(OnTutorialPageChangeListener).要删除监听器使用TutorialFragment#removeOnTutorialPageChangeListener(OnTutorialPageChangeListener).在OnTutorialPageChangeListener#onPageChanged(int)方法您将收到一个页面索引每次页面的变化。如果启用TutorialOptions.Builder#setUseAutoRemoveTutorialFragment(boolean)至如此,您将收到TutorialFragment.EMPTY_FRAGMENT_POSITION(要么TutorialSupportFragment.EMPTY_FRAGMENT_POSITION如果您正在使用支持库)的页面索引。
public
classCustomTutorialFragment
extendsTutorialFragment
implements
OnTutorialPageChangeListener
{
private
static
final
StringTAG
=
"CustomTutorialFragment";
@Override
public
void
onCreate(Bundle
savedInstanceState)
{
super.onCreate(savedInstanceState);
addOnTutorialPageChangeListener(this);
}
@Override
public
void
onPageChanged(int
position)
{
Log.i(TAG,
"onPageChanged:
position="
+
position);
if
(position==
TutorialFragment.EMPTY_FRAGMENT_POSITION)
{
Log.i(TAG,
"onPageChanged:
Emptyfragmentisvisible");
}
}
}
GitHublink-https://github.com/Cleveroad/SlidingTutorial-Android
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理