0
点赞
收藏
分享

微信扫一扫

SAP 电商云 Spartacus UI SiteContextParamsService 的实现原理解析

近些年来电子商务应用网站设计的一个趋势是引入所谓的 ​​无干扰 checkout​​,即去掉常规网页中的页眉和页脚,以便让用户将注意力集中在 checkout 流程本身,防止其不小心导航出了 checkout 页面。

Spartacus是由CMS(内容管理系统)驱动的。这意味着它显示基于从后端返回的内容。因此,要移除标题和 footer,它只需要从checkout CMS页面删除页眉和页脚槽。

这是一种快速且无需编码的解决方案,其优势是 Content Administrator 能够自行启用或禁用 ​​无干扰 checkout​​.

site-context-params.service.ts (SiteContextParamsService)

该类通过构造函数注入的三个依赖,都是 ​​site-context​​ 文件夹内实现的资源。

SAP 电商云 Spartacus UI SiteContextParamsService 的实现原理解析_页眉

SiteContextConfig 是在全局 config 对象上新增的 context 字段:

export abstract class SiteContextConfig {
context?: {
urlParameters?: string[];
[contextName: string]: string[] | undefined;
};
}

getContextParameters

该方法获得 context 里除了 urlParameters 之外的其他 context parameter,比如 language 和 currency 的字段名称。

getContextParameters(): string[] {
if (this.config.context) {
return Object.keys(this.config.context).filter(
(param) => param !== 'urlParameters'
);
}
return [];
}

getUrlEncodingParameters

取得 context 中的 url parameter 值:

getUrlEncodingParameters(): string[] {
return (this.config.context && this.config.context.urlParameters) || [];
}

getParamValues

取得参数的值内容:

getParamValues(param: string): string[] {
return getContextParameterValues(this.config, param);
}

getSiteContextService

根据参数名称,手动取得注入的参数服务类实例。在运行时,从浏览器地址栏 url 里,提取出地址栏包含的 url 参数:

SAP 电商云 Spartacus UI SiteContextParamsService 的实现原理解析_地址栏_02

解析出的 JSON 对象:

SAP 电商云 Spartacus UI SiteContextParamsService 的实现原理解析_字段_03

针对每个参数对象,根据参数名称,解析出对应的参数 service class,再调用 setValue 方法。

SAP 电商云 Spartacus UI SiteContextParamsService 的实现原理解析_字段_04

从 service map 里获得 service class 的 type,然后使用 Angular ​​injector​​ 进行实例注入:

SAP 电商云 Spartacus UI SiteContextParamsService 的实现原理解析_字段_05

将 active base site 设置成浏览器地址栏 url 里包含的值:

SAP 电商云 Spartacus UI SiteContextParamsService 的实现原理解析_页眉_06

这个 base-site.service.ts 位于 facade 层:

SAP 电商云 Spartacus UI SiteContextParamsService 的实现原理解析_地址栏_07

另外,当 context 发生变化时,service class 的 getActive 也会发射最新的数据:

SAP 电商云 Spartacus UI SiteContextParamsService 的实现原理解析_字段_08

举个例子,从下拉列表里更改语言:

SAP 电商云 Spartacus UI SiteContextParamsService 的实现原理解析_页眉_09

于是最新的语言,就被传入 subscribe 指定的回调函数里:

SAP 电商云 Spartacus UI SiteContextParamsService 的实现原理解析_地址栏_10

举报

相关推荐

0 条评论