Glisser-déposer rapide pour n'importe quelle expérience sur n'importe quelle pile technologique
Documents | ? Exemples | ? Comment ça marche
Le glisser-déposer pragmatique est une chaîne d'outils glisser-déposer de bas niveau qui permet une utilisation sûre et réussie des navigateurs intégrés à la fonctionnalité glisser-déposer. Le glisser-déposer pragmatique peut être utilisé avec n'importe quel calque de vue ( react
, svelte
, vue
, angular
et ainsi de suite). Le glisser-déposer pragmatique alimente certains des plus grands produits du Web, notamment Trello, Jira et Confluence.
Le glisser-déposer pragmatique se compose de quelques éléments de haut niveau :
Le glisser-déposer pragmatique contient un package de base et un certain nombre de packages facultatifs, qui vous fournissent les éléments nécessaires pour créer n'importe quelle expérience de glisser-déposer.
Ces pièces sont sans opinion sur le langage visuel ou l'accessibilité, et ne dépendent pas du système de conception Atlassian.
4.7kB
ko de cœurNous avons créé des sorties visuelles facultatives (par exemple notre indicateur de chute) pour nous permettre de créer très rapidement des expériences utilisateur Atlassian cohérentes. Les consommateurs non Atlassiens sont invités à utiliser ces sorties, à créer les leurs en copiant le style visuel ou à prendre une direction totalement différente.
Tous les utilisateurs ne peuvent pas réaliser des expériences de glisser-déposer basées sur un pointeur. Afin de proposer des expériences fantastiques aux utilisateurs de technologies d'assistance, nous fournissons une chaîne d'outils pour vous permettre de connecter rapidement des flux performants et conviviaux pour les technologies d'assistance pour n'importe quelle expérience.
Les commandes d'assistance en option que nous proposons sont basées sur le système de conception Atlassian. Si vous ne souhaitez pas utiliser Atlassian Design System, vous pouvez utiliser nos directives et remplacer nos composants par vos propres composants, ou vous pouvez aborder l'accessibilité d'une manière différente si vous le souhaitez.
Ce référentiel est actuellement un miroir à sens unique de notre monorepo interne qui contient tout le code pour le glisser-déposer Pragmatic.
L'intention de ce référentiel est de rendre public notre code, mais de ne pas accepter de contributions de code (à ce stade). À l'avenir, nous pourrions envisager de mettre en place un miroir bidirectionnel afin que les contributions à ce dépôt puissent également revenir vers notre monorepo. Vous êtes toujours invités à soulever des problèmes ou des suggestions sur ce référentiel !
Toute la documentation et les packages npm
sont publics et accessibles à tous
Ouais! Glisser-déposer pragmatique en tant que petit package de base, puis une gamme de packages optionnels. Certains des packages facultatifs ont des dépendances sur des solutions de style (par exemple emotion
), des bibliothèques de vues (par exemple react
) ou sur certaines sorties Atlassian supplémentaires (par exemple @atlaskit/tokens
). Nous avons séparé les packages facultatifs qui ont d'autres dépendances afin qu'ils puissent être facilement échangés avec vos propres éléments qui utilisent votre propre pile technologique et vos propres sorties visuelles.
Ouais! Nous avons créé des directives de conception qui incarnent la manière dont nous souhaitons réaliser le glisser-déposer dans nos produits, et certaines de ces décisions sont incorporées dans certains packages facultatifs. Cependant, vous êtes libre d’utiliser le langage de conception de votre choix, y compris le nôtre !
@atlaskit
? Les packages glisser-déposer Pragmatic sont publiés sous l'espace de noms @atlaskit
sur npm
import { draggable } from '@atlaskit/pragmatic-drag-and-drop/element/adapter' ;
@atlaskit
est l'espace de noms npm
sur lequel nous publions tous nos packages publics depuis notre monorepo interne. Nous pourrions envisager de créer un espace de noms distinct à l'avenir uniquement pour le glisser-déposer pragmatique. Si nous faisons cela, nous publierons des outils pour aider les utilisateurs à basculer automatiquement.
Fabriqué avec amour par :
Le glisser-déposer pragmatique repose sur les épaules de géants, y compris les personnes qui ont créé les spécifications du glisser-déposer, implémenté le glisser-déposer dans les navigateurs et les nombreuses bibliothèques de glisser-déposer qui l'ont précédé.