Быстрое перетаскивание для любого опыта в любом технологическом стеке
Документация | ? Примеры | ? Как это работает
Прагматическое перетаскивание — это низкоуровневая цепочка инструментов перетаскивания, которая обеспечивает безопасное и успешное использование браузеров, встроенных в функцию перетаскивания. Прагматическое перетаскивание можно использовать с любым слоем представления ( react , svelte , vue , angular и т. д.). Прагматическое перетаскивание лежит в основе некоторых крупнейших продуктов в Интернете, включая Trello, Jira и Confluence.
Прагматическое перетаскивание состоит из нескольких частей высокого уровня:
Прагматическое перетаскивание содержит основной пакет и ряд дополнительных пакетов, которые предоставляют вам все необходимое для создания любого опыта перетаскивания.
Эти произведения не имеют никакого мнения о визуальном языке или доступности и не зависят от системы дизайна Atlassian.
4.7kBМы создали дополнительные визуальные выходные данные (например, наш индикатор падения), чтобы максимально быстро создавать согласованный пользовательский интерфейс Atlassian. Потребители, не использующие Atlassian, могут использовать эти результаты, создавать свои собственные, копирующие визуальный стиль, или идти в совершенно другом направлении.
Не все пользователи могут использовать возможности перетаскивания с помощью указателя. Чтобы обеспечить фантастический опыт для пользователей ассистивных технологий, мы предоставляем набор инструментов, который позволит вам быстро подключить эффективные процессы, удобные для использования ассистивных технологий, для любого опыта.
Дополнительные вспомогательные элементы управления, которые мы предоставляем, основаны на системе Atlassian Design System. Если вы не хотите использовать Atlassian Design System, вы можете воспользоваться нашими рекомендациями и заменить наши компоненты своими собственными компонентами или по своему усмотрению можете обеспечить доступность другим способом.
Этот репозиторий в настоящее время является односторонним зеркалом нашего внутреннего монорепозитория, который содержит весь код для Pragmatic перетаскивания.
Целью этого репозитория является обнародование нашего кода, но не принятие кода (на данном этапе). В будущем мы могли бы изучить возможность создания двустороннего зеркала, чтобы вклады в этот репозиторий также могли возвращаться в наш монорепозиторий. Вы по-прежнему можете поднимать вопросы или предложения в этом репозитории!
Вся документация и пакеты npm общедоступны и доступны для использования всеми.
Ага! Прагматичное перетаскивание небольшого основного пакета, а затем ряда дополнительных пакетов. Некоторые из дополнительных пакетов зависят от решений по стилизации (например, emotion ), библиотек представлений (например, react ) или от некоторых дополнительных выходных данных Atlassian (например, @atlaskit/tokens ). Мы выделили дополнительные пакеты, которые имеют другие зависимости, чтобы их можно было легко заменить вашими собственными частями, использующими ваш собственный технологический стек и визуальные результаты.
Ага! Мы разработали некоторые рекомендации по проектированию, которые отражают то, как мы хотим добиться перетаскивания в наших продуктах, и некоторые из этих решений воплощены в некоторых дополнительных пакетах. Однако вы можете использовать любой язык дизайна, который вам нравится, включая наш!
@atlaskit ? Пакеты перетаскивания Pragmatic публикуются в пространстве имен @atlaskit на npm
import { draggable } from '@atlaskit/pragmatic-drag-and-drop/element/adapter' ; @atlaskit — это пространство имен npm , в котором мы публикуем все наши общедоступные пакеты изнутри нашего внутреннего монорепозитория. В будущем мы могли бы рассмотреть возможность создания отдельного пространства имен только для Pragmatic перетаскивания. Если мы это сделаем, мы выпустим некоторые инструменты, которые помогут людям автоматически переключаться.
Сделано с любовью:
Прагматическое перетаскивание стоит на плечах гигантов, в том числе людей, которые создали спецификации перетаскивания, реализовали перетаскивание в браузерах и множество библиотек перетаскивания, существовавших до этого.
