文字欄位:指南
文字欄位讓使用者可在介面中輸入文字。

用法
當使用者需要在介面中輸入文字(例如填寫聯絡或付款資訊)時,請使用文字欄位。

文字欄位有兩種變體:
- 填滿式文字欄位
- 外框文字欄位
兩種變體都透過容器提供互動的視覺提示,且功能相同。


外框文字欄位
外框文字欄位的視覺強調程度低於 填滿式文字欄位。當表單等版面需要並排多個文字欄位時,較低的視覺強調程度有助於簡化 版面配置。

選擇文字欄位
選擇文字欄位
兩種文字欄位變體功能相同,因此可依樣式選擇。
請選擇符合以下條件的變體:
- 最符合應用程式的視覺風格
- 最符合介面目標
- 最能與其他元件(例如 按鈕)及周圍內容區分開來


在同一畫面上使用兩種文字欄位變體
若介面同時使用兩種文字欄位變體,應在不同區段中一致使用,不要在同一區域內混用。
例如,一個區段使用 外框文字欄位,另一個區段使用 填滿式文字欄位。


結構
填滿式文字欄位

- 容器
- 前置圖示(選填)
- 空白欄位中的標籤文字
- 已填入欄位中的標籤文字
- 後置圖示(選填)
- 作用中指示器(聚焦狀態)
- 文字插入點
- 輸入文字
- 輔助文字(選填)
- 作用中指示器(啟用狀態)
外框文字欄位

- 啟用狀態下的容器外框
- 空白欄位中的標籤文字
- 前置圖示(選填)
- 已填入欄位中的標籤文字
- 後置圖示(選填)
- 聚焦狀態下的容器外框
- 文字插入點
- 輸入文字
- 輔助文字(選填)
容器
容器透過與周圍內容形成對比,提升文字欄位的可辨識性。
填色與描邊
文字欄位容器具有填色,且描邊可位於整個容器周圍,或僅位於底部邊緣。描邊的色彩與粗細可變化,以指示文字欄位是否處於作用中狀態。
圓角
外框文字欄位的容器四角皆為圓角;填滿式文字欄位的容器頂部為圓角、底部為直角。

標籤文字
標籤文字用來說明使用者需要提供什麼資訊。每個文字欄位都應有標籤。
標籤文字應與輸入文字對齊,且始終可見。標籤可置於文字欄位中央,或靠近容器頂端。
標籤文字不得截斷,也不得跨越多行;請保持簡短、清楚且完整可見。


相鄰標籤
若欄位用途已由獨立相鄰標籤清楚說明,該文字欄位就不需要內建標籤。
相鄰標籤應與文字欄位容器的起始邊對齊。

必填指示器
若要使欄位顯示為必填,請在標籤文字旁加上星號(*),並以下列任一方式說明星號代表必填欄位:
- 輔助文字
- 在表單開頭提供一則統一說明
其他最佳做法包括:
- 標示所有必填欄位
- 若必填欄位的文字使用特定色彩,星號也應使用相同色彩

輸入文字
輸入文字是使用者在文字欄位中輸入的內容。
文字欄位以下列方式顯示輸入文字:
- 單行文字欄位僅顯示一行文字
- 多行文字欄位會自動增高,以容納多行文字
- 文字區域則是固定高度的欄位

前置文字
文字欄位可包含前置文字,例如貨幣符號。

後置文字
文字欄位可包含後置文字,例如測量單位或電子郵件網域。


輔助文字與字元計數器
輔助文字提供輸入欄位的額外資訊,例如用途。理想上應維持單行,必要時可換行成多行。輔助文字可以持續顯示,或僅在欄位取得焦點時顯示。
若有字元或字數限制,請加入字元計數器或字數計數器,顯示已使用字元數與總字元上限的比例。

- 輔助文字
- 字元計數器
錯誤文字
對於會驗證內容的文字欄位(例如密碼),請以錯誤文字取代輔助文字。如此可避免因新增文字行而推擠內容並改變版面配置。
- 若只可能發生一個錯誤,錯誤文字應說明如何避免該錯誤
- 若可能發生多個錯誤,錯誤文字應說明如何避免最可能發生的錯誤

錯誤圖示
強烈建議在文字欄位處於錯誤狀態時顯示錯誤圖示。
這能為視覺障礙使用者突顯錯誤,並提供額外的感官提示。

圖示與圖片
文字欄位中的圖示為選填項目。圖示可以:
- 描述有效的 輸入方式,例如麥克風圖示
- 提供操作提示以使用額外功能,例如清除欄位內容
- 表達錯誤
前置與後置圖示會依書寫方向(由左至右或由右至左)改變位置。
高度為 24dp 的圖片可放置在文字欄位內。此高度能在欄位內提供最佳的上下內距,並與圖示尺寸建議一致。
- 指示圖示
指示圖示可描述文字欄位所需的輸入類型,並可作為巢狀元件的觸控目標。例如,輕觸日曆圖示即可顯示 日期選擇器。 - 有效或錯誤圖示
圖示可表示有效或無效的輸入,讓色盲使用者也能清楚辨識錯誤狀態。 - 清除圖示
清除圖示讓使用者能清除整個輸入欄位的內容,且僅在有輸入文字時出現。 - 語音輸入圖示
麥克風圖示表示使用者可透過語音輸入文字。 - 下拉箭頭圖示
下拉箭頭表示文字欄位具有內嵌的 選取元件。 - 圖片
圖片有助於說明所需輸入文字的內容,例如信用卡號碼。

- 指示圖示
- 有效或錯誤圖示
- 清除圖示
- 語音輸入圖示
- 下拉箭頭圖示
- 圖片
唯讀欄位
唯讀文字欄位顯示預先填入且使用者無法編輯的文字。
唯讀文字欄位的外觀與一般文字欄位相同,但會清楚標示為唯讀。


自適應設計
當版面配置因應較大螢幕與不同 中斷點而調整時,請為文字欄位採用彈性的容器尺寸。隨著版面配置縮放,請為 邊距、內距與容器尺寸設定最小值和最大值,並讓文字排版隨之調整,以提供更佳的閱讀體驗。

當文字欄位在流動版面配置中擴展時,請避免維持固定邊距與文字排版屬性,否則可能導致文字欄位過長。
例如,文字欄位不應佔滿大型螢幕全寬。

密度
密集文字欄位讓使用者能快速掃描大量資訊並採取行動。

避免預設套用密度
請勿預設對文字欄位套用密度設定,否則觸控目標會縮小至低於建議的 48x48 CSS 像素。建議提供使用者選擇更高密度的方法,例如選取較密集的版面配置或變更主題。
為確保使用中的密度設定能輕鬆還原,所有用於變更設定的觸控目標都應維持至少 48x48 CSS 像素。