您现在的位置是：亿华云 > 系统运维

鸿蒙HarmonyOS三方件开发指南-SwipeLayout侧滑删除

亿华云2025-10-03 02:27:46【系统运维】4人已围观

简介想了解更多内容，请访问：和华为官方合作共建的鸿蒙技术社区https://harmonyos.51cto.com1. SwipeLayout组件功能介绍1.1.功能介绍：SwipeLayout组件是一个

想了解更多内容，鸿蒙请访问：

和华为官方合作共建的侧滑鸿蒙技术社区

https://harmonyos.51cto.com

1. SwipeLayout组件功能介绍

1.1.功能介绍：

SwipeLayout组件是一个侧滑删除组件。

1.2. 模拟器上运行效果：

2. SwipeLayout使用方法

2.1. 新建工程，删除增加组件Har包依赖

在应用模块中添加HAR，鸿蒙只需要将SwipeLayout.har复制到entry\libs目录下即可(由于build.gradle中已经依赖的侧滑libs目录下的*.har，因此不需要再做修改)。删除

2.2. 修改主页面的鸿蒙布局文件

修改主页面的布局文件ability_main.xml，将自定义的侧滑SwipeLayout添加到xml中，将初始状态下展示的删除视图添加到SwipeLayout作为index为0的子视图：

<?xml version="1.0" encoding="utf-8"?> <DirectionalLayout xmlns:ohos="http://schemas.huawei.com/res/ohos" ohos:id="$+id:total1" ohos:height="match_parent" ohos:width="match_parent" ohos:background_element="gray" ohos:orientation="vertical"> <com.isoftstone.swipelayout.SwipeLayout ohos:id="$+id:sample2" ohos:height="80vp" ohos:width="match_parent" ohos:orientation="horizontal"> <Text ohos:id="$+id:bottom_layout1" ohos:height="match_parent" ohos:width="match_parent" ohos:background_element="white" ohos:multiple_lines="true" ohos:padding="10" ohos:text="要有最樸素的生活和最遙遠的夢想，香港云服务器即使明天天寒地凍，鸿蒙山高水遠，侧滑路遠馬亡。删除" ohos:text_alignment="left" ohos:text_size="14fp" ohos:visibility="visible"> </Text> <DirectionalLayout ohos:id="$+id:bottom_wrapper1" ohos:height="match_parent" ohos:width="360px" ohos:background_element="#ddff00" ohos:orientation="horizontal" ohos:visibility="visible"> <Text ohos:id="$+id:Texts1" ohos:height="match_parent" ohos:width="180px" ohos:background_element="#7B1FA2" ohos:left_padding="25" ohos:right_padding="25" ohos:text="收藏" ohos:text_alignment="center" ohos:text_color="#DC143C" ohos:text_size="14fp" ohos:visibility="visible" /> <Text ohos:id="$+id:texts2" ohos:height="match_parent" ohos:width="180px" ohos:background_element="#C7C7CC" ohos:left_padding="25" ohos:right_padding="25" ohos:text="删除" ohos:text_alignment="center" ohos:text_color="#DC143C" ohos:text_size="14fp" ohos:visibility="visible" /> </DirectionalLayout> <Image ohos:id="$+id:images3" ohos:height="match_parent" ohos:width="match_parent" ohos:background_element="gray" ohos:image_src="$media:star" /> <DirectionalLayout ohos:id="$+id:bottom_fronts" ohos:height="match_parent" ohos:width="match_content" ohos:background_element="#ddff00" ohos:orientation="horizontal" ohos:visibility="visible"> <Image ohos:id="$+id:images1" ohos:height="match_parent" ohos:width="180px" ohos:background_element="green" ohos:image_src="$media:star"/> <Image ohos:id="$+id:images2" ohos:height="match_parent" ohos:width="180px" ohos:background_element="red" ohos:image_src="$media:trash"/> </DirectionalLayout> </com.isoftstone.swipelayout.SwipeLayout> <Image ohos:id="$+id:images" ohos:height="match_content" ohos:width="match_content" ohos:background_element="green" ohos:image_src="$media:star" ohos:layout_alignment="horizontal_center" ohos:top_margin="100vp"/> </DirectionalLayout>

2.3. 初始化SwipeLayout

在MainAbilitySlince类的鸿蒙onStart函数中，增加如下代码。侧滑

SwipeLayout swipeLayout = (SwipeLayout) findComponentById(ResourceTable.Id_sample1); DirectionalLayout right = (DirectionalLayout) findComponentById(ResourceTable.Id_bottom_wrapper); //初始化 swipeLayout.initializeSwipe(); DirectionalLayout left = (DirectionalLayout) findComponentById(ResourceTable.Id_bottom_front); Image image3 = (Image) findComponentById(ResourceTable.Id_image3); //将各个方向拖拽时对应展示的删除视图添加到swipeLayout swipeLayout.addDrag(SwipeLayout.DragEdge.Left, right); swipeLayout.addDrag(SwipeLayout.DragEdge.Right, left); swipeLayout.addDrag(SwipeLayout.DragEdge.Bottom, image3);

3. SwipeLayout开发实现

3.1. 新建一个Module

新建一个Module，类型选择HarmonyOS Library，模块名为SwipeLayout，如图

3.2. 新建一个SwipeLayout类

新建一个SwipeLayout类，继承自PositionLayout类

SwipeLayout的主要流程：

1. 首先通过xml的构造方法，为SwipeLayout添加拖拽监听;

2. 将LinkedHashMap

3. 通过public void addDrag(DragEdge dragEdge, Component child) 方法将可拖拽的方向和对应展示的视图添加到mDragEdges，并设置其初始的ContentPosition;

public void addDrag(DragEdge dragEdge, Component child) { mDragEdges.put(dragEdge, child); switch (dragEdge) { case Left: child.setContentPosition(getWidth(), 0); break; case Right: HiLog.info(label, "Log_addDrag" + child.getHeight()); child.setContentPosition(-child.getWidth(), 0); break; case Top: child.setContentPosition(0, getHeight()); break; case Bottom: child.setContentPosition(0, -child.getHeight()); break; } child.setVisibility(INVISIBLE); addComponent(child, 0); }

4.在拖拽动作的服务器托管监听回调方法中完成对视图的更新

A.在update回调中设置打开和关闭的边界以及边界内的位置刷新

if (getSurfaceView().getContentPositionY() + dragInfo.yOffset <= 0) { close(); } else if (getSurfaceView().getContentPositionY() + dragInfo.yOffset >= getHeight()) { open(); } else { getSurfaceView().setContentPositionY(getSurfaceView().getContentPositionY() + (float) dragInfo.yOffset); getCurrentBottomView().setContentPositionY(getCurrentBottomView().getContentPositionY() + (float) dragInfo.yOffset); }

B.在end中判断滑动的距离，如果大于设定的滑动距离则直接将控件展开或者关闭

if (isCloseBeforeDrag && mDragDistanceY < 0) { if (Math.abs(mDragDistanceY) >= mWillOpenPercentAfterClose * getBottomViewHeight()) { open(); } else { close(); } } if (!isCloseBeforeDrag && mDragDistanceY > 0) { if (Math.abs(mDragDistanceY) >= mWillOpenPercentAfterClose * getBottomViewHeight()) { close(); } else { open(); } }

3.3. 编译HAR包

利用Gradle可以将HarmonyOS Library库模块构建为HAR包，构建HAR包的方法如下：

在Gradle构建任务中，双击PackageDebugHar或PackageReleaseHar任务，构建Debug类型或Release类型的HAR。

待构建任务完成后，可以loadingview> bulid > outputs > har目录中，获取生成的HAR包。

项目源代码地址：https://github.com/isoftstone-dev/SwipeBackLayout

欢迎交流：HWIS-HOS@isoftstone.com

想了解更多内容，请访问：

和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com