布局

使用我们的表单布局选项为您的表单提供一些结构——从内联到水平再到自定义网格实现

表单

每组表单字段都应该驻留在一个 <form> 元素中。 Bootstrap 没有为 <form> 元素提供默认样式,但是默认提供了一些强大的浏览器功能。

  • 浏览器表单的新手?考虑查看 MDN 表单文档以获取可用属性的概述和完整列表。
  • <form> 中的 <button> 默认为 type="submit",因此要尽量具体并始终包含类型。
  • 您可以使用 <form> 上的 disabled 属性禁用表单中的每个表单元素。

由于 Bootstrap 将 display: blockwidth: 100% 应用于我们几乎所有的表单控件,因此默认情况下表单将垂直堆叠。可以使用其他类来根据每个表单更改此布局。

实用程序

边距实用程序是向表单添加一些结构的最简单方法。它们提供标签、控件、可选表单文本和表单验证消息的基本分组。我们建议坚持使用最低边距实用程序,并在整个表单中使用单一方向以保持一致性。

随意使用 <fieldset>s、<div>s 或几乎任何其他元素来构建您喜欢的表单。

<div class="mb-3">
  <label for="formGroupExampleInput" class="form-label">label示例</label>
  <input type="text" class="form-control" id="formGroupExampleInput" placeholder="输入占位符示例">
</div>
<div class="mb-3">
  <label for="formGroupExampleInput2" class="form-label">另一个label</label>
  <input type="text" class="form-control" id="formGroupExampleInput2" placeholder="另一个输入占位符">
</div>
表格网格

使用我们的网格类可以构建更复杂的表单。将这些用于需要多列、不同宽度和其他对齐选项的表单布局。需要启用 $enable-grid-classes Sass 变量(默认启用)。

<div class="row">
  <div class="col">
    <input type="text" class="form-control" placeholder="First name" aria-label="姓名">
  </div>
  <div class="col">
    <input type="text" class="form-control" placeholder="Last name" aria-label="姓氏">
  </div>
</div>
边距

通过添加边距修饰符类,您可以控制边距宽度以及内联和块方向。还需要启用 $enable-grid-classes Sass 变量(默认启用)。

<div class="row g-3">
  <div class="col">
    <input type="text" class="form-control" placeholder="First name" aria-label="姓名">
  </div>
  <div class="col">
    <input type="text" class="form-control" placeholder="Last name" aria-label="姓氏">
  </div>
</div>

还可以使用网格系统创建更复杂的布局。

<form class="row g-3">
  <div class="col-md-6">
    <label for="inputEmail4" class="form-label">邮箱</label>
    <input type="email" class="form-control" id="inputEmail4">
  </div>
  <div class="col-md-6">
    <label for="inputPassword4" class="form-label">密码</label>
    <input type="password" class="form-control" id="inputPassword4">
  </div>
  <div class="col-12">
    <label for="inputAddress" class="form-label">地址</label>
    <input type="text" class="form-control" id="inputAddress" placeholder="1234 Main St">
  </div>
  <div class="col-12">
    <label for="inputAddress2" class="form-label">地址 2</label>
    <input type="text" class="form-control" id="inputAddress2" placeholder="Apartment, studio, or floor">
  </div>
  <div class="col-md-6">
    <label for="inputCity" class="form-label">城市</label>
    <input type="text" class="form-control" id="inputCity">
  </div>
  <div class="col-md-4">
    <label for="inputState" class="form-label">State</label>
    <select id="inputState" class="form-select">
      <option selected>请选择...</option>
      <option>...</option>
    </select>
  </div>
  <div class="col-md-2">
    <label for="inputZip" class="form-label">邮编</label>
    <input type="text" class="form-control" id="inputZip">
  </div>
  <div class="col-12">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" id="gridCheck">
      <label class="form-check-label" for="gridCheck">
        保持登录
      </label>
    </div>
  </div>
  <div class="col-12">
    <button type="submit" class="btn btn-primary">登录</button>
  </div>
</form>
水平形式

通过将 .row 类添加到表单组并使用 .col-*-* 类指定标签和控件的宽度,使用网格创建水平表单。请务必将 .col-form-label 添加到您的 <label> 中,以便它们与其关联的表单控件垂直居中。

有时,您可能需要使用边距或填充实用程序来创建所需的完美对齐。例如,我们移除了堆叠单选输入标签上的 padding-top,以更好地对齐文本基线。

单选框
<form>
  <div class="row mb-3">
    <label for="inputEmail3" class="col-sm-2 col-form-label">邮箱</label>
    <div class="col-sm-10">
      <input type="email" class="form-control" id="inputEmail3">
    </div>
  </div>
  <div class="row mb-3">
    <label for="inputPassword3" class="col-sm-2 col-form-label">密码</label>
    <div class="col-sm-10">
      <input type="password" class="form-control" id="inputPassword3">
    </div>
  </div>
  <fieldset class="row mb-3">
    <legend class="col-form-label col-sm-2 pt-0">单选框</legend>
    <div class="col-sm-10">
      <div class="form-check">
        <input class="form-check-input" type="radio" name="gridRadios" id="gridRadios1" value="option1" checked>
        <label class="form-check-label" for="gridRadios1">
          第一个单选框
        </label>
      </div>
      <div class="form-check">
        <input class="form-check-input" type="radio" name="gridRadios" id="gridRadios2" value="option2">
        <label class="form-check-label" for="gridRadios2">
          第二个单选框
        </label>
      </div>
      <div class="form-check disabled">
        <input class="form-check-input" type="radio" name="gridRadios" id="gridRadios3" value="option3" disabled>
        <label class="form-check-label" for="gridRadios3">
          第三个已禁用的单选框
        </label>
      </div>
    </div>
  </fieldset>
  <div class="row mb-3">
    <div class="col-sm-10 offset-sm-2">
      <div class="form-check">
        <input class="form-check-input" type="checkbox" id="gridCheck1">
        <label class="form-check-label" for="gridCheck1">
          复选框示例
        </label>
      </div>
    </div>
  </div>
  <button type="submit" class="btn btn-primary">登录</button>
</form>
水平表单标签大小

请务必使用 .col-form-label-sm.col-form-label-lg 到您的 <label><legend> 以跟随标签的大小 .form-control-lg.form-control-sm

<div class="row mb-3">
  <label for="colFormLabelSm" class="col-sm-2 col-form-label col-form-label-sm">邮箱</label>
  <div class="col-sm-10">
    <input type="email" class="form-control form-control-sm" id="colFormLabelSm" placeholder="col-form-label-sm">
  </div>
</div>
<div class="row mb-3">
  <label for="colFormLabel" class="col-sm-2 col-form-label">邮箱</label>
  <div class="col-sm-10">
    <input type="email" class="form-control" id="colFormLabel" placeholder="col-form-label">
  </div>
</div>
<div class="row">
  <label for="colFormLabelLg" class="col-sm-2 col-form-label col-form-label-lg">邮箱</label>
  <div class="col-sm-10">
    <input type="email" class="form-control form-control-lg" id="colFormLabelLg" placeholder="col-form-label-lg">
  </div>
</div>
列大小

如前面的示例所示,我们的网格系统允许您在 .row 中放置任意数量的 .col。他们将在它们之间平均分配可用宽度。您还可以选择列的子集以占用更多或更少的空间,而其余的 .cols 将其余部分平均分配,具有特定的列类,例如 .col-sm-7

<div class="row g-3">
  <div class="col-sm-7">
    <input type="text" class="form-control" placeholder="城市" aria-label="城市">
  </div>
  <div class="col-sm">
    <input type="text" class="form-control" placeholder="乡镇" aria-label="乡镇">
  </div>
  <div class="col-sm">
    <input type="text" class="form-control" placeholder="邮编" aria-label="邮编">
  </div>
</div>
自动调整大小

下面的示例使用 flexbox 实用程序将内容垂直居中并将 .col 更改为 .col-auto 以便您的列只占用所需的空间。换句话说,列大小本身基于内容。

@
<form class="row gy-2 gx-3 align-items-center">
  <div class="col-auto">
    <label class="visually-hidden" for="autoSizingInput">姓名</label>
    <input type="text" class="form-control" id="autoSizingInput" placeholder="乔峰">
  </div>
  <div class="col-auto">
    <label class="visually-hidden" for="autoSizingInputGroup">用户名</label>
    <div class="input-group">
      <div class="input-group-text">@</div>
      <input type="text" class="form-control" id="autoSizingInputGroup" placeholder="用户名">
    </div>
  </div>
  <div class="col-auto">
    <label class="visually-hidden" for="autoSizingSelect">爱好</label>
    <select class="form-select" id="autoSizingSelect">
      <option selected>请选择...</option>
      <option value="1">篮球</option>
      <option value="2">足球</option>
      <option value="3">羽毛球</option>
    </select>
  </div>
  <div class="col-auto">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" id="autoSizingCheck">
      <label class="form-check-label" for="autoSizingCheck">
        记住我
      </label>
    </div>
  </div>
  <div class="col-auto">
    <button type="submit" class="btn btn-primary">提交</button>
  </div>
</form>

然后,您可以再次将其与特定于大小的列类重新混合。

@
<form class="row gx-3 gy-2 align-items-center">
  <div class="col-sm-3">
    <label class="visually-hidden" for="specificSizeInputName">姓名</label>
    <input type="text" class="form-control" id="specificSizeInputName" placeholder="段誉">
  </div>
  <div class="col-sm-3">
    <label class="visually-hidden" for="specificSizeInputGroupUsername">用户名</label>
    <div class="input-group">
      <div class="input-group-text">@</div>
      <input type="text" class="form-control" id="specificSizeInputGroupUsername" placeholder="用户名">
    </div>
  </div>
  <div class="col-sm-3">
    <label class="visually-hidden" for="specificSizeSelect">爱好</label>
    <select class="form-select" id="specificSizeSelect">
      <option selected>请选择...</option>
      <option value="1">六脉神剑</option>
      <option value="2">一指禅</option>
      <option value="3">落英神剑</option>
    </select>
  </div>
  <div class="col-auto">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" id="autoSizingCheck2">
      <label class="form-check-label" for="autoSizingCheck2">
        记住我
      </label>
    </div>
  </div>
  <div class="col-auto">
    <button type="submit" class="btn btn-primary">提交</button>
  </div>
</form>
内联表单

使用 .row-cols-* 类创建响应式水平布局。通过添加排水沟修饰符类,我们将在水平和垂直方向上拥有排水沟。在狭窄的移动视口上,.col-12 有助于堆叠表单控件等。 .align-items-center 将表单元素对齐到中间,使 .form-checkbox 正确对齐。

@
<form class="row row-cols-lg-auto g-3 align-items-center">
  <div class="col-12">
    <label class="visually-hidden" for="inlineFormInputGroupUsername">用户名</label>
    <div class="input-group">
      <div class="input-group-text">@</div>
      <input type="text" class="form-control" id="inlineFormInputGroupUsername" placeholder="用户名">
    </div>
  </div>

  <div class="col-12">
    <label class="visually-hidden" for="inlineFormSelectPref">爱好</label>
    <select class="form-select" id="inlineFormSelectPref">
      <option selected>请选择...</option>
      <option value="1">天龙八部</option>
      <option value="2">神雕侠侣</option>
      <option value="3">倚天屠龙记</option>
    </select>
  </div>

  <div class="col-12">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" id="inlineFormCheck">
      <label class="form-check-label" for="inlineFormCheck">
        记住我
      </label>
    </div>
  </div>

  <div class="col-12">
    <button type="submit" class="btn btn-primary">提交</button>
  </div>
</form>