Jetpack 叒一新成员 DragAndDrop 框架:大大简化拖放手势开发
Posted TechMerger
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Jetpack 叒一新成员 DragAndDrop 框架:大大简化拖放手势开发相关的知识,希望对你有一定的参考价值。
对于
拖放
功能,大家并不陌生,这是在桌面端最稀松平常的操作,比如将文件拖入回收站。随着移动设备的大屏趋势、可折叠设备的愈加发完善,拖放操作在移动平台里端也显得愈加必要和流行!针对拖放功能的实现,android 平台现存的方案略为复杂。基于此,
Jetpack
框架集合里推出了新成员DragAndDrop
。本文着重阐述该框架的愿景和核心要点,主要内容译自
Android
开发者关系工程师Paul
在Meduim
上的 Post:Simplifying drag and drop。
本质来说,拖放
手势(drag and drop
)指的是用户通过点击选择图片
、文本
或者其他数据元素
,然后直接拖放到 App 的其他界面、甚至其他 App 的界面,接着这个数据就被纳入到新的界面内。这个手势通常表现为在触摸屏上的长按拖动
或者非触摸屏上的单击并用鼠标拖动
,最后在目标位置`放下。
来看一个 App 内典型的拖放效果:
尽管 Android 一直长期支持拖放功能的实现(比如早在 Android 3.0
即加入的 DragEvent
API),但事实证明:想要完整、顺畅地实现针对过程中的手势
、触摸事件
、权限
以及回调
的集成,往往比较困难和复杂。
现在我想向大家推荐 Jetpack 的新成员 DragAnd Drop 框架,目前处于 alpha
版本,其旨在辅助你更加简单地处理拖放 App 内的数据。
在 build.gradle 里引入依赖,即可使用。
implementation 'androidx.draganddrop:draganddrop:1.0.0-alpha02'
拖放功能的使用在大屏设备
上日益频繁,比如平板电脑和笔记本电脑,尤其是可折叠
设备。在这种类型的设备上进行分屏的操作比传统的智能手机多了高达 7 倍。他们的用户常常需要使用分屏
或多窗口
(https://developer.android.com/guide/topics/large-screens/multi-window-support) 模式来处理多任务
的场景,而将数据在不同的 App 间拖放是再自然不过的体验和需求!
Android 平台原生已经支持从输入框控件 EditText
拖动文本,但我们强烈建议开发者实现用户从其他控件拖动数据的功能,支持的数据类型除了文本以外,还能包括图片、文件等任意类型。当然了,反向支持数据从其他 App 拖放进来也同等重要,并值得鼓励。
来看一个 App 之间拖放文本和图片的示例效果:
DragStartHelper
,结合 DropHelper
构成了整个框架最核心的 API,它们可以轻松实现手势支持、数据的回调、样式和像素级的 UI 对齐等实现环节。
DragStartHelper
作为 Jetpack 框架集合 core
包下的工具类, DragStartHelper
负责监测拖动手势的开始时机。这些手势包括长按拖动、单击并用鼠标拖动等。
使用起来很简单,将需要监听的视图包装进来并开始监听。框架会在拖动手势触发的时候回调过来,之后进行一些简单的配置即可。
- 将需要传递的数据包装到
ClipData
中 - 新建用于展示拖动效果的图片实例
DragShadowBuilder
- 将数据和拖动效果外加一些 Flag 交由 View 的原生方法
startDragAndDrop()
进行后续的动作,包括效果的展示和数据的传递等
// Make a view draggable to share a file. DragStartHelper takes care of
// intercepting drag gestures and attaching the listener.
DragStartHelper(draggableView) view, _ ->
// Sets the appropriate MIME types automatically.
val dragClipData = ClipData.newUri(contentResolver, "File", fileUri)
// Set the visual look of the dragged object.
// Can be extended and customized; we use the default here.
val dragShadow = View.DragShadowBuilder(view)
// Starts the drag. Note that the global flag allows for cross-app dragging.
view.startDragAndDrop(
dragClipData,
dragShadow,
null, // Optional extra local state information
// Since this is a "content:" URI and not just plain text, we can use the
// DRAG_FLAG_GLOBAL_URI_READ to allow other apps to read from our content
// provider. Without it, other apps won't receive the drag events.
DRAG_FLAG_GLOBAL or DRAG_FLAG_GLOBAL_URI_READ)
)
.attach()
DropHelper
另一个核心工具类 DropHelper
,则关心拖动数据放下的时机和目标视图。
适配的代码简单来讲:
- 需要针对可拖放数据的试图调用
configureView
方法 - 其内部还需要设定关心的数据类型即
Mime Type
- 指定一些其他可选参数实例
DropHelper.Options
,比如放下时高亮的颜色和视图范围等 - 最后设置最重要的放下监听器
OnReceiveContentListener
,去从 ClipData 中取得数据执行上传、显示等处理,当然还包括不匹配的警告或视图提醒等
注意:构建 DropHelper.Options
实例的时候,记得调用 addInnerEditTexts()
,这样可以确保嵌套的 EditText 控件不会抢夺视图焦点。
DropHelper.configureView(
// Activity that will handle the drop
this,
// Target drop view to be highlighted
outerDropTarget,
// Supported MIME types
arrayOf(MIMETYPE_TEXT_PLAIN, "image/*"),
// Options for configuring drop targets
DropHelper.Options.Builder()
// To ensure proper drop target highlighting, all EditText elements in
// the drop target view hierarchy must be included in a call to this
// method. Otherwise, an EditText within the target, rather than the
// target view itself, acquires focus during the drag and drop operation.
.addInnerEditTexts(innerEditText)
.build()
) _, payload ->
// Process the payload here, returning any content that should be delegated to
// the platform.
...
了解更多
如上只是精简的介绍,更多细节可以到如下的官方文档进行详细地了解:
当然,也可以通过官方的完备 DEMO 进行更深入地学习和实践:
还有一点尤为重要,记得在 Android Issue
网站反馈你遇到的 Bug 或意见:
- https://issuetracker.google.com/issues/new?component=1139019
最后,如果你觉得我的阐述存在难以理解的地方,不妨阅读本文翻译的原文:
以上是关于Jetpack 叒一新成员 DragAndDrop 框架:大大简化拖放手势开发的主要内容,如果未能解决你的问题,请参考以下文章
Jetpack 叒一新成员 DragAndDrop 框架:大大简化拖放手势开发
Jetpack 又双叒一新成员 DragAndDrop 框架:大大简化拖放手势开发
Jetpack DragAndDrop 库——拖放操作如此轻松