CKTIS / HTML
oncopy — processador do evento de cópia
O atributo oncopy associa código JavaScript ao processamento do evento copy. Pode aparecer em qualquer elemento HTML para reagir a uma cópia, por exemplo, atualizando uma mensagem na página.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
oncopy="JavaScript statements"oncopy é um atributo global de processamento de eventos para copy, o evento associado à cópia. O seu valor contém instruções JavaScript, não um valor booleano nem apenas o nome de uma função. No código do atributo, o parâmetro event fornece o objeto do evento.
É importante distinguir o atributo HTML da propriedade JavaScript element.oncopy, à qual se atribui uma função ou null. Esta propriedade também está disponível nos objetos Document e Window. Uma nova atribuição substitui a função anterior da propriedade; addEventListener('copy', handler) permite registar ouvintes independentes.
Copiar texto selecionado no parágrafo do exemplo não garante que o respetivo processador seja executado. Para uma seleção numa área não editável, a especificação da Clipboard API define como alvo do evento copy o nó que tem o foco, ou body se nenhum nó tiver o foco. O parágrafo do exemplo não pode receber o foco. Se o respetivo processador for executado, a mensagem muda para copy; caso contrário, mantém-se Waiting. O exemplo não altera o conteúdo copiado. Devolver false no processador cancela o evento, se este puder ser cancelado. A Content Security Policy pode bloquear código nos atributos; adicionar oncopy não contorna essa restrição.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oncopy demo</title>
<p id="sample" oncopy="document.getElementById('status').textContent = event.type">Select and copy this text.</p>
<output id="status">Waiting</output>
</html>Resultado
copy
O resultado `copy` foi observado num ambiente isolado com Chromium. Noutros navegadores, a mensagem pode manter-se `Waiting`.