Project Icon

draggable

JavaScript拖拽库 提供全面拖放控制和自定义功能

Draggable是一个JavaScript拖放库,抽象了浏览器原生事件,提供API用于创建自定义拖放体验。核心模块Draggable与附加模块Sortable、Droppable和Swappable协同工作,支持多种输入方式。通过事件钩子和自定义传感器,开发者可扩展拖拽功能。该库基于ES6设计,体积小巧,适用于构建各类拖放界面。

npm 版本 CI 欢迎提交PR 包大小

开发

**Draggable不再由其原作者维护。**此仓库的维护已交接给新的协作者,不再由Shopify的任何人负责。

**我们仍在寻找更多的维护者!**如果有人有兴趣回答/分类问题、审核/拒绝/批准PR,以及编写代码修复bug/添加新功能 —— 请发送电子邮件至max.hoffmann (at) shopify (dot) com。在获得协作权限之前,您可能会被问几个问题,但如果一切顺利,我们将很高兴将您添加为协作者。


使用Draggable完全控制拖放行为!Draggable将原生浏览器事件抽象为全面的API,以创建自定义拖放体验。Draggable附带额外模块:SortableDroppableSwappable。Draggable本身在拖动时不执行任何排序行为,但会完成繁重的工作,例如创建镜像、发出事件、管理传感器事件、使元素可拖动。

这些额外模块建立在Draggable之上,因此提供类似的API接口,更多信息请阅读下面的文档。

特性

  • 适用于原生拖动、鼠标、触摸和压力触摸事件
  • 可以通过挂钩到draggable的事件生命周期来扩展拖动行为
  • 可以通过向draggable添加传感器来扩展拖动检测
  • 该库首选ES6目标

目录

安装

您可以通过npm安装该库。

npm install @shopify/draggable --save

或通过yarn:

yarn add @shopify/draggable

或通过CDN

<!-- 整个包 -->
<script type="module">
  import {
    Draggable,
    Sortable,
    Droppable,
    Swappable,
  } from 'https://cdn.jsdelivr.net/npm/@shopify/draggable/build/esm/index.mjs';
</script>
<!-- 仅Draggable -->
<script type="module">
  import Draggable from 'https://cdn.jsdelivr.net/npm/@shopify/draggable/build/esm/Draggable/Draggable.mjs';
</script>
<!-- 仅Sortable -->
<script type="module">
  import Sortable from 'https://cdn.jsdelivr.net/npm/@shopify/draggable/build/esm/Sortable/Sortable.mjs';
</script>
<!-- 仅Droppable -->
<script type="module">
  import Droppable from 'https://cdn.jsdelivr.net/npm/@shopify/draggable/build/esm/Droppable/Droppable.mjs';
</script>
<!-- 仅Swappable -->
<script type="module">
  import Swappable from 'https://cdn.jsdelivr.net/npm/@shopify/draggable/build/esm/Swappable/Swappable.mjs';
</script>
<!-- 仅插件 -->
<script type="module">
  import * as Plugins from 'https://cdn.jsdelivr.net/npm/@shopify/draggable/build/esm/Plugins/index.mjs';
</script>
<!-- UMD浏览器 -->
<script src="https://cdn.jsdelivr.net/npm/@shopify/draggable/build/umd/index.min.js"></script>
<script>
  console.log(window.Draggable);
</script>

浏览器兼容性

查看package.json中的"browserlist"属性以获取更多信息

ChromeFirefoxOperaSafariEdge
最新3个版本 ✔最新3个版本 ✔最新3个版本 ✔最新3个版本 ✔最新3个版本 ✔

文档

您可以在各自的目录中找到每个模块的文档。

TypeScript

Draggable包含TypeScript定义。

文档

运行示例

要在本地运行examples项目,只需在draggable根目录下运行以下命令:

yarn && yarn start

这将启动一个托管examples/内容的服务器。它还会监视来自src/examples/src的文件更改并重新加载浏览器。

贡献

我们非常欢迎贡献,代码库仍然很新,需要更多的关注。

有关更多信息,请查看贡献文档

相关资源

版权

版权所有 (c) 2018-现在 Shopify。更多详情请参阅LICENSE.md。

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

白日梦AI

白日梦AI提供专注于AI视频生成的多样化功能,包括文生视频、动态画面和形象生成等,帮助用户快速上手,创造专业级内容。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

讯飞绘镜

讯飞绘镜是一个支持从创意到完整视频创作的智能平台,用户可以快速生成视频素材并创作独特的音乐视频和故事。平台提供多样化的主题和精选作品,帮助用户探索创意灵感。

Project Cover

讯飞文书

讯飞文书依托讯飞星火大模型,为文书写作者提供从素材筹备到稿件撰写及审稿的全程支持。通过录音智记和以稿写稿等功能,满足事务性工作的高频需求,帮助撰稿人节省精力,提高效率,优化工作与生活。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号