【软通动力】HarmonyOS三方件开发指南(13)-SwipeLayout侧滑删除原创

软通田可辉

发布于 2021-2-24 11:30

浏览

19收藏

1. SwipeLayout组件功能介绍
1.1.功能介绍：
SwipeLayout组件是一个侧滑删除组件。

1.2. 模拟器上运行效果：
【软通动力】HarmonyOS三方件开发指南(13)-SwipeLayout侧滑删除-鸿蒙开发者社区

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>1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
88.
89.
90.
91.
92.
93.
94.
95.
96.

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);1.
2.
3.
4.
5.
6.
7.
8.
9.
10.

3. SwipeLayout开发实现
3.1. 新建一个Module
新建一个Module，类型选择HarmonyOS Library，模块名为SwipeLayout，如图

【软通动力】HarmonyOS三方件开发指南(13)-SwipeLayout侧滑删除-鸿蒙开发者社区

3.2. 新建一个SwipeLayout类
新建一个SwipeLayout类，继承自PositionLayout类
SwipeLayout的主要流程：

1. 首先通过xml的构造方法，为SwipeLayout添加拖拽监听；
2. 将LinkedHashMap<DragEdge, Component> mDragEdges初始化为空，并确定主界面的显示位置；
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);
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.

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);
}1.
2.
3.
4.
5.
6.
7.
8.

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();
    }
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.