SAP|SAP 电商云 Spartacus UI 的响应式 UI 实现细节

在文件 projects\storefrontlib\layout\config\default-layout.config.ts 里,定义了各个屏幕尺寸所对应的 breakpoint:

export const defaultLayoutConfig: LayoutConfig = { breakpoints: { xs: 576, sm: 768, md: 992, lg: 1200, xl: { min: 1200, }, }, };

SAP|SAP 电商云 Spartacus UI 的响应式 UI 实现细节
文章图片

注意这个 breakpoint 和编程语言里的断点没有关系。
breakpoint.service.ts 的 getBreakpoint 方法,提供了根据当前屏幕宽度返回最合适的 breakpoint:
SAP|SAP 电商云 Spartacus UI 的响应式 UI 实现细节
文章图片

以这个 id 为 trigger 的按钮为例,它是完全 css 驱动的:
SAP|SAP 电商云 Spartacus UI 的响应式 UI 实现细节
文章图片

这个按钮的 css:
btn btn-action btn-block dialog-trigger
该按钮在 lg 这个 breakpoint 情况下,会被设置为 display:none:
SAP|SAP 电商云 Spartacus UI 的响应式 UI 实现细节
文章图片

SAP|SAP 电商云 Spartacus UI 的响应式 UI 实现细节
文章图片

而 Spartacus 应用代码怎么知道当前的屏幕尺寸对应的 break point 呢?
答案是我们自己实现的 breakpoint.service.ts.
SAP|SAP 电商云 Spartacus UI 的响应式 UI 实现细节
文章图片

首先定义枚举类型 BREAKPOINT:
export enum BREAKPOINT { xs = 'xs', sm = 'sm', md = 'md', lg = 'lg', xl = 'xl', }

然后根据当前代码的运行环境进行计算:
breakpoint$: Observable = isPlatformBrowser(this.platform) ? this.winRef.resize$.pipe( map((event) => this.getBreakpoint((event.target).innerWidth)), distinctUntilChanged() ) : of(this.fallbackBreakpoint); constructor( protected winRef: WindowRef, protected layoutConfig: LayoutConfig, @Inject(PLATFORM_ID) protected platform: any ) {}

【SAP|SAP 电商云 Spartacus UI 的响应式 UI 实现细节】如果当前运行在浏览器环境下,isPlatformBrowser(this.platform) 返回 true,那么进入三元表达式前面的分支,调用 this.getBreakpoint 根据当前屏幕的 innerWidth,获取对应的 breakpoint.
同时,一旦有 resize 事件发生,会自动重新计算新的 breakpoint. 每次 resize 事件发生时,产生的 event 对象 event.target 指向 Window 对象,该对象的 innerWidth 即是新的屏幕宽度。
如何捕捉屏幕的 resize 事件?
get resize$(): Observable { if (!this.nativeWindow) { return of(null); } else { return fromEvent(this.nativeWindow, 'resize').pipe( debounceTime(300), startWith({ target: this.nativeWindow }), distinctUntilChanged() ); } }

这里我们使用了 rxJs 的 fromEvent 和 debounce, 将 window 对象产生的 resize 事件,做了一个 300 毫秒的限流,意思是当 resize 事件触发后,如果300毫秒之内并没有新的 resize 事件发生时,再把这个 resize 事件,交给 Observable 执行链的下游处理,即重新获取 breakpoint.
SAP|SAP 电商云 Spartacus UI 的响应式 UI 实现细节
文章图片

如果当前代码在服务器端 Node.js 环境中运行,进入三元表达式问号后面的分支:of(this.fallbackBreakpoint);
返回最小屏幕尺寸对应的 breakpoint,这也体现了 mobile first 的设计思路。
SAP|SAP 电商云 Spartacus UI 的响应式 UI 实现细节
文章图片

更多Jerry的原创文章,尽在:"汪子熙":
SAP|SAP 电商云 Spartacus UI 的响应式 UI 实现细节
文章图片

    推荐阅读