标题

从 <h1> 到 <h6> 所有的HTML标题.

h1. Heading 1

h2. Heading 2

h3. Heading 3

h4. Heading 4

h5. Heading 5

h6. Heading 6

Body copy

Bootstrap的全局设置默认 font-size 为 14px, line-height 为 20px. 这应用在 <body> 和所有段落. 此外, <p> (段落) 里的行与行间隙为line-height的一半 (即默认10px).

Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Nullam id dolor id nibh ultricies vehicula.

Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec ullamcorper nulla non metus auctor fringilla. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Donec ullamcorper nulla non metus auctor fringilla.

Maecenas sed diam eget risus varius blandit sit amet non magna. Donec id elit non mi porta gravida at eget metus. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit.

<p>...</p>

Lead body copy

突出一个段落只需加 .lead.

Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.

<p class="lead">...</p>

构建在Less

排版的尺寸大小在variables.less这2个LESS变量: @baseFontSize and @baseLineHeight的基础上. 第一个是贯穿整个font-size, 第二个是line-heightThe. 我们使用这些变量和一些简单的数值来创建margin, padding, 和 line-height 等等类型.

强调

这里使用了HTML默认的轻量级风格的强调标签.

`<small>`

强调内嵌和文本块, 使用小标签.

This line of text is meant to be treated as fine print.

<p>
  <small>This line of text is meant to be treated as fine print.</small>
</p>

加粗

用font-weight强调一小段文字.

The following snippet of text is rendered as bold text.

<strong>rendered as bold text</strong>

斜体

用斜体强调一小段文字.

The following snippet of text is rendered as italicized text.

<em>rendered as italicized text</em>

注意! 在HTML5可随意使用 <b> 和 <i> . <b> 是为了突出词或短语, 而不会有其他重要含义, 而 <i> 提供主要是语态, 专业术语等含义.

对齐

简单方便将文字对齐的属性.

居左文字.

居中文字.

居右文字.

<p class="text-left">居左文字.</p>
<p class="text-center">居中文字.</p>
<p class="text-right">居右文字.</p>

强调的属性

通过一些颜色来强调.

Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.

Etiam porta sem malesuada magna mollis euismod.

Donec ullamcorper nulla non metus auctor fringilla.

Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis.

Duis mollis, est non commodo luctus, nisi erat porttitor ligula.

<p class="muted">Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.</p>
<p class="text-warning">Etiam porta sem malesuada magna mollis euismod.</p>
<p class="text-error">Donec ullamcorper nulla non metus auctor fringilla.</p>
<p class="text-info">Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis.</p>
<p class="text-success">Duis mollis, est non commodo luctus, nisi erat porttitor ligula.</p>

缩写

参照在鼠标悬停在缩写和缩写词就显示完整内容的HTML<abbr> 元素. abbr元素带有 title 属性之后缩写部分的底部会有一条虚线, 并且鼠标悬停在上面会有一个“帮助”符号, 同时还会显示title所提供的内容.

`<abbr>`

如想看完整文字可把鼠标悬停在缩写词, 但需要包含 title 属性.

An abbreviation of the word attribute is attr.

<abbr title="attribute">attr</abbr>

`<abbr class="initialism">`

如果要缩小缩写词字体大小, 可添加 .initialism .

HTML is the best thing since sliced bread.

<abbr title="HyperText Markup Language" class="initialism">HTML</abbr>

地址

让联系信息最接近原始格式的形式呈现.

`<address>`

换行使用 <br>.

Twitter, Inc.
795 Folsom Ave, Suite 600
San Francisco, CA 94107
P: (123) 456-7890

Full Name
[email protected]

<address>
  <strong>Twitter, Inc.</strong><br>
  795 Folsom Ave, Suite 600<br>
  San Francisco, CA 94107<br>
  <abbr title="Phone">P:</abbr> (123) 456-7890
</address>

<address>
  <strong>Full Name</strong><br>
  <a href="mailto:#">[email protected]</a>
</address>

引用

在你的文档中引用其他来源的内容.

默认

把任何 HTML 嵌套在 <blockquote> 里面即可. 对于直接的引用, 我们建议使用 <p>.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

<blockquote>
  <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
</blockquote>

选项

在标准的引用里, 可以很简单的改变风格和内容.

标出来源

添加 <small> 标签来注明引用的来源. 来源标题可以放在 <cite> 标签里面.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
Someone famous in Source Title

<blockquote>
  <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
  <small>Someone famous <cite title="Source Title">Source Title</cite></small>
</blockquote>

其他

使用 .pull-right 属性, 可以让引用向右靠齐.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
Someone famous in Source Title

<blockquote class="pull-right">
  ...
</blockquote>

列表

无序列表

用于没有明确信息的列表.

Lorem ipsum dolor sit amet
Consectetur adipiscing elit
Integer molestie lorem at massa
Facilisis in pretium nisl aliquet
Nulla volutpat aliquam velit
- Phasellus iaculis neque
- Purus sodales ultricies
- Vestibulum laoreet porttitor sem
- Ac tristique libero volutpat at
Faucibus porta lacus fringilla vel
Aenean sit amet erat nunc
Eget porttitor lorem

<ul>
  <li>...</li>
</ul>

有序列表

用于有明确或需按序号排序的信息的列表.

Lorem ipsum dolor sit amet
Consectetur adipiscing elit
Integer molestie lorem at massa
Facilisis in pretium nisl aliquet
Nulla volutpat aliquam velit
Faucibus porta lacus fringilla vel
Aenean sit amet erat nunc
Eget porttitor lorem

<ol>
  <li>...</li>
</ol>

无样式列表

移除了默认的list-style, 并左填充列表(只对子节点项有效).

Lorem ipsum dolor sit amet
Consectetur adipiscing elit
Integer molestie lorem at massa
Facilisis in pretium nisl aliquet
Nulla volutpat aliquam velit
- Phasellus iaculis neque
- Purus sodales ultricies
- Vestibulum laoreet porttitor sem
- Ac tristique libero volutpat at
Faucibus porta lacus fringilla vel
Aenean sit amet erat nunc
Eget porttitor lorem

<ul class="unstyled">
  <li>...</li>
</ul>

水平列表

使用 inline-block 让列表项水平排列一行, 同时每项都有一定的间距.

Lorem ipsum
Phasellus iaculis
Nulla volutpat

<ul class="inline">
  <li>...</li>
</ul>

描述

对一个(条款)列表进行关联描述.

Description lists: A description list is perfect for defining terms.
Euismod: Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.; Donec id elit non mi porta gravida at eget metus.
Malesuada porta: Etiam porta sem malesuada magna mollis euismod.

<dl>
  <dt>...</dt>
  <dd>...</dd>
</dl>

横向描述

使用<dl>把列表和对其的描述一对一横向显示.

Description lists: A description list is perfect for defining terms.
Euismod: Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.; Donec id elit non mi porta gravida at eget metus.
Malesuada porta: Etiam porta sem malesuada magna mollis euismod.
Felis euismod semper eget lacinia: Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.

<dl class="dl-horizontal">
  <dt>...</dt>
  <dd>...</dd>
</dl>

注意! 横向描述通过text-overflow会对过长而无法在左栏中完全显示的列名截断掉一部分. 而在较窄的视口(宽度)中, 会改变成垂直(形式)表述, 来适应当前屏幕.

内嵌

把一小段代码内嵌到 <code> 标签.

For example, <section> should be wrapped as inline.

For example, <code>&lt;section&gt;</code> should be wrapped as inline.

基本块

使用 <pre> 放入多行代码. 为了能正确渲染, 在代码中一定要避免使用任何尖括号.

<p>Sample text here...</p>

<pre>
  &lt;p&gt;Sample text here...&lt;/p&gt;
</pre>

注意! 因为在 <pre> 标签里, tab会被算进去, 所以要保持代码尽可能的靠左侧.

你也可以添加 .pre-scrollable 把该区域设置成最大高度为350px并带有一个Y轴滚动条.

默认的样式

基本 styling—light padding 和水平分隔符 — 在任意 <table> 添加 .table 即可.

#	First Name	Last Name	Username
1	Mark	Otto	@mdo
2	Jacob	Thornton	@fat
3	Larry	the Bird	@twitter

<table class="table">
  …
</table>

可选属性

可在 .table 添加以下任何属性.

`.table-striped`

在 <tbody> 行内, 通过:nth-child CSS选择器(不支持IE7-8)添加条纹状.

#	First Name	Last Name	Username
1	Mark	Otto	@mdo
2	Jacob	Thornton	@fat
3	Larry	the Bird	@twitter

<table class="table table-striped">
  …
</table>

`.table-bordered`

添加边框和圆角.

#	First Name	Last Name	Username
1	Mark	Otto	@mdo
1	Mark	Otto	@TwBootstrap
2	Jacob	Thornton	@fat
3	Larry the Bird		@twitter

<table class="table table-bordered">
  …
</table>

`.table-hover`

在 <tbody> 内使用停悬效果.

#	First Name	Last Name	Username
1	Mark	Otto	@mdo
2	Jacob	Thornton	@fat
3	Larry the Bird		@twitter

<table class="table table-hover">
  …
</table>

`.table-condensed`

单元格padding减半, 让表格更加紧凑.

#	First Name	Last Name	Username
1	Mark	Otto	@mdo
2	Jacob	Thornton	@fat
3	Larry the Bird		@twitter

<table class="table table-condensed">
  …
</table>

可选的行属性

使用情景(contextual)属性在表格中添加颜色.

属性	描述
`.success`	表示成功或积极的行为.
`.error`	表示一个危险或存有潜在危险的作用.
`.warning`	表示警告, 可能需要注意的作用.
`.info`	作为一个信息的默认样式.

#	Product	Payment Taken	Status
1	TB - Monthly	01/04/2012	Approved
2	TB - Monthly	02/04/2012	Declined
3	TB - Monthly	03/04/2012	Pending
4	TB - Monthly	04/04/2012	Call in to confirm

...
  <tr class="success">
    <td>1</td>
    <td>TB - Monthly</td>
    <td>01/04/2012</td>
    <td>Approved</td>
  </tr>
...

表格支持的标记

下表是表格支持的HTML元素以及应该如何使用它们.

标签	描述
`<table>`	以表格形式显示数据的包装元素
`<thead>`	表头行标签(`<tr>`)
`<tbody>`	表格的内容行(`<tr>`)
`<tr>`	在单行设置一组单元格(`<td>` or `<th>`)
`<td>`	默认的表格单元格
`<th>`	列标签的特殊单元格(或行, 这取决于范围和位置)
`<caption>`	用于对表的描述或总结, 对屏幕阅读器特别有用.

<table>
  <caption>...</caption>
  <thead>
    <tr>
      <th>...</th>
      <th>...</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>...</td>
      <td>...</td>
    </tr>
  </tbody>
</table>

默认样式

单个表单控件的样式, 但在<form>没有包含任何属性或有大的变化标记. 在上下堆叠的结果是表单控件中的标签为左对齐.

<form>
  <fieldset>
    <legend>Legend</legend>
    <label>Label name</label>
    <input type="text" placeholder="Type something…">
    <span class="help-block">Example block-level help text here.</span>
    <label class="checkbox">
      <input type="checkbox"> Check me out
    </label>
    <button type="submit" class="btn">Submit</button>
  </fieldset>
</form>

可选布局

Bootstrap包含3个常用的表单布局.

搜索表单

在表单添加 .form-search 和在 <input> 添加 .search-query 可为输入框提供一个额外的圆角.

<form class="form-search">
  <input type="text" class="input-medium search-query">
  <button type="submit" class="btn">Search</button>
</form>

水平表单

添加 .form-inline 使标签左对齐, 以及通过inline-block控制一个紧凑的布局.

<form class="form-inline">
  <input type="text" class="input-small" placeholder="Email">
  <input type="password" class="input-small" placeholder="Password">
  <label class="checkbox">
    <input type="checkbox"> Remember me
  </label>
  <button type="submit" class="btn">Sign in</button>
</form>

行表单

右对齐的标签和左浮动, 使它们在同一行一一对照. 需要从默认的表格中改动一些的标记:

在表格添加 .form-horizontal
把标签和控件包含在 .control-group
在标签添加 .control-label
为任何关联的控件添加 .controls 来确保位置正确

<form class="form-horizontal">
  <div class="control-group">
    <label class="control-label" for="inputEmail">Email</label>
    <div class="controls">
      <input type="text" id="inputEmail" placeholder="Email">
    </div>
  </div>
  <div class="control-group">
    <label class="control-label" for="inputPassword">Password</label>
    <div class="controls">
      <input type="password" id="inputPassword" placeholder="Password">
    </div>
  </div>
  <div class="control-group">
    <div class="controls">
      <label class="checkbox">
        <input type="checkbox"> Remember me
      </label>
      <button type="submit" class="btn">Sign in</button>
    </div>
  </div>
</form>

支持的表单控件

控件例子.

输入框

最常见的表单控件, 基于文本输入字段. 支持包含HTML5在内的所有类型: 文本, 密码, 日期时间, 本地日期时间, 日期, 月, 时间, 星期, 数字, E-mail, url, 搜索, 电话, 和颜色.

在任何时候都需要指定type.

<input type="text" placeholder="Text input">

文本域

表单控件支持多行的文本. 根据需要可改变 rows 属性.

<textarea rows="3"></textarea>

复选框和单选框

复选框是用于在一个列表中选择一个或多个选项, 而单选框是在众多选择中选择一个选项.

默认 (上下摆放)

<label class="checkbox">
  <input type="checkbox" value="">
  Option one is this and that—be sure to include why it's great
</label>

<label class="radio">
  <input type="radio" name="optionsRadios" id="optionsRadios1" value="option1" checked>
  Option one is this and that—be sure to include why it's great
</label>
<label class="radio">
  <input type="radio" name="optionsRadios" id="optionsRadios2" value="option2">
  Option two can be something else and selecting it will deselect option one
</label>

水平复选框

在复选框或单选框添加 .inline 属性, 使它们在同一行显示.

<label class="checkbox inline">
  <input type="checkbox" id="inlineCheckbox1" value="option1"> 1
</label>
<label class="checkbox inline">
  <input type="checkbox" id="inlineCheckbox2" value="option2"> 2
</label>
<label class="checkbox inline">
  <input type="checkbox" id="inlineCheckbox3" value="option3"> 3
</label>

下拉框

使用默认的选项或者指定 multiple="multiple" 一次显示多个选项.

<select>
  <option>1</option>
  <option>2</option>
  <option>3</option>
  <option>4</option>
  <option>5</option>
</select>

<select multiple="multiple">
  <option>1</option>
  <option>2</option>
  <option>3</option>
  <option>4</option>
  <option>5</option>
</select>

扩展的表单控件

在现有的浏览器添加控件, Bootstrap包含其他有用的表单组件.

前缀和附加输入

在任何文本输入框的基础上, 前或后添加一个文本或按钮. 注意, 不支持select 元素.

默认选项

把 .add-on 放在一个 input 前面或后面.

<div class="input-prepend">
  <span class="add-on">@</span>
  <input class="span2" id="prependedInput" type="text" placeholder="Username">
</div>
<div class="input-append">
  <input class="span2" id="appendedInput" type="text">
  <span class="add-on">.00</span>
</div>

结合

使用2个.add-on, 让输入框拥有前缀和后面附加内容.

<div class="input-prepend input-append">
  <span class="add-on">$</span>
  <input class="span2" id="appendedPrependedInput" type="text">
  <span class="add-on">.00</span>
</div>

按钮代替文本

使用 .btn 附加一个(或两个)按钮, 代替 <span> 的文本.

<div class="input-append">
  <input class="span2" id="appendedInputButton" type="text">
  <button class="btn" type="button">Go!</button>
</div>

<div class="input-append">
  <input class="span2" id="appendedInputButtons" type="text">
  <button class="btn" type="button">搜索</button>
  <button class="btn" type="button">选项</button>
</div>

按钮式下拉菜单

<div class="input-append">
  <input class="span2" id="appendedDropdownButton" type="text">
  <div class="btn-group">
    <button class="btn dropdown-toggle" data-toggle="dropdown">
      Action
      <span class="caret"></span>
    </button>
    <ul class="dropdown-menu">
      ...
    </ul>
  </div>
</div>

<div class="input-prepend">
  <div class="btn-group">
    <button class="btn dropdown-toggle" data-toggle="dropdown">
      Action
      <span class="caret"></span>
    </button>
    <ul class="dropdown-menu">
      ...
    </ul>
  </div>
  <input class="span2" id="prependedDropdownButton" type="text">
</div>

<div class="input-prepend input-append">
  <div class="btn-group">
    <button class="btn dropdown-toggle" data-toggle="dropdown">
      Action
      <span class="caret"></span>
    </button>
    <ul class="dropdown-menu">
      ...
    </ul>
  </div>
  <input class="span2" id="appendedPrependedDropdownButton" type="text">
  <div class="btn-group">
    <button class="btn dropdown-toggle" data-toggle="dropdown">
      Action
      <span class="caret"></span>
    </button>
    <ul class="dropdown-menu">
      ...
    </ul>
  </div>
</div>

分段式下拉菜单

<form>
  <div class="input-prepend">
    <div class="btn-group">...</div>
    <input type="text">
  </div>
  <div class="input-append">
    <input type="text">
    <div class="btn-group">...</div>
  </div>
</form>

搜索表单

<form class="form-search">
  <div class="input-append">
    <input type="text" class="span2 search-query">
    <button type="submit" class="btn">搜索</button>
  </div>
  <div class="input-prepend">
    <button type="submit" class="btn">搜索</button>
    <input type="text" class="span2 search-query">
  </div>
</form>

控件大小

使用相对大小的属性, 例如.input-large 或者使用.span*属性, 使输入框适合网格列大小.

块级输入框

让 <input> 或 <textarea> 元素像一个块级元素.

<input class="input-block-level" type="text" placeholder=".input-block-level">

相对大小

<input class="input-mini" type="text" placeholder=".input-mini">
<input class="input-small" type="text" placeholder=".input-small">
<input class="input-medium" type="text" placeholder=".input-medium">
<input class="input-large" type="text" placeholder=".input-large">
<input class="input-xlarge" type="text" placeholder=".input-xlarge">
<input class="input-xxlarge" type="text" placeholder=".input-xxlarge">

注意! 在未来的版本中, 我们将会修改这些属性, 让按钮大小也使用类似属性. 例如, .input-large 将提高按钮的padding和字体大小.

网格列大小

使用 .span1 到 .span12 让输入框的大小和网格列一致.

<input class="span1" type="text" placeholder=".span1">
<input class="span2" type="text" placeholder=".span2">
<input class="span3" type="text" placeholder=".span3">
<select class="span1">
  ...
</select>
<select class="span2">
  ...
</select>
<select class="span3">
  ...
</select>

对于每行有多个输入框, 使用 .controls-row 为输入框直接加入适当的间距. 通过浮动让输入框之间缩减一些空白, 设置适当的边距, 并清除浮动.

<div class="controls">
  <input class="span5" type="text" placeholder=".span5">
</div>
<div class="controls controls-row">
  <input class="span4" type="text" placeholder=".span4">
  <input class="span1" type="text" placeholder=".span1">
</div>
...

不可编辑的输入框

在表单呈现不可编辑的数据, 无需使用实际的表单标记.

<span class="input-xlarge uneditable-input">Some value here</span>

表单行为

一组(按钮)行为放在表单尾部. 当放置在 .form-actions, 按钮会在表单里自动缩进.

<div class="form-actions">
  <button type="submit" class="btn btn-primary">保存</button>
  <button type="button" class="btn">取消</button>
</div>

帮助文本

说明文字支持水平和块级显示.

水平

<input type="text"><span class="help-inline">请输入中文</span>

块状

<input type="text"><span class="help-block">帮助文本, 如文字过长, 可采用块级显示.</span>

表单控件状态

在表单控件和标签通过基本的反馈状态给用户或者访客提供反馈.

输入焦点

我们在一些表单控件和:focus地方应用了box-shadow, 移除了默认的 outline 样式.

<input class="input-xlarge" id="focusedInput" type="text" value="This is focused...">

无效输入

该样式使用浏览器:invalid的风格. 指定一个type, 添加 required 属性. 如果字段不可用(或可用), 可以指定一个pattern.

这个在Internet Explorer 7-9下不可用, 因为它们不支持CSS伪类选择器.

<input class="span3" type="email" required>

不可输入的输入框

在输入框添加 disabled 属性, 会有一个稍微不同的外观, 并且防止用户输入.

<input class="input-xlarge" id="disabledInput" type="text" placeholder="Disabled input here..." disabled>

验证状态

Bootstrap包含了错误, 警告, 资料, 和成功信息的验证样式. 在 .control-group 添加适当的属性便可以使用.

<div class="control-group warning">
  <label class="control-label" for="inputWarning">警告</label>
  <div class="controls">
    <input type="text" id="inputWarning">
    <span class="help-inline">有问题</span>
  </div>
</div>

<div class="control-group error">
  <label class="control-label" for="inputError">出错</label>
  <div class="controls">
    <input type="text" id="inputError">
    <span class="help-inline">请修改错误</span>
  </div>
</div>

<div class="control-group info">
  <label class="control-label" for="inputInfo">资料</label>
  <div class="controls">
    <input type="text" id="inputInfo">
    <span class="help-inline">用户名已被使用</span>
  </div>
</div>

<div class="control-group success">
  <label class="control-label" for="inputSuccess">成功</label>
  <div class="controls">
    <input type="text" id="inputSuccess">
    <span class="help-inline">不错!</span>
  </div>
</div>

默认

按钮样式可应用于任何有 .btn 属性的按钮. 但是, 通常应用在 <a> 和 <button> 元素会有更好的渲染效果.

按钮	class=""	描述
	`btn`	标准的渐变灰色按钮
	`btn btn-primary`	提供额外的视觉感, 可在一系列的按钮中指出主要操作
	`btn btn-info`	用作可替代默认样式
	`btn btn-success`	表示一个成功或积极的行为
	`btn btn-warning`	表示应该谨慎采取这个动作
	`btn btn-danger`	表示这个动作危险或存在危险
	`btn btn-inverse`	备用的暗灰色按钮, 不依赖于语义和用途
	`btn btn-link`	简化一个按钮, 使它看起来像一个链接, 同时保持按钮的行为

浏览器兼容性

IE9不支持渐变背景, 所以我们将其删除. IE9 jankifies 禁用button元素, 文本会呈现灰色并带有一个令人讨厌的阴影, 此情况我们无法修复.

按钮大小

想使用更大或更小的按钮吗? 添加 .btn-large, .btn-small, 或 .btn-mini 即可改变按钮大小.

<p>
  <button class="btn btn-large btn-primary" type="button">大号按钮</button>
  <button class="btn btn-large" type="button">大号按钮</button>
</p>
<p>
  <button class="btn btn-primary" type="button">默认大小</button>
  <button class="btn" type="button">默认大小</button>
</p>
<p>
  <button class="btn btn-small btn-primary" type="button">小号按钮</button>
  <button class="btn btn-small" type="button">小号按钮</button>
</p>
<p>
  <button class="btn btn-mini btn-primary" type="button">迷你按钮</button>
  <button class="btn btn-mini" type="button">迷你按钮</button>
</p>

通过添加.btn-block创建块级按钮, 同时会填充整个父级的宽度.

<button class="btn btn-large btn-block btn-primary" type="button">Block level button</button>
<button class="btn btn-large btn-block" type="button">Block level button</button>

禁用状态

颜色淡出50%, 让按钮看起来无法点击.

链接元素

在<a>添加.disabled.

主链接链接

<a href="#" class="btn btn-large btn-primary disabled">主链接</a>
<a href="#" class="btn btn-large disabled">链接</a>

注意! 我们这里把 .disabled 看做是一个实用属性, 与常见的 .active 属性类似, 所以无需添加前缀. 此外, 这个属性只是为了美观, 你必须使用JavaScript来禁用链接.

按钮元素

在<button>添加disabled.

<button type="button" class="btn btn-large btn-primary disabled" disabled="disabled">主按钮</button>
<button type="button" class="btn btn-large" disabled>按钮</button>

一个属性, 支持多标签

在 <a>, <button>, 或 <input> 元素使用 .btn.

<a class="btn" href="">Link</a>
<button class="btn" type="submit">Button</button>
<input class="btn" type="button" value="Input">
<input class="btn" type="submit" value="Submit">

一个最佳做法, 就是根据需要尝试找到一个合适的元素, 以确保渲染的效果在各个浏览器保存基本一致. 假如你正使用着一个 input, 那么你的按钮可使用 <input type="submit">.

在任何项目可以很轻松的改变图像样式, 只需在 <img> 元素添加属性

<img src="..." class="img-rounded">
<img src="..." class="img-circle">
<img src="..." class="img-polaroid">

注意! IE7-8不支持.img-rounded 和 .img-circle, 因为它们缺少对 border-radius 的支持.

图标的含义

140个图标在精灵(sprite)表里, 由Glyphicons提供, 有暗灰色(默认)和白色可用.

icon-glass
icon-music
icon-search
icon-envelope
icon-heart
icon-star
icon-star-empty
icon-user
icon-film
icon-th-large
icon-th
icon-th-list
icon-ok
icon-remove
icon-zoom-in
icon-zoom-out
icon-off
icon-signal
icon-cog
icon-trash
icon-home
icon-file
icon-time
icon-road
icon-download-alt
icon-download
icon-upload
icon-inbox
icon-play-circle
icon-repeat
icon-refresh
icon-list-alt
icon-lock
icon-flag
icon-headphones
icon-volume-off
icon-volume-down
icon-volume-up
icon-qrcode
icon-barcode
icon-tag
icon-tags
icon-book
icon-bookmark
icon-print
icon-camera
icon-font
icon-bold
icon-italic
icon-text-height
icon-text-width
icon-align-left
icon-align-center
icon-align-right
icon-align-justify
icon-list
icon-indent-left
icon-indent-right
icon-facetime-video
icon-picture
icon-pencil
icon-map-marker
icon-adjust
icon-tint
icon-edit
icon-share
icon-check
icon-move
icon-step-backward
icon-fast-backward
icon-backward
icon-play
icon-pause
icon-stop
icon-forward
icon-fast-forward
icon-step-forward
icon-eject
icon-chevron-left
icon-chevron-right
icon-plus-sign
icon-minus-sign
icon-remove-sign
icon-ok-sign
icon-question-sign
icon-info-sign
icon-screenshot
icon-remove-circle
icon-ok-circle
icon-ban-circle
icon-arrow-left
icon-arrow-right
icon-arrow-up
icon-arrow-down
icon-share-alt
icon-resize-full
icon-resize-small
icon-plus
icon-minus
icon-asterisk
icon-exclamation-sign
icon-gift
icon-leaf
icon-fire
icon-eye-open
icon-eye-close
icon-warning-sign
icon-plane
icon-calendar
icon-random
icon-comment
icon-magnet
icon-chevron-up
icon-chevron-down
icon-retweet
icon-shopping-cart
icon-folder-close
icon-folder-open
icon-resize-vertical
icon-resize-horizontal
icon-hdd
icon-bullhorn
icon-bell
icon-certificate
icon-thumbs-up
icon-thumbs-down
icon-hand-right
icon-hand-left
icon-hand-up
icon-hand-down
icon-circle-arrow-right
icon-circle-arrow-left
icon-circle-arrow-up
icon-circle-arrow-down
icon-globe
icon-wrench
icon-tasks
icon-filter
icon-briefcase
icon-fullscreen

Glyphicons的来源

Glyphicons一般不会提供免费, 但Bootstrap和Glyphicons的创作者之间的协调, 让作为开发人员的你免费使用. 与此同时, 我们也希望你在实际使用的时候, 可以添加一个Glyphicons的链接.

如何使用

所有图标都需要一个独特、前缀带 icon-属性的<i> 标签. 如需使用时, 可直接将以下代码使用在任何地方:

<i class="icon-search"></i>

也可以使用风格相反(白色)的图标, 这里准备了一个额外的属性. 我们将具体展示这些属性在导航条和下拉菜单中悬停和活动时候的状态效果.

<i class="icon-search icon-white"></i>

注意! 当在旁边使用文本, 按钮或导航链接, 为了有一个适当的间距, 请一定要在<i>后面留一个空格位置.

图标例子

使用在按钮, 工具栏的按钮组合, 导航, 或表单的前缀输入框.

按钮

按钮工具栏

<div class="btn-toolbar">
  <div class="btn-group">
    <a class="btn" href="#"><i class="icon-align-left"></i></a>
    <a class="btn" href="#"><i class="icon-align-center"></i></a>
    <a class="btn" href="#"><i class="icon-align-right"></i></a>
    <a class="btn" href="#"><i class="icon-align-justify"></i></a>
  </div>
</div>

下拉菜单

用户

<div class="btn-group">
  <a class="btn btn-primary" href="#"><i class="icon-user icon-white"></i> 用户</a>
  <a class="btn btn-primary dropdown-toggle" data-toggle="dropdown" href="#"><span class="caret"></span></a>
  <ul class="dropdown-menu">
    <li><a href="#"><i class="icon-pencil"></i> 编辑</a></li>
    <li><a href="#"><i class="icon-trash"></i> 删除</a></li>
    <li><a href="#"><i class="icon-ban-circle"></i> 禁止</a></li>
    <li class="divider"></li>
    <li><a href="#"><i class="i"></i> 编辑</a></li>
  </ul>
</div>

按钮尺寸

星星星星星星

<a class="btn btn-large" href="#"><i class="icon-star"></i> 星星</a>
<a class="btn btn-small" href="#"><i class="icon-star"></i> 星星</a>
<a class="btn btn-mini" href="#"><i class="icon-star"></i> 星星</a>

表单域

<div class="control-group">
  <label class="control-label" for="inputIcon">邮箱地址</label>
  <div class="controls">
    <div class="input-prepend">
      <span class="add-on"><i class="icon-envelope"></i></span>
      <input class="span2" id="inputIcon" type="text">
    </div>
  </div>
</div>