정의 및 사용 방법
:out-of-range 가상 클래스 선택자는
범위의 제한이 있는 폼 컨트롤 요소가 허용되는 범위 밖의 값일 때 해당 요소를 선택합니다.
이 가상 클래스 선택자를 사용하면 필드의 현재 값이 허용 범위 밖에 있다는 시각적 표시를 사용자에게 제공하는 데 유용합니다.
구문
:out-of-range {
/* ... */
}
기본 예제
다음 예제에서는 :out-of-range를 사용해 폼 컨트롤 요소의 값이 허용되는 범위 밖에 있을 때만 스타일을 지정했습니다.
input:out-of-range {
background-color: red;
}
<p>
<label for="user-number">예약 인원? (최소 1 ~ 최대 7)</label>
<input type="number" id="user-number" value="10" min="1" max="7">
</p>
<p>
<label for="user-time">사용 가능 시간? (09:30 ~ 11:00)</label>
<input type="time" id="user-time" value="08:30" min="09:00" max="11:00">
</p>
사용법 참고 사항
참고하세요!
:out-of-range는 허용되는 범위 밖의 값일 때 해당 요소를 선택하지만, :in-range는 허용되는 범위 내의 값일 때 해당 요소를 선택합니다.
주의할 점
:out-of-range 가상 클래스 선택자를 사용할 때 종종 헷갈리거나 오해하기 쉬운 몇 가지 포인트가 있습니다. 코드를 작성하기 전에 아래 내용들을 꼭 확인해 두는 것이 좋습니다.
해당 요소에 값이 비어있지 않고 유효하게 설정되어 있어야 합니다.
:out-of-range 가상 클래스 선택자는 유효한 범위 제한이 있고, 하한값 미만(underflow)이거나 상한값 초과(overflow) 상태인 폼 컨트롤 요소를 선택합니다.
값 자체가 없거나 유효하지 않지 않거나 비어있을 때에는 하한값 미만(underflow)이거나 상한값 초과(overflow) 상태가 아니므로 선택되지 않습니다.
input:out-of-range {
background-color: red;
}
<p> <!-- 값 자체가 없을 때 -->
<label for="user-number-1">예약 인원? (최소 1 ~ 최대 7)</label>
<input type="number" id="user-number-1" min="1" max="7">
</p>
<p> <!-- 값이 비었을 때 -->
<label for="user-number-2">예약 인원? (최소 1 ~ 최대 7)</label>
<input type="number" id="user-number-2" value="" min="1" max="7">
</p>
<p> <!-- 값이 유효하지 않을 때 -->
<label for="user-number-3">예약 인원? (최소 1 ~ 최대 7)</label>
<input type="number" id="user-number-3" value="😁" min="1" max="7">
</p>
해당 요소는 '범위 제한'이라는 제약 조건 검증 대상이어야 합니다.
:out-of-range 가상 클래스 선택자는 유효한 범위 제한이 있고, 하한값 미만(underflow)이거나 상한값 초과(overflow) 상태인 폼 컨트롤 요소를 선택하지만, 반드시 '범위 제한'이라는 제약 조건 검증 대상(candidates for constraint validation)이 되어야 합니다.
input:out-of-range {
background-color: red;
}
<p> <!-- 읽기 전용 상태 -->
<label for="user-number-1">예약 인원? (최소 1 ~ 최대 7)</label>
<input type="number" id="user-number-1" value="10" min="1" max="7" readonly>
</p>
<p> <!-- 비활성 상태 -->
<label for="user-number-2">예약 인원? (최소 1 ~ 최대 7)</label>
<input type="number" id="user-number-2" value="10" min="1" max="7" disabled>
</p>
<meter> 요소는 적용되지 않습니다.
:in-range 가상 클래스 선택자는 범위 제한이 정의된 폼 컨트롤 요소에만 적용 가능합니다.
부연 설명
<meter> 요소는 알려진 범위 내의 정량적인 측정값 또는 분수 값을 나타냅니다. 예를 들어, 디스크 사용량이나 시험 점수, 용량 등 최솟값과 최댓값이 설정된 범위 내의 상태를 가로막대형의 측정기(gauge)처럼 브라우저에 시각적으로 표시합니다.
meter:out-of-range {
height: 100px;
width: 100px;
}
<label for="fuel-level">연료 잔량</label>
<meter id="fuel-level"
min="0.3"
max="1"
value="0">0%</meter>
<meter> 요소는 :out-of-range 가상 클래스 선택자로 선택할 수 없습니다.
minlength와 maxlength 속성은 적용 대상이 아닙니다.
유효성 검사를 충족하는 폼 컨트롤 요소를 선택하려면
반면, :invalid 가상 클래스 선택자는 제약 조건에 대한 브라우저의 유효성 검사를 충족하지 못하는 폼 관련 요소를 선택합니다.
이러한 유효성 검사 조건을 충족하지 못하는 폼 컨트롤 요소를 선택하려면 :invalid 가상 클래스 선택자 사용을 고려해 보세요.
브라우저 호환성
| 선택자 |
데스크탑 Chrome
|
데스크탑 Edge
|
데스크탑 Firefox
|
Safari
|
|---|---|---|---|---|
:out-of-range
|
10 | 13 | 29 | 5.1 |
명세서
| 명세서 사양 | |
|---|---|
:out-of-range
|
HTML #selector-out-of-range |
:out-of-range
|
Selectors Level 4 #out-of-range-pseudo |