pragmatic-drag-and-drop

<div align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://github.com/alexreardon/files/assets/2182637/4405f071-4d88-4ad7-bcc0-a050420f3f3e" height="372px" width="372px" aria-label="实用拖放功能标志"> <img src="https://github.com/alexreardon/files/assets/2182637/9e57e0bb-aa9b-4552-affa-59aecf70bfc0" height="372px" width="372px" aria-label="实用拖放功能标志"> </picture>

适用于任何技术栈的快速拖放功能

📖 文档 | 🤹 示例 | 🎥 工作原理

</div> <br/>

关于

实用拖放功能是一个低级别的拖放工具链，它能够安全有效地使用浏览器内置的拖放功能。实用拖放功能可以与任何视图层（react、svelte、vue、angular 等）一起使用。实用拖放功能正在为一些网络上最大的产品提供支持，包括 Trello、Jira 和 Confluence。

<details> <summary>功能</summary>

实用拖放功能由几个高级部分组成：

1. 低级别拖放行为

实用拖放功能包含一个核心包和多个可选包，为您提供创建任何拖放体验所需的组件。

这些组件对视觉语言或可访问性没有特定要求，也不依赖于 Atlassian 设计系统。

• 体积小：核心包仅 ~4.7kB
• 增量式：只使用您需要的部分
• 无头：完全控制渲染和样式
• 框架无关：适用于任何前端框架
• 延迟加载兼容：延迟加载核心包和可选包，以进一步提高页面加载速度
• 灵活性：创建任何您想要的体验，在拖动操作期间进行任何更改
• 广泛兼容：在 Firefox、Safari 和 Chrome、iOS 和 Android 上完全支持所有功能
• 支持虚拟化：创建任何您想要的虚拟体验！

2. 可选的视觉输出

我们创建了可选的视觉输出（例如我们的放置指示器），以便快速构建一致的 Atlassian 用户体验。非 Atlassian 用户也可以使用这些输出，创建自己的复制视觉样式的输出，或者采用完全不同的方向。

3. 可选的辅助技术控件

并非所有用户都能实现基于指针的拖放体验。为了为使用辅助技术的用户提供出色的体验，我们提供了一个工具链，让您可以快速连接高性能的、适合辅助技术的流程，适用于任何体验。

我们提供的可选辅助控件基于 Atlassian 设计系统。如果您不想使用 Atlassian 设计系统，可以使用我们的指南并用您自己的组件替换我们的组件，或者您可以选择采用不同的方式来实现可访问性。

</details>

这个仓库是什么？

这个仓库目前是我们内部单一代码库的单向镜像，包含了实用拖放功能的所有代码。

<div align="center"> <img src="https://github.com/alexreardon/files/assets/2182637/b45c2dfe-2c54-459e-a3e6-68b2342fe97b" alt="镜像工作原理图" width="600px"> </div>

这个仓库的目的是公开我们的代码，但目前不接受代码贡献。将来我们可能会探索建立双向镜像，以便对这个仓库的贡献也能反馈到我们的单一代码库中。您仍然可以在这个仓库中提出问题或建议！

所有文档和 npm 包都是公开的，可供所有人使用。

我可以将其用于自己的设计系统吗？

当然可以！实用拖放功能有一个小型核心包，以及一系列可选包。一些可选包依赖于样式解决方案（如 emotion）、视图库（如 react）或一些额外的 Atlassian 输出（如 @atlaskit/tokens）。我们将具有其他依赖项的可选包分开，以便可以轻松地用您自己的技术栈和视觉输出替换它们。

我可以使用自己的设计语言吗？

当然可以！我们创建了一些设计指南，体现了我们希望在产品中实现拖放的方式，其中一些决策体现在一些可选包中。但是，您可以自由使用任何您喜欢的设计语言，包括我们的！

什么是 @atlaskit？

实用拖放功能包在 npm 上以 @atlaskit 命名空间发布。

import { draggable } from '@atlaskit/pragmatic-drag-and-drop/element/adapter';

@atlaskit 是我们在内部单一代码库中发布所有公共包的 npm 命名空间。将来我们可能会考虑为实用拖放功能创建一个单独的命名空间。如果我们这样做，我们会发布一些工具来帮助用户自动切换。

致谢

由以下人员倾情制作：

• Alex Reardon
• Declan Warn
• Lewis Healey
• Eleni Misthos
• Jesse Bauer
• Mitch Gavan
• Michael Abrahamian
• Tim Keir
• Greta Ritchard
• Atlassian 的许多其他人员
• 标志由 Michelle Holik 和 Vojta Holik 创作

实用拖放功能站在巨人的肩膀上，包括创建拖放规范的人员、在浏览器中实现拖放功能的人员，以及之前的许多拖放库。