浮动标签

创建浮动在输入字段上的精美简单的表单标签。

内容提要

示例

在 .form-floating 中包装一对 <input class="form-control"> 和 <label> 元素以启用 Bootstrap 文本表单字段的浮动标签。每个 <input> 都需要一个 placeholder，因为我们的纯 CSS 浮动标签方法使用 :placeholder-shown 伪元素。另请注意，<input> 必须放在前面，以便我们可以使用同级选择器（例如，~）。

Email address

Password

<div class="form-floating mb-3">
  <input type="email" class="form-control" id="floatingInput" placeholder="name@example.com">
  <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>s 会自动定位到它们的浮动位置。

<form class="form-floating">
  <input type="email" class="form-control" id="floatingInputValue" placeholder="name@example.com" value="test@example.com">
  <label for="floatingInputValue">Input with value</label>
</form>

表单验证样式也会按预期工作。

<form class="form-floating">
  <input type="email" class="form-control is-invalid" id="floatingInputInvalid" placeholder="name@example.com" value="test@example.com">
  <label for="floatingInputInvalid">Invalid input</label>
</form>

Textareas

默认情况下，添加了 .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>

要在 <textarea> 上设置自定义高度，请不要使用 rows 属性。相反，设置一个显式的 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>

下拉列表框(Selects)

除了 .form-control 之外，浮动标签仅在 .form-select 上可用。它们以相同的方式工作，但与 <input> 不同的是，它们将始终以浮动状态显示 <label>。 不支持设置 select 的 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 网格系统时，请确保将表单元素放置在列类中。

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="name@example.com" value="mdo@example.com">
      <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

变量

$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;