정의 및 사용 방법
list 속성은 해당 <input> 태그에 미리 정의된 옵션 목록을 제공하는 <datalist> 태그의 id 속성 값을 지정합니다.
<input> 태그에서 사용할 수 있는 미리 정의된 옵션 데이터 목록을 나타내는 <datalist> 태그는, 이 목록을 사용할 컨트롤인 <input> 태그와 연결해야 합니다.
<datalist> 태그를 <input> 태그와 연결하려면 <datalist> 태그에 고유한 id 속성을 지정한 다음,
해당 <input>에 list 속성을 추가하고 이 id 속성의 값을 list 속성의 값으로 지정합니다.
list 속성을 지원하는 <input> 유형
list 속성은 모든 요소에 적용할 수 있는 글로벌 속성이 아닙니다.
<input> 태그의 일부 유형에서 지원합니다.
다음의 유형에서 지원합니다.
브라우저에 따라 지원하는 호환성 여부가 다를 수 있습니다. (자세한 브라우저 지원 정보는 브라우저 호환성을 참고하세요.)
위에서 명시한 바와 같이 list 속성은 다음의 유형에서는 유형에서는 지원되지 않습니다.
기본 예제
다음의 예제에서는 <input type="color">에 사용자가 쉽게 색상 값을 선택할 수 있도록,
<datalist> 태그가 미리 정의된 색상 목록을 제공하는 용도로 사용되었습니다.
<label for="colors">색상 선택:</label>
<input type="color" list="red-colors" id="colors"> <!-- list 속성을 추가 -->
<datalist id="red-colors"> <!-- 고유한 id를 지정 -->
<!-- 목록의 항목은 <option> 태그로 정의됩니다. -->
<option value="#ff0000"></option> <!-- 빨강 -->
<option value="#0000ff"></option> <!-- 파랑 -->
<option value="#ffff00"></option> <!-- 노랑 -->
</datalist>
설명
이 예제는 <datalist> 태그와 컨트롤인 <input type="color">를 연결하는 방법을 보여줍니다.
<datalist>태그는 사용자가 쉽게 선택할 수 있도록 미리 정의된 색상 목록을 제공합니다.<datalist>태그와 연결한<input type="color">에list속성을 추가하고, 이 속성의 값으로 연결할<datalist>태그의id값을 지정합니다.
위 예제에서 사용자가 색상 선택기(color picker)를 활성화하면, 지정된 미리 정의된 색상 목록이 표시됩니다. 사용자는 목록에서 색상을 선택하거나 직접 색상 값을 입력할 수 있습니다.
더 많은 예제
다음의 예제들은 더 많은 웹 양식 관련 컨트롤의 유형에 따른 <datalist>의 사용을 상황별로 보여줍니다.
<label for="fruits">과일 선물</label>
<input type="text" list="fruit-options" id="fruits">
<!-- 드롭다운 메뉴에 표시 -->
<datalist id="fruit-options">
<option value="사과"></option>
<option value="바나나"></option>
<option value="체리"></option>
<option value="대추야자"></option>
</datalist>
범위 유형의 컨트롤
범위 유형의 컨트롤과 함께 사용되는 <datalist>는 사용자가 쉽게 선택할 수 있는 눈금을 표시합니다.
<label for="volume">볼륨</label>
<input type="range"
id="volume"
min="0"
max="100"
step="25"
value="50"
list="markers">
<!-- 눈금 표시 -->
<datalist id="markers">
<option value="0"></option>
<option value="25"></option>
<option value="50"></option>
<option value="75"></option>
<option value="100"></option>
</datalist>
브라우저 호환성
마지막 업데이트 정보:
| 속성 |
데스크탑 Chrome
|
데스크탑 Edge
|
데스크탑 Firefox
|
Safari
|
|---|---|---|---|---|
<input>의 list 속성 |
20 | 12 | 4 | 12.1 |
<datalist>
|
20 | 12 | 4 | 12.1 |
<input type="color"> 지원 |
20 | 14 | 아니오 | 12.1 |
<input type="date"> 지원 |
20 | 12 | 아니오 | 14.1 |
<input type="email"> 지원 |
22 | 12 | 4 | 12.1 |
<input type="number"> 지원 |
22 | 12 | 4 | 12.1 |
<input type="range"> 지원 |
20 | 12 | 110 | 12.1 |
<input type="search"> 지원 |
22 | 12 | 4 | 12.1 |
<input type="tel"> 지원 |
22 | 12 | 4 | 12.1 |
<input type="text"> 지원 |
20 | 12 | 4 | 12.1 |
<input type="time"> 지원 |
20 | 12 | 아니오 | 14.1 |
<input type="url"> 지원 |
22 | 12 | 4 | 12.1 |
Firefox for Android 호환성 주의
Firefox for Android에서는 <input type="range">에서 list 속성을 지원하지 않을 수 있습니다.
사용 전 최신 브라우저 호환성을 확인해 보세요.
명세서
| 명세서 사양 | |
|---|---|
list
|
HTML #attr-input-list |