Cette bibliothèque n'est plus maintenue car elle n'est plus nécessaire pour le développement Web moderne. Si vous voulez que votre JavaScript Frontend manipule le presse-papiers, veuillez consulter la nouvelle API du presse-papiers HTML (divers documents disponibles sur MDN) ou un petit emballage de commodité autour de celui-ci comme le presse-papiers.js. Merci pour tout votre soutien, ce projet a été un travail d'amour pendant de nombreuses années.
Cette branche master contient la base de code v2.x pour ZeroClipboard! Pour la base de code v1.x , consultez plutôt la branche 1.x-master .
La bibliothèque Zeroclipboard fournit un moyen facile de copier du texte dans le presse-papiers à l'aide d'un film Adobe Flash invisible et d'une interface JavaScript. Le "zéro" signifie que la bibliothèque est invisible et que l'interface utilisateur est entièrement à vous.
Ceci est réalisé en flottant automatiquement le film invisible en plus d'un élément DOM de votre choix. Les événements de souris standard se propagent même à votre élément DOM, vous pouvez donc toujours avoir des effets de retour et de souris.
Les suggestions sont en train de bien être lus sur les directives contributives.
Pour configurer le projet de développement local, commencez par ces commandes dans votre terminal.
$ git clone https://github.com/zeroclipboard/zeroclipboard.git
$ cd zeroclipboard/
$ npm install -g grunt-cli
$ npm install
$ gruntAvant de soumettre une demande de traction, vous devrez valider, construire et tester votre code. Exécutez la tâche de grognement par défaut dans votre terminal.
$ gruntSi vous souhaitez simplement exécuter les tests, exécutez le test de grognement.
$ grunt test En raison des restrictions de sécurité du navigateur et du flash, cette injection de presse-papiers ne peut se produire que lorsque l'utilisateur clique sur le film flash invisible. Un événement click simulé de JavaScript ne suffira pas car cela permettrait d'empoisonner le presse-papiers.
Pour une liste complète des limitations, voir Docs / Instructions.md # Limitations.
Sur cette page, vous trouverez également une explication des raisons pour lesquelles Zeroclipboard ne fonctionnera pas par défaut sur les sites de jeu de code comme JSFiddle, JSBin et Codepen, ainsi que les URL "Voir" appropriées à utiliser sur ces sites afin de permettre à Zeroclipboard de fonctionner.
< html >
< body >
< button id =" copy-button " data-clipboard-text =" Copy Me! " title =" Click to copy me. " > Copy to Clipboard </ button >
< script src =" ZeroClipboard.js " > </ script >
< script src =" main.js " > </ script >
</ body >
</ html > // main.js
var client = new ZeroClipboard ( document . getElementById ( "copy-button" ) ) ;
client . on ( "ready" , function ( readyEvent ) {
// alert( "ZeroClipboard SWF is ready!" );
client . on ( "aftercopy" , function ( event ) {
// `this` === `client`
// `event.target` === the element that was clicked
event . target . style . display = "none" ;
alert ( "Copied text to clipboard: " + event . data [ "text/plain" ] ) ;
} ) ;
} ) ;Voir docs / instructions.md pour des options plus avancées dans l'utilisation de la bibliothèque de votre site. Voir docs / api / zeroclipboard.md pour la documentation complète de l'API.
Voici une page de test de travail où vous pouvez essayer Zeroclipboard dans votre navigateur.
Pour tester la page de démonstration de page localement, clonez le site Web du site Web.
Cette bibliothèque est entièrement compatible avec Flash Player 11.0.0 et plus, ce qui nécessite que l'opération de copie du presse-papiers soit lancée par un événement de clic utilisateur à l'intérieur du film Flash. Ceci est réalisé en flottant automatiquement le film invisible en plus d'un élément DOM de votre choix. Les événements de souris standard se propagent même à votre élément DOM, vous pouvez donc toujours avoir des effets de retour et de souris avec juste un petit effort supplémentaire.
Zeroclipboard v2.x devrait fonctionner dans IE9 + et tous les navigateurs à feuilles persistantes. Bien que le soutien à IE7 et IE8 ait été officiellement abandonné dans v2.0.0 , il était en fait toujours pris en charge techniquement via v2.0.2 .
À partir de la version 1.1.7, ZeroClipboard utilise le versioning sémantique.
Voir les versions
MIT © James M. Greene Jon Rohan