HTML-Attribut: disabled

Das Boolean-Attribut disabled, wenn es vorhanden ist, macht das Element nicht veränderbar, fokussierbar oder mit dem Formular einsendbar. Der Benutzer kann den Steuerelementen und deren untergeordneten Formularsteuerelementen weder bearbeiten noch den Fokus setzen.

Probieren Sie es aus

Übersicht

Wenn das disabled-Attribut bei einem Formularsteuerelement angegeben ist, nehmen das Element und seine untergeordneten Formularsteuerelemente nicht an der Zwangsvalidierung teil. Oftmals werden solche Steuerelemente von Browsern ausgegraut und erhalten keine Browsing-Ereignisse, wie z. B. Mausklicks oder fokusbezogene Ereignisse.

Das disabled-Attribut wird von <button>, <fieldset>, <optgroup>, <option>, <select>, <textarea> und <input> unterstützt.

Dieses Boolean-Attribut indicates dass der Benutzer nicht mit dem Steuerelement oder dessen untergeordneten Steuerelementen interagieren kann. Wenn dieses Attribut nicht angegeben ist, erbt das Steuerelement seine Einstellung vom umgebenden Element, zum Beispiel fieldset; wenn es kein umgebendes Element mit gesetztem disabled-Attribut gibt und das Steuerelement selbst das Attribut nicht hat, ist das Steuerelement aktiviert. Wenn es bei einem <optgroup> deklariert ist, bleibt das select dennoch interaktiv (sofern nicht anders deaktiviert), aber keines der Elemente in der Optionsgruppe ist auswählbar.

Hinweis: Wenn ein <fieldset> deaktiviert ist, sind alle untergeordneten Formularsteuerelemente deaktiviert, mit Ausnahme von Formularsteuerelementen innerhalb des <legend>.

Wenn auf ein unterstützendes Element das disabled-Attribut angewandt wird, gilt auch die :disabled-Pseudoklasse. Umgekehrt entsprechen Elemente, die das disabled-Attribut unterstützen, aber das Attribut nicht gesetzt haben, der :enabled-Pseudoklasse.

Dieses Boolean-Attribut verhindert, dass der Benutzer mit dem Button interagiert. Wird dieses Attribut nicht gesetzt, kann der Button dennoch durch ein umgebendes Element, zum Beispiel <fieldset>; deaktiviert werden. Wenn es kein umgebendes Element mit gesetztem disabled-Attribut gibt, ist der Button aktiviert.

Anders als andere Browser wird Firefox den dynamischen deaktivierten Zustand eines <button> über Seitenladevorgänge hinweg beibehalten. Verwenden Sie das autocomplete-Attribut, um diese Funktion zu steuern.

Attribut-Interaktionen

Der Unterschied zwischen disabled und readonly besteht darin, dass schreibgeschützte Steuerelemente weiterhin funktionieren und fokussierbar sind, während deaktivierte Steuerelemente keinen Fokus erhalten können und nicht mit dem Formular eingereicht werden und generell nicht als Steuerelemente funktionieren, bis sie aktiviert sind.

Da ein deaktiviertes Feld seinen Wert nicht ändern kann, hat required keine Auswirkungen auf Eingaben, bei denen auch das disabled-Attribut angegeben ist. Da die Elemente unveränderlich werden, haben die meisten anderen Attribute, wie pattern, keine Wirkung, bis das Steuerelement aktiviert wird.

Hinweis: Das required-Attribut ist bei Eingaben mit angegebenem disabled-Attribut nicht zulässig.

Benutzerfreundlichkeit

Browser zeigen deaktivierte Formularsteuerelemente ausgegraut an, da deaktivierte Formularsteuerelemente unveränderlich sind, keinen Fokus oder Browsing-Ereignisse wie Mausklicks oder fokusbezogene Ereignisse erhalten und nicht mit dem Formular einsendbar sind.

Wenn es bei unterstützenden Elementen vorhanden ist, wird die :disabled-Pseudoklasse übereinstimmen. Wenn das Attribut nicht enthalten ist, wird die :enabled-Pseudoklasse übereinstimmen. Wenn das Element das disabled-Attribut nicht unterstützt, wird das Attribut keine Wirkung haben, auch nicht dazu führen, dass es mit den :disabled- und :enabled-Pseudoklassen übereinstimmt.

Zwangsvalidierung

Wenn das Element disabled ist, kann der Wert des Elements keinen Fokus empfangen und nicht vom Benutzer aktualisiert werden und nimmt nicht an der Zwangsvalidierung teil.

Beispiele

Wenn Formularsteuerelemente deaktiviert sind, zeigen viele Browser sie standardmäßig in einem helleren, ausgegrauten Farbton an. Hier sind Beispiele für ein deaktiviertes Kontrollkästchen, Optionsfeld, <option> und <optgroup>, sowie einige Formularsteuerelemente, die über das disabled-Attribut im Vorgängerelement <fieldset> deaktiviert wurden. Die <option>s sind deaktiviert, aber das <select> selbst nicht. Wir könnten das gesamte <select> deaktivieren, indem wir das Attribut zu diesem Element anstelle seiner Nachkommen hinzufügen.

html
<fieldset>
  <legend>Checkboxes</legend>
  <p>
    <label>
      <input type="checkbox" name="ch-box" value="regular" /> Regular
    </label>
  </p>
  <p>
    <label>
      <input type="checkbox" name="ch-box" value="disabled" disabled /> disabled
    </label>
  </p>
</fieldset>

<fieldset>
  <legend>Radio buttons</legend>
  <p>
    <label> <input type="radio" name="radio" value="regular" /> Regular </label>
  </p>
  <p>
    <label>
      <input type="radio" name="radio" value="disabled" disabled /> disabled
    </label>
  </p>
</fieldset>

<p>
  <label
    >Select an option:
    <select>
      <optgroup label="Group 1">
        <option>Option 1.1</option>
      </optgroup>
      <optgroup label="Group 2">
        <option>Option 2.1</option>
        <option disabled>Option 2.2</option>
        <option>Option 2.3</option>
      </optgroup>
      <optgroup label="Group 3" disabled>
        <option>Disabled 3.1</option>
        <option>Disabled 3.2</option>
        <option>Disabled 3.3</option>
      </optgroup>
    </select>
  </label>
</p>

<fieldset disabled>
  <legend>Disabled fieldset</legend>
  <p>
    <label>
      Name: <input type="radio" name="radio" value="regular" /> Regular
    </label>
  </p>
  <p>
    <label>Number: <input type="number" /></label>
  </p>
</fieldset>

Spezifikationen

Specification
HTML Standard
# attr-fe-disabled
HTML Standard
# attr-optgroup-disabled
HTML Standard
# attr-option-disabled

Browser-Kompatibilität

html.elements.button.disabled

BCD tables only load in the browser

html.elements.fieldset.disabled

BCD tables only load in the browser

html.elements.input.disabled

BCD tables only load in the browser

html.elements.optgroup.disabled

BCD tables only load in the browser

html.elements.option.disabled

BCD tables only load in the browser

html.elements.select.disabled

BCD tables only load in the browser

html.elements.textarea.disabled

BCD tables only load in the browser

Siehe auch