aboutsummaryrefslogtreecommitdiff
path: root/docs/_includes/components/input-groups.html
diff options
context:
space:
mode:
authorMark Otto <[email protected]>2014-03-16 19:03:53 -0700
committerMark Otto <[email protected]>2014-03-16 19:03:53 -0700
commit2a43e7e78a59c70e217383c12c9ef0482cabb163 (patch)
tree8fc0b4560d171f63efb353d4c9965aa5c761d82c /docs/_includes/components/input-groups.html
parentbdb70fa471965728609d86c001384791fa44398b (diff)
downloadbootstrap-2a43e7e78a59c70e217383c12c9ef0482cabb163.tar.xz
bootstrap-2a43e7e78a59c70e217383c12c9ef0482cabb163.zip
Break up docs into includes
Diffstat (limited to 'docs/_includes/components/input-groups.html')
-rw-r--r--docs/_includes/components/input-groups.html311
1 files changed, 311 insertions, 0 deletions
diff --git a/docs/_includes/components/input-groups.html b/docs/_includes/components/input-groups.html
new file mode 100644
index 000000000..e7ea9c064
--- /dev/null
+++ b/docs/_includes/components/input-groups.html
@@ -0,0 +1,311 @@
+<div class="bs-docs-section">
+ <h1 id="input-groups" class="page-header">Input groups</h1>
+
+ <p class="lead">Extend form controls by adding text or buttons before, after, or on both sides of any text-based input. Use <code>.input-group</code> with an <code>.input-group-addon</code> to prepend or append elements to a single <code>.form-control</code>.</p>
+
+ <div class="bs-callout bs-callout-danger">
+ <h4>Cross-browser compatibility</h4>
+ <p>Avoid using <code>&lt;select&gt;</code> elements here as they cannot be fully styled in WebKit browsers.</p>
+ </div>
+ <div class="bs-callout bs-callout-warning">
+ <h4>Tooltips &amp; popovers in input groups require special setting</h4>
+ <p>When using tooltips or popovers on elements within an <code>.input-group</code>, you'll have to specify the option <code>container: 'body'</code> to avoid unwanted side effects (such as the element growing wider and/or losing its rounded corners when the tooltip or popover is triggered).</p>
+ </div>
+ <div class="bs-callout bs-callout-warning">
+ <h4>Don't mix with other components</h4>
+ <p>Do not mix form groups or grid column classes directly with input groups. Instead, nest the input group inside of the form group or grid-related element.</p>
+ </div>
+
+
+ <h2 id="input-groups-basic">Basic example</h2>
+ <p>Place one add-on or button on either side of an input. You may also place one on both sides of an input.</p>
+ <p><strong class="text-danger">We do not support multiple add-ons on a single side.</strong></p>
+ <p><strong class="text-danger">We do not support multiple form-controls in a single input group.</strong></p>
+ <form class="bs-example bs-example-form" role="form">
+ <div class="input-group">
+ <span class="input-group-addon">@</span>
+ <input type="text" class="form-control" placeholder="Username">
+ </div>
+ <br>
+ <div class="input-group">
+ <input type="text" class="form-control">
+ <span class="input-group-addon">.00</span>
+ </div>
+ <br>
+ <div class="input-group">
+ <span class="input-group-addon">$</span>
+ <input type="text" class="form-control">
+ <span class="input-group-addon">.00</span>
+ </div>
+ </form>
+{% highlight html %}
+<div class="input-group">
+ <span class="input-group-addon">@</span>
+ <input type="text" class="form-control" placeholder="Username">
+</div>
+
+<div class="input-group">
+ <input type="text" class="form-control">
+ <span class="input-group-addon">.00</span>
+</div>
+
+<div class="input-group">
+ <span class="input-group-addon">$</span>
+ <input type="text" class="form-control">
+ <span class="input-group-addon">.00</span>
+</div>
+{% endhighlight %}
+
+ <h2 id="input-groups-sizing">Sizing</h2>
+ <p>Add the relative form sizing classes to the <code>.input-group</code> itself and contents within will automatically resize—no need for repeating the form control size classes on each element.</p>
+ <form class="bs-example bs-example-form" role="form">
+ <div class="input-group input-group-lg">
+ <span class="input-group-addon">@</span>
+ <input type="text" class="form-control" placeholder="Username">
+ </div>
+ <br>
+ <div class="input-group">
+ <span class="input-group-addon">@</span>
+ <input type="text" class="form-control" placeholder="Username">
+ </div>
+ <br>
+ <div class="input-group input-group-sm">
+ <span class="input-group-addon">@</span>
+ <input type="text" class="form-control" placeholder="Username">
+ </div>
+ </form>
+{% highlight html %}
+<div class="input-group input-group-lg">
+ <span class="input-group-addon">@</span>
+ <input type="text" class="form-control" placeholder="Username">
+</div>
+
+<div class="input-group">
+ <span class="input-group-addon">@</span>
+ <input type="text" class="form-control" placeholder="Username">
+</div>
+
+<div class="input-group input-group-sm">
+ <span class="input-group-addon">@</span>
+ <input type="text" class="form-control" placeholder="Username">
+</div>
+{% endhighlight %}
+
+
+ <h2 id="input-groups-checkboxes-radios">Checkboxes and radio addons</h2>
+ <p>Place any checkbox or radio option within an input group's addon instead of text.</p>
+ <form class="bs-example bs-example-form">
+ <div class="row">
+ <div class="col-lg-6">
+ <div class="input-group">
+ <span class="input-group-addon">
+ <input type="checkbox">
+ </span>
+ <input type="text" class="form-control">
+ </div><!-- /input-group -->
+ </div><!-- /.col-lg-6 -->
+ <div class="col-lg-6">
+ <div class="input-group">
+ <span class="input-group-addon">
+ <input type="radio">
+ </span>
+ <input type="text" class="form-control">
+ </div><!-- /input-group -->
+ </div><!-- /.col-lg-6 -->
+ </div><!-- /.row -->
+ </form>
+{% highlight html %}
+<div class="row">
+ <div class="col-lg-6">
+ <div class="input-group">
+ <span class="input-group-addon">
+ <input type="checkbox">
+ </span>
+ <input type="text" class="form-control">
+ </div><!-- /input-group -->
+ </div><!-- /.col-lg-6 -->
+ <div class="col-lg-6">
+ <div class="input-group">
+ <span class="input-group-addon">
+ <input type="radio">
+ </span>
+ <input type="text" class="form-control">
+ </div><!-- /input-group -->
+ </div><!-- /.col-lg-6 -->
+</div><!-- /.row -->
+{% endhighlight %}
+
+
+ <h2 id="input-groups-buttons">Button addons</h2>
+ <p>Buttons in input groups are a bit different and require one extra level of nesting. Instead of <code>.input-group-addon</code>, you'll need to use <code>.input-group-btn</code> to wrap the buttons. This is required due to default browser styles that cannot be overridden.</p>
+ <form class="bs-example bs-example-form">
+ <div class="row">
+ <div class="col-lg-6">
+ <div class="input-group">
+ <span class="input-group-btn">
+ <button class="btn btn-default" type="button">Go!</button>
+ </span>
+ <input type="text" class="form-control">
+ </div><!-- /input-group -->
+ </div><!-- /.col-lg-6 -->
+ <div class="col-lg-6">
+ <div class="input-group">
+ <input type="text" class="form-control">
+ <span class="input-group-btn">
+ <button class="btn btn-default" type="button">Go!</button>
+ </span>
+ </div><!-- /input-group -->
+ </div><!-- /.col-lg-6 -->
+ </div><!-- /.row -->
+ </form>
+{% highlight html %}
+<div class="row">
+ <div class="col-lg-6">
+ <div class="input-group">
+ <span class="input-group-btn">
+ <button class="btn btn-default" type="button">Go!</button>
+ </span>
+ <input type="text" class="form-control">
+ </div><!-- /input-group -->
+ </div><!-- /.col-lg-6 -->
+ <div class="col-lg-6">
+ <div class="input-group">
+ <input type="text" class="form-control">
+ <span class="input-group-btn">
+ <button class="btn btn-default" type="button">Go!</button>
+ </span>
+ </div><!-- /input-group -->
+ </div><!-- /.col-lg-6 -->
+</div><!-- /.row -->
+{% endhighlight %}
+
+ <h2 id="input-groups-buttons-dropdowns">Buttons with dropdowns</h2>
+ <p></p>
+ <form class="bs-example bs-example-form" role="form">
+ <div class="row">
+ <div class="col-lg-6">
+ <div class="input-group">
+ <div class="input-group-btn">
+ <button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
+ <ul class="dropdown-menu" role="menu">
+ <li><a href="#">Action</a></li>
+ <li><a href="#">Another action</a></li>
+ <li><a href="#">Something else here</a></li>
+ <li class="divider"></li>
+ <li><a href="#">Separated link</a></li>
+ </ul>
+ </div><!-- /btn-group -->
+ <input type="text" class="form-control">
+ </div><!-- /input-group -->
+ </div><!-- /.col-lg-6 -->
+ <div class="col-lg-6">
+ <div class="input-group">
+ <input type="text" class="form-control">
+ <div class="input-group-btn">
+ <button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
+ <ul class="dropdown-menu dropdown-menu-right" role="menu">
+ <li><a href="#">Action</a></li>
+ <li><a href="#">Another action</a></li>
+ <li><a href="#">Something else here</a></li>
+ <li class="divider"></li>
+ <li><a href="#">Separated link</a></li>
+ </ul>
+ </div><!-- /btn-group -->
+ </div><!-- /input-group -->
+ </div><!-- /.col-lg-6 -->
+ </div><!-- /.row -->
+ </form>
+{% highlight html %}
+<div class="row">
+ <div class="col-lg-6">
+ <div class="input-group">
+ <div class="input-group-btn">
+ <button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
+ <ul class="dropdown-menu">
+ <li><a href="#">Action</a></li>
+ <li><a href="#">Another action</a></li>
+ <li><a href="#">Something else here</a></li>
+ <li class="divider"></li>
+ <li><a href="#">Separated link</a></li>
+ </ul>
+ </div><!-- /btn-group -->
+ <input type="text" class="form-control">
+ </div><!-- /input-group -->
+ </div><!-- /.col-lg-6 -->
+ <div class="col-lg-6">
+ <div class="input-group">
+ <input type="text" class="form-control">
+ <div class="input-group-btn">
+ <button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
+ <ul class="dropdown-menu dropdown-menu-right">
+ <li><a href="#">Action</a></li>
+ <li><a href="#">Another action</a></li>
+ <li><a href="#">Something else here</a></li>
+ <li class="divider"></li>
+ <li><a href="#">Separated link</a></li>
+ </ul>
+ </div><!-- /btn-group -->
+ </div><!-- /input-group -->
+ </div><!-- /.col-lg-6 -->
+</div><!-- /.row -->
+{% endhighlight %}
+
+ <h2 id="input-groups-buttons-segmented">Segmented buttons</h2>
+ <form class="bs-example bs-example-form" role="form">
+ <div class="row">
+ <div class="col-lg-6">
+ <div class="input-group">
+ <div class="input-group-btn">
+ <button type="button" class="btn btn-default" tabindex="-1">Action</button>
+ <button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" tabindex="-1">
+ <span class="caret"></span>
+ <span class="sr-only">Toggle Dropdown</span>
+ </button>
+ <ul class="dropdown-menu" role="menu">
+ <li><a href="#">Action</a></li>
+ <li><a href="#">Another action</a></li>
+ <li><a href="#">Something else here</a></li>
+ <li class="divider"></li>
+ <li><a href="#">Separated link</a></li>
+ </ul>
+ </div>
+ <input type="text" class="form-control">
+ </div><!-- /.input-group -->
+ </div><!-- /.col-lg-6 -->
+ <div class="col-lg-6">
+ <div class="input-group">
+ <input type="text" class="form-control">
+ <div class="input-group-btn">
+ <button type="button" class="btn btn-default" tabindex="-1">Action</button>
+ <button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" tabindex="-1">
+ <span class="caret"></span>
+ <span class="sr-only">Toggle Dropdown</span>
+ </button>
+ <ul class="dropdown-menu dropdown-menu-right" role="menu">
+ <li><a href="#">Action</a></li>
+ <li><a href="#">Another action</a></li>
+ <li><a href="#">Something else here</a></li>
+ <li class="divider"></li>
+ <li><a href="#">Separated link</a></li>
+ </ul>
+ </div>
+ </div><!-- /.input-group -->
+ </div><!-- /.col-lg-6 -->
+ </div><!-- /.row -->
+ </form>
+{% highlight html %}
+<div class="input-group">
+ <div class="input-group-btn">
+ <!-- Button and dropdown menu -->
+ </div>
+ <input type="text" class="form-control">
+</div>
+
+<div class="input-group">
+ <input type="text" class="form-control">
+ <div class="input-group-btn">
+ <!-- Button and dropdown menu -->
+ </div>
+</div>
+{% endhighlight %}
+</div>