Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

oncut — tratar o evento cut

O atributo oncut contém código JavaScript que trata o evento cut. Pode surgir em qualquer elemento HTML; no exemplo, atualiza uma mensagem de estado e cancela a ação de corte predefinida.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

oncut="JavaScript statements"

oncut é um atributo global de HTML que trata o evento cut. O seu valor é código JavaScript, não um nome de evento nem um URL de script. Por ser global, o atributo pode surgir em qualquer elemento HTML, não apenas em campos editáveis.

No código do atributo, o parâmetro event fornece o evento. Devolver false cancela a ação predefinida, se o evento puder ser cancelado. A simples execução do processador não significa que o evento seja cancelado.

O exemplo utiliza um textarea. Seleciona Alpha e executa o comando de corte. A mensagem esperada é cut handled, e o campo mantém Alpha Beta, porque o código executa return false;. O exemplo requer um ambiente que permita processadores de eventos inline.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>oncut demo</title>
<textarea oncut="document.getElementById('status').textContent = 'cut handled'; return false;">Alpha Beta</textarea>
<p id="status">waiting</p>

Resultado

cut handled

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes