This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

HTML disabled 속성

참과 거짓 중 하나의 값을 갖는 disabled 속성이 있을 경우 해당 요소는 수정하거나 포커스를 맞출 수 없고, 폼을 통해 제출될 수도 없습니다. 사용자는 컨트롤이나 폼 컨트롤의 자손 요소들을 편집하거나 포커스할 수 없습니다.

시도해 보기

<form>
  <label for="name">Name:</label>
  <input id="name" name="name" type="text" />

  <label for="emp">Employed:</label>
  <select id="emp" name="emp" disabled>
    <option>No</option>
    <option>Yes</option>
  </select>

  <label for="empDate">Employment Date:</label>
  <input id="empDate" name="empDate" type="date" disabled />

  <label for="resume">Resume:</label>
  <input id="resume" name="resume" type="file" />
</form>
label {
  display: block;
  margin-top: 1em;
}

*:disabled {
  background-color: dimgrey;
  color: linen;
  opacity: 1;
}

개요

disabled 속성이 폼 컨트롤 요소에 지정되면 해당 요소와 하위 폼 컨트롤 요소들은 제약 조건 검증에 참여하지 않습니다. 브라우저는 종종 해당 컨트롤들을 회색으로 나타내고 마우스 클릭이나 포커스와 관련된 브라우징 이벤트를 수신하지 않습니다.

disabled 속성은 <button>, <fieldset>, <optgroup>, <option>, <select>, <textarea>, <input> 에서 지원됩니다.

참과 거짓 중 하나의 값을 갖는 비활성화 속성은 사용자가 컨트롤 또는 하위 컨트롤들과 상호작용할 수 없음을 의미합니다. 이 속성이 지정되지 않은 경우 컨트롤은 상위 요소, 예를 들어 fieldset에서 설정을 상속받습니다. disabled 속성이 설정된 상위 요소가 없고, 컨트롤도 해당 속성을 갖지 않는다면 컨트롤이 활성화됩니다. <optgroup>에 선언되었을 경우 선택 요소와는 여전히 상호작용이 가능하지만 (다른 요소들은 비활성화되지 않았을 때), 옵션 그룹 내의 어떤 항목도 선택할 수 없습니다.

참고 : <fieldset> 이 비활성화된 경우 <legend> 내의 폼 컨트롤을 제외한 모든 하위 폼 컨트롤들이 비활성화됩니다.

지원하는 요소에 disabled 속성이 적용되면 :disabled 의사 클래스가 해당 요소에 적용됩니다. 반대로 disabled 속성을 지원하지만 속성이 설정되지 않은 요소는 :enabled 의사 클래스가 적용됩니다.

이 불리언 속성은 사용자가 버튼과 상호작용하는 것을 방지합니다. 해당 속성이 지정되지 않은 경우에도 <fieldset> 과 같은 상위 요소에 의해 버튼이 여전히 비활성화된 상태일 수도 있습니다. 만약 disabled 속성이 지정된 상위 요소가 없다면 버튼이 활성화됩니다.

Firefox는 다른 브라우저들과 달리 페이지를 불러올 때마다 <button> 의 동적 비활성화 상태를 유지합니다. 이 기능을 제어하기 위해서는 autocomplete 속성을 사용합니다.

속성 상호작용

disabledreadonly의 차이는 읽기 전용으로 지정된 컨트롤은 여전��� 동작하고 포커스가 가능하다는 반면, 비활성화된 컨트롤은 포커스를 받거나 폼과 함께 제출되지 않고 일반적으로 활성화될 때까지 컨트롤로서 동작하지 않는다는 것입니다.

비활성화된 필드는 그 값이 변경될 수 없기 때문에, requireddisabled 속성이 지정된 입력 필드에 아무 영향도 미치지 않습니다. 또한 요소들이 변경 불가능하게 되므로 pattern 과 같은 대부분의 다른 속성들도 컨트롤이 활성화될 때까지 영향을 미치지 않습니다.

참고 : disabled 속성이 지정된 입력 필드에는 required 속성을 사용할 수 없습니다.

유용성

브라우저는 비활성화된 폼 컨트롤들을 회색으로 표시합니다. 비활성화된 폼 컨트롤은 변경되거나 폼과 함께 제출되지 않으며, 마우스 클릭이나 포커스와 관련된 브라우징 이벤트를 수신하지 않습니다.

지원하는 요소에 존재하는 경우 :disabled 의사 클래스가 적용됩니다. 해당 속성이 지정되지 않았을 경우에는 :enabled 의사 클래스가 적용됩니다. 요소가 비활성화 속성을 지원하지 않는 경우에는 해당 속성이 어떤 효과도 갖지 않으며, :disabled:enabled 의사 클래스도 적용되지 않습니다.

제약 조건 검증

요소가 disabled 상태일 경우 해당 요소의 값은 포커스를 받거나 사용자에 의해 값이 변경될 수 없으며, 제약 조건 검증에도 참여하지 않습니다.

예시

많은 브라우저들은 기본적으로 폼 컨트롤이 비활성화되면 이를 더 밝은 회색의 색상으로 표시합니다. 다음은 비활성화된 체크박스, 라디오 버튼, <option>, <optgroup>의 예시이며, 상위 <fieldset> 요소에 적용된 disabled 속성에 의해 비활성화된 일부 폼 컨트롤의 예시입니다. <option>들은 비활성화되지만 <select>은 그렇지 않습니다. <select> 전체를 비활성화하기 위해서는 하위 요소가 아닌 해당 요소에 속성을 추가해야 합니다.

html
<fieldset>
  <legend>체크박스</legend>
  <p>
    <label> <input type="checkbox" name="chbox" value="regular" /> 일반 </label>
  </p>
  <p>
    <label>
      <input type="checkbox" name="chbox" value="disabled" disabled /> 비활성
    </label>
  </p>
</fieldset>

<fieldset>
  <legend>라디오 버튼</legend>
  <p>
    <label> <input type="radio" name="radio" value="regular" /> 일반 </label>
  </p>
  <p>
    <label>
      <input type="radio" name="radio" value="disabled" disabled /> 비활성
    </label>
  </p>
</fieldset>

<p>
  <label
    >옵션 선택:
    <select>
      <optgroup label="그룹 1">
        <option>옵션 1.1</option>
      </optgroup>
      <optgroup label="그룹 2">
        <option>옵션 2.1</option>
        <option disabled>옵션 2.2</option>
        <option>옵션 2.3</option>
      </optgroup>
      <optgroup label="그룹 3" disabled>
        <option>비활성 3.1</option>
        <option>비활성 3.2</option>
        <option>비활성 3.3</option>
      </optgroup>
    </select>
  </label>
</p>

<fieldset disabled>
  <legend>비활성 fieldset</legend>
  <p>
    <label>
      이름: <input type="radio" name="radio" value="regular" /> 일반
    </label>
  </p>
  <p>
    <label>숫자: <input type="number" /></label>
  </p>
</fieldset>

명세

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

브라우저 호환성

html.elements.button.disabled

html.elements.fieldset.disabled

html.elements.input.disabled

html.elements.optgroup.disabled

html.elements.option.disabled

html.elements.select.disabled

html.elements.textarea.disabled

같이 보기