From a749db8d0f216491cfefb3849891d93f89b775f7 Mon Sep 17 00:00:00 2001 From: Mario Date: Tue, 11 Oct 2022 18:45:17 +0000 Subject: composer update twbs --- .../site/content/docs/5.2/about/overview.md | 2 +- .../bootstrap/site/content/docs/5.2/about/team.md | 2 +- .../site/content/docs/5.2/components/buttons.md | 4 +- .../site/content/docs/5.2/components/card.md | 2 +- .../site/content/docs/5.2/components/carousel.md | 14 +++- .../site/content/docs/5.2/components/collapse.md | 8 +- .../site/content/docs/5.2/components/dropdowns.md | 10 +-- .../site/content/docs/5.2/components/list-group.md | 66 ++++----------- .../site/content/docs/5.2/components/modal.md | 58 +++++++------- .../site/content/docs/5.2/components/navbar.md | 18 +++-- .../site/content/docs/5.2/components/navs-tabs.md | 71 +++-------------- .../site/content/docs/5.2/components/offcanvas.md | 50 ++++++------ .../site/content/docs/5.2/components/popovers.md | 19 +++-- .../site/content/docs/5.2/components/scrollspy.md | 8 +- .../site/content/docs/5.2/components/toasts.md | 10 +-- .../site/content/docs/5.2/components/tooltips.md | 14 ++-- .../site/content/docs/5.2/customize/overview.md | 2 +- .../site/content/docs/5.2/examples/_index.md | 2 +- .../docs/5.2/examples/cheatsheet-rtl/index.html | 19 +++-- .../docs/5.2/examples/cheatsheet/index.html | 19 +++-- .../docs/5.2/examples/features/features.css | 5 ++ .../content/docs/5.2/examples/features/index.html | 93 ++++++++++++++++++---- .../content/docs/5.2/examples/modals/index.html | 6 +- .../docs/5.2/examples/starter-template/index.html | 2 +- .../site/content/docs/5.2/forms/layout.md | 2 +- .../docs/5.2/getting-started/best-practices.md | 2 +- .../docs/5.2/getting-started/browsers-devices.md | 2 +- .../content/docs/5.2/getting-started/contents.md | 16 ++-- .../content/docs/5.2/getting-started/download.md | 2 +- .../docs/5.2/getting-started/introduction.md | 6 +- .../content/docs/5.2/getting-started/javascript.md | 4 +- .../content/docs/5.2/getting-started/parcel.md | 1 + .../site/content/docs/5.2/getting-started/rtl.md | 2 +- .../site/content/docs/5.2/getting-started/vite.md | 3 +- .../content/docs/5.2/getting-started/webpack.md | 90 ++++++++++++++++++++- .../site/content/docs/5.2/layout/breakpoints.md | 2 +- .../bootstrap/site/content/docs/5.2/layout/grid.md | 4 +- .../site/content/docs/5.2/layout/gutters.md | 2 +- .../site/content/docs/5.2/utilities/borders.md | 2 + 39 files changed, 383 insertions(+), 261 deletions(-) (limited to 'vendor/twbs/bootstrap/site/content') diff --git a/vendor/twbs/bootstrap/site/content/docs/5.2/about/overview.md b/vendor/twbs/bootstrap/site/content/docs/5.2/about/overview.md index f61101c15..1f39b85aa 100644 --- a/vendor/twbs/bootstrap/site/content/docs/5.2/about/overview.md +++ b/vendor/twbs/bootstrap/site/content/docs/5.2/about/overview.md @@ -26,4 +26,4 @@ Our latest release, Bootstrap 5, focuses on improving v4's codebase with as few ## Get involved -Get involved with Bootstrap development by [opening an issue]({{< param repo >}}/issues/new) or submitting a pull request. Read our [contributing guidelines]({{< param repo >}}/blob/v{{< param current_version >}}/.github/CONTRIBUTING.md) for information on how we develop. +Get involved with Bootstrap development by [opening an issue]({{< param repo >}}/issues/new/choose) or submitting a pull request. Read our [contributing guidelines]({{< param repo >}}/blob/v{{< param current_version >}}/.github/CONTRIBUTING.md) for information on how we develop. diff --git a/vendor/twbs/bootstrap/site/content/docs/5.2/about/team.md b/vendor/twbs/bootstrap/site/content/docs/5.2/about/team.md index 3c1666f29..c00ba4efc 100644 --- a/vendor/twbs/bootstrap/site/content/docs/5.2/about/team.md +++ b/vendor/twbs/bootstrap/site/content/docs/5.2/about/team.md @@ -20,4 +20,4 @@ Bootstrap is maintained by the founding team and a small group of invaluable cor {{< /team.inline >}} -Get involved with Bootstrap development by [opening an issue]({{< param repo >}}/issues/new) or submitting a pull request. Read our [contributing guidelines]({{< param repo >}}/blob/v{{< param current_version >}}/.github/CONTRIBUTING.md) for information on how we develop. +Get involved with Bootstrap development by [opening an issue]({{< param repo >}}/issues/new/choose) or submitting a pull request. Read our [contributing guidelines]({{< param repo >}}/blob/v{{< param current_version >}}/.github/CONTRIBUTING.md) for information on how we develop. diff --git a/vendor/twbs/bootstrap/site/content/docs/5.2/components/buttons.md b/vendor/twbs/bootstrap/site/content/docs/5.2/components/buttons.md index 246641529..c2fdd75b1 100644 --- a/vendor/twbs/bootstrap/site/content/docs/5.2/components/buttons.md +++ b/vendor/twbs/bootstrap/site/content/docs/5.2/components/buttons.md @@ -187,8 +187,8 @@ const bsButton = new bootstrap.Button('#myButton') | Method | Description | | --- | --- | | `dispose` | Destroys an element's button. (Removes stored data on the DOM element) | -| `getInstance` | Static method which allows you to get the button instance associated to a DOM element, you can use it like this: `bootstrap.Button.getInstance(element)`| -| `getOrCreateInstance` | Static method which returns a button instance associated to a DOM element or create a new one in case it wasn't initialized. You can use it like this: `bootstrap.Button.getOrCreateInstance(element)` | +| `getInstance` | Static method which allows you to get the button instance associated to a DOM element, you can use it like this: `bootstrap.Button.getInstance(element)`. | +| `getOrCreateInstance` | Static method which returns a button instance associated to a DOM element or create a new one in case it wasn't initialized. You can use it like this: `bootstrap.Button.getOrCreateInstance(element)`. | | `toggle` | Toggles push state. Gives the button the appearance that it has been activated. | {{< /bs-table >}} diff --git a/vendor/twbs/bootstrap/site/content/docs/5.2/components/card.md b/vendor/twbs/bootstrap/site/content/docs/5.2/components/card.md index 78c7cd3f3..6bc90e7b8 100644 --- a/vendor/twbs/bootstrap/site/content/docs/5.2/components/card.md +++ b/vendor/twbs/bootstrap/site/content/docs/5.2/components/card.md @@ -381,7 +381,7 @@ Turn an image into a card background and overlay your card's text. Depending on
Card title

This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

-

Last updated 3 mins ago

+

Last updated 3 mins ago

{{< /example >}} diff --git a/vendor/twbs/bootstrap/site/content/docs/5.2/components/carousel.md b/vendor/twbs/bootstrap/site/content/docs/5.2/components/carousel.md index fee28995b..e32ce64eb 100644 --- a/vendor/twbs/bootstrap/site/content/docs/5.2/components/carousel.md +++ b/vendor/twbs/bootstrap/site/content/docs/5.2/components/carousel.md @@ -281,14 +281,20 @@ Add `.carousel-dark` to the `.carousel` for darker controls, indicators, and cap ## Custom transition -The transition duration of `.carousel-item` can be changed with the `$carousel-transition-duration` Sass variable before compiling or custom styles if you're using the compiled CSS. If multiple transitions are applied, make sure the transform transition is defined first (eg. `transition: transform 2s ease, opacity .5s ease-out`). +The transition duration of `.carousel-item` can be changed with the `$carousel-transition-duration` Sass variable before compiling or custom styles if you're using the compiled CSS. If multiple transitions are applied, make sure the transform transition is defined first (e.g. `transition: transform 2s ease, opacity .5s ease-out`). ## Sass ### Variables +Variables for all carousels: + {{< scss-docs name="carousel-variables" file="scss/_variables.scss" >}} +Variables for the [dark carousel](#dark-variant): + +{{< scss-docs name="carousel-dark-variables" file="scss/_variables.scss" >}} + ## Usage ### Via data attributes @@ -343,10 +349,10 @@ const carousel = new bootstrap.Carousel(myCarouselElement, { | --- | --- | | `cycle` | Cycles through the carousel items from left to right. | | `dispose` | Destroys an element's carousel. (Removes stored data on the DOM element) | -| `getInstance` | Static method which allows you to get the carousel instance associated to a DOM element, you can use it like this: `bootstrap.Carousel.getInstance(element)` | -| `getOrCreateInstance` | Static method which returns a carousel instance associated to a DOM element or create a new one in case it wasn't initialized. You can use it like this: `bootstrap.Carousel.getOrCreateInstance(element)` | +| `getInstance` | Static method which allows you to get the carousel instance associated to a DOM element, you can use it like this: `bootstrap.Carousel.getInstance(element)`. | +| `getOrCreateInstance` | Static method which returns a carousel instance associated to a DOM element or create a new one in case it wasn't initialized. You can use it like this: `bootstrap.Carousel.getOrCreateInstance(element)`. | | `next` | Cycles to the next item. **Returns to the caller before the next item has been shown** (e.g., before the `slid.bs.carousel` event occurs). | -| `nextWhenVisible` | Don't cycle carousel to next when the page isn't visible or the carousel or its parent isn't visible. **Returns to the caller before the target item has been shown** | +| `nextWhenVisible` | Don't cycle carousel to next when the page isn't visible or the carousel or its parent isn't visible. **Returns to the caller before the target item has been shown**. | | `pause` | Stops the carousel from cycling through items. | | `prev` | Cycles to the previous item. **Returns to the caller before the previous item has been shown** (e.g., before the `slid.bs.carousel` event occurs). | | `to` | Cycles the carousel to a particular frame (0 based, similar to an array). **Returns to the caller before the target item has been shown** (e.g., before the `slid.bs.carousel` event occurs). | diff --git a/vendor/twbs/bootstrap/site/content/docs/5.2/components/collapse.md b/vendor/twbs/bootstrap/site/content/docs/5.2/components/collapse.md index 8d775e95d..21be901c0 100644 --- a/vendor/twbs/bootstrap/site/content/docs/5.2/components/collapse.md +++ b/vendor/twbs/bootstrap/site/content/docs/5.2/components/collapse.md @@ -146,8 +146,8 @@ const collapseList = [...collapseElementList].map(collapseEl => new bootstrap.Co {{< bs-table "table" >}} | Name | Type | Default | Description | | --- | --- | --- | --- | -`parent` | selector, jQuery object, DOM element | `false` | If parent is provided, then all collapsible elements under the specified parent will be closed when this collapsible item is shown. (similar to traditional accordion behavior - this is dependent on the `card` class). The attribute has to be set on the target collapsible area. | -`toggle` | boolean | `true` | Toggles the collapsible element on invocation | +`parent` | selector, DOM element | `null` | If parent is provided, then all collapsible elements under the specified parent will be closed when this collapsible item is shown. (similar to traditional accordion behavior - this is dependent on the `card` class). The attribute has to be set on the target collapsible area. | +`toggle` | boolean | `true` | Toggles the collapsible element on invocation. | {{< /bs-table >}} ### Methods @@ -170,8 +170,8 @@ const bsCollapse = new bootstrap.Collapse('#myCollapse', { | Method | Description | | --- | --- | | `dispose` | Destroys an element's collapse. (Removes stored data on the DOM element) | -| `getInstance` | Static method which allows you to get the collapse instance associated to a DOM element, you can use it like this: `bootstrap.Collapse.getInstance(element)` | -| `getOrCreateInstance` | Static method which returns a collapse instance associated to a DOM element or create a new one in case it wasn't initialized. You can use it like this: `bootstrap.Collapse.getOrCreateInstance(element)` | +| `getInstance` | Static method which allows you to get the collapse instance associated to a DOM element, you can use it like this: `bootstrap.Collapse.getInstance(element)`. | +| `getOrCreateInstance` | Static method which returns a collapse instance associated to a DOM element or create a new one in case it wasn't initialized. You can use it like this: `bootstrap.Collapse.getOrCreateInstance(element)`. | | `hide` | Hides a collapsible element. **Returns to the caller before the collapsible element has actually been hidden** (e.g., before the `hidden.bs.collapse` event occurs). | | `show` | Shows a collapsible element. **Returns to the caller before the collapsible element has actually been shown** (e.g., before the `shown.bs.collapse` event occurs). | | `toggle` | Toggles a collapsible element to shown or hidden. **Returns to the caller before the collapsible element has actually been shown or hidden** (i.e. before the `shown.bs.collapse` or `hidden.bs.collapse` event occurs). | diff --git a/vendor/twbs/bootstrap/site/content/docs/5.2/components/dropdowns.md b/vendor/twbs/bootstrap/site/content/docs/5.2/components/dropdowns.md index ec7e584b5..b58922775 100644 --- a/vendor/twbs/bootstrap/site/content/docs/5.2/components/dropdowns.md +++ b/vendor/twbs/bootstrap/site/content/docs/5.2/components/dropdowns.md @@ -1069,12 +1069,12 @@ Regardless of whether you call your dropdown via JavaScript or instead use the d {{< bs-table "table" >}} | Name | Type | Default | Description | | --- | --- | --- | --- | -| `autoClose` | boolean, string | `true` | Configure the auto close behavior of the dropdown: Note: the dropdown can always be closed with the ESC key | -| `boundary` | string, element | `'scrollParent'` | Overflow constraint boundary of the dropdown menu (applies only to Popper's preventOverflow modifier). By default it's `clippingParents` and can accept an HTMLElement reference (via JavaScript only). For more information refer to Popper's [detectOverflow docs](https://popper.js.org/docs/v2/utils/detect-overflow/#boundary). | +| `autoClose` | boolean, string | `true` | Configure the auto close behavior of the dropdown: Note: the dropdown can always be closed with the ESC key. | +| `boundary` | string, element | `'clippingParents'` | Overflow constraint boundary of the dropdown menu (applies only to Popper's preventOverflow modifier). By default it's `clippingParents` and can accept an HTMLElement reference (via JavaScript only). For more information refer to Popper's [detectOverflow docs](https://popper.js.org/docs/v2/utils/detect-overflow/#boundary). | | `display` | string | `'dynamic'` | By default, we use Popper for dynamic positioning. Disable this with `static`. | -| `offset` | number, string, function | `[0, 2]` | Offset of the dropdown relative to its target. You can pass a string in data attributes with comma separated values like: `data-bs-offset="10,20"`. When a function is used to determine the offset, it is called with an object containing the popper placement, the reference, and popper rects as its first argument. The triggering element DOM node is passed as the second argument. The function must return an array with two numbers: [skidding](https://popper.js.org/docs/v2/modifiers/offset/#skidding-1), [distance](https://popper.js.org/docs/v2/modifiers/offset/#distance-1). For more information refer to Popper's [offset docs](https://popper.js.org/docs/v2/modifiers/offset/#options). | +| `offset` | array, string, function | `[0, 2]` | Offset of the dropdown relative to its target. You can pass a string in data attributes with comma separated values like: `data-bs-offset="10,20"`. When a function is used to determine the offset, it is called with an object containing the popper placement, the reference, and popper rects as its first argument. The triggering element DOM node is passed as the second argument. The function must return an array with two numbers: [skidding](https://popper.js.org/docs/v2/modifiers/offset/#skidding-1), [distance](https://popper.js.org/docs/v2/modifiers/offset/#distance-1). For more information refer to Popper's [offset docs](https://popper.js.org/docs/v2/modifiers/offset/#options). | | `popperConfig` | null, object, function | `null` | To change Bootstrap's default Popper config, see [Popper's configuration](https://popper.js.org/docs/v2/constructors/#options). When a function is used to create the Popper configuration, it's called with an object that contains the Bootstrap's default Popper configuration. It helps you use and merge the default with your own configuration. The function must return a configuration object for Popper. | -| `reference` | string, element | `'toggle'` | Reference element of the dropdown menu. Accepts the values of `'toggle'`, `'parent'`, an HTMLElement reference or an object providing `getBoundingClientRect`. For more information refer to Popper's [constructor docs](https://popper.js.org/docs/v2/constructors/#createpopper) and [virtual element docs](https://popper.js.org/docs/v2/virtual-elements/). | +| `reference` | string, element, object | `'toggle'` | Reference element of the dropdown menu. Accepts the values of `'toggle'`, `'parent'`, an HTMLElement reference or an object providing `getBoundingClientRect`. For more information refer to Popper's [constructor docs](https://popper.js.org/docs/v2/constructors/#createpopper) and [virtual element docs](https://popper.js.org/docs/v2/virtual-elements/). | {{< /bs-table >}} #### Using function with `popperConfig` @@ -1095,7 +1095,7 @@ const dropdown = new bootstrap.Dropdown(element, { | Method | Description | | --- | --- | | `dispose` | Destroys an element's dropdown. (Removes stored data on the DOM element) | -| `getInstance` | Static method which allows you to get the dropdown instance associated to a DOM element, you can use it like this: `bootstrap.Dropdown.getInstance(element)` | +| `getInstance` | Static method which allows you to get the dropdown instance associated to a DOM element, you can use it like this: `bootstrap.Dropdown.getInstance(element)`. | | `getOrCreateInstance` | Static method which returns a dropdown instance associated to a DOM element or create a new one in case it wasn't initialized. You can use it like this: `bootstrap.Dropdown.getOrCreateInstance(element)`. | | `hide` | Hides the dropdown menu of a given navbar or tabbed navigation. | | `show` | Shows the dropdown menu of a given navbar or tabbed navigation. | diff --git a/vendor/twbs/bootstrap/site/content/docs/5.2/components/list-group.md b/vendor/twbs/bootstrap/site/content/docs/5.2/components/list-group.md index 563d5b527..7804c7406 100644 --- a/vendor/twbs/bootstrap/site/content/docs/5.2/components/list-group.md +++ b/vendor/twbs/bootstrap/site/content/docs/5.2/components/list-group.md @@ -442,62 +442,26 @@ To make tabs panel fade in, add `.fade` to each `.tab-pane`. The first tab pane ### Methods -#### constructor - -Activates a list item element and content container. Tab should have either a `data-bs-target` or an `href` targeting a container node in the DOM. - -```html -
- Home - Profile - Messages - Settings -
- -
-
...
-
...
-
...
-
...
-
- - -``` - -#### show - -Selects the given list item and shows its associated pane. Any other list item that was previously selected becomes unselected and its associated pane is hidden. **Returns to the caller before the tab pane has actually been shown** (for example, before the `shown.bs.tab` event occurs). - -```js -const tab = new bootstrap.Tab('#someListItem') - -tab.show() -``` - -#### dispose - -Destroys an element's tab. +{{< callout danger >}} +{{< partial "callout-danger-async-methods.md" >}} +{{< /callout >}} -#### getInstance +Activates your content as a tab element. -*Static* method which allows you to get the tab instance associated with a DOM element +You can create a tab instance with the constructor, for example: ```js -const tab = bootstrap.Tab.getInstance('#trigger') // Returns a Bootstrap tab instance +const bsTab = new bootstrap.Tab('#myTab') ``` -#### getOrCreateInstance - -*Static* method which allows you to get the tab instance associated with a DOM element, or create a new one in case it wasn't initialized - -```js -const tab = bootstrap.Tab.getOrCreateInstance('#trigger') // Returns a Bootstrap tab instance -``` +{{< bs-table >}} +| Method | Description | +| --- | --- | +| `dispose` | Destroys an element's tab. | +| `getInstance` | Static method which allows you to get the tab instance associated with a DOM element, you can use it like this: `bootstrap.Tab.getInstance(element)`. | +| `getOrCreateInstance` | Static method which returns a tab instance associated to a DOM element or create a new one in case it wasn't initialized. You can use it like this: `bootstrap.Tab.getOrCreateInstance(element)`. | +| `show` | Selects the given tab and shows its associated pane. Any other tab that was previously selected becomes unselected and its associated pane is hidden. **Returns to the caller before the tab pane has actually been shown** (i.e. before the `shown.bs.tab` event occurs). | +{{< /bs-table >}} ### Events @@ -508,7 +472,7 @@ When showing a new tab, the events fire in the following order: 3. `hidden.bs.tab` (on the previous active tab, the same one as for the `hide.bs.tab` event) 4. `shown.bs.tab` (on the newly-active just-shown tab, the same one as for the `show.bs.tab` event) -If no tab was already active, the `hide.bs.tab` and `hidden.bs.tab` events will not be fired. +If no tab was already active, then the `hide.bs.tab` and `hidden.bs.tab` events will not be fired. {{< bs-table >}} | Event type | Description | diff --git a/vendor/twbs/bootstrap/site/content/docs/5.2/components/modal.md b/vendor/twbs/bootstrap/site/content/docs/5.2/components/modal.md index aa6012cb0..ed31b7374 100644 --- a/vendor/twbs/bootstrap/site/content/docs/5.2/components/modal.md +++ b/vendor/twbs/bootstrap/site/content/docs/5.2/components/modal.md @@ -78,6 +78,10 @@ Below is a _static_ modal example (meaning its `position` and `display` have bee ``` +{{< callout info >}} +In the above static example, we use `
`, to avoid issues with the heading hierarchy in the documentation page. Structurally, however, a modal dialog represents its own separate document/context, so the `.modal-title` should ideally be an `

`. If necessary, you can use the [font size utilities]({{< docsref "/utilities/text#font-size" >}}) to control the heading's appearance. All the following live examples use this approach. +{{< /callout >}} + ### Live demo Toggle a working modal demo by clicking the button below. It will slide down and fade in from the top of the page. @@ -86,7 +90,7 @@ Toggle a working modal demo by clicking the button below. It will slide down and