DragListView开源项目教程-优快云博客

DragListView开源项目教程

DragListViewDrag and drop to reorder items in a list, grid or board for Android. Based on RecyclerView. Also supports swiping items in a list.项目地址:https://gitcode.com/gh_mirrors/dr/DragListView

项目介绍

DragListView是一款Android库，专为那些希望在列表、网格或看板中实现项目重新排序功能的应用设计。该组件不仅支持传统的上下滑动，还特别加入了横向滑动项目的能力，极大地丰富了交互方式。它适用于各种场景，如任务管理器、笔记应用或是任何需要动态调整显示元素顺序的应用界面。

项目快速启动

要快速集成DragListView到你的项目中，首先确保你的项目兼容Android SDK并配置了Gradle构建系统。接着，遵循以下步骤：

添加依赖

在你的build.gradle（Module级别）文件中，添加DragListView的依赖。由于没有具体的版本号，假设这是一个示例流程，实际使用时应替换为项目的最新版本或通过JitPack获取。

dependencies {
    implementation 'com.github.woxblom:DragListView:latest.version'
}

同步 Gradle 项目后，你可以开始使用DragListView。

示例代码

在布局文件中添加DragListView控件：

<com.example.DragListView
    android:id="@+id/drag_list_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

然后，在Activity或Fragment中初始化并设置监听事件：

DragListView mDragListView = findViewById(R.id.drag_list_view);

// 设置布局管理器，这里以LinearLayoutManager为例
mDragListView.setLayoutManager(new LinearLayoutManager(this));

// 创建适配器并设置给DragListView
List<Item> mItemArray = ...; // 初始化数据
ItemAdapter listAdapter = new ItemAdapter(mItemArray, R.layout.list_item, R.id.image, false);
mDragListView.setAdapter(listAdapter);

// 禁止水平拖动，若需启用则设为true
mDragListView.setCanDragHorizontally(false);

// 监听拖拽开始和结束事件
mDragListView.setOnItemDragListener(new OnItemDragListener() {
    @Override
    public void onItemDragStarted(int position) {
        Toast.makeText(getBaseContext(), "开始 - 位置: " + position, Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onItemDragEnded(int fromPosition, int toPosition) {
        if (fromPosition != toPosition) {
            Toast.makeText(getBaseContext(), "结束 - 新位置: " + toPosition, Toast.LENGTH_SHORT).show();
        }
    }
});