Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

:disabled — pseudoklasa wyłączonych elementów

Pseudoklasa :disabled wybiera elementy faktycznie wyłączone zgodnie z regułami HTML, a nie tylko elementy z atrybutem disabled. Pozwala stylować stan kontrolki, ale sama jej nie wyłącza.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

:disabled

Pseudoklasa :disabled dopasowuje elementy interfejsu w stanie wyłączenia zdefiniowanym przez język dokumentu. W HTML obejmuje faktycznie wyłączone elementy button, input, select, textarea, optgroup, option, fieldset oraz niestandardowe elementy powiązane z formularzem. Zapis button:disabled ogranicza dopasowanie do przycisków.

Nie utożsamiaj :disabled z [disabled]: drugi selektor sprawdza wyłącznie obecność atrybutu. Kontrolka wewnątrz wyłączonego fieldset może pasować do :disabled bez własnego atrybutu disabled. Wyłączenie przez dany fieldset nie obejmuje potomków jego pierwszego elementu potomnego legend; nadal mogą oni być wyłączeni z innego powodu. Przykład pokazuje tę różnicę.

Selektor tylko rozpoznaje stan — reguła CSS nie wyłącza kontrolki. Właściwości takie jak display i visibility nie zmieniają dopasowania do :disabled. Samo readonly również nie oznacza wyłączenia. :enabled nie jest odpowiednikiem :not(:disabled) dla wszystkich elementów: zwykły akapit nie pasuje ani do :enabled, ani do :disabled, ale pasuje do :not(:disabled).

W przykładzie czerwony obrys otrzymują przyciski inherited i direct, a wynik tekstowy to inherited, direct. Przycisk exception korzysta z wyjątku dla pierwszego legend, a available pozostaje włączony. Wynik tekstowy potwierdzono w odizolowanym środowisku przeglądarkowym.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:disabled example</title>
<style>
  button:disabled { outline: 3px solid #b00020; }
</style>
<fieldset disabled>
  <legend><button id="exception" type="button">Exception</button></legend>
  <button id="inherited" type="button">Inherited</button>
</fieldset>
<button id="direct" type="button" disabled>Direct</button>
<button id="available" type="button">Available</button>
<pre id="result"></pre>
<script>
  const ids = Array.from(document.querySelectorAll('button:disabled'),
    button => button.id);
  document.getElementById('result').textContent = ids.join(', ');
</script>
</html>

Wynik

inherited, direct

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła