Esta biblioteca ya no se mantiene ya que ya no es necesaria para el desarrollo web moderno. Si desea que su JavaScript Frontend manipule el portapapeles, busque la nueva API de portapapeles HTML (varios documentos disponibles en MDN) o un pequeño envoltorio de conveniencia alrededor de él como un portapapeles.js. Gracias por todo su apoyo, este proyecto fue un trabajo de amor durante muchos años.
¡Esta rama master contiene la base de código v2.x para ZeroClipboard! Para la base de código v1.x , consulte la rama 1.x-master en su lugar.
La biblioteca ZeroClipboard proporciona una manera fácil de copiar texto al portapapeles utilizando una película invisible de Adobe Flash y una interfaz JavaScript. El "cero" significa que la biblioteca es invisible y la interfaz de usuario se deja completamente a usted.
Esto se logra flotando automáticamente la película invisible además de un elemento DOM de su elección. Los eventos estándar del mouse incluso se propagan a su elemento DOM, por lo que aún puede tener efectos de reinversión y mouseDown.
Sugerencias Bienvenidas Leer sobre las pautas contribuyentes.
Para configurar el proyecto para el desarrollo local, comience con estos comandos en su terminal.
$ git clone https://github.com/zeroclipboard/zeroclipboard.git
$ cd zeroclipboard/
$ npm install -g grunt-cli
$ npm install
$ gruntAntes de enviar una solicitud de extracción, deberá validar, construir y probar su código. Ejecute la tarea gruñida predeterminada en su terminal.
$ gruntSi solo desea ejecutar las pruebas, ejecute la prueba Grunt.
$ grunt test Debido a las restricciones de seguridad del navegador y flash, esta inyección del portapapeles solo puede ocurrir cuando el usuario hace clic en la película Flash invisible. Un evento click simulado de JavaScript no será suficiente, ya que esto habilitaría el envenenamiento del portapapeles.
Para obtener una lista completa de limitaciones, consulte Docs/Instrucciones. MD#Limitaciones.
En esa página, también encontrará una explicación de por qué ZeroClipboard no funcionará de forma predeterminada en sitios de juegos de código como JSFIDDLE, JSBIN y CODEPEN, así como las URL de "ver" apropiadas para usar en esos sitios para permitir que ZeroClipboard funcione.
< 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" ] ) ;
} ) ;
} ) ;Consulte Docs/Instrucciones. MD para obtener opciones más avanzadas al usar la biblioteca en su sitio. Consulte Docs/API/ZeroClipboard.md para la documentación completa de API.
Aquí hay una página de prueba de trabajo donde puede probar ZeroClipboard en su navegador.
Para probar la página de demostración de la página localmente, clone el repositorio del sitio web.
Esta biblioteca es totalmente compatible con Flash Player 11.0.0 y arriba, lo que requiere que la operación de copia del portapapeles sea iniciada por un evento de clics de usuario dentro de la película Flash. Esto se logra flotando automáticamente la película invisible además de un elemento DOM de su elección. Los eventos estándar del mouse incluso se propagan a su elemento DOM, por lo que aún puede tener efectos de reinversión y mouseDown con solo un poco de esfuerzo adicional.
Se espera que ZeroClipboard v2.x funcione en IE9+ y en todos los navegadores de hoja perenne. Aunque el soporte para IE7 e IE8 se eliminó oficialmente en v2.0.0 , en realidad todavía se admitía técnicamente a través de v2.0.2 .
Comenzando con la versión 1.1.7, ZeroClipboard utiliza versiones semánticas.
Ver lanzamientos
MIT © James M. Greene Jon Rohan