@salesforcedevs/docs-components 1.27.22-banner7 → 1.27.22-banner9

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforcedevs/docs-components",
-    "version": "1.27.22-banner7",
+    "version": "1.27.22-banner9",
     "description": "Docs Lightning web components for DSC",
     "license": "MIT",
     "main": "index.js",
@@ -25,5 +25,5 @@
         "@types/lodash.orderby": "4.6.9",
         "@types/lodash.uniqby": "4.7.9"
     },
-    "gitHead": "c6a070901f664e9ecfbb267d1fe15f0ad436524e"
+    "gitHead": "6bfe41efab500f95128e0dd50057065992d724ad"
 }

package/src/modules/doc/xmlContent/xmlContent.html

@@ -17,7 +17,7 @@
     >
         <doc-banner
             slot="locale-banner"
-            lwc:if={showLocaleBanner}
+            lwc:if={showLocaleBannerInSlot}
             message-text="This text was translated using Salesforce's machine translation system. More details can be found "
             message-link-url="https://help.salesforce.com/s/articleView?id=sf.machine_translation.htm"
             message-link-text="here"

package/src/modules/doc/xmlContent/xmlContent.ts

@@ -80,6 +80,7 @@ export default class DocXmlContent extends LightningElementWithState<{
     private docTitle = "";
     private _pathName = "";
     private listenerAttached = false;
+    private _xmlLocaleBannerDispatched = false;
     private sidebarFooterContent: SiderbarFooter = { ...defaultSidebarFooter };
     private latestVersion = false;
     private previewVersion = false;
@@ -221,6 +222,16 @@ export default class DocXmlContent extends LightningElementWithState<{
             this.setState({ internalLinkClicked: false });
         }
 
+        if (
+            this.displayContent &&
+            !normalizeBoolean(this.localeBannerEnabled) &&
+            this.shouldShowLocaleBanner &&
+            !this._xmlLocaleBannerDispatched
+        ) {
+            this._xmlLocaleBannerDispatched = true;
+            this.injectLocaleBannerIntoThemeHost();
+        }
+
         if (
             (this.prevState.isFetchingContent &&
                 !this.state.isFetchingContent) ||
@@ -257,10 +268,14 @@ export default class DocXmlContent extends LightningElementWithState<{
         return this.pageReference.deliverable;
     }
 
-    private get showLocaleBanner(): boolean {
-        if (!normalizeBoolean(this.localeBannerEnabled)) {
-            return false;
-        }
+    private get showLocaleBannerInSlot(): boolean {
+        return (
+            normalizeBoolean(this.localeBannerEnabled) &&
+            this.shouldShowLocaleBanner
+        );
+    }
+
+    private get shouldShowLocaleBanner(): boolean {
         if (!this.pageReference?.deliverable) {
             return false;
         }
@@ -289,6 +304,45 @@ export default class DocXmlContent extends LightningElementWithState<{
         });
     }
 
+    private injectLocaleBannerIntoThemeHost(retry = false): void {
+        if (typeof document === "undefined") {
+            return;
+        }
+        const host = document.getElementById("doc-xml-locale-banner-host");
+        if (!host) {
+            if (!retry) {
+                setTimeout(
+                    () => this.injectLocaleBannerIntoThemeHost(true),
+                    100
+                );
+            }
+            return;
+        }
+        if (host.hasChildNodes()) {
+            return;
+        }
+        const banner = document.createElement("doc-banner");
+        banner.setAttribute(
+            "message-text",
+            "This text was translated using Salesforce's machine translation system. More details can be found "
+        );
+        banner.setAttribute(
+            "message-link-url",
+            "https://help.salesforce.com/s/articleView?id=sf.machine_translation.htm"
+        );
+        banner.setAttribute("message-link-text", "here");
+        banner.setAttribute("button-label", "Switch to English");
+        banner.setAttribute("button-href", this.localeBannerEnUsHref);
+        banner.setAttribute("secondary-label", "Not Now");
+        banner.setAttribute("show-close-button", "true");
+        banner.setAttribute(
+            "dismiss-storage-key",
+            this.deliverable || "default"
+        );
+        host.setAttribute("aria-hidden", "false");
+        host.appendChild(banner);
+    }
+
     private get useOldSidebar(): boolean {
         // Coveo is enabled and the version is greater than  51 (within the latest 3 versions)
         // TODO: we need a better fix for version number check