跳到主要内容
在 GitHub 查看原文

表单控件

为文本表单控件，如 <input> 和 <textarea>，提供自定义样式、尺寸、焦点状态等升级。

本页目录

示例

表单控件采用 Sass 和 CSS 变量混合的样式，使它们能够适应颜色模式并支持任何自定义方法。

HTML
<div class="mb-3">
  <label for="exampleFormControlInput1" class="form-label">Email address</label>
  <input type="email" class="form-control" id="exampleFormControlInput1" placeholder="name@example.com">
</div>
<div class="mb-3">
  <label for="exampleFormControlTextarea1" class="form-label">Example textarea</label>
  <textarea class="form-control" id="exampleFormControlTextarea1" rows="3"></textarea>
</div>

尺寸

使用诸如 .form-control-lg 和 .form-control-sm 的类来设置高度。

HTML
<input class="form-control form-control-lg" type="text" placeholder=".form-control-lg" aria-label=".form-control-lg example">
<input class="form-control" type="text" placeholder="Default input" aria-label="default input example">
<input class="form-control form-control-sm" type="text" placeholder=".form-control-sm" aria-label=".form-control-sm example">

表单文本

块级或行内级表单文本可以使用 .form-text 创建。

表单文本应使用 aria-describedby 属性明确关联到其所对应的表单控件。这将确保辅助技术（例如屏幕阅读器）在用户聚焦或输入控件时能够朗读此表单文本。

输入框下方的表单文本可以使用 .form-text 进行样式设置。如果将使用块级元素，会添加上边距，以便与上方的输入框轻松间隔。

你的密码必须为8-20个字符长，包含字母和数字，且不得包含空格、特殊字符或表情符号。
HTML
<label for="inputPassword5" class="form-label">Password</label>
<input type="password" id="inputPassword5" class="form-control" aria-describedby="passwordHelpBlock">
<div id="passwordHelpBlock" class="form-text">
  Your password must be 8-20 characters long, contain letters and numbers, and must not contain spaces, special characters, or emoji.
</div>

内联文本可以使用任何典型的内联 HTML 元素（无论是 <span>、<small>，还是其他），只需添加 .form-text 类。

必须为8-20个字符。
HTML
<div class="row g-3 align-items-center">
  <div class="col-auto">
    <label for="inputPassword6" class="col-form-label">Password</label>
  </div>
  <div class="col-auto">
    <input type="password" id="inputPassword6" class="form-control" aria-describedby="passwordHelpInline">
  </div>
  <div class="col-auto">
    <span id="passwordHelpInline" class="form-text">
      Must be 8-20 characters long.
    </span>
  </div>
</div>

禁用

在输入框上添加disabled布尔属性，使其显示为灰色，移除指针事件，并防止聚焦。

HTML
<input class="form-control" type="text" placeholder="Disabled input" aria-label="Disabled input example" disabled>
<input class="form-control" type="text" value="Disabled readonly input" aria-label="Disabled input example" disabled readonly>

只读

在输入框上添加readonly布尔属性可以防止输入值被修改。readonly输入框仍然可以获取焦点并被选中，而disabled输入框则不能。

HTML
<input class="form-control" type="text" value="Readonly input here..." aria-label="readonly input example" readonly>

只读纯文本

如果你想在表单中将 <input readonly> 元素显示为纯文本，请将 .form-control 替换为 .form-control-plaintext 以移除默认的表单字段样式，并保留正确的 margin 和 padding。

HTML
<div class="mb-3 row">
  <label for="staticEmail" class="col-sm-2 col-form-label">Email</label>
  <div class="col-sm-10">
    <input type="text" readonly class="form-control-plaintext" id="staticEmail" value="email@example.com">
  </div>
</div>
<div class="mb-3 row">
  <label for="inputPassword" class="col-sm-2 col-form-label">Password</label>
  <div class="col-sm-10">
    <input type="password" class="form-control" id="inputPassword">
  </div>
</div>
HTML
<form class="row g-3">
  <div class="col-auto">
    <label for="staticEmail2" class="visually-hidden">Email</label>
    <input type="text" readonly class="form-control-plaintext" id="staticEmail2" value="email@example.com">
  </div>
  <div class="col-auto">
    <label for="inputPassword2" class="visually-hidden">Password</label>
    <input type="password" class="form-control" id="inputPassword2" placeholder="Password">
  </div>
  <div class="col-auto">
    <button type="submit" class="btn btn-primary mb-3">Confirm identity</button>
  </div>
</form>

文件输入

HTML
<div class="mb-3">
  <label for="formFile" class="form-label">Default file input example</label>
  <input class="form-control" type="file" id="formFile">
</div>
<div class="mb-3">
  <label for="formFileMultiple" class="form-label">Multiple files input example</label>
  <input class="form-control" type="file" id="formFileMultiple" multiple>
</div>
<div class="mb-3">
  <label for="formFileDisabled" class="form-label">Disabled file input example</label>
  <input class="form-control" type="file" id="formFileDisabled" disabled>
</div>
<div class="mb-3">
  <label for="formFileSm" class="form-label">Small file input example</label>
  <input class="form-control form-control-sm" id="formFileSm" type="file">
</div>
<div>
  <label for="formFileLg" class="form-label">Large file input example</label>
  <input class="form-control form-control-lg" id="formFileLg" type="file">
</div>

颜色

设置 type="color" 并添加 .form-control-color 到 <input>. 我们使用修饰符类来设置固定的 height并覆盖浏览器之间的一些不一致之处。

HTML
<label for="exampleColorInput" class="form-label">Color picker</label>
<input type="color" class="form-control form-control-color" id="exampleColorInput" value="#563d7c" title="Choose your color">

数据列表

数据列表允许你创建一组 <option>可以从内部访问（并自动完成）的s <input>这些类似于 <select> 元素，但在菜单样式上有更多限制和差异。虽然大多数浏览器和操作系统都包含对某些支持 <datalist> 元素，它们的样式充其量也是不一致的。

了解更多关于datalist 元素支持情况的信息。

HTML
<label for="exampleDataList" class="form-label">Datalist example</label>
<input class="form-control" list="datalistOptions" id="exampleDataList" placeholder="Type to search...">
<datalist id="datalistOptions">
  <option value="San Francisco">
  <option value="New York">
  <option value="Seattle">
  <option value="Los Angeles">
  <option value="Chicago">
</datalist>

CSS

Sass 变量

$input-* 在我们大多数表单控件中共享（而不是按钮）。

scss/_variables.scss
$input-padding-y:                       $input-btn-padding-y;
$input-padding-x:                       $input-btn-padding-x;
$input-font-family:                     $input-btn-font-family;
$input-font-size:                       $input-btn-font-size;
$input-font-weight:                     $font-weight-base;
$input-line-height:                     $input-btn-line-height;

$input-padding-y-sm:                    $input-btn-padding-y-sm;
$input-padding-x-sm:                    $input-btn-padding-x-sm;
$input-font-size-sm:                    $input-btn-font-size-sm;


$input-padding-y-lg:                    $input-btn-padding-y-lg;
$input-padding-x-lg:                    $input-btn-padding-x-lg;
$input-font-size-lg:                    $input-btn-font-size-lg;


$input-bg:                              var(--#{$prefix}body-bg);
$input-disabled-color:                  null;
$input-disabled-bg:                     var(--#{$prefix}secondary-bg);
$input-disabled-border-color:           null;


$input-color:                           var(--#{$prefix}body-color);
$input-border-color:                    var(--#{$prefix}border-color);
$input-border-width:                    $input-btn-border-width;
$input-box-shadow:                      var(--#{$prefix}box-shadow-inset);


$input-border-radius:                   var(--#{$prefix}border-radius);
$input-border-radius-sm:                var(--#{$prefix}border-radius-sm);
$input-border-radius-lg:                var(--#{$prefix}border-radius-lg);


$input-focus-bg:                        $input-bg;
$input-focus-border-color:              tint-color($component-active-bg, 50%);
$input-focus-color:                     $input-color;
$input-focus-width:                     $input-btn-focus-width;
$input-focus-box-shadow:                $input-btn-focus-box-shadow;


$input-placeholder-color:               var(--#{$prefix}secondary-color);
$input-plaintext-color:                 var(--#{$prefix}body-color);


$input-height-border:                   calc(#{$input-border-width} * 2); // stylelint-disable-line function-disallowed-list


$input-height-inner:                    add($input-line-height  1em, $input-padding-y  2);
$input-height-inner-half:               add($input-line-height  .5em, $input-padding-y);
$input-height-inner-quarter:            add($input-line-height  .25em, $input-padding-y * .5);


$input-height:                          add($input-line-height  1em, add($input-padding-y  2, $input-height-border, false));
$input-height-sm:                       add($input-line-height  1em, add($input-padding-y-sm  2, $input-height-border, false));
$input-height-lg:                       add($input-line-height  1em, add($input-padding-y-lg  2, $input-height-border, false));


$input-transition:                      border-color .15s ease-in-out, box-shadow .15s ease-in-out;


$form-color-width:                      3rem;

$form-label-* 和 $form-text-* 是给我们的 <label> 和 .form-text 组件的。

scss/_variables.scss
$form-label-margin-bottom:              .5rem;
$form-label-font-size:                  null;
$form-label-font-style:                 null;
$form-label-font-weight:                null;
$form-label-color:                      null;
scss/_variables.scss
$form-text-margin-top:                  .25rem;
$form-text-font-size:                   $small-font-size;
$form-text-font-style:                  null;
$form-text-font-weight:                 null;
$form-text-color:                       var(--#{$prefix}secondary-color);

$form-file-* 用于文件输入。

scss/_variables.scss
$form-file-button-color:          $input-color;
$form-file-button-bg:             var(--#{$prefix}tertiary-bg);
$form-file-button-hover-bg:       var(--#{$prefix}secondary-bg);