diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2023-06-24 12:44:40 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2023-06-24 12:44:49 +0000 |
commit | db46bfc03f3a22752ef6bd91ae577d893872a216 (patch) | |
tree | 89d924513bc95e6bac4dc8e26f0da84caa477b7b /site/content/docs/5.2/forms/form-control.md | |
parent | Releasing debian version 5.2.3+dfsg-8. (diff) | |
download | bootstrap-html-db46bfc03f3a22752ef6bd91ae577d893872a216.tar.xz bootstrap-html-db46bfc03f3a22752ef6bd91ae577d893872a216.zip |
Merging upstream version 5.3.0+dfsg.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'site/content/docs/5.2/forms/form-control.md')
-rw-r--r-- | site/content/docs/5.2/forms/form-control.md | 152 |
1 files changed, 0 insertions, 152 deletions
diff --git a/site/content/docs/5.2/forms/form-control.md b/site/content/docs/5.2/forms/form-control.md deleted file mode 100644 index 4d6972d..0000000 --- a/site/content/docs/5.2/forms/form-control.md +++ /dev/null @@ -1,152 +0,0 @@ ---- -layout: docs -title: Form controls -description: Give textual form controls like `<input>`s and `<textarea>`s an upgrade with custom styles, sizing, focus states, and more. -group: forms -toc: true ---- - -## Example - -{{< example >}} -<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> -{{< /example >}} - -## Sizing - -Set heights using classes like `.form-control-lg` and `.form-control-sm`. - -{{< example >}} -<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"> -{{< /example >}} - -## Disabled - -Add the `disabled` boolean attribute on an input to give it a grayed out appearance, remove pointer events, and prevent focusing. - -{{< example >}} -<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> -{{< /example >}} - -## Readonly - -Add the `readonly` boolean attribute on an input to prevent modification of the input's value. `readonly` inputs can still be focused and selected, while `disabled` inputs cannot. - -{{< example >}} -<input class="form-control" type="text" value="Readonly input here..." aria-label="readonly input example" readonly> -{{< /example >}} - -## Readonly plain text - -If you want to have `<input readonly>` elements in your form styled as plain text, replace `.form-control` with `.form-control-plaintext` to remove the default form field styling and preserve the correct `margin` and `padding`. - -{{< example >}} - <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> -{{< /example >}} - -{{< example >}} -<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> -{{< /example >}} - -## File input - -{{< example >}} -<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> -{{< /example >}} - -## Color - -Set the `type="color"` and add `.form-control-color` to the `<input>`. We use the modifier class to set fixed `height`s and override some inconsistencies between browsers. - -{{< example >}} -<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"> -{{< /example >}} - -## Datalists - -Datalists allow you to create a group of `<option>`s that can be accessed (and autocompleted) from within an `<input>`. These are similar to `<select>` elements, but come with more menu styling limitations and differences. While most browsers and operating systems include some support for `<datalist>` elements, their styling is inconsistent at best. - -Learn more about [support for datalist elements](https://caniuse.com/datalist). - -{{< example >}} -<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> -{{< /example >}} - -## Sass - -### Variables - -`$input-*` are shared across most of our form controls (and not buttons). - -{{< scss-docs name="form-input-variables" file="scss/_variables.scss" >}} - -`$form-label-*` and `$form-text-*` are for our `<label>`s and `.form-text` component. - -{{< scss-docs name="form-label-variables" file="scss/_variables.scss" >}} - -{{< scss-docs name="form-text-variables" file="scss/_variables.scss" >}} - -`$form-file-*` are for file input. - -{{< scss-docs name="form-file-variables" file="scss/_variables.scss" >}} |