這是一個 ListContainer 的粘性頭部裝飾器組件,主要用于展示列表+粘性頭部的滑動效果。
原理解析
UI 顯示部分如下圖所示,基礎(chǔ)布局采用 TabList+PageSlider 聯(lián)動,實(shí)現(xiàn)翻頁滑動效果,TabList 實(shí)現(xiàn) page 頁 title 自定義顯示,PageSlider 通過加載不同的布局顯示對應(yīng)滑動列表。
單個 page 頁面中采用 ListContainer+Text,header 頭部是使用懸停的 Text 控件來顯示的,根據(jù)需要顯示的頭部類型來加載 Text 控件數(shù)量。
這里需要注意:HarmonyOS SDK 6 及之前版本仍不支持 PageSlider 添加 Fraction,故采用 PageSlider 添加 ComponentContainer 方式實(shí)現(xiàn)相似效果。
滑動處理邏輯如下:
-
首先在滑動監(jiān)聽接口中通過獲取觸摸點(diǎn) Y 坐標(biāo)值 point.getY() 來判斷上下滑動方向。
-
通過 Header 頭部類型判斷需要執(zhí)行的代碼邏輯,僅在需要更新 herader 頭部顯示時添加移動動畫效果。
不同 header 頭部類型滑動事件的處理思路是一樣的,單頭部 StickyHeader 邏輯如下:
-
假設(shè) herader 頭部高度為 Y,列表單個 Item 高度為 Y,當(dāng)觸發(fā)列表向上滾動且當(dāng)前列表顯示在屏幕中的第二個 Item 是新的 Header 數(shù)據(jù)時,開始對 Text 控件執(zhí)行向上滑動的動畫效果。
-
當(dāng)觸發(fā)列表向下滾動且當(dāng)前列表顯示在屏幕中的第一個 Item 是新的 Header 數(shù)據(jù)時,開始對 Text 控件執(zhí)行向下滑動的動畫效果。在滑動過程中,通過獲取指定 Item.getTop() 與 Header 頭部高度 Y 的差值。
-
確定 Text 控件每次需要移動的 Y 軸坐標(biāo) moveY,該區(qū)間值 moveY 是 0 到 -Y 之間。最后通過調(diào)用 setContentPositionY() 方法實(shí)現(xiàn)控件滑動動畫。
使用說明
Java 調(diào)用示例:
使用1:
//獲取ListContainer
ListContainerlistContainer=(ListContainer)rootView.findComponentById(ResourceTable.Id_list_double_inline);
//需要的數(shù)據(jù)
ListdataList=Utils.getDoubleInlineList();
listContainer.setItemProvider(newInlineDoubleHeaderTestAdapter(context,dataList));
//將TextListContainer列表與HeaderDecor進(jìn)行綁定
HeaderDecorheaderDecor=newHeaderDecor(listContainer,headerText,doubleText);
//headerDecor調(diào)用setDataList()方法即可
headerDecor.setDataList(dataList);
使用2:
Texttext=(Text)rootView.findComponentById(ResourceTable.Id_title_text);
//獲取ListContainer
ListContainerlistContainer=(ListContainer)rootView.findComponentById(ResourceTable.Id_list_sticky_inline);
//需要的數(shù)據(jù)
ListdataList=Utils.getStickyInlineList();
listContainer.setItemProvider(newInlineStickyTestAdapter(context,dataList));
//將TextListContainer列表與HeaderDecor進(jìn)行綁定
HeaderDecorheaderDecor=newHeaderDecor(listContainer,text);
//headerDecor調(diào)用setDataList()方法即可
headerDecor.setDataList(dataList);
該三方庫目前已經(jīng)在 gitee 上開源并且發(fā)布 lib 倉庫,可以在 moudle 級別下的 build.gradle 文件中添加依賴。
//添加maven倉庫
repositories{
maven{
url'https://s01.oss.sonatype.org/content/repositories/releases/'
}
}
//添加依賴庫
dependencies{
implementation'com.gitee.chinasoft_ohos1.0.0'
}
源碼下載
以上就是 Header-Decor 的介紹,代碼已經(jīng)開源到header-decor,歡迎各位下載使用并提出寶貴意見!
https://gitee.com/chinasoft2_ohos/header-decor
-
操作系統(tǒng)
+關(guān)注
關(guān)注
37文章
7402瀏覽量
129321 -
鴻蒙系統(tǒng)
+關(guān)注
關(guān)注
183文章
2642瀏覽量
69857 -
HarmonyOS
+關(guān)注
關(guān)注
80文章
2153瀏覽量
36060
原文標(biāo)題:鴻蒙粘性頭部裝飾器組件,已開源!
文章出處:【微信號:gh_834c4b3d87fe,微信公眾號:OpenHarmony技術(shù)社區(qū)】歡迎添加關(guān)注!文章轉(zhuǎn)載請注明出處。
發(fā)布評論請先 登錄
鴻蒙非侵入式彈窗新解法,企查查正式開源“QuickDialog”彈窗組件庫
蜻蜓FM開源“SmartXPlayer”音頻播放組件,打造鴻蒙多端音頻播放新引擎
【HarmonyOS 5】鴻蒙頁面和組件生命周期函數(shù)
【HarmonyOS 5】金融應(yīng)用開發(fā)鴻蒙組件實(shí)踐
飛書開源“RTV”富文本組件 重塑鴻蒙應(yīng)用富文本渲染體驗(yàn)
鴻蒙5開發(fā)寶藏案例分享---Swiper組件性能優(yōu)化實(shí)戰(zhàn)
鴻蒙5開發(fā)寶藏案例分享---瀑布流優(yōu)化實(shí)戰(zhàn)分享
鴻蒙5開發(fā)寶藏案例分享---分析幀率問題
HarmonyOS實(shí)戰(zhàn):組件化項(xiàng)目搭建
鴻蒙ListContainer粘性頭部裝飾器組件
評論