鸿蒙页面滑动组件,代码已开源!-鸿蒙 滑动

基于安卓平台的页面滑动组件 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

上一篇 2023-04-25 08:01:38
下一篇 2023-04-25 10:15:18

相关推荐

联系云恒

在线留言: 我要留言
客服热线:400-600-0310
工作时间:周一至周六,08:30-17:30,节假日休息。