HTMLInputElement

例項屬性

它還繼承了其父介面 HTMLElement 的屬性。

某些屬性僅適用於支援相應屬性的輸入元素型別。

align 已棄用

一個字串，表示元素的對齊方式。請改用 CSS。

alpha 實驗性

一個布林值，表示元素的 alpha 屬性，指示顏色的 alpha 分量是否可以由終端使用者操作，並且不必完全不透明。

colorSpace 實驗性

一個字串，表示元素的 colorspace 屬性，指示序列化 CSS 顏色的色彩空間（sRGB 或 display-p3）。

defaultValue

一個字串，表示建立此物件時 HTML 中最初指定的預設值。

dirName

一個字串，表示元素的文字方向。

incremental 非標準

一個布林值，表示搜尋事件的觸發模式，如果為 true，則在每次按鍵或單擊取消按鈕時觸發；否則，在按 Enter 鍵時觸發。

labels 只讀

返回為此元素標記的 <label> 元素列表。

list 只讀

返回由 list 屬性指向的元素。如果在同一樹中未找到 HTML 元素，則該屬性可能為 null。

multiple

一個布林值，表示元素的 multiple 屬性，指示是否可能存在多個值（例如，多個檔案）。

name

一個字串，表示元素的 name 屬性，其中包含在提交表單時標識元素的名稱。

popoverTargetAction

獲取並設定由 type="button" 的 <input> 元素控制的浮層元素要執行的操作（"hide"、"show" 或 "toggle"）。它反映了 popovertargetaction HTML 屬性的值。

popoverTargetElement

獲取並設定要透過 type="button" 的 <input> 元素控制的浮層元素。與 popovertarget HTML 屬性等效的 JavaScript 屬性。

step

一個字串，表示元素的 step 屬性，它與 min 和 max 配合使用，以限制數字或日期時間值的增量。它可以是字串 any 或一個正浮點數。如果未將其設定為 any，則控制元件只接受大於最小值的步長值倍數的值。

type

一個字串，表示元素的 type 屬性，指示要顯示的控制元件型別。有關可能的值，請參閱 type 屬性的文件。

useMap 已棄用

一個字串，表示客戶端影像對映。

value

一個字串，表示控制元件的當前值。如果使用者輸入的值與預期值不同，則這可能會返回一個空字串。

valueAsDate

一個 Date 物件，表示元素的值，被解釋為日期，如果無法轉換則為 null。

valueAsNumber

一個數字，表示元素的值，按順序解釋為以下之一：時間值、數字，如果無法轉換則為 NaN。

與父表單相關的例項屬性

form 只讀

返回對父 <form> 元素的引用。

formAction

一個字串，表示元素的 formaction 屬性，其中包含處理元素提交的資訊的程式的 URL。這會覆蓋父表單的 action 屬性。

formEnctype

一個字串，表示元素的 formenctype 屬性，其中包含用於將表單提交到伺服器的內容型別。這會覆蓋父表單的 enctype 屬性。

formMethod

一個字串，表示元素的 formmethod 屬性，其中包含瀏覽器用於提交表單的 HTTP 方法。這會覆蓋父表單的 method 屬性。

formNoValidate

一個布林值，表示元素的 formnovalidate 屬性，指示在提交時不對錶單進行驗證。這會覆蓋父表單的 novalidate 屬性。

formTarget

一個字串，表示元素的 formtarget 屬性，其中包含一個名稱或關鍵字，指示在提交表單後在何處顯示收到的響應。這會覆蓋父表單的 target 屬性。

適用於任何非隱藏輸入元素型別的例項屬性

disabled

一個布林值，表示元素的 disabled 屬性，指示控制元件不可互動。輸入值不會隨表單提交。另請參見 readonly。

required

一個布林值，表示元素的 required 屬性，指示使用者在提交表單前必須填寫值。

validationMessage 只讀

返回描述控制元件不滿足的驗證約束（如果有）的本地化訊息。如果控制元件不是約束驗證的候選物件（willValidate 為 false），或者它滿足其約束，則此為空字串。此值可以透過 setCustomValidity() 方法設定。

validity 只讀

返回元素的當前有效性狀態。

willValidate 只讀

返回元素是否是約束驗證的候選物件。如果任何條件阻止其進行約束驗證，則為 false，包括：其 type 為 hidden、reset 或 button，它具有 <datalist> 祖先，或者其 disabled 屬性為 true。

僅適用於複選框或單選按鈕型別的例項屬性

checked

一個布林值，表示元素的當前狀態。

defaultChecked

一個布林值，表示建立此物件時 HTML 中最初指定的單選按鈕或複選框的預設狀態。

indeterminate

一個布林值，表示複選框或單選按鈕是否處於不確定狀態。對於複選框，其效果是複選框的外觀以某種方式模糊/變灰，以指示其狀態不確定（未選中也未取消選中）。不影響 checked 屬性的值，單擊複選框將把值設定為 false。

僅適用於影像型別的例項屬性

alt

一個字串，表示元素的 alt 屬性，其中包含要使用的替代文字。

height

一個字串，表示元素的 height 屬性，它定義了按鈕顯示影像的高度。

src

一個字串，表示元素的 src 屬性，它指定了圖形提交按鈕上要顯示的影像位置的 URI。

width

一個字串，表示元素的 width 屬性，它定義了按鈕顯示影像的寬度。

僅適用於檔案型別的例項屬性

accept

一個字串，表示元素的 accept 屬性，其中包含逗號分隔的檔案型別列表，可以選擇這些檔案型別。

capture

一個字串，表示元素的 capture 屬性，指示檔案上傳控制元件中的媒體捕獲輸入方法。

files

一個 FileList 物件，表示已選擇上傳的檔案。

webkitdirectory

一個布林值，表示 webkitdirectory 屬性。如果為 true，則檔案系統選擇器介面只接受目錄而不是檔案。

webkitEntries 只讀

描述當前選定的檔案或目錄。

僅適用於包含文字或數字的可見元素的例項屬性

autocomplete

一個字串，表示元素的 autocomplete 屬性，指示瀏覽器是否可以自動完成控制元件的值。

max

一個字串，表示元素的 max 屬性，其中包含此項的最大（數字或日期時間）值，該值不得小於其最小值（min 屬性）值。

maxLength

一個數字，表示元素的 maxlength 屬性，其中包含值可以擁有的最大字元數（以 Unicode 程式碼點為單位）。

min

一個字串，表示元素的 min 屬性，其中包含此項的最小（數字或日期時間）值，該值不得大於其最大值（max 屬性）值。

minLength

一個數字，表示元素的 minlength 屬性，其中包含值可以擁有的最小字元數（以 Unicode 程式碼點為單位）。

pattern

一個字串，表示元素的 pattern 屬性，其中包含一個正則表示式，用於檢查控制元件的值。使用 title 屬性來描述模式以幫助使用者。此屬性僅在 type 屬性的值為 text、search、tel、url 或 email 時適用。

placeholder

一個字串，表示元素的 placeholder 屬性，其中包含對使用者的提示，說明可以在控制元件中輸入什麼。佔位符文字不得包含回車符或換行符。此屬性僅在 type 屬性的值為 text、search、tel、url 或 email 時適用。

readOnly

一個布林值，表示元素的 readonly 屬性，指示使用者無法修改控制元件的值。如果 type 為 hidden、range、color、checkbox、radio、file 或按鈕型別，則此屬性將被忽略。

selectionDirection

一個字串，表示選擇發生的方向。可能的值為：forward（選擇是按照當前語言環境的從頭到尾方向執行的）、backward（相反方向）或 none（方向未知）。

selectionEnd

一個數字，表示選定文字的結束索引。如果沒有選擇，則返回當前文字輸入游標位置之後緊鄰的字元的偏移量。

selectionStart

一個數字，表示選定文字的起始索引。如果沒有選擇，則返回 <input> 元素中文字輸入游標（插入符）的位置。

size

一個數字，表示元素的 size 屬性，其中包含控制元件的視覺大小。此值以畫素為單位，除非 type 的值為 text 或 password，在這種情況下，它是整數個字元。僅當 type 設定為 text、search、tel、url、email 或 password 時適用。

例項方法

它還繼承了其父介面 HTMLElement 的方法。

checkValidity()

如果元素是約束驗證的候選物件且不滿足其約束，則返回布林值 false。在這種情況下，它還會向元素觸發 invalid 事件。如果元素不是約束驗證的候選物件，或者它滿足其約束，則返回 true。

reportValidity()

執行 checkValidity() 方法，如果它返回 false（對於無效輸入或未提供 pattern 屬性），則以與提交表單相同的方式向用戶報告輸入無效。

select()

選擇輸入元素中的所有文字，並聚焦它，以便使用者隨後可以替換其所有內容。

setCustomValidity()

為元素設定自定義有效性訊息。如果此訊息不是空字串，則元素存在自定義有效性錯誤，並且不進行驗證。

setRangeText()

用新文字替換輸入元素中的一段文字。

setSelectionRange()

選擇輸入元素中的一段文字（但不聚焦它）。

showPicker()

顯示日期、時間、顏色和檔案的瀏覽器選擇器。

stepDown()

將 value 遞減 (step * n)，如果未指定，n 預設為 1。

stepUp()

將 value 遞增 (step * n)，如果未指定，n 預設為 1。

事件

它還繼承了其父介面 HTMLElement 的事件。

使用 addEventListener() 或將事件監聽器分配給此介面的 oneventname 屬性來監聽這些事件

cancel 事件

當用戶透過 Esc 鍵或取消按鈕取消檔案選擇器對話方塊時，以及當用戶重新選擇之前選擇的相同檔案時觸發。

invalid 事件

當元素在約束驗證期間不滿足其約束時觸發。

search 事件 非標準

當對 type="search" 的 <input> 進行搜尋時觸發。

select 事件

當一些文字被選中時觸發。

selectionchange 事件

當 <input> 元素中的文字選擇發生變化時觸發。

規範

瀏覽器相容性

另見

• 實現此介面的 HTML 元素：<input>