--- title: ': 입력 요소' slug: Web/HTML/Element/Input tags: - Element - Forms - HTML - HTML forms - HTML input tag - Reference - Web translation_of: Web/HTML/Element/input ---

HTML <input> 요소는 웹 기반 양식에서 사용자의 데이터를 받을 수 있는 대화형 컨트롤을 생성합니다. {{glossary("user agent", "사용자 에이전트")}}에 따라서 다양한 종류의 입력 데이터 유형과 컨트롤 위젯이 존재합니다. 입력 유형과 특성의 다양한 조합 가능성으로 인해, <input> 요소는 HTML에서 제일 강력하고 복잡한 요소 중 하나입니다.

{{EmbedInteractiveExample("pages/tabbed/input-text.html", "tabbed-shorter")}}

`<input>` 유형

<input> 요소의 동작 방식은 {{htmlattrxref("type")}} 특성에 따라 현격히 달라지므로, 각각의 유형은 별도의 참고 문서에서 더 자세히 확인할 수 있습니다. 특성을 지정하지 않은 경우, 기본값은 text입니다.

가능한 유형은 다음과 같습니다.

유형	설명	기본 예제	Spec
{{HTMLElement("input/button", "button")}}	기본 행동을 가지지 않으며 {{htmlattrxref("value", "input")}}을 레이블로 사용하는 푸시 버튼.	<input type="button" name="button" /> {{EmbedLiveSample("examplebutton",200,55,"","", "nobutton")}}
{{HTMLElement("input/checkbox", "checkbox")}}	단일 값을 선택하거나 선택 해제할 수 있는 체크박스.	<input type="checkbox" name="checkbox"/> {{EmbedLiveSample("examplecheckbox",200,55,"","", "nobutton")}}
{{HTMLElement("input/color", "color")}}	색을 지정할 수 있는 컨트롤. 브라우저가 지원하는 경우, 활성화 시 색상 선택기를 열어줍니다.	<input type="color" name="color"/> {{EmbedLiveSample("examplecolor",200,55,"","", "nobutton")}}	{{HTMLVersionInline("5")}}
{{HTMLElement("input/date", "date")}}	날짜(연월일, 시간 없음)를 지정할 수 있는 컨트롤. 브라우저가 지원하는 경우, 활성화 시 날짜를 선택할 수 있는 달력 등을 열어줍니다.	<input type="date" name="date"/> {{EmbedLiveSample("exampledate",200,55,"","", "nobutton")}}	{{HTMLVersionInline("5")}}
{{HTMLElement("input/datetime-local", "datetime-local")}}	날짜와 시간을 지정할 수 있는 컨트롤. 시간대는 지정할 수 없습니다. 브라우저가 지원하는 경우, 활성화 시 날짜를 선택할 수 있는 달력과, 시계 등을 열어줍니다.	<input type="datetime-local" name="datetime-local"/> {{EmbedLiveSample("exampledtl",200,55,"","", "nobutton")}}	{{HTMLVersionInline("5")}}
{{HTMLElement("input/email", "email")}}	이메일 주소를 편집할 수 있는 필드. 텍스트 입력 필드처럼 보이지만 유효성 검증 매개변수가 존재하며, 브라우저와 장치가 동적 키보드를 지원하는 경우 이메일에 적합한 키보드를 보여줍니다.	<input type="email" name="email"/> {{EmbedLiveSample("exampleemail",200,55,"","", "nobutton")}}	{{HTMLVersionInline("5")}}
{{HTMLElement("input/file", "file")}}	파일을 지정할 수 있는 컨트롤. {{htmlattrxref("accept", "input")}} 특성을 사용하면 허용하는 파일 유형을 지정할 수 있습니다.	<input type="file" accept="image/, text/" name="file"/> {{EmbedLiveSample("examplefile",'100%',55,"","", "nobutton")}}
{{HTMLElement("input/hidden", "hidden")}}	보이지 않지만 값은 서버로 전송하는 컨트롤. 오른쪽 칸에 예제가 있지만 숨겨져서 안보이네요!
{{HTMLElement("input/image", "image")}}	`src` 특성에 지정한 이미지로 나타나는 시각적 제출 버튼. 이미지의 {{anch('src')}}를 누락한 경우 {{anch('alt')}} 특성의 텍스트를 대신 보여줍니다.	<input type="image" name="image" src="" alt="image input"/> {{EmbedLiveSample("exampleimage",200,55,"","", "nobutton")}}
{{HTMLElement("input/month", "month")}}	연과 월을 지정할 수 있는 컨트롤. 시간대는 지정할 수 없습니다.	<input type="month" name="month"/> {{EmbedLiveSample("examplemonth",200,55,"","", "nobutton")}}	{{HTMLVersionInline("5")}}
{{HTMLElement("input/number", "number")}}	숫자를 입력하기 위한 컨트롤. 스피너를 표시하고 지원되는 기본 확인을 추가합니다. 몇몇 장치에서는 동적 키패드들과 숫자 키패드를 표시합니다.	<input type="number" name="number"/> {{EmbedLiveSample("examplenumber",200,55,"","", "nobutton")}}	{{HTMLVersionInline("5")}}
{{HTMLElement("input/password", "password")}}	값이 가려진 한줄 텍스트 필드. 사이트가 안전하지 않으면 사용자에게 경고합니다.	<input type="password" name="password"/> {{EmbedLiveSample("examplepassword",200,55,"","", "nobutton")}}
{{HTMLElement("input/radio", "radio")}}	같은 {{anch('name')}} 값을 가진 여러개의 선택중에서 하나의 값을 선택하게 하는 라디오 버튼입니다.	<input type="radio" name="radio"/> {{EmbedLiveSample("exampleradio",200,55,"","", "nobutton")}}
{{HTMLElement("input/range", "range")}}	값이 가려진 숫자를 입력하는 컨트롤. 디폴트 값이 중간값인 범위 위젯으로 표시합니다. 접속사 {{anch('min')}} 와 {{anch('max')}} 사이에 사용되며 수용가능한 값의 범위를 정의합니다.	<input type="range" name="range" min="0" max="25"/> {{EmbedLiveSample("examplerange",200,55,"","", "nobutton")}}	{{HTMLVersionInline("5")}}
{{HTMLElement("input/reset", "reset")}}	양식의 내용을 디폴트값(기본값)으로 초기화하는 버튼. 권장되지 않습니다.	<input type="reset" name="reset"/> {{EmbedLiveSample("examplereset",200,55,"","", "nobutton")}}
{{HTMLElement("input/search", "search")}}	검색문자열을 입력하는 한줄 텍스트 필드. 줄바꿈 문자는 입력값에서 자동으로 제거됩니다. 지원 브라우저에서 필드를 클리어하기 위해 사용되는 삭제 아이콘이 포함됩니다. 동적 키패드들이 있는 몇몇 장치에서 엔터키 대신에 검색 아이콘을 표시합니다.	<input type="search" name="search"/> {{EmbedLiveSample("examplesearch",200,55,"","", "nobutton")}}	{{HTMLVersionInline("5")}}
{{HTMLElement("input/submit", "submit")}}	양식을 전송하는 버튼	<input type="submit" name="submit"/> {{EmbedLiveSample("examplesubmit",200,55,"","", "nobutton")}}
{{HTMLElement("input/tel", "tel")}}	전화번호를 입력하는 컨트롤. 몇몇 장치에서 동적 키패드들과 전화번호 입력기를 표시한다.	<input type="tel" name="tel"/> {{EmbedLiveSample("exampletel",200,55,"","", "nobutton")}}	{{HTMLVersionInline("5")}}
{{HTMLElement("input/text", "text")}}	디폴트 값. 한줄의 텍스트 필드입니다. 새줄 문자는 입력값으로부터 자동으로 제거됩니다.	<input type="text" name="text"/> {{EmbedLiveSample("exampletext",200,55,"","", "nobutton")}}
{{HTMLElement("input/time", "time")}}	시간대가 없는 시간값을 입력하는 콘트롤	<input type="time" name="time"/> {{EmbedLiveSample("exampletime",200,55,"","", "nobutton")}}	{{HTMLVersionInline("5")}}
{{HTMLElement("input/url", "url")}}	URL을 입력하는 필드. 텍스트 입력처럼 보이지만, 검증 매개변수가 있습니다. 동적 키보드들을 지원하는 브라우저와 장치들에 관련된 키보드가 있습니다.	<input type="url" name="url"/> {{EmbedLiveSample("exampleurl",200,55,"","", "nobutton")}}	{{HTMLVersionInline("5")}}
{{HTMLElement("input/week", "week")}}	시간대가 없는 주-년 값과 주의 값을 구성하는 날짜를 입력하는 컨트롤입니다.	<input type="week" name="week"/> {{EmbedLiveSample("exampleweek",200,55,"","", "nobutton")}}	{{HTMLVersionInline("5")}}
퇴화한 값
{{HTMLElement("input/datetime", "datetime")}}	{{deprecated_inline}} {{obsolete_inline}} UTC 시간대에 기반한 날짜와 시간(시,분,초 그리고 초의 분수)을 입력하는 콘트롤입니다.	<input type="datetime" name="datetime"/> {{EmbedLiveSample("exampledatetime",200,75,"","", "nobutton")}}	{{HTMLVersionInline("5")}}

속성

<input> 요소가 강력한 이유는 바로 다양한 속성 때문입니다. 그 중에서도, 위의 표에서 확인할 수 있는 {{htmlattrxref("type", "input")}} 속성이 제일 중요합니다. 모든 <input> 요소는 유형에 상관하지 않고 {{domxref("HTMLInputElement")}} 인터페이스에 기반하므로, 기술적으로는 모든 <input>이 동일한 속성을 가집니다. 그러나 사실 대부분의 속성은 일부 유형에서만 효과를 보입니다. 게다가, 어떤 속성은 유형별로 그 영향이 달라집니다.

여기에서는 모든 속성값들에 대해 간략한 설명을 담은 표를 제공합니다. 이 표 다음에는 각각의 속성을 더욱 상세하게 설명하는 목록이 나오는데, 그들이 연관된 input 유형과 함께 나옵니다. 대부분의 혹은 모든 input 유형에 공통적인 속성들은 그 아래 더욱 상세하게 설명되어 있습니다. 몇몇 input 유형에만 특정하게 해당하는 속성들이나 모든 유형에 공통적으로 해당하지만 특정 유형에 사용될 때 특정한 행동양식을 나타내는 속성들은 그 유형의 해당 페이지에 대신 기술되어 있습니다. 이 요소에는 글로벌 속성들도 포함됩니다. input에 관련된 특별히 중요한 속성들은 하이라이트로 표시되었습니다.

{{htmlelement('input')}} 요소는 전역 속성(Global Attributes)과 다음 특성을 포함합니다.
특성	유형	설명
{{anch('htmlattrdefaccept', 'accept')}}	file	파일을 업로드 컨트롤에서 기대하는 파일 유형을 암시
{{anch('htmlattrdefalt', 'alt')}}	image	이미지 유형에 대한 대체 속성. accessibiltiy 측면에서 필요.
{{anch('htmlattrdefautocomplete', 'autocomplete')}}	all	양식 자동생성 기능 (form autofill) 암시
{{anch('htmlattrdefautofocus', 'autofocus')}}	all	페이지가 로딩될때 양식 제어에 오토포커스
{{anch('htmlattrdefcapture', 'capture')}}	file	파일 업로드 제어에서 input 방식에서 미디어 capture
{{anch('htmlattrdefchecked', 'checked')}}	radio, checkbox	커맨드나 컨트롤이 체크 되었는지의 여부
{{anch('htmlattrdefdirname', 'dirname')}}	text, search	양식 전송시 요소의 방향성을 전송할 때 양식 필드의 Name
{{anch('htmlattrdefdisabled', 'disabled')}}	all	양식 컨트롤이 비활성화되었는지의 여부
{{anch('htmlattrdefform', 'form')}}	all	컨트롤을 양식 요소와 연결
{{anch('htmlattrdefformaction', 'formaction')}}	image, submit	양식 전송시 URL 사용하기
{{anch('htmlattrdefformenctype', 'formenctype')}}	image, submit	양식의 데이터 인코딩 유형이 양식 전송시 사용될 것
{{anch('htmlattrdefformmethod', 'formmethod')}}	image, submit	양식 전송시 HTTP 방식을 사용
{{anch('htmlattrdefformnovalidate', 'formnovalidate')}}	image, submit	양식 전송시 양식 컨트롤 확인을 무시하기
{{anch('htmlattrdefformtarget', 'formtarget')}}	image, submit	양식 전송시 브라우징 맥락
{{anch('htmlattrdefheight', 'height')}}	image	이미지 높이에서 `height` 속성과 같음
{{anch('htmlattrdeflist', 'list')}}	almost all	datalist 자동입력 옵션의 id 속성값
{{anch('htmlattrdefmax', 'max')}}	numeric types	최대값
{{anch('htmlattrdefmaxlength', 'maxlength')}}	password, search, tel, text, url	`value`의 최대 길이 (문자수)
{{anch('htmlattrdefmin', 'min')}}	numeric types	최소값
{{anch('htmlattrdefminlength', 'minlength')}}	password, search, tel, text, url	`value`의 최소 길이 (문자수)
{{anch('htmlattrdefmultiple', 'multiple')}}	email, file	불리언값. 여러 값을 허용할지의 여부
{{anch('htmlattrdefname', 'name')}}	all	input 양식 컨트롤의 이름. 이름/값 짝(name/value pair)의 일부로서 양식과 함께 전송된다
{{anch('htmlattrdefpattern', 'pattern')}}	password, text, tel	`value` 가 유효하기 위해 일치해야 하는 패턴
{{anch('htmlattrdefplaceholder', 'placeholder')}}	password, search, tel, text, url	양식 컨트롤이 비어있는 때 양식 컨트롤에 나타나는 내용
readonly	almost all	불리언값. 이 값은 수정이 불가능함
required	almost all	불리언값. 양식이 전송되기 위해서 반드시 입력하거나 확인이 필요한 값
{{anch('htmlattrdefsize', 'size')}}	email, password, tel, text	컨트롤의 크기
{{anch('htmlattrdefsrc', 'src')}}	image	이미지 출처의 주소에서 `src` 와 같은 속성
{{anch('htmlattrdefstep', 'step')}}	numeric types	유효한 증분적인 (Incremental)값
{{anch('htmlattrdeftype', 'type')}}	all	input 양식 컨트롤의 유형
{{anch('htmlattrdefvalue', 'value')}}	all	양식 컨트롤의 현재 값. 이름/값 짝(name/value pair)의 일부로서 양식과 함께 전송된다
{{anch('htmlattrdefwidth', 'width')}}	image	이미지의 `width` 속성과 같다

A few additional non-standard attributes are listed following the descriptions of the standard attributes

개별 속성

{{htmlattrdef("accept")}}

Valid for the file input type only, the accept property defines which file types are selectable in a file upload control. See the {{HTMLElement("input/file", "file")}} input type.

{{htmlattrdef("alt")}}

Valid for the image button only, the alt attribute provides alternative text for the image, displaying the value of the attribute if the image {{anch("src")}} is missing or otherwise fails to load. See the {{HTMLElement("input/image", "image")}} input type.

{{htmlattrdef("autocomplete")}}

Not a Boolean attribute, the autocomplete attribute takes as its value a space separated string that describes what, if any, type of autocomplete functionality the input should provide. A typical implementation of autocomplete simply recalls previous values entered in the same input field, but more complex forms of autocomplete can exist. For instance, a browser could integrate with a device's contacts list to autocomplete email addresses in an email input field. See {{SectionOnPage("/en-US/docs/Web/HTML/Attributes/autocomplete", "Values")}} for permitted values.

The autocomplete attribute is valid on hidden, text, search, url, tel, email, date, month, week, time, datetime-local, number, range, color and password. This attribute has no effect on input types that do not return numeric or text data, being valid for all input types except checkbox, radio, file, or any of the button types. See The HTML autocomplete attribute for additional information, including information on password security and how autocomplete is slightly different for hidden than for other input types.

{{htmlattrdef("autofocus")}}

A Boolean attribute which, if present, indicates that the input should automatically have focus when the page has finished loading (or when the {{HTMLElement("dialog")}} containing the element has been displayed).

Note: An element with the autofocus attribute may gain focus before the {{domxref("DOMContentLoaded")}} event is fired.

No more than one element in the document may have the autofocus attribute, and autofocus cannot be used on inputs of type hidden, because hidden inputs can't be focused. If put on more than one element, the first one with the attribute receives focus .

Warning: Automatically focusing a form control can confuse visually-impaired people using screen-reading technology and people with cognitive impairments. When autofocus is assigned, screen-readers "teleport" their user to the form control without warning them beforehand.

For better usability, avoid using autofocus. Automatically focusing on a form control can cause the page to scroll on load. The focus can also cause dynamic keyboards to display on some touch devices. While a screen reader will announce the label of the form control receiving focus, the screen reader will not announce anything before the label, and the sighted user on a small device will equally miss the context created by the preceding content.

{{htmlattrdef("capture")}}

Introduced in the HTML Media Capture specification and valid for the file input type only, the capture attribute defines which media - microphone, video, or camera - should be used to capture a new file for upload with file upload control in supporting scenarios. See the {{HTMLElement("input/file", "file")}} input type.

{{htmlattrdef("checked")}}

Valid for both radio and checkbox types, checked is a Boolean attribute. If present on a radio type, it indicates that that radio button is the currently selected one in the group of same-named radio buttons. If present on a checkbox type, it indicates that the checkbox is checked by default (when the page loads). It does not indicate whether this checkbox is currently checked: if the checkbox’s state is changed, this content attribute does not reflect the change. (Only the HTMLInputElement’s checked IDL attribute is updated.)

Note: Unlike other input controls, a checkboxes and radio buttons value are only included in the submitted data if they are currently checked. If they are, the name and the value(s) of the checked controls are submitted.

For example, if a checkbox whose name is fruit has a value of cherry, and the checkbox is checked, the form data submitted will include fruit=cherry. If the checkbox isn't active, it isn't listed in the form data at all. The default value for checkboxes and radio buttons is on.

{{htmlattrdef("dirname")}}

Valid for text and search input types only, the dirname attribute enables the submission of the directionality of the element. When included, the form control will submit with two name/value pairs: the first being the {{anch('name')}} and {{anch('value')}}, the second being the value of the dirname as the name with the value of ltr or rtl being set by the browser.

<form action="page.html" method="post">
  <label>Fruit: <input type="text" name="fruit" dirname="fruit.dir" value="cherry"></label>
  <input type="submit"/>
</form>
<!-- page.html?fruit=cherry&fruit.dir=ltr -->

When the form above is submitted, the input cause both the name / value pair of fruit=cherry and the dirname / direction pair of fruit.dir=ltr to be sent.

{{htmlattrdef("disabled")}}

A Boolean attribute which, if present, indicates that the user should not be able to interact with the input. Disabled inputs are typically rendered with a dimmer color or using some other form of indication that the field is not available for use.

Specifically, disabled inputs do not receive the {{event("click")}} event, and disabled inputs are not submitted with the form.

Note: Although not required by the specification, Firefox will by default persist the dynamic disabled state of an <input> across page loads. Use the {{htmlattrxref("autocomplete","input")}} attribute to control this feature.

{{htmlattrdef("form")}}

A string specifying the {{HTMLElement("form")}} element with which the input is associated (that is, its form owner). This string's value, if present, must match the {{htmlattrxref("id")}} of a <form> element in the same document. If this attribute isn't specified, the <input> element is associated with the nearest containing form, if any.

The form attribute lets you place an input anywhere in the document but have it included with a form elsewhere in the document.

Note: An input can only be associated with one form.

{{htmlattrdef('formaction')}}