SAP 电商云 Spartacus UI 去除 Checkout 页面 header 和 footer 区域的几种方法介绍

1 distraction-free checkout

如何移除 checkout 页面的 footer 和 header

方法1 - 把 checkout CMS page 的header 和 footer slot 删除即可

可以直接在 Backoffice 或者 SmartEdit 里手动删除，也可以创建 Impex 删除。这样 Hybris Re-initialize 的时候，这些 Impex 脚本可以重用。

所有的 checkout 页面，包括 shipping address，delivery mode 等页面，都需要删除。

这个步骤做完之后，我们仍然能够在左上角，看到一个 Hi XXX 的字段：

这个字段位于一个名叫 SiteLogin 的 content slot 内，该 slot 包含了一个 cx-login component.

注意，这个内容信息并非来自 Commerce Cloud CMS 后台，而是属于 Spartacus Static Configuration 的一部分。

这个 static 配置定义在 Spartacus 代码这个位置：

现在我们需要把这个静态配置移到 CMS Component 里。

(1) 在 SiteLogin slot 添加类型为 flexType 的 CMSFlexComponent：LoginComponent.

给包括 checkout pages 在内的所有页面都添加这个 Component assignment 关系。

(2) 对于 PreHeader slot 和 HamburgerMenuComponent 重复上述的操作。

pages besides the checkout pages.

(3) 从 SpartacusConfigurationModule. 中删除 static 配置，即 …defaultCmsContentProviders 相关代码。

方法2 - 复写页面模板 MultiStepCheckoutSummaryPageTemplate 的 header 和 footer section

使用如下代码将这两个区域设置为 [] 即可：

provideConfig({
layoutSlots: {
MultiStepCheckoutSummaryPageTemplate: {
header: {
slots: [],
},
footer: {
slots: [],
},
},
},
} as LayoutConfig),           

复制

这种简单粗暴的方法，使我们失去了在 CMS 里控制页面布局的可能性。有一种折中的方案，即使用另一种 content slot 集合。

provideConfig({
layoutSlots: {
MultiStepCheckoutSummaryPageTemplate: {
header: {
slots: [‘CheckoutHeader’],
},
footer: {
slots: [‘CheckoutFooter’],
},
},
},
} as LayoutConfig),           

复制

开发 header

ng g m spartacus/my-storefront ng g c spartacus/my-storefront --export ng g m spartacus/my-storefront/my-desktop-header

使用 MyStorefrontComponent 扩展 StorefrontComponent

把后者的 .html 文件里的内容全部拷贝到前者的 .html 文件里。

将 StorefrontComponentModule import 区域的值拷贝到 MyStorefrontModule.

@NgModule({
imports: [
CommonModule,
RouterModule,
GlobalMessageComponentModule,
OutletModule,
OutletRefModule,
PageLayoutModule,
PageSlotModule,
KeyboardFocusModule,
SkipLinkModule,
MyDesktopHeaderModule,
],
declarations: [MyStorefrontComponent],
exports: [MyStorefrontComponent],
})
export class MyStorefrontModule {}           

复制

以上是 my-storefront.module.ts 的值。

然后将 MyStorefrontModule 导入 AppModule. 将 app.component.html 文件里的 cx-storefront 替换成 app-my-storefront.

既然现在我们对 app-my-storefront 有 100% 的控制权了，就可以随意修改其 html 文件里的内容了。

<ng-template [cxOutlet]=”StorefrontOutlets.STOREFRONT” cxPageTemplateStyle>
<ng-template cxOutlet=”cx-header”>
<header
cxSkipLink=”cx-header”
[cxFocus]=”{ disableMouseFocus: true }”
[class.is-expanded]=”isExpanded$ | async”
(keydown.escape)=”collapseMenu()”
(click)=”collapseMenuIfClickOutside($event)”
>
<app-my-desktop-header></app-my-desktop-header>
</header>
<cx-page-slot position=”BottomHeaderSlot”></cx-page-slot>
<cx-global-message
aria-atomic=”true”
aria-live=”assertive”
></cx-global-message>
</ng-template>
<main cxSkipLink=”cx-main” [cxFocus]=”{ disableMouseFocus: true }”>
<router-outlet></router-outlet>
</main>
<ng-template cxOutlet=”cx-footer”>
<footer cxSkipLink=”cx-footer” [cxFocus]=”{ disableMouseFocus: true }”>
<cx-page-layout section=”footer”></cx-page-layout>
</footer>
</ng-template>
</ng-template>           

复制

我们仍然期望我们 header 区域的某些部分可以在 CMS 里被编辑，比如 links 和 navigation bar.

因此我们在这些位置，放置 cx-page-slot component.

这个 slot Component 的作用是，渲染在 CMS 里被分配给某个 slot 的 Component.

<div class=”top-header py-2”>
<div class=”container”>
<div class=”row justify-content-between align-items-center”>
<cx-page-slot position=”SiteLinks”></cx-page-slot>
<div>
Download our application. <a><u>Find out more</u></a>
</div>
<cx-page-slot
class=”d-flex align-items-center”
position=”SiteContext”
></cx-page-slot>
</div>
</div>
</div>
<div class=”container”>
<div class=”row justify-content-between align-items-center”>
<cx-generic-link [url]=”’/’”><img src=”assets/logo.png” /></cxgeneric-
link>
<cx-page-slot position=”NavigationBar”></cx-page-slot>
<cx-searchbox></cx-searchbox>
<div class=”header-icons”>
<cx-generic-link [url]=”{ cxRoute: ‘login’ } | cxUrl”
><cx-icon [cxIcon]=”’USER’”></cx-icon
></cx-generic-link>
<cx-generic-link [url]=”{ cxRoute: ‘wishlist’ } | cxUrl”
><cx-icon [cxIcon]=”’EMPTY_HEART’”></cx-icon
></cx-generic-link>
<cx-mini-cart></cx-mini-cart>
</div>
</div>
</div>           

复制

以上是文件 my-desktop–header.component.html 的内容。

为了让这个模板能够工作，我们需要在 MyDesktopHeaderModule 里导入一些 dependencies.

@NgModule({
imports: [
CommonModule,
GenericLinkModule,
SearchBoxModule,
PageSlotModule,
MiniCartModule,
IconModule,
UrlModule,
],
declarations: [MyDesktopHeaderComponent],
exports: [MyDesktopHeaderComponent],
})
export class MyHeaderModule {}           

复制

一切完成后，新的 header 区域如下图所示：

这是因为新的 header structure 同默认的 Spartacus style 不匹配。

修改 styles.scss 的值：

//change the default font
@import url(“https://fonts.googleapis.com/css?family=Raleway:100,300,400,500
,700,900&display=swap&subset=latin-ext”);
$font-family-base: “Raleway”, sans-serif;
$styleVersion: 4.2;
// remove default styles for the header section and some components
$skipComponentStyles: (header, cx-mini-cart);
@import “~@spartacus/styles/index”;
// define color variables
:root {
--cx-color-secondary: #f1f2f3;
--cx-color-primary: #43464e;
}           

复制