View on GitHub

浮動標籤 (Floating labels)

創建能夠浮動在輸入框上方的精美表單標籤

六角學院的 Bootstrap 5 課程上線囉，立即與萬人一同學習最專業、最深入的 Bootstrap 5 課程。

On this page

範例

在 .form-floating 中包覆一對 <input class="form-control"> 和 <label> 元素，以在 Bootstrap 的文字表單區段啟用浮動標籤。基於我們的 CSS 方法 (只有浮動標籤使用 :placeholder-shown 偽元素)，每一個 <input> 都需要一個 placeholder。另外也需要注意 <input> 必須放在最前面，Bootstrap 才能套用到兄弟選擇器 (e.g., ~)。

Email address

Password

<div class="form-floating mb-3">
  <input type="email" class="form-control" id="floatingInput" placeholder="[email protected]">
  <label for="floatingInput">Email address</label>
</div>
<div class="form-floating">
  <input type="password" class="form-control" id="floatingPassword" placeholder="Password">
  <label for="floatingPassword">Password</label>
</div>

如果已經定義 value ，則 <label> 會自動調整為其浮動位置。

<form class="form-floating">
  <input type="email" class="form-control" id="floatingInputValue" placeholder="[email protected]" value="[email protected]">
  <label for="floatingInputValue">Input with value</label>
</form>

表單驗證樣式也可以按預期運作。

<form class="form-floating">
  <input type="email" class="form-control is-invalid" id="floatingInputInvalid" placeholder="[email protected]" value="[email protected]">
  <label for="floatingInputInvalid">Invalid input</label>
</form>

文字欄位

預設情況下，帶有 .form-control 的 <textarea> 會跟 <input> 有相同的高度。

Comments

<div class="form-floating">
  <textarea class="form-control" placeholder="Leave a comment here" id="floatingTextarea"></textarea>
  <label for="floatingTextarea">Comments</label>
</div>

不要使用 rows 屬性來自定義 <textarea> 的高度，而是使用 height 屬性 (透過行內設定，或是自定義的 CSS)。

Comments

<div class="form-floating">
  <textarea class="form-control" placeholder="Leave a comment here" id="floatingTextarea2" style="height: 100px"></textarea>
  <label for="floatingTextarea2">Comments</label>
</div>

選擇

除了 .form-control 外，浮動標籤僅適用於 .form-select。他們的運作方式相同，但不同於 <input>，他們始終會將 <label> 呈現在其浮動位置。不支持帶有 size 和 multiple。

Works with selects

<div class="form-floating">
  <select class="form-select" id="floatingSelect" aria-label="Floating label select example">
    <option selected>Open this select menu</option>
    <option value="1">One</option>
    <option value="2">Two</option>
    <option value="3">Three</option>
  </select>
  <label for="floatingSelect">Works with selects</label>
</div>

排版

使用 Bootstrap 的網格 (Grid) 系統時，請確保將表單元素放在 column 類別裡面。

Email address

Works with selects

<div class="row g-2">
  <div class="col-md">
    <div class="form-floating">
      <input type="email" class="form-control" id="floatingInputGrid" placeholder="[email protected]" value="[email protected]">
      <label for="floatingInputGrid">Email address</label>
    </div>
  </div>
  <div class="col-md">
    <div class="form-floating">
      <select class="form-select" id="floatingSelectGrid" aria-label="Floating label select example">
        <option selected>Open this select menu</option>
        <option value="1">One</option>
        <option value="2">Two</option>
        <option value="3">Three</option>
      </select>
      <label for="floatingSelectGrid">Works with selects</label>
    </div>
  </div>
</div>

Sass

Variables

$form-floating-height:            add(3.5rem, $input-height-border);
$form-floating-line-height:       1.25;
$form-floating-padding-x:         $input-padding-x;
$form-floating-padding-y:         1rem;
$form-floating-input-padding-t:   1.625rem;
$form-floating-input-padding-b:   .625rem;
$form-floating-label-opacity:     .65;
$form-floating-label-transform:   scale(.85) translateY(-.5rem) translateX(.15rem);
$form-floating-transition:        opacity .1s ease-in-out, transform .1s ease-in-out;