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

CKTIS / HTML

writingsuggestions — sugestões durante a escrita

O atributo writingsuggestions determina se um navegador deve oferecer sugestões de escrita. A definição pode ser herdada; as preferências do utilizador têm prioridade.

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

Sintaxe

writingsuggestions="true" | writingsuggestions="false" | writingsuggestions=""

writingsuggestions é um atributo enumerado, não um atributo booleano: true permite sugestões e false desativa-as. Um valor vazio ou inválido significa o estado True, não a desativação.

Se o atributo for omitido, aplica-se o estado Default: o valor calculado herda false do elemento pai; caso contrário, é true. Um true explícito substitui a desativação herdada.

As sugestões aplicam-se a áreas editáveis e a controlos textarea e input modificáveis dos tipos text, search, tel, url e email. O atributo, por si só, não permite a edição. O utilizador pode desativar as sugestões; a norma não especifica a respetiva interface.

A propriedade DOM writingSuggestions devolve a cadeia "true" ou "false", e não um valor booleano. Também pode ser definida. A leitura não tem em conta as preferências do utilizador que prevalecem, pelo que não prova que as sugestões irão realmente aparecer.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>writingsuggestions</title>
<div writingsuggestions="false">
  <label>Draft <textarea id="draft"></textarea></label>
  <label>Assisted draft <textarea id="assisted" writingsuggestions="true"></textarea></label>
</div>
<pre id="result"></pre>
<script>
  const draft = document.getElementById('draft');
  const assisted = document.getElementById('assisted');
  document.getElementById('result').textContent =
    `${draft.writingSuggestions}\n${assisted.writingSuggestions}`;
</script>

Resultado

false
true

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