互動元素 (包括表單控制項、連結和按鈕) 預設為可聚焦和可透過 Tab 鍵選取。可透過 Tab 鍵選取的元素是文件依序焦點導覽順序的一部分。其他元素則為惰性元素,也就是不具互動性。您可以使用 HTML 屬性,將互動元素設為惰性,並將惰性元素設為互動。
根據預設,導覽焦點順序與視覺順序相同,也就是原始碼順序。HTML 屬性可以改變這個順序,CSS 屬性則可以改變內容的視覺順序。使用 HTML 變更 Tab 鍵順序,或使用 CSS 變更視覺呈現順序,可能會損害使用者體驗。
請勿使用 CSS 和 HTML 更改感知和實際的 Tab 鍵順序。如下列兩個範例所示,如果分頁順序與預期的視覺順序不同,使用者會感到困惑,且使用者體驗不佳。
在以下範例中,tabindex 屬性的值會導致分頁順序混亂:
在這個範例中,CSS 造成內容的定位順序和視覺順序不一致:
flex-flow: row-reverse; 宣告會反轉視覺順序。此外,CSS order 屬性套用至第六個字詞「This」,因此該字詞在視覺上會移動。Tab 鍵順序是程式碼的順序,不再與視覺順序相符。這會造成鍵盤使用者無法順利操作。
部分 CSS 功能 (包括 flexbox、grid、positioning、transforms 和 multi-column) 可能會改變內容的視覺順序。使用鍵盤按 Tab 鍵瀏覽內容,測試內容:使用 Shift + Tab 鍵向後移動。使用 CSS 指出哪個元素具有焦點。請勿使用 CSS 重新排序可聚焦元素。
請務必在所有可視區域大小中,維持合理的 Tab 鍵順序。
讓惰性元素可互動
contenteditable 和 tabindex 屬性是全域屬性,可新增至任何元素,讓元素在過程中可聚焦。您也可以透過設定 autofocus 屬性,或使用 element.focus() 等指令碼,以滑鼠或指標聚焦於可聚焦元素。
tabindex 屬性
屬性中介紹的全域 tabindex 屬性,可讓原本無法接收焦點的元素取得焦點,通常是使用 Tab 鍵,因此得名。
tabindex 屬性會將整數做為值。負值會使元素可聚焦,但無法透過 Tab 鍵選取。tabindex 值為 0 時,元素可聚焦且可透過 Tab 鍵選取,並會按照原始碼順序,將套用該值的元素加入依序焦點導覽順序。如果值為 1 或更大,元素可聚焦且可透過 Tab 鍵瀏覽,但會加入優先 Tab 鍵序列,因此應避免使用。
在這個頁面上,分享按鈕 <share-action> 是自訂元素。tabindex="0" 會將這個元素加入鍵盤預設分頁順序:
<share-action authors="@front-end.social/@estellevw" data-action="click"
data-category="web.dev" data-icon="share" data-label="share, mastodon"
role="button" tabindex="0">
<svg aria-label="share" role="img" xmlns="http://www.w3.org/2000/svg">
<use href="#shareIcon" />
</svg>
<span>Share</span>
</share-action>
此外,本機導覽具有 tabindex 值為負數的自訂元素:
<web-navigation-drawer type="standard" tabindex="-1">
如果 tabindex 屬性值為負數,元素可聚焦,但無法透過 Tab 鍵選取。元素可以接收焦點,例如使用 HTMLElement.focus(),但不是依序焦點導覽順序的一部分。對於無法使用 Tab 鍵瀏覽但可聚焦的元素,慣例是使用 tabindex="-1"。如果將 tabindex="-1" 新增至互動元素,該元素就無法再透過 Tab 鍵選取。
element.focus() 方法可用於將焦點設為可聚焦元素。瀏覽器會將焦點元素捲動至檢視畫面中。因此,請避免使用 element.focus({preventScroll:true}),因為聚焦於不可見的元素會造成不佳的使用者體驗。
如要查詢文件,找出哪個元素具有焦點,請使用唯讀的 Document.activeElement 屬性。
tabindex 為 1 以上的元素會納入獨立的分頁序列。如下列 Codepen 所示,分頁會以不同的順序開始,從最低值到最高值,然後依來源順序依一般順序 (未設定 tabindex 或 tabindex="0") 進行:
如果 tabindex 的值為正數,元素會進入優先焦點序列,可能導致焦點順序混亂。避免使用 tabindex 修改 DOM 順序。變更分頁順序可能會導致使用者體驗不佳,且難以維護。
contenteditable 屬性
contenteditable 是全域屬性。在任何元素上設定 contenteditable="true",即可讓元素可編輯、可聚焦,並成為 Tab 鍵順序的一部分。焦點行為與設定 tabindex="0" 類似,但不完全相同。
巢狀 contenteditable 元素可聚焦,但無法透過 Tab 鍵選取。如要讓巢狀 contenteditable 元素可透過 Tab 鍵瀏覽,請新增 tabindex="0",將元素加入依序焦點導覽順序。
為互動元素提供 autofocus
雖然布林值 autofocus 是全域屬性,可設定在任何元素上,但無法讓惰性元素變成互動式元素。網頁載入時,只要第一個具有 autofocus 屬性的可聚焦元素顯示,且未巢狀在 <dialog> 中,就會接收焦點。
自動將焦點設在內容上可能會造成使用者困擾。在表單控制項上設定 autofocus 時,該表單控制項會在載入網頁時捲動至檢視畫面。使用者 (包括螢幕閱讀器使用者和可視區域較小的使用者) 可能會遺漏表單的操作說明,甚至是表單控制項的標籤。此外,autofocus 屬性不會改變文件的依序焦點導覽順序。系統會略過序列中位於自動聚焦元素之前的元素。基於上述原因,請避免使用 autofocus 屬性。
「不使用 autofocus」建議的例外狀況,是在 <dialog> 元素中加入 autofocus 屬性。開啟對話方塊時,瀏覽器會自動聚焦於 <dialog> 內第一個可聚焦的互動元素,因此不需要在元素中加入 autofocus。如要確保對話方塊開啟時,對話方塊中的特定互動元素會獲得焦點,請在該元素中加入 autofocus 屬性。
<dialog open>
<form method="dialog">
<button type="submit" autofocus>close</button>
</form>
</dialog>
在關閉 <button> 上設定的 autofocus 屬性,可讓對話方塊開啟時接收焦點。由於它是對話方塊中的第一個元素,因此無論如何都會獲得焦點。根據預設,開啟對話方塊時,對話方塊中第一個可聚焦的元素會取得焦點,除非對話方塊中的其他元素已設定 autofocus 屬性。
停用互動元素
此外,您也可以使用 HTML 屬性,從分頁序列中移除互動元素。包括在可聚焦元素中加入負 tabindex、在支援的表單控制項中加入 disabled 屬性,以及在容器中加入全域 inert 屬性,都會使元素無法透過 Tab 鍵瀏覽。這三個屬性完全獨立,無法互換。
負 tabindex 值
如果 tabindex 屬性值為負值,元素可聚焦,但無法透過 Tab 鍵選取。雖然在預設可聚焦的元素 (包括連結、按鈕、表單控制項和 contenteditable 元素) 中加入 tabindex="0" 並非必要,但加入負值的 tabindex 會從依序焦點導覽順序中移除通常可透過 Tab 鍵選取的元素。
如果 tabindex 值為負數,鍵盤使用者就無法聚焦於互動元素,但不會停用該元素。指標使用者仍可聚焦於該元素。如要停用元素,請使用 disabled 屬性。
已停用
布林值 disabled 屬性會使套用該屬性的表單控制項及其子系 (如有) 無法聚焦。已停用的表單控制項無法聚焦、不會收到點擊事件,也不會在提交表單時提交。
「disabled」不是全域屬性。適用於 <button>、<input>、<optgroup>、<option>、<select>、<textarea>、與表單相關聯的自訂元素,以及 <fieldset>。在 <optgroup> 或 <fieldset> 上設定時,所有子表單控制項都會停用,但 <fieldset> 的第一個 <legend> 內容除外。
支援 disabled 的元素也可用於 :disabled 和 :enabled 虛擬類別。使用 disabled 屬性停用的元素,通常會以使用者代理程式樣式表設定為淺灰色,即使已設定 accent-color 也是如此。
由於這是布林值屬性,因此只要存在,就會停用原本啟用的元素,無法設為 false。如要重新啟用已停用的元素,必須移除屬性,通常使用 Element.removeAttribute('disabled')。
HTMLInputElement.disabled 屬性可讓您檢查輸入內容是否已停用。由於 disabled 不是全域屬性,因此不會從 HTMLElement 繼承,但每個支援的元素介面 (例如 HTMLSelectElement、HTMLTextareaElement) 都具有相同的唯讀屬性。
disabled 屬性不適用於透過 tabindex 或 contenteditable 設為可聚焦的一般 inert 元素,也不適用於 <form> 元素。如要停用這些元素,可以使用全域 inert 屬性。
inert 屬性
將 inert 全域布林值屬性新增至元素後,該元素和所有巢狀內容都會停用,也就是無法點選或透過 Tab 鍵選取。也會從無障礙樹狀結構中移除。雖然 inert 可套用至任何元素,但通常用於內容區段,例如螢幕外或其他隱藏的內容。
將 disabled 套用至表單控制項時,瀏覽器會提供預設樣式,並可使用 :disabled 虛擬類別設定樣式。inert 屬性不提供視覺指標,也沒有相符的虛擬類別 (雖然 [inert] 屬性選取器相符)。
在可見內容上使用 inert,但未以樣式表示惰性,可能會導致使用者體驗不佳。由於螢幕閱讀器使用者無法存取惰性內容,因此當視障螢幕閱讀器使用者在畫面上看到無障礙工具無法存取的內容時,可能會感到困惑。使用 CSS 讓 inert 屬性非常明顯。
請確保焦點不會移至不可見的內容。任何在畫面外算繪、且在聚焦時不會自動顯示的內容,都應設為惰性。如果內容隱藏,但聚焦時會顯示 (例如跳到內容連結),則不需要設為惰性。
隨堂測驗
測試你對焦點的瞭解程度。
如果無法聚焦於某個元素,該元素會被描述為:
如果元素具有 disabled 屬性,下列何者正確?