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,
    },
  },
};

注意这个 breakpoint 和编程语言里的断点没有关系。

breakpoint.service.ts 的 getBreakpoint 方法，提供了根据当前屏幕宽度返回最合适的 breakpoint:

以这个 id 为 trigger 的按钮为例，它是完全 css 驱动的：

这个按钮的 css：

btn btn-action btn-block dialog-trigger

该按钮在 lg 这个 breakpoint 情况下，会被设置为 display：none：

而 Spartacus 应用代码怎么知道当前的屏幕尺寸对应的 break point 呢？

答案是我们自己实现的 breakpoint.service.ts.

首先定义枚举类型 BREAKPOINT:

export enum BREAKPOINT {
  xs = 'xs',
  sm = 'sm',
  md = 'md',
  lg = 'lg',
  xl = 'xl',
}

然后根据当前代码的运行环境进行计算：

breakpoint$: Observable<BREAKPOINT> = isPlatformBrowser(this.platform)
    ? this.winRef.resize$.pipe(
        map((event) => this.getBreakpoint((<Window>event.target).innerWidth)),
        distinctUntilChanged()
      )
    : of(this.fallbackBreakpoint);

  constructor(
    protected winRef: WindowRef,
    protected layoutConfig: LayoutConfig,
    @Inject(PLATFORM_ID) protected platform: any
  ) {}

如果当前运行在浏览器环境下，isPlatformBrowser(this.platform) 返回 true，那么进入三元表达式前面的分支，调用 this.getBreakpoint 根据当前屏幕的 innerWidth，获取对应的 breakpoint.

同时，一旦有 resize 事件发生，会自动重新计算新的 breakpoint. 每次 resize 事件发生时，产生的 event 对象 event.target 指向 Window 对象，该对象的 innerWidth 即是新的屏幕宽度。

如何捕捉屏幕的 resize 事件？

 get resize$(): Observable<any> {
    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.

如果当前代码在服务器端 Node.js 环境中运行，进入三元表达式问号后面的分支：of(this.fallbackBreakpoint);

返回最小屏幕尺寸对应的 breakpoint，这也体现了 mobile first 的设计思路。

更多Jerry的原创文章，尽在："汪子熙":