Commit Graph

218 Commits

Author SHA1 Message Date
Mark Otto
9dd42e1a07
Attempt to fix focus ring being cut off in table of contents (#37965)
* Attempt to fix focus ring being cut off in table of contents

* Update _toc.scss

---------

Co-authored-by: Patrick H. Lauke <redux@splintered.co.uk>
2023-02-14 08:58:08 -08:00
Patrick H. Lauke
d0fece9320 Docs: add scroll-margin-top for keyboard navigation 2023-02-14 08:53:25 -08:00
Julien Déramond
9f5dca0777
Remove debug references from DocSearch v2 (#38032) 2023-02-11 08:04:09 +01:00
Mark Otto
82391bc7b7
Theme color improvements (#37953)
* Use tint-color() and shade-color() functions to generate new color mode adaptive theme values

* More consistent shading

* Fix callouts use of emphasis variables

* Use tint and shade functions on link and code colors for dark mode
2023-01-25 18:11:22 -08:00
louismaximepiton
16aff741ec Proposal 2023-01-17 10:39:49 -08: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
Mark Otto
779baab369
Small color mode docs CSS fixes (#37896)
* SImplify background gradient syntax

* Move inline style to CSS file
2023-01-16 16:56:50 -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
7399b13052 Docs: fix .btn-clipboard and .btn-edit link hover color 2023-01-06 11:42:32 -08:00
Louis-Maxime Piton
fd1ec97bd3
Docs: Small enhancements (#37803)
* Consistency with the doc

* Bring a class to avoid weird behavior

* Consistency + Add some explaining text

* fix(color)
2023-01-05 19:59:59 -08:00
Julien Déramond
1b83ab24fc Docs: remove some CSS from .highlight-toolbar def 2023-01-05 19:29:17 -08:00
Julien Déramond
803d9d405c
Docs: fix headings color in light/dark mode (#37802) 2023-01-04 08:47:31 -08:00
Mark Otto
d70b5db2e0
Add new link utilities, icon link helper, and update colored link helpers (#37762)
* Add new link utilities, update colored link helpers

* Remove commented out code

* Fixes

* Remove examples changes

* Fixes and copy

* Fix icon-link instances on homepage

* Bump bundlewatch

* Fix node-sass issue for rgba() function bug

* More bundlewatch

* One more time after merge

* Add callout for a11y

* Hover and focus-visible

* Add a11y callouts

* Remove duplicate for now

* More code review feedback
2023-01-03 22:23:46 -08:00
Mark Otto
da1c968965 Remove dark mode --bs-heading-color value, set to null, and add custom styles for the docs dark mode headings 2023-01-03 19:36:20 -08:00
Mark Otto
3ee2a75495 Use Bootstrap colors in syntax highlighting 2023-01-02 22:06:59 -08:00
AucT
19d547be3d
fix live toast demo (#37590)
* fix live toast demo

* Fix live toast demo

* Update snippets.js

* Update toasts.md

* Update snippets.js

* Code review comments addressed

Co-authored-by: XhmikosR <xhmikosr@gmail.com>
Co-authored-by: Mark Otto <markdotto@gmail.com>
2023-01-02 22:06:09 -08:00
Mark Otto
d0b0fec409 Fix code color in callouts 2023-01-01 22:33:54 -08:00
Patrick H. Lauke
2cc580e2d1
Docs: remove remnants of Twitter / bump dates (#37779) 2023-01-01 16:30:53 -08:00
Mark Otto
9e17b2b34c
Focus ring helper and utilities (#33125)
* Add global variables for box-shadow focus rings

* Update instances of -btn-focus-box-shadow to use -ring-box-shadow, unless it's for buttons or inputs

* fix variable name

* Add CSS variables for global focus styling, document it

* Move to CSS vars section

* Update scss/_nav.scss

Co-authored-by: Gaël Poupard <ffoodd@users.noreply.github.com>

* Helper and utils

* Fix bundlewatch

* Change 'Focus ring' in sidebar so that the page can be visible

* Minor typo fix

* fix merge

* Revamp some more, improve docs

Co-authored-by: Gaël Poupard <ffoodd@users.noreply.github.com>
Co-authored-by: Julien Déramond <juderamond@gmail.com>
Co-authored-by: Patrick H. Lauke <redux@splintered.co.uk>
2022-12-29 14:19:22 -08:00
Julien Déramond
1a043b55bc Docs: enhance callouts links on dark mode 2022-12-29 13:32:09 -08:00
Mark Otto
fabe074199 Darken some text emphasis and syntax colors 2022-12-29 12:28:02 -08:00
GeoSot
a9810ece61
Use scrollspy on docs pages (#33428)
* use scrollspy on docs pages

* Update colors by taking into account new dark mode

* Restyle it

* Update colors once more

* Fix some color contrast issues

Co-authored-by: Julien Déramond <juderamond@gmail.com>
Co-authored-by: Mark Otto <markdotto@gmail.com>
2022-12-29 12:11:01 -08:00
Julien Déramond
993ad97fdc
Docs: handle light/dark mode in Algolia search modal (#37738)
* Docs: handle light/dark mode in Algolia search modal

* Improve scopes
2022-12-27 16:43:42 -08:00
Mark Otto
6295d3ba36
Few miscellaneous docs fixes (#37625)
* Update hero button color

* Fix link color on examples index

* Move .bd-btn-lg to docs buttons partial, move larger border-radius to that class so medium buttons don't look odd

* Undo the markup split

* Round padding up to whole number
2022-12-26 11:32:43 -08:00
Julien Déramond
41f62c5a11
Fix Sass compilation when $color-mode-type is set to media-query (#37687)
* Fix Sass compilation when `$color-mode-type` is set to `media-query`

* Update mixin names, fix docs color modes for using media queries by using mixin

Co-authored-by: Mark Otto <markdotto@gmail.com>
2022-12-21 08:52:07 +02:00
Mark Otto
f6687e99b5 Follow up 2022-12-20 14:25:36 -08:00
XhmikosR
e1315d11f2
docs: move color-mode script (#37658)
* docs: move color-mode script

* Move color-modes.js in static folder

* Async load color-modes.js

* Switch to DOMContentLoaded

* Revert async loading
2022-12-18 14:32:17 -07:00
Louis-Maxime Piton
6807008159
Docs: replace some --#{$prefix} by --bs in Sass files (#37617)
Co-authored-by: Julien Déramond <juderamond@gmail.com>
2022-12-18 08:19:33 +01:00
XhmikosR
18fec8bf36
code-examples.js: switch to firstElementChild (#37570)
This ensures that we will get the first element child and not text
2022-12-01 20:14:33 +02:00
Patrick H. Lauke
0444d2cfe5
Docs: rewrite/reorganise carousel docs page (#37354)
* Instantiate/initialize all non-autoplaying carousels in docs pages

* Rewrite/reorganise carousel docs page

* start with static/non-autoplaying examples
* explicitly mention that carousels currently need to be manually initialized
* split out and explain autoplaying and the weird "autoplay after first interaction" behaviour, as well as the pause on hover/focus

* Add callout about autoplaying and accessibility

* Don't have the dark variant example autoplay

* Add "autoplaying" to cspell custom dictionary

* Tweal wording, move Page Visibility API to autoplay section

* Tweak explanation for methods, add line break in js code for consistency with last code block on the page

* Tweak method descriptions

* Tweak headings (plural "carousels")

* Move some paragraphs out of intro and into basic example, reword the nested and accessibility paragraph

* Tweak warning about `.active` slide

* Tweak callout wording

* Further prose tweaks

move the sentence about not double-initialising autoplaying carousels to the callout right at the top
instead of talking about `data-bs...` attributes, talk about the "option" instead, as authors may be setting these not via data attributes, but at instatiation time with options in the constructor
remove the incorrect statement about pausing when keyboard focus is in the carousel

* Instantiate/initialize all non-autoplaying carousels in docs pages

* Rewrite/reorganise carousel docs page

* start with static/non-autoplaying examples
* explicitly mention that carousels currently need to be manually initialized
* split out and explain autoplaying and the weird "autoplay after first interaction" behaviour, as well as the pause on hover/focus

* Add callout about autoplaying and accessibility

* Don't have the dark variant example autoplay

* Add "autoplaying" to cspell custom dictionary

* Tweal wording, move Page Visibility API to autoplay section

* Tweak explanation for methods, add line break in js code for consistency with last code block on the page

* Tweak method descriptions

* Tweak headings (plural "carousels")

* Move some paragraphs out of intro and into basic example, reword the nested and accessibility paragraph

* Tweak warning about `.active` slide

* Tweak callout wording

* Further prose tweaks

move the sentence about not double-initialising autoplaying carousels to the callout right at the top
instead of talking about `data-bs...` attributes, talk about the "option" instead, as authors may be setting these not via data attributes, but at instatiation time with options in the constructor
remove the incorrect statement about pausing when keyboard focus is in the carousel

* Fix relative link

* Update site/assets/js/snippets.js

Co-authored-by: GeoSot <geo.sotis@gmail.com>

* Fix snippet.js

* Tweak content organisation just a bit

Co-authored-by: GeoSot <geo.sotis@gmail.com>
Co-authored-by: Julien Déramond <juderamond@gmail.com>
Co-authored-by: Julien Déramond <julien.deramond@orange.com>
Co-authored-by: Mark Otto <markdotto@gmail.com>
2022-11-28 23:20:35 -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
Julien Déramond
f97149a4af Docs: add margin between buttons in tooltip examples 2022-11-14 09:32:14 -08:00
Mark Otto
0968db8099
Add z-index utilities, .z-* (#37317)
* Add z-index utilities, .z-*

* Fix missing comma in _utilities.scss

* Fix bundlewatch

* Fix lint

* Update site/content/docs/5.2/utilities/z-index.md

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

* custom appearance

* linter

Co-authored-by: Julien Déramond <juderamond@gmail.com>
Co-authored-by: Julien Déramond <julien.deramond@orange.com>
2022-10-22 17:13:39 -04:00
Mark Otto
538f50be5a
Home imports (#37318)
* Update docs homepage to use separate partials for each section

Also modifies the homepage code snippets under getting started to remove the code comments, making copy-pasting easier.

* Update some copy and examples

* newlines

* type button

* more code review, bring back interactive components

* fix hover
2022-10-22 16:51:44 -04:00
Patrick H. Lauke
cda901f244
v5/docs: reintroduce outline for docs code samples, buttons when :not(:focus-visible) (#36507)
* Remove outline suppression for focused `<pre>`

Sighted keyboard users rely on knowing where their focus is. If the `<pre>` receives focus (so that it can be scrolled by keyboard users, for instance) then it's essential that they know this is the case

* Only suppress outline for buttons when `:not(:focus-visible)`

* Add right-hand margin to pre

avoids having the focus outline awkwardly clipped by the copy button
2022-08-31 18:30:23 -07:00
louismaximepiton
4cea8b1786 Add a comment for track the bug. 2022-08-31 18:03:42 -07:00
louismaximepiton
995df354f2 Set cursor to auto instead of pointer on .DocSearch-Container 2022-08-31 18:03:42 -07:00
Mark Otto
3feaf6ca0b
Move DocSearch out of offcanvas to always show it on mobile (#36824) 2022-07-27 13:30:42 -07:00
Marc Wrobel
6d101b15a4
Fix typos in snippets.js (#36758) 2022-07-17 20:54:34 +02:00
Julien Déramond
6cf72530ed
Docs: add indeterminate disabled checkbox example (#36674) 2022-07-06 07:43:38 +02:00
Julien Déramond
828034f26f
Fix search modal z-index to be on top of all docs showcased components (#36627) 2022-06-28 07:41:15 +02:00
Julien Déramond
8de0488330 Docs: update clipboard.js to v2.0.11 2022-06-25 16:06:07 +03:00
Mark Otto
24d79fe74c
Add example of dark navbar and offcanvas to docs (#36510) 2022-06-15 07:41:39 -07:00
Julien Déramond
ac89c3692b Docs: remove unused _algolia.scss 2022-06-01 14:24:08 -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
3a327c9015
Rewrite Webpack guide (#36382)
* Rewrite Webpack guide

Co-Authored-By: GeoSot <geo.sotis@gmail.com>
Co-Authored-By: Julien Déramond <17381666+julien-deramond@users.noreply.github.com>

* rewrite some pieces

* eslint-skip

Co-authored-by: GeoSot <geo.sotis@gmail.com>
Co-authored-by: Julien Déramond <17381666+julien-deramond@users.noreply.github.com>
2022-05-20 13:43:30 -07:00
Louis-Maxime Piton
e2e107fc72
CSS: few proposals (#36406)
* Something to try about `!important` in color-bg helper

* Better understanding border utility `.border-*-0`

* Having rounded numbers of px
2022-05-20 10:28:31 -07:00
Mark Otto
e12e0806fb Update search box styling and position 2022-05-15 14:22:33 -07:00
Mark Otto
46bb9e78d7 Fix homepage npm install snippet 2022-05-13 20:16:05 +03:00