mirror of
https://github.com/twbs/bootstrap.git
synced 2024-12-12 00:08:59 +01:00
3e2f9ab237
* v5: Promote floating labels example to component - Adds new .form-floating - Stubs out basics of a docs page - Removes existing Example * Update floating labels to support .form-select, make inputs and selects more consistent - To do this, I made the .form-control and .form-select consistent in min-height vs height - Removed some unused variables now - Updated -color to be the -color because I don't know why this was any different before - Update page to include some examples for layout, validation, and value - Rewrite styles to not modify padding, but instead transform and opacity * Streamline and bulletproof some things - Apply some optimizations from code review - Removed unecessary properties from the label - Add some comments for what properties are required - Move from fixed height for labels to height 100% so we can support textareas - Improve docs a little bit, add ToC * Move some values to variables, switch from scaling font-size to scale, update transforms * Bring over changes from #30966 and add to them to tighten things up * Delete the now unused example images * Fix typo * Allowlist the calc function * Add transform-origin, update transform values * Test out autofill fix * Fix linter issue * Mention it in the migration guide * Bump bundlesize * Add one more variable per review * Shave .25rem off the height Co-authored-by: XhmikosR <xhmikosr@gmail.com>
105 lines
3.8 KiB
Markdown
105 lines
3.8 KiB
Markdown
---
|
|
layout: docs
|
|
title: Floating labels
|
|
description: Create beautifully simple form labels that float over your input fields.
|
|
group: forms
|
|
toc: true
|
|
---
|
|
|
|
## Example
|
|
|
|
Wrap a pair of `<input class="form-control">` and `<label>` elements in `.form-floating` to enable floating labels with Bootstrap's textual form fields. A `placeholder` is required on each `<input>` as our method of CSS-only floating labels uses the `:placeholder-shown` pseudo-element. Also note that the `<input>` must come first so we can utilize a sibling selector (e.g., `~`).
|
|
|
|
This approach works in the new Microsoft Edge built on Chromium and gracefully degrades on older versions.
|
|
|
|
{{< example >}}
|
|
<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>
|
|
{{< /example >}}
|
|
|
|
When there's a `value` already defined, `<label>`s will automatically adjust to their floated position.
|
|
|
|
{{< example >}}
|
|
<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>
|
|
{{< /example >}}
|
|
|
|
Form validation styles also work as expected.
|
|
|
|
{{< example >}}
|
|
<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>
|
|
{{< /example >}}
|
|
|
|
## Textareas
|
|
|
|
By default, `<textarea>`s with `.form-control` will be the same height as `<input>`s.
|
|
|
|
{{< example >}}
|
|
<div class="form-floating">
|
|
<textarea class="form-control" placeholder="Leave a comment here" id="floatingTextarea"></textarea>
|
|
<label for="floatingTextarea">Comments</label>
|
|
</div>
|
|
{{< /example >}}
|
|
|
|
To set a custom height on your `<textarea>`, do not use the `rows` attribute. Instead, set an explicit `height` (either inline or via custom CSS).
|
|
|
|
{{< example >}}
|
|
<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>
|
|
{{< /example >}}
|
|
|
|
## Selects
|
|
|
|
Other than `.form-control`, floating labels only available on `.form-select`s. They work in the same way, but unlike `<input>`s, they'll always show the `<label>` in its floated state.
|
|
|
|
{{< example >}}
|
|
<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>
|
|
{{< /example >}}
|
|
|
|
## Layout
|
|
|
|
When working with the Bootstrap grid system, be sure to place form elements within column classes.
|
|
|
|
{{< example >}}
|
|
<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>
|
|
{{< /example >}}
|