User Input

⊙	Input element

成員 input指定一個文字輸入物件,藉由可選擇式的format屬性來指定使用者輸入的格式,如果一個有效的輸入遮罩限制一個輸入物件,客戶端必須確定藉由輸入物件所收集的值,都必須遵循輸入遮罩,如果輸入不能遵守,客戶端不能傳送且要通知使用者其輸入被拒絕接受,而且允許使用者重新鍵入,客戶端不能以任何沒有遵守輸入遮罩的值來啟始一個輸入物件.

在沒有任何啟始的資料通知輸入遮罩下,客戶端要以沒有資料看待之

語法

下列為其屬性表:

name=nmtoken	變數命明,用以儲存使用者鍵入的資料結果,其變數值將載入其輸入物件
value=vdata	value 屬性指的是,由屬性name已命名的變數的預設值,當該元素被顯示時也尚未有設定值,則value的值將給予該變數名稱,如果屬性name所建立的變數已有值,則屬性value建立的值將被忽視,如果屬性value無法藉由屬性format通知輸入遮罩,則不會有任何有效值被建立或設定
type=(text\|passwd)	屬性 type 為指定文字輸入欄位的型態其預設值為text,下列的值將被允許: text 文字進入控制,客戶代理器和輸入遮罩會適當的回應其輸入, 如果被遞送的值通知了輸入遮罩,則客戶代理器必須儲存未改變且完整的變數, 例如客戶端代理器不必藉由移掉輸入的空白字元來修飾整個輸入如果變數未被設定,則客戶代理器必須以適當的態度回應一個空字串 passwd 文字進入控制, 每一個輸入字元將被回應一個不能解的形式(ex: *),典型的 passwd 模式常被使用在隱密的資料的輸入,但是重要且須要安全機制的應用程式,不應只依賴它,相同於text型態例如客戶端代理器不必藉由移掉輸入的空白字元來修飾整個輸入如果變數未被設定,則客戶代理器必須以適當的態度回應一個空字串
format=cdata	說明用於為使用者的輸入做一個輸入遮罩,此字串包括遮罩的控制字元和在輸入控制區域所顯示的靜態文字,當它只包含合法的格式控制碼時,輸入遮罩只是有效的客戶端代理器必須忽視無效的輸入遮罩格式控制碼指定使用者輸入的資料型態,其預設值為 “M” 格式控制碼分述如下 A 允許任何大寫字元或者標點符號字元, 即大寫非數字字元 a 允許任何小寫字元或者標點符號字元, 即小寫非數字字元 N 允許任何數字字元 X 允許任何大寫字元 x 允許任何小寫字元 M 允許任何字元,客戶端也許選擇假設簡單的資料都是大寫的,但是必須允許任何字元 m 允許任何字元,客戶端也許選擇假設簡單的資料都是小寫的,但是必須允許任何字元 f 允許任何數目的字元數,此格式控制碼能被指定一次, 且必須出現在格式字串的結尾 nf 允許n個字元 , n從 1-9 \C 顯示下一個字元,在輸入欄位
emptyok=boolean	如果你設定其屬性為True,則成員input 將接受空的輸入,即使一個非空字串已被指定, 典型的應用為用於可選擇式的輸入, 預設值為false,用以輸入資料能和我們要求的一致
size=number	此屬性指定文字輸入區域的字元寬度
maxlength=number	指定使用者能夠輸入在文字輸入區域的最大字元數, 預設為無限制
title=vdata	為指定input成員的名稱此名稱習慣於表達此物件的功用
tabindex=number	指定目前成員的標籤位置而標籤位置指的是在單一的card中各成員的相關位置
xml:lang	見一般屬性
id	見一般屬性
class	見一般屬性

範例[35]

下列的例子將指定一個input成員來接受任何字元,且用使用者可以閱讀的方式,顯示給使用者看,最大鍵入字元數為32 ,其輸入結果給變數 X.

<input name=”X” type=”text” maxlength=”32” />

下一個例子為將要求使用者輸入,且將結果傳給變數”name”其欄位預設值為

“Robert”.

<input name=”name” type=”text” value=”Robert”/>

下列例子為一個提示使用者輸入姓和名,以及年齡,在年齡的欄位中,使用者可以鍵入兩位數的數字

<card> <p> First name:<input type=”text” name=”First”/><br/> Last name:<input type=”text” name=”Last”/><br/> Age :<input type=”text” name=”age” format=”NN”/> </p> </card>