<search>:通用搜尋元素

Baseline 2023

Newly available

Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

<search> HTML 元素是一個容器,代表文件或應用程式中具有與執行搜尋或過濾操作相關的表單控制項或其他內容的部分。<search> 元素在語義上標識元素內容的目的,即具有搜尋或過濾功能。搜尋或過濾功能可以用於網站或應用程式、當前網頁或文件,或整個互聯網或其子部分。

屬性

此元素僅包含全域屬性

使用注意事項

<search> 元素不用於呈現搜尋結果。相反的,用於搜尋或過濾結果應該呈現為該網頁主內容的一部分。儘管如此,作為搜尋功能內的「快速搜尋」功能的建議和鏈接應嵌套在 <search> 元素的內容中,因為它們是搜尋功能的一部分。

可訪問性注意事項

<search> 元素定義了一個搜索標誌。這消除了向 <form> 元素添加 role=search 的需要。

範例

頁首搜尋表單

此示例演示了在網站頁首中使用 <search> 作為容器,以執行簡單的全站搜尋。<search> 是包含將用戶輸入的搜尋查詢提交到服務器的 <form> 的語義容器。

HTML

html
<header>
  <h1>電影網站</h1>
  <search>
    <form action="./search/">
      <label for="movie">尋找電影</label>
      <input type="search" id="movie" name="q" />
      <button type="submit">搜尋</button>
    </form>
  </search>
</header>

結果

Web 應用程式搜尋

此示例演示了在 Web 應用程式中動態包含 JavaScript 搜尋功能時的潛在 DOM 內容。當搜尋功能完全使用 JavaScript 實現時,如果沒有提交表單,則不需要 <form> 元素或提交 <button>。出於語義原因,包含 <search> 元素以容納搜尋和過濾功能。

HTML

html
<search>
  <label>
    Find and filter your query
    <input type="search" id="query" />
  </label>
  <label>
    <input type="checkbox" id="exact-only" />
    Exact matches only
  </label>

  <section>
    <h3>Results:</h3>
    <ul id="results">
      <!-- search result content -->
    </ul>
    <output id="no-results">
      <!-- no results content -->
    </output>
  </section>
</search>

結果

備註:請記住,一些用戶沒有 JavaScript,且在 JavaScript 成功下載、解析和執行之前,沒有任何用戶運行 JavaScript,請確保你的用戶可以在禁用 JavaScript 的情況下訪問你站點的內容。

多個搜尋

此示例演示了一個帶有兩個搜尋功能的頁面。第一個是位於頁首的全站搜尋。第二個是基於頁面上下文的搜尋和過濾,例如我們的例子中的汽車搜尋。

HTML

html
<body>
  <header>
    <h1>Car rental agency</h1>
    <search title="Website">...</search>
  </header>
  <main>
    <h2>Cars available for rent</h2>
    <search title="Cars">
      <h3>Filter results</h3>
      ...
    </search>
    <article>
      <!-- search result content -->
    </article>
  </main>
</body>

結果

技術摘要

內容類型 流內容捫及內容
允許的內容 流內容
標籤省略 不允許,開始和結束標籤都是必須的。
隱含 ARIA 角色 search
允許的 ARIA 角色 formgroupnonepresentationregionsearch
DOM 介面 HTMLElement

規格

Specification
HTML Standard
# the-search-element

瀏覽器相容性

BCD tables only load in the browser

參閱