0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-12 00:08:59 +01:00
Commit Graph

47 Commits

Author SHA1 Message Date
Hannah Issermann
06f7c3b6c7
Add js-docs shortcode to ensure consistency between doc and js code (#38316)
Co-authored-by: XhmikosR <xhmikosr@gmail.com>
2023-03-27 12:10:25 +03:00
Louis-Maxime Piton
f8a56da8b0
Docs: scss-docs unindent automatically the code inside shortcode 2023-03-24 16:11:22 +02:00
Julien Déramond
f52d4a35b3
Fix placeholder shortcode color and background params when 'img' markup (#38263) 2023-03-19 17:42:30 -07:00
Hannah Issermann
fd7cfac4cb
Improve docs on Modals, Alerts, Offcanvas and Toasts close triggers examples (#38182)
* Improve docs on Modals, Alerts, Offcanvas and Toasts close triggers examples

* Update site/layouts/shortcodes/js-dismiss.html

Co-authored-by: Julien Déramond <juderamond@gmail.com>

---------

Co-authored-by: Mark Otto <markdotto@gmail.com>
Co-authored-by: Julien Déramond <juderamond@gmail.com>
2023-03-10 11:23:59 -06:00
louismaxime.piton
8e27427fd9 Improve scss-docs link 2023-03-10 11:16:59 -06:00
Mark Otto
20ab8219a0
Sass docs updates (#37897)
* Add maps

* Redesign scss-docs rendering

* Update other CSS sections

* Fix linter
2023-01-16 18:57:24 -08:00
Louis-Maxime Piton
9042efd0f8
Deprecate the Sass var and remove any occurence of the .text-muted (#37890) 2023-01-16 15:55:28 -08:00
Julien Déramond
1b83ab24fc Docs: remove some CSS from .highlight-toolbar def 2023-01-05 19:29:17 -08:00
Mark Otto
fc3f4b67d6
Add dark mode support (#35857)
* Add dark mode to docs

* Minor fix: missing space indentation

* Minor fix: revert utilities/z-index added-in modification

* Remove prev: and next: from doc because extracted to another PR

* Use .bg-body-tertiary in all Utilities > Overflow examples

* fix example

* Fix up spacing examples

* Update box-shadow Sass variables and utilities to auto-adjust to color modes

* Remove unused docs class

* Refactor form styles to use CSS variable for background images on .form-check and .form-switch

* Fix docs selector

* Rename shortcut for clarity

* Heading consistency

* Reintroduce missing 4th grid item in Utilities > Spacing example

* Fix bundlewatch

* .bd-callout* rendering is OK so removing comments in the code

* Update scss/_utilities.scss

Co-authored-by: Julien Déramond <julien.deramond@orange.com>

* Fix gutters example styling

* Fix text colors on background utils docs

* redesign and fix up position marker example, which doesn't show nicely in darkmode but at least isn't broken

* fix some color utils examples

* Deprecate mixin notice

* Deprecate notice for list-group-item-variant() mixin

* Revamp new link CSS vars

* Use map-keys in some each Sass files

* Remove list-group-item-variant mixin ref in sass loop desc

* Display CSS vars scoped to our built-in dark mode

* Revert previous commit

* Fix list group variant link

* Fix typo

* Remove imports of alert/list-group mixins in scss/_mixins.scss

* Small formatting + comments removal in scss/_content.scss

* Fix alert links colors

* fix dropdown border-radius mixin

* fix link color and underline again, this time using CSS var override for color var and fallback value for the underline

* fix colors on docs navbar for dark mode

* remove two changes

* missing ref

* another link underline fix, just use sass vars for link decoration for now

* missing color bg docs, plus move dropdown override to scss

* more changes from review

* fix some examples, drop unused docs navbar styles, update docs navbar color mode to use mixin

* Few fixes around type

- Restored CSS variable for color on headings, this time with a fallback value
- In conjunction, restored and wrapped the default CSS var with a null value check
- Split headings and paragraphs docs in Reboot, elaborated on them

* Restyle custom details > summary element in docs

* Rewrite some migration docs

* fix form checks

* Fix up some navbar styling, tweak docs callout

* Fix select images, mostly for validation styling

* Clean up some migration notes, document some new form control CSS vars, mention new variables-dark in sass docs

* Update site/content/docs/5.2/components/scrollspy.md

Co-authored-by: Julien Déramond <julien.deramond@orange.com>

* Apply suggestions from code review

Co-authored-by: Julien Déramond <julien.deramond@orange.com>

* mention form control css vars in migration guide

* Tweak grid and flex docs background examples

* clarify some docs

* fix some more things

Co-authored-by: Julien Déramond <juderamond@gmail.com>
Co-authored-by: Julien Déramond <julien.deramond@orange.com>
2022-11-28 22:30:26 -08:00
Mewen Le Hô
cc25d6f10c
Fix accessibility of examples buttons (#37498)
Co-authored-by: Patrick H. Lauke <redux@splintered.co.uk>
2022-11-16 19:12:28 -08:00
XhmikosR
a7a2253507
docs: remove moot newlines (#37379) 2022-10-26 08:37:04 +03:00
Daniel Raymond
708a3a0e39
Utilities for overflow and object fit (#36848)
* Added "overflow-x" and "overflow-y"

- Having the same properties as overflow but for just the x and y axises
- Usecase being I want my y axis to be scrollable but not my x axis
- E.g a card with a vertical list of items.

* Added "object-fit" utilities

- The CSS object-fit property is used to specify how an <img> or <video> should be resized to fit its container.
- A responsive alternative to using background-img for a resizable fill/fit image.

* Updated documantation for the overflow utilities

- Now includes docs for `overflow-x` and `overflow-y` utilities

* Placeholder shortcode updated

- Can now choose to render an img tag or svg
- The image contains a base64 svg generated within the template
- example shortcode updated to detect, replace and render preview of 'img' tags as well

* New documentaion for Object Fit added

- Documentation added for the 'object-fit' util

* Updated spell checks issues

* Update object-fit.md

* Update overflow.md

* Update object-fit.md

* Updated markup to address HTML Validation Errors

- error: Bad value  for attribute "src" on element "img": Illegal character in scheme data: space is not allowed.
- info warning: Self-closing tag syntax in text/html documents is widely discouraged; it's unnecessary and interacts badly with other HTML features (e.g., unquoted attribute values). If you're using a tool that injects self-closing tag syntax into all void elements, without any option to prevent it from doing so, then consider switching to a different tool.

* Updated Fix

- Added Legibility to the img markup (example.html)
- Fixed issue with example not working properly (because image closing tag no longer has "/>" )

* update values by step of 0.25 in bundlewatch.config

The following values in .bundlewatch.config.json have been updated:
- ./dist/css/bootstrap-utilities.css
- ./dist/css/bootstrap-utilities.min.css
- ./dist/css/bootstrap.css
- ./dist/css/bootstrap.min.css

Co-authored-by: Daniel O <dobiekwe@byteworks.com.ng>
Co-authored-by: Mark Otto <otto@github.com>
2022-10-06 13:14:11 -07:00
Marc Wrobel
eae51cdf32 Fix various small typos in documentation (#36762) 2022-07-18 13:30:41 -07:00
Julien Déramond
cfabeb71fa
Fix StackBlitz Popovers and Tooltips examples (#36449)
* Fix StackBlitz Popovers and Tooltips examples

* Rename shortcode example parameters

* Reorder example shortcode doc params + fix Cspell

* Remove 'stackblitz' param + use data-bs-title instead of title

* Update site/layouts/partials/callout-warning-data-bs-title-vs-title.md

Co-authored-by: Mark Otto <markd.otto@gmail.com>

Co-authored-by: Mark Otto <markd.otto@gmail.com>
2022-06-20 07:19:47 -07:00
Julien Déramond
8b85267739
Fix StackBlitz examples by embedding snippets.js when needed (#36352)
* Fix StackBlitz examples by embedding snippets.js when needed

* Fix Popovers

* Fix tooltips

* Fix Toasts

* Add comment sections

* Fix Alerts

* Indeterminate heckboxes + classes handling

* Nothing to do for links

* Fix modals

* Nothing to do for Offcanvas

* Remove correctly .bd-example

* Add body .p-3 for all StackBlitz examples
2022-05-26 14:29:08 -07:00
Louis-Maxime Piton
dea14df8ca
CSS: doc fixes (#36425)
* Remove unused attributes

* Use utilities rather than using new CSS

* Removed unused class

* Change StackBlitz icon `aria-label` + small inconsistency
2022-05-24 10:39:57 -07:00
Mark Otto
195440f2fb
v5.2.0 design refresh, plus responsive offcanvas classes (#35736)
* Add responsive offcanvas classes

- Updates navbar-expand classes to de-dupe some styles—these shouldn't interfere now.
- Adds some JS to the offcanvas component to help with responsiveness

Co-Authored-By: GeoSot <geo.sotis@gmail.com>

* Redesign homepage, docs, and examples

Homepage:

- New Bootstrap purple navbar
- Redesigned masthead
- Rewrote and redesigned homepage content
- Replace Copy text with icons like Bootstrap Icons site across all ClipboardJS instances
- Fixed padding issues in site footer
- Match homepage button styles to examples page, use gap instead of tons of responsive margin utils

Docs:

- New navbar, no more subnav. Migrated search and version picker into the main navbar and refreshed the design of it all, including the responsive toggles.
- New sidebar navigation is always expanded, and now features Bootstrap Icons alongside section headings
- Sidebar navigation autoscrolls to active link for better usability
- Subnav and navbar padding issues ironed out
- Enhanced the version picker in anticipation of v5.2: we can now link right to the same page in the previous version.
- Redesign callouts to add more color to our pages
- Collapse table of contents on mobile
- Cleanup and redesign button styles with CSS variables
- Update design for subnav version dropdown
- Update highlight and example to be full-width until md
- Improve the Added In badges
- Turn the ToC into a well on mobile
- Redesign code snippets to better house two action buttons

Examples:

- Redesign Examples page layout
- Add new example for responsive offcanvases in navbars

* Convert offcanvas to CSS vars

* Feat: add resize handler to Offcanvas.js.

If we could use as default the `.offcanvas` class without modifiers, we then, could add a simplified selector
The selector itself, ignores the .offcanvas class as it doesn't have any responsive behavior
The `aria-modal` addon is to protect us, selection backdrop elements

* Separate examples code, Add some selectors, fix stackblitz btn

Co-authored-by: GeoSot <geo.sotis@gmail.com>
2022-04-17 22:17:50 -07:00
Mark Otto
a9a89debc7
Rewrite docs tables in Markdown with table shortcode (#31337)
Co-authored-by: XhmikosR <xhmikosr@gmail.com>
Co-authored-by: GeoSot <geo.sotis@gmail.com>
2022-03-14 09:38:04 +02:00
Mark Otto
7c966f5848
Convert added in badges to shortcode (#36007) 2022-03-12 07:27:58 +02:00
Puru Vijay
645f955845
docs: add a StackBlitz "Try It" button in code examples (#35644)
Co-authored-by: GeoSot <geo.sotis@gmail.com>
Co-authored-by: XhmikosR <xhmikosr@gmail.com>
2022-03-09 17:32:58 +02:00
XhmikosR
283cbd9026 Use path.Join when joining paths 2021-08-31 17:24:38 +03:00
XhmikosR
f22966c920 example: remove unneeded escape characters 2021-08-31 17:24:38 +03:00
XhmikosR
5cc633dfab Minor shortcode tweaks and consistency changes 2021-08-31 17:24:38 +03:00
XhmikosR
365d6d9fb1 Tweak scss-docs shortcode 2021-08-31 17:24:38 +03:00
GeoSot
4bfd8a2cbc
Use a streamlined way to trigger component dismiss (#34170)
* use a streamlined way to trigger component dismiss

* add documentation

Co-authored-by: XhmikosR <xhmikosr@gmail.com>
2021-07-28 17:39:32 +03:00
XhmikosR
a1bb65ef49 Tweak scss-docs shortcode
Should work now with indented start/end capture statements
2021-02-03 07:15:49 +02:00
XhmikosR
d5b405ea9a
example.html: remove extra whitespace (#32143)
If we don't pass `class` to the `placeholder` shortcode, this resulted in two spaces before the `alt` attribute:

```html
{{< example >}}
{{< placeholder width="64" height="64" >}}
{{< /example >}}
```

```html
<img src="..."  alt="...">
```
2020-11-13 12:45:11 +02:00
XhmikosR
afc0e83ecc
Update bs-table shortcode (#31803) 2020-10-22 09:32:46 +03:00
XhmikosR
f3cfc8e7ec
Revert "Improve callout shortcode. (#31802)" (#31871)
This reverts commit 5c6925385e.
2020-10-13 16:37:21 +03:00
XhmikosR
5c6925385e
Improve callout shortcode. (#31802)
Remove the `markdownify` call, and instead rely on Hugo's proper syntax; `{{% callout %}}` when we want to the content to be processed as Markdown.

This allows for stuff like:

{{% callout info %}}
##### I'm an info callout!

```css
.foo {
  color: #fff;
}
```

{{< example >}}
<div class="alert alert-warning alert-dismissible fade show" role="alert">
  <strong>Holy guacamole!</strong> You should check in on some of those fields below.
  <button type="button" class="btn-close" data-dismiss="alert" aria-label="Close"></button>
</div>
{{< /example >}}
{{% /callout %}}
2020-10-12 09:06:06 +03:00
Gaël Poupard
5b37d03ff9
docs(placeholder): drop role=img and use aria-hidden for decorative SVG placeholders (#31575)
Co-authored-by: XhmikosR <xhmikosr@gmail.com>
2020-09-04 20:21:54 +03:00
XhmikosR
08742abda3 shortcodes/example.html: allow specifying the highlighting language 2020-06-03 15:57:20 +03:00
Regis Philibert
f979307833 Add a param shortcode to work around the escaped characters in hashes 2020-05-07 20:53:21 +03:00
Mark Otto
85ac2fc35e Create a new table shortcode so we can easily add Bootstrap table classes to Markdown tables 2020-04-26 17:26:04 -07:00
Martijn Cuppens
d089a683c8 Prevent nested tables style leaks 2020-04-24 10:05:10 +02:00
Martijn Cuppens
83b49aa688
Create scss-docs shortcode to get some snippets from the Scs… (#30502)
Co-authored-by: XhmikosR <xhmikosr@gmail.com>
2020-04-06 20:13:35 +02:00
Gaël Poupard
8f94ed8e30
docs(SVG placeholder): add focusable=false to placeholder SVGs (#30075)
Co-authored-by: XhmikosR <xhmikosr@gmail.com>
2020-02-06 09:01:02 +02:00
XhmikosR
972369c997 Tighten regex a bit.
If we need to make this more robust in the future, we can revert this as needed.
2019-11-04 15:32:29 +02:00
XhmikosR
e40b3355f0 example.html: use double quotes 2019-11-04 15:32:29 +02:00
Christopher Morrissey
04acb679ab Example shortcode: use a regex and simplify logic. 2019-11-04 15:32:29 +02:00
XhmikosR
d6945d5e8f Move shortcodes used only once where they are needed. 2019-09-06 11:57:50 +03:00
XhmikosR
6f1eb110e7
Docs: simplify a few Hugo ranges. (#29333) 2019-09-02 12:31:02 +03:00
XhmikosR
919b526f17
Fix shortcodes/example.html class bug. (#29344)
It always used the first placeholder's class before.
2019-08-31 08:11:16 +03:00
XhmikosR
b316235e63
docs: Fix badges after #28458. (#29199) 2019-08-04 08:23:25 +03:00
Bjørn Erik Pedersen
69e18b9634 Fix bugify. 2019-03-13 19:22:59 +02:00
XhmikosR
5d6e896ebb Add a docsref shortcode.
This allows for the build to fail if a reference isn't found.
2019-03-13 19:22:59 +02:00
XhmikosR
d95d30029f Switch to Hugo.
No more Ruby dependency and most important more than 10 times less build time (at least on Windows)!
2019-03-13 19:22:59 +02:00