From fc6f0d98e00ff44ba795aae827d671ba4a4ba8c5 Mon Sep 17 00:00:00 2001
From: Charles de Dreuille <charles.dedreuille@gmail.com>
Date: Sun, 26 Apr 2026 15:29:36 +0100
Subject: [PATCH] Remove display contents from sticky Header

Signed-off-by: Charles de Dreuille <charles.dedreuille@gmail.com>
---
 .../src/components/Header/Header.module.css   |  20 +-
 packages/ui/src/components/Header/Header.tsx  | 241 ++++++++++--------
 2 files changed, 137 insertions(+), 124 deletions(-)

diff --git a/packages/ui/src/components/Header/Header.module.css b/packages/ui/src/components/Header/Header.module.css
index 0d6e9f7612..d8d0119771 100644
--- a/packages/ui/src/components/Header/Header.module.css
+++ b/packages/ui/src/components/Header/Header.module.css
@@ -25,20 +25,16 @@
     padding-inline: var(--bui-space-5);
   }
 
-  .bui-Header[data-sticky] {
-    display: contents;
-  }
-
   .bui-HeaderAfterSticky {
     display: flex;
     flex-direction: column;
     gap: var(--bui-space-3);
   }
 
-  .bui-Header[data-sticky] .bui-HeaderBeforeSticky,
-  .bui-Header[data-sticky] .bui-HeaderStickySentinel,
-  .bui-Header[data-sticky] .bui-HeaderContent,
-  .bui-Header[data-sticky] .bui-HeaderAfterSticky {
+  .bui-HeaderBeforeSticky[data-sticky],
+  .bui-HeaderStickySentinel[data-sticky],
+  .bui-HeaderContent[data-sticky],
+  .bui-HeaderAfterSticky[data-sticky] {
     width: 100%;
     padding-inline: var(--bui-space-5);
     box-sizing: border-box;
@@ -48,7 +44,7 @@
     padding-top: var(--bui-space-4);
   }
 
-  .bui-Header[data-sticky] .bui-HeaderBeforeSticky {
+  .bui-HeaderBeforeSticky[data-sticky] {
     padding-top: var(--bui-space-6);
   }
 
@@ -72,15 +68,15 @@
     z-index: 10;
     background-color: var(--bui-bg-app);
 
-    .bui-Header[data-on-bg='neutral-1'] & {
+    &[data-on-bg='neutral-1'] {
       background-color: var(--bui-bg-neutral-1);
     }
 
-    .bui-Header[data-on-bg='neutral-2'] & {
+    &[data-on-bg='neutral-2'] {
       background-color: var(--bui-bg-neutral-2);
     }
 
-    .bui-Header[data-on-bg='neutral-3'] & {
+    &[data-on-bg='neutral-3'] {
       background-color: var(--bui-bg-neutral-3);
     }
   }
diff --git a/packages/ui/src/components/Header/Header.tsx b/packages/ui/src/components/Header/Header.tsx
index 6e36d627f8..ab64dd6e7d 100644
--- a/packages/ui/src/components/Header/Header.tsx
+++ b/packages/ui/src/components/Header/Header.tsx
@@ -79,7 +79,9 @@ function renderInlineMarkdown(text: string): React.ReactNode[] {
  * @public
  */
 export const Header = (props: HeaderProps) => {
-  const { ownProps, dataAttributes } = useDefinition(HeaderDefinition, props);
+  const { ownProps, dataAttributes } = useDefinition(HeaderDefinition, props, {
+    classNameTarget: props.sticky ? 'content' : 'root',
+  });
   const {
     classes,
     title,
@@ -147,63 +149,70 @@ export const Header = (props: HeaderProps) => {
     };
   }, [sticky]);
 
-  return (
-    <header
-      className={classes.root}
-      data-sticky={sticky || undefined}
-      {...dataAttributes}
-    >
-      {tags && tags.length > 0 && (
-        <div className={classes.beforeSticky}>
-          <ul className={classes.tags}>
-            {tags.map((tag, i) => (
-              <li
-                key={`${i}:${tag.label}:${tag.href ?? ''}`}
-                className={classes.tag}
+  const beforeStickyContent = tags && tags.length > 0 && (
+    <div className={classes.beforeSticky} data-sticky={sticky || undefined}>
+      <ul className={classes.tags}>
+        {tags.map((tag, i) => (
+          <li
+            key={`${i}:${tag.label}:${tag.href ?? ''}`}
+            className={classes.tag}
+          >
+            {tag.href ? (
+              <Link
+                href={tag.href}
+                variant="body-medium"
+                color="secondary"
+                standalone
               >
-                {tag.href ? (
-                  <Link
-                    href={tag.href}
-                    variant="body-medium"
-                    color="secondary"
-                    standalone
-                  >
-                    {tag.label}
-                  </Link>
-                ) : (
-                  <Text variant="body-medium" color="secondary">
-                    {tag.label}
-                  </Text>
-                )}
-              </li>
+                {tag.label}
+              </Link>
+            ) : (
+              <Text variant="body-medium" color="secondary">
+                {tag.label}
+              </Text>
+            )}
+          </li>
+        ))}
+      </ul>
+    </div>
+  );
+
+  const titleAndActionsContent = (
+    <>
+      <div className={classes.titleStack}>
+        <div className={classes.breadcrumbs} aria-hidden={isStuck || undefined}>
+          {breadcrumbs &&
+            breadcrumbs.map(breadcrumb => (
+              <Fragment key={breadcrumb.label}>
+                <Link
+                  href={isStuck ? undefined : breadcrumb.href}
+                  color="secondary"
+                  className={classes.breadcrumbLink}
+                  standalone
+                >
+                  {breadcrumb.label}
+                </Link>
+                <RiArrowRightSLine
+                  className={classes.breadcrumbSeparator}
+                  size={16}
+                  color="var(--bui-fg-secondary)"
+                />
+              </Fragment>
             ))}
-          </ul>
+          <h2 className={classes.title}>{title}</h2>
         </div>
-      )}
-      {sticky && (
-        <div
-          ref={stickySentinelRef}
-          className={classes.stickySentinel}
-          aria-hidden="true"
-        />
-      )}
-      <div
-        className={classes.content}
-        data-sticky={sticky || undefined}
-        data-stuck={isStuck || undefined}
-      >
-        <div className={classes.titleStack}>
+        {sticky && (
           <div
-            className={classes.breadcrumbs}
-            aria-hidden={isStuck || undefined}
+            className={classes.breadcrumbsSmall}
+            aria-hidden={!isStuck || undefined}
           >
             {breadcrumbs &&
               breadcrumbs.map(breadcrumb => (
                 <Fragment key={breadcrumb.label}>
                   <Link
-                    href={isStuck ? undefined : breadcrumb.href}
+                    href={isStuck ? breadcrumb.href : undefined}
                     color="secondary"
-                    className={classes.breadcrumbLink}
+                    className={classes.breadcrumbLinkSmall}
                     standalone
                   >
                     {breadcrumb.label}
@@ -215,75 +224,83 @@ export const Header = (props: HeaderProps) => {
                   />
                 </Fragment>
               ))}
-            <h2 className={classes.title}>{title}</h2>
+            <h2 className={classes.titleSmall}>{title}</h2>
           </div>
-          {sticky && (
-            <div
-              className={classes.breadcrumbsSmall}
-              aria-hidden={!isStuck || undefined}
-            >
-              {breadcrumbs &&
-                breadcrumbs.map(breadcrumb => (
-                  <Fragment key={breadcrumb.label}>
-                    <Link
-                      href={isStuck ? breadcrumb.href : undefined}
-                      color="secondary"
-                      className={classes.breadcrumbLinkSmall}
-                      standalone
-                    >
-                      {breadcrumb.label}
-                    </Link>
-                    <RiArrowRightSLine
-                      className={classes.breadcrumbSeparator}
-                      size={16}
-                      color="var(--bui-fg-secondary)"
-                    />
-                  </Fragment>
-                ))}
-              <h2 className={classes.titleSmall}>{title}</h2>
-            </div>
-          )}
-        </div>
-        <div className={classes.controls}>{customActions}</div>
+        )}
       </div>
-      {(description || (metadata && metadata.length > 0) || tabs) && (
-        <div className={classes.afterSticky}>
-          {description && (
-            <Text
-              variant="body-medium"
-              color="secondary"
-              className={classes.description}
-            >
-              {descriptionNodes}
-            </Text>
-          )}
-          {metadata && metadata.length > 0 && (
-            <dl className={classes.metaRow}>
-              {metadata.map((item, i) => (
-                <div key={`${i}:${item.label}`} className={classes.metaItem}>
-                  <dt>
-                    <Text variant="body-medium" color="secondary">
-                      {item.label}
-                    </Text>
-                  </dt>
-                  <dd>
-                    {typeof item.value === 'string' ? (
-                      <Text variant="body-medium">{item.value}</Text>
-                    ) : (
-                      item.value
-                    )}
-                  </dd>
-                </div>
-              ))}
-            </dl>
-          )}
-          {tabs && (
-            <div className={classes.tabsWrapper}>
-              <HeaderNav tabs={tabs} activeTabId={activeTabId} />
+      <div className={classes.controls}>{customActions}</div>
+    </>
+  );
+
+  const afterStickyContent = (description ||
+    (metadata && metadata.length > 0) ||
+    tabs) && (
+    <div className={classes.afterSticky} data-sticky={sticky || undefined}>
+      {description && (
+        <Text
+          variant="body-medium"
+          color="secondary"
+          className={classes.description}
+        >
+          {descriptionNodes}
+        </Text>
+      )}
+      {metadata && metadata.length > 0 && (
+        <dl className={classes.metaRow}>
+          {metadata.map((item, i) => (
+            <div key={`${i}:${item.label}`} className={classes.metaItem}>
+              <dt>
+                <Text variant="body-medium" color="secondary">
+                  {item.label}
+                </Text>
+              </dt>
+              <dd>
+                {typeof item.value === 'string' ? (
+                  <Text variant="body-medium">{item.value}</Text>
+                ) : (
+                  item.value
+                )}
+              </dd>
             </div>
-          )}
+          ))}
+        </dl>
+      )}
+      {tabs && (
+        <div className={classes.tabsWrapper}>
+          <HeaderNav tabs={tabs} activeTabId={activeTabId} />
         </div>
       )}
+    </div>
+  );
+
+  if (sticky) {
+    return (
+      <>
+        {beforeStickyContent}
+        <div
+          ref={stickySentinelRef}
+          className={classes.stickySentinel}
+          data-sticky=""
+          aria-hidden="true"
+        />
+        <header
+          className={classes.content}
+          data-sticky=""
+          data-stuck={isStuck || undefined}
+          {...dataAttributes}
+        >
+          {titleAndActionsContent}
+        </header>
+        {afterStickyContent}
+      </>
+    );
+  }
+
+  return (
+    <header className={classes.root} {...dataAttributes}>
+      {beforeStickyContent}
+      <div className={classes.content}>{titleAndActionsContent}</div>
+      {afterStickyContent}
     </header>
   );
 };