diff options
author | Mario <mario@mariovavti.com> | 2021-07-29 08:25:05 +0000 |
---|---|---|
committer | Mario <mario@mariovavti.com> | 2021-07-29 08:25:05 +0000 |
commit | d459dfac74e90c29950d49a82edc19fd913d435e (patch) | |
tree | 7bed5f2dbc318f87bbe0f4be2cde3dde09cd97c7 /vendor/twbs/bootstrap/site/content/docs/5.0/forms/form-control.md | |
parent | cec2f0d894b80f3affeb60cff2d4afa49a2019a8 (diff) | |
download | volse-hubzilla-d459dfac74e90c29950d49a82edc19fd913d435e.tar.gz volse-hubzilla-d459dfac74e90c29950d49a82edc19fd913d435e.tar.bz2 volse-hubzilla-d459dfac74e90c29950d49a82edc19fd913d435e.zip |
update to bootstrap 5.0.2
Diffstat (limited to 'vendor/twbs/bootstrap/site/content/docs/5.0/forms/form-control.md')
-rw-r--r-- | vendor/twbs/bootstrap/site/content/docs/5.0/forms/form-control.md | 150 |
1 files changed, 150 insertions, 0 deletions
diff --git a/vendor/twbs/bootstrap/site/content/docs/5.0/forms/form-control.md b/vendor/twbs/bootstrap/site/content/docs/5.0/forms/form-control.md new file mode 100644 index 000000000..9c1c495b1 --- /dev/null +++ b/vendor/twbs/bootstrap/site/content/docs/5.0/forms/form-control.md @@ -0,0 +1,150 @@ +--- +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 and remove pointer events. + +{{< 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. + +{{< 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, use the `.form-control-plaintext` class 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 + +{{< 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" >}} |