From 2e03b8cbac1876c3e519123ae57481c6916b3b1c Mon Sep 17 00:00:00 2001
From: Nick Krantz <125900171+nick-livefront@users.noreply.github.com>
Date: Mon, 7 Jul 2025 08:56:31 -0500
Subject: [PATCH] [PM-22180] Setup Extension Videos (#15419)
* remove placeholder image
* add videos for setup extension
* add support for mobile viewports
* add mobile/responsiveness for setup extension page
* add videos from `assets.bitwarden.com`
* align with figma for borders and shadow
* make text responsive for setup headings
* remove period
* add tests
* add tests for video sequence
* force font weight on `h2`
* add 8px to bottom margin of video container
---
.../add-extension-videos.component.html | 82 +++++++++
.../add-extension-videos.component.spec.ts | 170 ++++++++++++++++++
.../add-extension-videos.component.ts | 146 +++++++++++++++
.../setup-extension.component.html | 17 +-
.../setup-extension.component.spec.ts | 1 +
.../setup-extension.component.ts | 42 ++++-
.../setup-extension-placeholder.png | Bin 788300 -> 0 bytes
apps/web/src/locales/en/messages.json | 6 +-
apps/web/webpack.config.js | 3 +
9 files changed, 450 insertions(+), 17 deletions(-)
create mode 100644 apps/web/src/app/vault/components/setup-extension/add-extension-videos.component.html
create mode 100644 apps/web/src/app/vault/components/setup-extension/add-extension-videos.component.spec.ts
create mode 100644 apps/web/src/app/vault/components/setup-extension/add-extension-videos.component.ts
delete mode 100644 apps/web/src/images/setup-extension/setup-extension-placeholder.png
diff --git a/apps/web/src/app/vault/components/setup-extension/add-extension-videos.component.html b/apps/web/src/app/vault/components/setup-extension/add-extension-videos.component.html
new file mode 100644
index 00000000000..3764f7d828f
--- /dev/null
+++ b/apps/web/src/app/vault/components/setup-extension/add-extension-videos.component.html
@@ -0,0 +1,82 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/apps/web/src/app/vault/components/setup-extension/add-extension-videos.component.spec.ts b/apps/web/src/app/vault/components/setup-extension/add-extension-videos.component.spec.ts
new file mode 100644
index 00000000000..9f39a3edcac
--- /dev/null
+++ b/apps/web/src/app/vault/components/setup-extension/add-extension-videos.component.spec.ts
@@ -0,0 +1,170 @@
+import { ComponentFixture, fakeAsync, TestBed, tick } from "@angular/core/testing";
+import { By } from "@angular/platform-browser";
+import { provideNoopAnimations } from "@angular/platform-browser/animations";
+import { RouterModule } from "@angular/router";
+
+import { I18nService } from "@bitwarden/common/platform/abstractions/i18n.service";
+
+import { AddExtensionVideosComponent } from "./add-extension-videos.component";
+
+describe("AddExtensionVideosComponent", () => {
+ let fixture: ComponentFixture;
+ let component: AddExtensionVideosComponent;
+
+ // Mock HTMLMediaElement load to stop the video file from being loaded
+ Object.defineProperty(HTMLMediaElement.prototype, "load", {
+ value: jest.fn(),
+ writable: true,
+ });
+
+ const play = jest.fn(() => Promise.resolve());
+ HTMLMediaElement.prototype.play = play;
+
+ beforeEach(async () => {
+ window.matchMedia = jest.fn().mockReturnValue(false);
+ play.mockClear();
+
+ await TestBed.configureTestingModule({
+ imports: [AddExtensionVideosComponent, RouterModule.forRoot([])],
+ providers: [
+ provideNoopAnimations(),
+ { provide: I18nService, useValue: { t: (key: string) => key } },
+ ],
+ }).compileComponents();
+
+ fixture = TestBed.createComponent(AddExtensionVideosComponent);
+ component = fixture.componentInstance;
+ fixture.detectChanges();
+ });
+
+ describe("loading pulse", () => {
+ it("shows loading spinner when all videos are not loaded", () => {
+ const loadingSpinners = fixture.debugElement.queryAll(By.css("[data-testid='video-pulse']"));
+ expect(loadingSpinners.length).toBe(3);
+ });
+
+ it("shows all pulses until all videos are loaded", () => {
+ let loadingSpinners = fixture.debugElement.queryAll(By.css("[data-testid='video-pulse']"));
+ expect(loadingSpinners.length).toBe(3);
+
+ // Simulate two video loaded
+ component["videoElements"].get(0)?.nativeElement.dispatchEvent(new Event("loadeddata"));
+ component["videoElements"].get(1)?.nativeElement.dispatchEvent(new Event("loadeddata"));
+
+ loadingSpinners = fixture.debugElement.queryAll(By.css("[data-testid='video-pulse']"));
+
+ expect(component["numberOfLoadedVideos"]).toBe(2);
+ expect(loadingSpinners.length).toBe(3);
+ });
+ });
+
+ describe("window resizing", () => {
+ beforeEach(() => {
+ component["numberOfLoadedVideos"] = 3;
+ fixture.detectChanges();
+ });
+
+ it("shows all videos when window is resized to desktop viewport", fakeAsync(() => {
+ component["variant"] = "mobile";
+ Object.defineProperty(component["document"].documentElement, "clientWidth", {
+ configurable: true,
+ value: 1000,
+ });
+
+ window.dispatchEvent(new Event("resize"));
+
+ fixture.detectChanges();
+ tick(50);
+
+ expect(
+ Array.from(component["videoElements"]).every(
+ (video) => video.nativeElement.parentElement?.style.opacity === "1",
+ ),
+ ).toBe(true);
+ }));
+
+ it("shows only the playing video when window is resized to mobile viewport", fakeAsync(() => {
+ component["variant"] = "desktop";
+ // readonly property needs redefining
+ Object.defineProperty(component["document"].documentElement, "clientWidth", {
+ value: 500,
+ });
+
+ const video1 = component["videoElements"].get(1);
+ Object.defineProperty(video1!.nativeElement, "paused", {
+ value: false,
+ });
+
+ window.dispatchEvent(new Event("resize"));
+
+ fixture.detectChanges();
+ tick(50);
+
+ expect(component["videoElements"].get(0)?.nativeElement.parentElement?.style.opacity).toBe(
+ "0",
+ );
+ expect(component["videoElements"].get(1)?.nativeElement.parentElement?.style.opacity).toBe(
+ "1",
+ );
+ expect(component["videoElements"].get(2)?.nativeElement.parentElement?.style.opacity).toBe(
+ "0",
+ );
+ }));
+ });
+
+ describe("video sequence", () => {
+ let firstVideo: HTMLVideoElement;
+ let secondVideo: HTMLVideoElement;
+ let thirdVideo: HTMLVideoElement;
+
+ beforeEach(() => {
+ component["numberOfLoadedVideos"] = 2;
+ component["onVideoLoad"]();
+
+ firstVideo = component["videoElements"].get(0)!.nativeElement;
+ secondVideo = component["videoElements"].get(1)!.nativeElement;
+ thirdVideo = component["videoElements"].get(2)!.nativeElement;
+ });
+
+ it("starts the video sequence when all videos are loaded", fakeAsync(() => {
+ tick();
+
+ expect(firstVideo.play).toHaveBeenCalled();
+ }));
+
+ it("plays videos in sequence", fakeAsync(() => {
+ tick(); // let first video play
+
+ play.mockClear();
+ firstVideo.onended!(new Event("ended")); // trigger next video
+
+ tick();
+
+ expect(secondVideo.play).toHaveBeenCalledTimes(1);
+
+ play.mockClear();
+ secondVideo.onended!(new Event("ended")); // trigger next video
+
+ tick();
+
+ expect(thirdVideo.play).toHaveBeenCalledTimes(1);
+ }));
+
+ it("doesn't play videos again when the user prefers no motion", fakeAsync(() => {
+ component["prefersReducedMotion"] = true;
+
+ tick();
+ firstVideo.onended!(new Event("ended"));
+ tick();
+ secondVideo.onended!(new Event("ended"));
+ tick();
+
+ play.mockClear();
+
+ thirdVideo.onended!(new Event("ended")); // trigger first video again
+
+ tick();
+ expect(play).toHaveBeenCalledTimes(0);
+ }));
+ });
+});
diff --git a/apps/web/src/app/vault/components/setup-extension/add-extension-videos.component.ts b/apps/web/src/app/vault/components/setup-extension/add-extension-videos.component.ts
new file mode 100644
index 00000000000..2420414fc88
--- /dev/null
+++ b/apps/web/src/app/vault/components/setup-extension/add-extension-videos.component.ts
@@ -0,0 +1,146 @@
+import { CommonModule, DOCUMENT } from "@angular/common";
+import { Component, ViewChildren, QueryList, ElementRef, inject } from "@angular/core";
+import { takeUntilDestroyed } from "@angular/core/rxjs-interop";
+import { debounceTime, fromEvent } from "rxjs";
+
+import { JslibModule } from "@bitwarden/angular/jslib.module";
+
+@Component({
+ selector: "vault-add-extension-videos",
+ templateUrl: "./add-extension-videos.component.html",
+ imports: [CommonModule, JslibModule],
+})
+export class AddExtensionVideosComponent {
+ @ViewChildren("video", { read: ElementRef }) protected videoElements!: QueryList<
+ ElementRef
+ >;
+
+ private document = inject(DOCUMENT);
+
+ /** Current viewport size */
+ protected variant: "mobile" | "desktop" = "desktop";
+
+ /** Number of videos that have loaded and are ready to play */
+ protected numberOfLoadedVideos = 0;
+
+ /** True when the user prefers reduced motion */
+ protected prefersReducedMotion = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+
+ /** Returns true when all videos are loaded */
+ get allVideosLoaded(): boolean {
+ return this.numberOfLoadedVideos >= 3;
+ }
+
+ constructor() {
+ fromEvent(window, "resize")
+ .pipe(takeUntilDestroyed(), debounceTime(25))
+ .subscribe(() => this.onResize());
+ }
+
+ /** Resets the video states based on the viewport width changes */
+ onResize(): void {
+ const oldVariant = this.variant;
+ this.variant = this.document.documentElement.clientWidth < 768 ? "mobile" : "desktop";
+
+ // When the viewport changes from desktop to mobile, hide all videos except the one that is playing.
+ if (this.variant !== oldVariant && this.variant === "mobile") {
+ this.videoElements.forEach((video) => {
+ if (video.nativeElement.paused) {
+ this.hideElement(video.nativeElement.parentElement!);
+ } else {
+ this.showElement(video.nativeElement.parentElement!);
+ }
+ });
+ }
+
+ // When the viewport changes from mobile to desktop, show all videos.
+ if (this.variant !== oldVariant && this.variant === "desktop") {
+ this.videoElements.forEach((video) => {
+ this.showElement(video.nativeElement.parentElement!);
+ });
+ }
+ }
+
+ /**
+ * Increment the number of loaded videos.
+ * When all videos are loaded, start the first one.
+ */
+ protected onVideoLoad() {
+ this.numberOfLoadedVideos = this.numberOfLoadedVideos + 1;
+
+ if (this.allVideosLoaded) {
+ void this.startVideoSequence(0);
+ }
+ }
+
+ /** Recursive method to start the video sequence. */
+ private async startVideoSequence(i: number): Promise {
+ let index = i;
+ const endOfVideos = index >= this.videoElements.length;
+
+ // When the user prefers reduced motion, don't play the videos more than once
+ if (endOfVideos && this.prefersReducedMotion) {
+ return;
+ }
+
+ // When the last of the videos has played, loop back to the start
+ if (endOfVideos) {
+ this.videoElements.forEach((video) => {
+ // Reset all videos to the start
+ video.nativeElement.currentTime = 0;
+ });
+
+ // Loop back to the first video
+ index = 0;
+ }
+
+ const video = this.videoElements.toArray()[index].nativeElement;
+ video.onended = () => {
+ void this.startVideoSequence(index + 1);
+ };
+
+ this.mobileTransitionIn(index);
+
+ // Set muted via JavaScript, browsers are respecting autoplay consistently over just the HTML attribute
+ video.muted = true;
+ await video.play();
+ }
+
+ /** For mobile viewports, fades the current video out and the next video in. */
+ private mobileTransitionIn(index: number): void {
+ // When the viewport is above the tablet breakpoint, all videos are shown at once.
+ // No transition is needed.
+ if (this.isAboveTabletBreakpoint()) {
+ return;
+ }
+
+ const currentParent = this.videoElements.toArray()[index].nativeElement.parentElement!;
+ const previousIndex = index === 0 ? this.videoElements.length - 1 : index - 1;
+
+ const previousParent = this.videoElements.toArray()[previousIndex].nativeElement.parentElement!;
+
+ // Fade out the previous video
+ this.hideElement(previousParent, true);
+
+ // Fade in the current video
+ this.showElement(currentParent, true);
+ }
+
+ /** Returns true when the viewport width is 768px or above. */
+ private isAboveTabletBreakpoint(): boolean {
+ const width = this.document.documentElement.clientWidth;
+ return width >= 768;
+ }
+
+ /** Visually hides the given element. */
+ private hideElement(element: HTMLElement, transition = false): void {
+ element.style.transition = transition ? "opacity 0.5s linear" : "";
+ element.style.opacity = "0";
+ }
+
+ /** Visually shows the given element. */
+ private showElement(element: HTMLElement, transition = false): void {
+ element.style.transition = transition ? "opacity 0.5s linear" : "";
+ element.style.opacity = "1";
+ }
+}
diff --git a/apps/web/src/app/vault/components/setup-extension/setup-extension.component.html b/apps/web/src/app/vault/components/setup-extension/setup-extension.component.html
index fc2b1bc60cb..3b9ec19fd34 100644
--- a/apps/web/src/app/vault/components/setup-extension/setup-extension.component.html
+++ b/apps/web/src/app/vault/components/setup-extension/setup-extension.component.html
@@ -6,16 +6,13 @@
>
- {{ "setupExtensionPageTitle" | i18n }}
- {{ "setupExtensionPageDescription" | i18n }}
-
-
-
-
+ {{ "setupExtensionPageTitle" | i18n }}
+
+
+ {{ "setupExtensionPageDescription" | i18n }}
+
+
{
navigate.mockClear();
openExtension.mockClear();
getFeatureFlag.mockClear().mockResolvedValue(true);
+ window.matchMedia = jest.fn().mockReturnValue(false);
await TestBed.configureTestingModule({
imports: [SetupExtensionComponent, RouterModule.forRoot([])],
diff --git a/apps/web/src/app/vault/components/setup-extension/setup-extension.component.ts b/apps/web/src/app/vault/components/setup-extension/setup-extension.component.ts
index 839572f3a30..9ee8e189627 100644
--- a/apps/web/src/app/vault/components/setup-extension/setup-extension.component.ts
+++ b/apps/web/src/app/vault/components/setup-extension/setup-extension.component.ts
@@ -1,5 +1,5 @@
-import { NgIf } from "@angular/common";
-import { Component, DestroyRef, inject, OnInit } from "@angular/core";
+import { DOCUMENT, NgIf } from "@angular/common";
+import { Component, DestroyRef, inject, OnDestroy, OnInit } from "@angular/core";
import { takeUntilDestroyed } from "@angular/core/rxjs-interop";
import { Router, RouterModule } from "@angular/router";
import { pairwise, startWith } from "rxjs";
@@ -23,6 +23,7 @@ import { VaultIcons } from "@bitwarden/vault";
import { WebBrowserInteractionService } from "../../services/web-browser-interaction.service";
import { AddExtensionLaterDialogComponent } from "./add-extension-later-dialog.component";
+import { AddExtensionVideosComponent } from "./add-extension-videos.component";
const SetupExtensionState = {
Loading: "loading",
@@ -35,15 +36,24 @@ type SetupExtensionState = UnionOfValues;
@Component({
selector: "vault-setup-extension",
templateUrl: "./setup-extension.component.html",
- imports: [NgIf, JslibModule, ButtonComponent, LinkModule, IconModule, RouterModule],
+ imports: [
+ NgIf,
+ JslibModule,
+ ButtonComponent,
+ LinkModule,
+ IconModule,
+ RouterModule,
+ AddExtensionVideosComponent,
+ ],
})
-export class SetupExtensionComponent implements OnInit {
+export class SetupExtensionComponent implements OnInit, OnDestroy {
private webBrowserExtensionInteractionService = inject(WebBrowserInteractionService);
private configService = inject(ConfigService);
private router = inject(Router);
private destroyRef = inject(DestroyRef);
private platformUtilsService = inject(PlatformUtilsService);
private dialogService = inject(DialogService);
+ private document = inject(DOCUMENT);
protected SetupExtensionState = SetupExtensionState;
protected PartyIcon = VaultIcons.Party;
@@ -56,8 +66,21 @@ export class SetupExtensionComponent implements OnInit {
/** Reference to the add it later dialog */
protected dialogRef: DialogRef | null = null;
+ private viewportContent: string | null = null;
async ngOnInit() {
+ // It is not be uncommon for users to hit this page from smaller viewports.
+ // There are global styles that set a min-width for the page which cause it to render poorly.
+ // Remove them here.
+ // https://github.com/bitwarden/clients/blob/main/apps/web/src/scss/base.scss#L6
+ this.document.body.style.minWidth = "auto";
+
+ const viewportMeta = this.document.querySelector('meta[name="viewport"]');
+
+ // Save the current viewport content to reset it when the component is destroyed
+ this.viewportContent = viewportMeta?.getAttribute("content") ?? null;
+ viewportMeta?.setAttribute("content", "width=device-width, initial-scale=1.0");
+
await this.conditionallyRedirectUser();
this.webStoreUrl = getWebStoreUrl(this.platformUtilsService.getDevice());
@@ -83,6 +106,17 @@ export class SetupExtensionComponent implements OnInit {
});
}
+ ngOnDestroy(): void {
+ // Reset the body min-width when the component is destroyed
+ this.document.body.style.minWidth = "";
+
+ if (this.viewportContent !== null) {
+ this.document
+ .querySelector('meta[name="viewport"]')
+ ?.setAttribute("content", this.viewportContent);
+ }
+ }
+
/** Conditionally redirects the user to the vault upon landing on the page. */
async conditionallyRedirectUser() {
const isFeatureEnabled = await this.configService.getFeatureFlag(
diff --git a/apps/web/src/images/setup-extension/setup-extension-placeholder.png b/apps/web/src/images/setup-extension/setup-extension-placeholder.png
deleted file mode 100644
index 03a6d8951c01924b20d9e3c52d35d0456ae4ede9..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 788300
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 nlX(VT~LJ|WfU9AH3^B7gkCFDTFz@~KbL
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