diff --git a/site/src/assets/stackblitz.js b/site/src/assets/stackblitz.js index ddb3d32cb8..ffc8abcc61 100644 --- a/site/src/assets/stackblitz.js +++ b/site/src/assets/stackblitz.js @@ -23,12 +23,14 @@ export default () => { document.querySelectorAll('.btn-edit').forEach(btn => { btn.addEventListener('click', event => { const codeSnippet = event.target.closest('.bd-code-snippet') - const exampleEl = codeSnippet.querySelector('.bd-example') + // The preview markup and any author-supplied classes live on the inner + // content wrapper. Fall back to `.bd-example` for older markup. + const exampleEl = codeSnippet.querySelector('.bd-example-content') || codeSnippet.querySelector('.bd-example') const htmlSnippet = exampleEl.innerHTML const jsSnippet = codeSnippet.querySelector('.btn-edit').getAttribute('data-sb-js-snippet') - // Get extra classes for this example - const classes = [...exampleEl.classList].join(' ') + // Get extra classes for this example, minus the docs-only wrapper class + const classes = [...exampleEl.classList].filter(cls => cls !== 'bd-example-content').join(' ') openBootstrapSnippet(htmlSnippet, jsSnippet, classes) }) diff --git a/site/src/components/shortcodes/Example.astro b/site/src/components/shortcodes/Example.astro index f74dfe22d9..276c7ec2a7 100644 --- a/site/src/components/shortcodes/Example.astro +++ b/site/src/components/shortcodes/Example.astro @@ -86,8 +86,10 @@ const simplifiedMarkup = sourceMarkup
{ showPreview && ( -
- +
+
+ +
) } diff --git a/site/src/scss/_component-examples.scss b/site/src/scss/_component-examples.scss index d2d1143024..baf44f88c0 100644 --- a/site/src/scss/_component-examples.scss +++ b/site/src/scss/_component-examples.scss @@ -51,8 +51,13 @@ } .bd-example { + --bd-example-min-height: 12rem; + position: relative; - display: flow-root; + display: flex; + flex-direction: column; + justify-content: center; // vertically center the content wrapper + min-height: var(--bd-example-min-height); padding: var(--bd-example-padding); font-size: var(--body-font-size); line-height: var(--body-line-height); @@ -66,41 +71,6 @@ margin-top: 2rem; } - > .tab-content { - min-height: 120px; - padding: var(--bs-spacer); - background-color: var(--bs-bg-1); - @include border-radius(var(--bd-example-radius)); - } - - > .menu.position-static { - max-width: fit-content; - } - - // > :last-child, - > nav:last-child .breadcrumb { - margin-bottom: 0; - } - - > hr:last-child { - margin-bottom: var(--spacer); - } - - // Images - > svg + svg, - > img + img { - margin-inline-start: .5rem; - } - - // List groups - > .list-group { - max-width: 400px; - } - - > [class*="list-group-horizontal"] { - max-width: 100%; - } - // Navbars .fixed-top, .sticky-top { @@ -121,6 +91,76 @@ } } + // Preview content wrapper. It keeps normal flow so loose inline items (buttons, + // badges, links) stay on one centered line, while block components keep full + // width. The frame centers this wrapper vertically. + .bd-example-content { + display: flow-root; + // Inert in normal flow. When an example sets `d-flex`/`d-grid`/`vstack` on + // the wrapper, this centers the row on the main axis. Utilities still win. + justify-content: center; + width: 100%; + text-align: center; + + // When an example turns the wrapper into a flexbox (`d-flex`, `vstack`, + // `hstack`), center its items on the cross axis too, so column layouts do + // not sit left in the tall min-height frame. Grid wrappers are excluded so + // grid items keep stretching to equal heights. + &:not([class*="grid"]) { + align-items: center; + } + + // Keep block-level components left-aligned inside. Only loose inline items + // (buttons, badges, links, icons) pick up the centered text-align above. + // Utilities still win via layer order, so `.text-center` etc. is unaffected. + > * { + text-align: start; + } + + // Center width-constrained block components (cards, wrappers). Full-width + // blocks (alerts, forms) are unaffected. Grid rows keep their negative + // gutters, so exclude `.row` and grid containers. + > *:not(.row, [class*="grid"]) { + margin-inline: auto; + } + + > .tab-content { + min-height: 120px; + padding: var(--bs-spacer); + background-color: var(--bs-bg-1); + @include border-radius(var(--bd-example-radius)); + } + + > .menu.position-static { + max-width: fit-content; + margin-inline: auto; + } + + > nav:last-child .breadcrumb { + margin-bottom: 0; + } + + > hr:last-child { + margin-bottom: var(--spacer); + } + + // Images + > svg + svg, + > img + img { + margin-inline-start: .5rem; + } + + // List groups + > .list-group { + max-width: 400px; + margin-inline: auto; + } + + > [class*="list-group-horizontal"] { + max-width: 100%; + } + } + // // Grid examples //