基于安卓平台的页面滑动组件 ViewPagerIndicator,实现了鸿蒙化迁移和重构,代码已开源,目前已经获得了很多人的 Star 和 Fork,欢迎各位下载使用并提出宝贵意见!
开源代码: https://gitee.com/isrc_ohos/view-pager-indicator
ViewPagerIndicator_ohos 是一个信息展示组件,适用于展示新闻类、购物类等复杂信息。使用传统的页面展示内容时,同种类的信息在同一个页面上展示。
使用 ViewPagerIndicator_ohos 组件展示内容时,一个种类的信息可以在多个页面展示,用户通过滑动屏幕的方式来实现页面切换。
二者的效果对比如图 1 所示:
图 1:ViewPagerIndicator_ohos 组件与传统的页面在展示内容时的区别
组件效果展示
组件应用的主界面中有 3 个按钮,其中,“主页”和“我的”按钮展示的是组件的局部效果,“社区”按钮展示的是组件的整体效果。
此处,我们不再赘述局部效果,直接讲解组件的整体效果,有对其余两个按钮的功能感兴趣的朋友可以下载源码了解。
当用户点击应用底部导航栏区“社区”标签时,组件向用户展示“社区”板块的内容,内容分布在多个页面内。
在应用的顶部有页面指示器,用户可以通过两种方式实现页面的切换效果:
滑动屏幕时,页面随滑动切换,页面指示器始终指示当前正在展示的页面。
点击页面指示器,页面会切换到被选中的指示器所指示的页面。
效果如图 2 所示: 图 2:滑动页面同时指示器显示当前页面功能
Sample 解析
Sample 部分主要用于构建显示布局,MainAbilitySlice 文件负责构建应用主界面布局,CommunityFraction 文件负责构建页面和页面指示器布局,CommunityFraction 形成的 UI 以 Fraction 的形式嵌入到主界面布局中。
①MainAbilitySlice 文件
MainAbilitySlice 文件负责构建组件应用的主界面布局,下面给出布局构建的具体步骤:
第 1 步:设置组件应用的布局文件
组件的主界面布局定义在 ability_main.xml 中,界面包含三个 Button 和一个 StackLayout,前者表示“主页”、“我的”和“社区”按钮,后者表示内容显示页面。
通过 setUIContent() 方法将 ability_main.xml 文件设置为组件应用的主界面布局。 super.setUIContent(ResourceTable.Layout_ability_main);
第 2 步:按钮的定位
在 MainAbilitySlice 文件的 OnStart() 方法中,通过 findComponentById() 的方法实现第 1 步中“社区”按钮的定位。
//“主页”、“我的”和“社区”按钮 private Button basebtn,mybtn,communitybtn; …… //定位“社区”按钮
communitybtn= (Button) findComponentById(ResourceTable.Id_main_community_btn);第 3 步:按钮监听
给“社区”按钮设置点击事件,点击按钮时,将表示社区内容的 CommunityFraction 嵌入到第 1 步的 StackLayout 中,实现点击“社区”按钮后的显示效果。
//设置按钮监听 communitybtn.setClickedListener(this); …… @Override public void onClick(Component component) { //点击事件 switch (component.getId()){ …… case ResourceTable.Id_main_community_btn: displayCommunityFraction(); //将CommunityFraction嵌入主界面布局 break; default: break; } }
②CommunityFraction 文件
CommunityFraction 类继承自 Fraction 类,作为整体显示布局的一部分嵌入 MainAbility 中,不能单独使用。
CommunityFraction 文件负责构建页面和页面指示器布局,此处使用 ViewPager 对象管理页面切换。
使用 TabList 创建页面指示器,将 ViewPager 里的页面与 TabList 里的 Tab 按顺序绑定,以实现组件效果展示中描述的效果,下面给出具体的实现步骤。
第 1 步:创建 CommunityFraction 文件的布局
fraction_community.xml 是 CommunityFraction 文件的布局文件,布局中包含一个 ViewPager 和一个 TabList。
通过 LayoutScatter 类对象的 parse() 方法将 fraction_community.xml 形成一个 Component 对象,方便后续的步骤使用。
Component component = scatter.parse(ResourceTable.Layout_fraction_community, container, false);
第 2 步:导入相关类并声明对象
在 CommunityFraction 文件中导入 ViewPager、PagerAdapter 类,其中 ViewPager 类继承自 PageSlider 类,通过响应屏幕滑动完成页面之间的切换。
PagerAdapter 类继承自 PageSliderProvider 类,提供了页面项管理功能。
导入 ohos.agp.components 下的所有类,其中包含用于创建页面指示器的 TabList 类,和用于设置 TabList 的监听和样式 FixedIndicatorView 类。
import com.shizhefei.view.indicator.CommunityTabListener; import com.shizhefei.view.indicator.FixedIndicatorView; import com.shizhefei.view.viewpager.PagerAdapter; import com.shizhefei.view.viewpager.ViewPager; public class CommunityFraction extends Fraction { …… private ViewPager viewPager; private PagerAdapter adapter; private Component component ; private TabList tabList; ….. }
第 3 步:创建不同的页面
因为 CommunityFraction 类继承自 Fraction 类,因此需要重写 onComponentAttached() 方法,当 CommunityFraction 被添加到主界面布局时,此方法被调用。
在 onComponentAttached() 方法中,用 xml 的方式创建三个不同的显示页面,分别为“页面 1”、“页面 2”、“页面 3”。
@Override protected Component onComponentAttached(LayoutScatter scatter, ComponentContainer container, Intent intent) { …… DirectionalLayout directionalLayout1 = (DirectionalLayout) scatter.parse(ResourceTable.Layout_page1, null, false); //页面1 DirectionalLayout directionalLayout2 = (DirectionalLayout) scatter.parse(ResourceTable.Layout_page2, null, false); //页面2 DirectionalLayout directionalLayout3 = (DirectionalLayout) scatter.parse(ResourceTable.Layout_page3, null, false); //页面3 …… }
同时创建一个元素类型为 Component 的 ArrayList(数组列表),将上述创建的三个页面依次添加到 ArrayList 中。 //创建ArrayList pages = new ArrayList(); //将页面装入ArrayList pages = new ArrayList(); pages.add(directionalLayout1); pages.add(directionalLayout2); pages.add(directionalLayout3);
第 4 步:创建页面指示器
首先定义一个 String 类型的数组,数组的长度决定页面指示器的个数,数组的元素决定页面指示器上的内容。
然后创建一个 TabList 类对象,通过 findComponentById() 方法定位到 fraction_community.xml 中的 TabList。
最后使用 for 循环,将数组里的内容逐个设置为 TabList 里各 Tab 的文本。
private String[] str={“主页1″,”主页2″,”主页3”}; …… this.tabList = tabList; if(this.tabList!=null){ for(int i=0;i<str.length;i++){ //页面数量小于之前设定的tab标签数量 TabList.Tab tab = this.tabList.new Tab(getContext()); tab.setText(str[i]); tabList.addTab(tab); } } //tabList初始化默认选择第一个tab this.tabList.selectTabAt(0);
第 5 步:ViewPager 载入页面
首先实例化 ViewPager 类对象,定位到 fraction_community.xml 里的 ViewPager;并实例化 PagerAdapter 类对象,形成页面管理适配器。
然后通过 setPages() 方法将第 3 步中包含三个页面的 ArrayList 传入适配器中。
最后将适配器和上述 ViewPager 对象绑定,即可实现滑动屏幕后多个页面来回切换的效果。
viewPager = (ViewPager)mcomponent.findComponentById(ResourceTable.Id_pageslider_community); //定位ViewPager adapter = new PagerAdapter(); //实例化PagerAdapter类对象 adapter.setPages(pages); //传入包含三个页面的ArrayList viewPager.setProvider(adapter);第 6 步:实现 TabList 跟随页面切换而变化
为 ViewPager 添加页面滑动监听事件,当页面切换时,执行相应操作来实现 TabList 跟随页面切换而变化的效果。
onPageChosen() 方法用于设置当页面处于被选中状态时执行的操作,在重写方法该方法时,需传入当前被选中的(正在显示的)页面的编号 i,并将 tabList 中相应编号的 Tab 设置为选中状态。
viewPager.addPageChangedListener(new PageSlider.PageChangedListener() { // 页面滑动转换过程中调用 ……. @Override public void onPageChosen(int i) { // i表示页面编号 tabList.selectTabAt(i); // tabIndicator随页面滑动切换而改变 } });
第 7 步:绑定 TabList 并使其按固定大小平均排列
通过 CommunityTabListener 类的 setViewPager() 方法能够将 ViewPager 和 TabList 绑定。
FixedIndicatorView 类的 setFixedIndicator() 方法能够固定 TabList 中各 Tab 的尺寸,实现等距离平均排列的效果。
FixedIndicatorView fixedIndicatorView = new FixedIndicatorView(str,this.tabList); //CommunityTabListener实现了TabList.TabSelectedListener CommunityTabListener tabListener=new CommunityTabListener(); tabListener.setViewPager(viewPager); //设置TabList 监听 fixedIndicatorView.setTabListListener(tabListener); //设置TabList UI风格 fixedIndicatorView.setIndicatorStyle(TabList.INDICATOR_BOTTOM_LINE); //设置TabList的各Tab的长度固定且相等 fixedIndicatorView.setFixedIndicator(true);Library 解析
ViewPagerIndicator_ohos 组件的关键功能包括 ViewPager 页面切换和 TabList 页面指示器切换。
Library 按照上述两个功能划分为两个文件: indicator 文件
viewpager 文件
如图 3 所示:
图 3:Library 部分的工程结构
indicator 文件夹包括 CommunityTabListener、FixedIndicatorView 和 TabListener(在“我的”板块被引用,因此不作详细讲解)。
viewpager 文件夹包括 PagerAdapter 和 ViewPager。接下来将针对上述文件进行具体讲解。
①页面指示器功能实现
(1) CommunityTabListener 功能实现
页面指示器中的各 Tab 标签中设有监听,点击不同的 Tab 可以切换至不同的页面,具体效果可参考图 2。
上述功能具体由 CommunityTabListener 类来完成,该类实现了 TabList 类的 TabSelectedListener 接口。
在此接口中,主要重写三个函数:onSelected()、onUnSelected() 和 onReselected(),分别负责设置当页面上 tab 被选中、未被选中、以及被释放时的行为。
此处设置:当 Tab 被选中时,页面切换到 Tab 指示的页面。 public class CommunityTabListener implements TabList.TabSelectedListener { private ViewPager mviewPager; @Override //页面指示器的某个Tab被选中时调用该方法 public void onSelected(TabList.Tab tab) { int i = tab.getPosition();//获取当前Tab的位置 if(i>=0){//当前tab位置大于0 mviewPager.setCurrentPage(i);// 页面切换到Tab指示的页面 } }
@Override //页面没有被选中时 public void onUnselected(TabList.Tab tab) { }
@Override //页面重新被选中时 public void onReselected(TabList.Tab tab) { }
//ViewPager 传入 public void setViewPager(ViewPager viewPager) { this.mviewPager = viewPager; }}
(2) FixdIndicatorView 功能实现
FixedIndicatorView 类用于设置 TabList 监听事件和 UI 样式。其中,setTabListListener() 方法用来设置指示器的监听。
setFixedIndicator() 方法用来固定 TabList 中各 Tab 的尺寸和位置,实现个 Tab 大小相等且平均排列分布的效果。
//设置页面指示器的监听 public void setTabListListener(TabList.TabSelectedListener tabSelectedListener){ tabList.addTabSelectedListener(tabSelectedListener); }
//设置页面指示器的UI风格 public void setIndicatorStyle(int style){ this.tabList.setIndicatorType(style); }
//设置页面指示器的Tab尺寸固定且相等 public void setFixedIndicator(boolean b){ tabList.setFixedMode(b); }
②页面管理功能实现
(1)PagerAdapter 功能实现
页面管理适配器由 PagerAdapter 类来完成,其主要用于和上述 ViewPager 类对象绑定,可实现滑动屏幕时多个页面切换,提供了页面项管理功能。
setPages() 方法将已经创建好的页面传入适配器。createPageInContainer() 方法用于在特定的位置添加 Page。
在刚载入 ViewPager 的时候,默认显示第一个页面,页面加载需要调用 createPageInContainer() 方法。
第一个页面显示后,用户可能会立刻滑动屏幕,切换到相邻的页面,为了页面的顺滑切换。
在第一个页面显示的同时,相邻页面也需要调用 createPageInContainer() 方法加载出来。
因此在载入 ViewPager 的时候,createPageInContainer() 方法被调用了两遍。
destroyPageFromContainer() 方法用于销毁某个特定的界面。ViewPager 会同时缓存 3 个页面,当我们创建的显示页面多于 3 个时,需要在 ViewPager 中销毁多余页面,防止程序崩溃。
//页面管理适配器 public class PagerAdapter extends PageSliderProvider { private ArrayList pages; //创建页面所需元件 public void setPages(ArrayList pages) { this.pages = pages; } @Override //获取页面数量及大小 public int getCount() { return pages.size(); } @Override //特定位置创建页面 public Object createPageInContainer(ComponentContainer componentContainer, int i) { componentContainer.addComponent(pages.get(i)); return pages.get(i); } @Override //删除特定页面 public void destroyPageFromContainer(ComponentContainer componentContainer, int i, Object o) { componentContainer.removeComponent(pages.get(i)); } //判定是否为同一张Page @Override public boolean isPageMatchToObject(Component component, Object o) { return component==o; } }
(2)ViewPager 功能实现
滑动页面功能由 ViewPager 类来完成,该类继承自 PageSlider,其主要用于通过响应屏幕滑动完成页面之间的切换。
类中预留了三个接口:slideLock()、setCanSlide()、isCanScroll(),用户可以在开发其他功能时调用此接口。
isCanScroll() 方法判断页面是否可以滑动,slideLock() 方法设置页面不可滑动,setCanSlide() 方法设置页面可以滑动。
//接口预留 public class ViewPager extends PageSlider { …… //设置页面不可以滑动 public void slideLock() { this.setSlidingPossible(false); } //设置页面可以滑动 public void setCanSlide() { this.setSlidingPossible(true); } //判断页面是否可以滑动 public boolean isCanScroll() { return getSlidingPossible(); } }
来源:鸿蒙技术社区
免责声明:文章内容来自互联网,本站不对其真实性负责,也不承担任何法律责任,如有侵权等情况,请与本站联系删除。
转载请注明出处:鸿蒙页面滑动组件,代码已开源!-鸿蒙 滑动 https://www.yhzz.com.cn/a/11550.html