Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Właściwości `value` i `disabled` w polach `input` i `textarea`

Odczytuj i zmieniaj wartość kontrolki niezależnie od tego, czy użytkownik może z niej korzystać. Rozróżniaj własny atrybut `disabled` od faktycznego stanu kontrolki i sprawdzaj, które dane trafią do formularza.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

control.value          // read a string
control.value = text   // write a string; input.type determines the rules
control.disabled       // read the element's own disabled attribute as a boolean
control.disabled = true
control.disabled = false
control.matches(':disabled') // test whether the control is actually disabled

HTMLInputElement i HTMLTextAreaElement to interfejsy DOM zdefiniowane przez standard HTML, nie przez ECMAScript 2024. W tekstowym input i w textarea właściwość value odczytuje i ustawia bieżącą wartość jako ciąg znaków. textarea.value normalizuje końce wierszy do LF (\n). Wartość domyślna (defaultValue) pochodzi z atrybutu value elementu input lub z treści tekstowej textarea. Po edycji przez użytkownika lub przypisaniu do value zmiana wartości domyślnej nie nadpisuje już bieżącej. Przy resecie formularza bieżąca wartość jest ustawiana na podstawie wartości domyślnej, ale w przypadku input przeglądarka stosuje też algorytm oczyszczania wartości, jeśli dany typ go definiuje. Na przykład w polu type="text" reset usuwa z value znaki końca wiersza, nawet jeśli występują w defaultValue.

W input działanie value zależy od type. W trybie wartości, np. dla text i number, przeglądarka może przekształcić lub wyczyścić przypisany tekst zgodnie z regułami typu; number nadal zwraca ciąg znaków. Dla hidden właściwość odzwierciedla atrybut value i zwraca '', gdy go brak. W checkbox i radio również odzwierciedla ten atrybut, ale bez niego zwraca 'on'; stan zaznaczenia sprawdzaj przez checked. W file odczyt nie ujawnia rzeczywistej ścieżki: użyj files. Przypisanie '' czyści wybór, a niepusty ciąg powoduje InvalidStateError.

Logiczna właściwość disabled odzwierciedla tylko własny atrybut elementu: true go dodaje, a false usuwa. W HTML nawet disabled="false" wyłącza kontrolkę, bo liczy się obecność atrybutu. Kontrolka może mieć disabled === false, a mimo to być wyłączona przez nadrzędny fieldset z atrybutem disabled. Wyjątkiem są potomkowie pierwszego dziecka legend tej grupy. Faktyczny stan sprawdzaj przez control.matches(':disabled').

Wyłączona kontrolka nie przyjmuje fokusu, użytkownik nie może jej edytować, nie podlega walidacji ograniczeń i jest pomijana przy wysyłaniu formularza oraz w new FormData(form). Skrypt nadal może odczytać i zmienić value; przypisanie samo nie wywołuje zdarzeń input ani change. Jeśli użytkownik ma móc ustawić fokus, ale nie edytować pola, użyj readOnly tam, gdzie jest obsługiwane: samo w sobie nie wyklucza pola z wysyłki. Żaden z tych stanów nie zastępuje walidacji ani autoryzacji na serwerze.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Form control value and disabled state</title>
</head>
<body>
<script>
(() => {
  const form = document.createElement('form');
  const group = document.createElement('fieldset');
  const input = document.createElement('input');
  const textarea = document.createElement('textarea');
  input.type = 'text';
  input.name = 'title';
  textarea.name = 'note';
  group.append(input);
  form.append(group, textarea);

  group.disabled = true;
  input.value = 'Draft';
  textarea.value = 'Line 1\r\nLine 2';
  console.log(JSON.stringify([input.value, input.disabled, input.matches(':disabled')]));
  console.log(JSON.stringify([...new FormData(form)]));

  group.disabled = false;
  textarea.disabled = true;
  console.log(JSON.stringify([...new FormData(form)]));
})();
</script>
</body>
</html>

Wynik

["Draft",false,true]
[["note","Line 1\nLine 2"]]
[["title","Draft"]]

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź jej konsolę. Pierwszy wiersz pokazuje, że można zapisać `Draft`, chociaż pole jest faktycznie wyłączone i jego własne `disabled` wynosi `false`. Dwa następne wiersze pokazują dane przed zmianą stanu kontrolek i po niej; `\n` w JSON oznacza koniec wiersza LF.

Powiązane lekcje

  • JavaScript · Lekcja 4 · Zaawansowany · Wersja: 4

Źródła