Esta biblioteca não é mais mantida, pois não é mais necessária para o desenvolvimento da web moderno. Se você deseja que seu JavaScript de front -end manipule a área de transferência, consulte a nova API da área de transferência HTML (vários documentos disponíveis no MDN) ou um pequeno invólucro de conveniência em torno dele, como o CLIPBOOD.JS. Obrigado por todo o seu apoio, este projeto foi um trabalho de amor por muitos anos.
Esta filial master contém a base de código v2.x para a Zeroclipboard! Para a base de código v1.x , consulte a ramificação 1.x-master .
A biblioteca Zeroclipboard fornece uma maneira fácil de copiar o texto para a área de transferência usando um filme invisível do Adobe Flash e uma interface JavaScript. O "zero" significa que a biblioteca é invisível e a interface do usuário é deixada inteiramente com você.
Isso é conseguido flutuando automaticamente o filme invisível em cima de um elemento DOM de sua escolha. Os eventos padrão do mouse são até propagados para o seu elemento DOM, para que você ainda possa ter efeitos de rolagem e mousedown.
Sugestões são bem -vindas lidas sobre as diretrizes contribuintes.
Para configurar o projeto para o desenvolvimento local, comece com esses comandos em seu terminal.
$ git clone https://github.com/zeroclipboard/zeroclipboard.git
$ cd zeroclipboard/
$ npm install -g grunt-cli
$ npm install
$ gruntAntes de enviar uma solicitação de tração, você precisará validar, construir e testar seu código. Execute a tarefa Grunt padrão em seu terminal.
$ gruntSe você deseja apenas executar os testes, execute o teste grunhido.
$ grunt test Devido às restrições de segurança do navegador e flash, essa injeção de quadro de transferência só pode ocorrer quando o usuário clica no filme Flash Invisible. Um evento click simulado do JavaScript não será suficiente, pois isso permitiria o envenenamento da área de transferência.
Para uma lista completa de limitações, consulte Docs/Instruções.MD#Limitações.
Nessa página, você também encontrará uma explicação sobre por que a Zeroclipboard não funcionará por padrão nos sites de playground de código como JSFiddle, JSBin e Codepen, bem como os URLs de "exibir" apropriados para usar nesses sites para permitir que o Zeroclipboard trabalhe.
< 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/Instruções.MD para obter opções mais avançadas no uso da biblioteca no seu site. Consulte Docs/API/Zeroclipboard.md para obter a documentação completa da API.
Aqui está uma página de teste de trabalho na qual você pode experimentar a Zeroclipboard no seu navegador.
Para testar a página de demonstração da página localmente, clone o repositório do site.
Esta biblioteca é totalmente compatível com o Flash Player 11.0.0 e acima, o que exige que a operação de cópia da área de transferência seja iniciada por um evento de clique no usuário dentro do filme Flash. Isso é conseguido flutuando automaticamente o filme invisível em cima de um elemento DOM de sua escolha. Os eventos padrão do mouse são propagados para o seu elemento DOM, para que você ainda possa ter efeitos de rolagem e mousedown com apenas um pouco de esforço extra.
A Zeroclipboard v2.x deve funcionar no IE9+ e em todos os navegadores sempre -verdes. Embora o apoio ao IE7 e IE8 tenha sido oficialmente retirado na v2.0.0 , ele ainda era tecnicamente suportado até a v2.0.2 .
Começando com a versão 1.1.7, o Zeroclipboard usa versão semântica.
Veja lançamentos
MIT © James M. Greene Jon Rohan