Tableau UI for Angular

Server-side rendering

Every component renders on the server; what needs a screen waits for the browser.

The components render on the server

No component touches window or document while it renders, so an app can render its pages on a server or prerender them at build time. This site prerenders every page, with the components on it, and its build fails when a page throws while it renders. These are its own server files:

import type { ApplicationConfig } from '@angular/core';
import { mergeApplicationConfig } from '@angular/core';
import { provideServerRendering, withRoutes } from '@angular/ssr';
import { appConfig } from './app.config';
import { serverRoutes } from './app.routes.server';

const serverConfig: ApplicationConfig = {
  providers: [provideServerRendering(withRoutes(serverRoutes))],
};

export const config = mergeApplicationConfig(appConfig, serverConfig);
import type { ServerRoute } from '@angular/ssr';
import { RenderMode } from '@angular/ssr';

export const serverRoutes: ServerRoute[] = [
  // Every page is prerendered: its components render on the server. A path the app has no page for renders on the
  // client, from the shell.
  { path: '', renderMode: RenderMode.Prerender },
  { path: 'getting-started', renderMode: RenderMode.Prerender },
  { path: 'dashboard', renderMode: RenderMode.Prerender },
  { path: 'theming', renderMode: RenderMode.Prerender },
  { path: 'ssr', renderMode: RenderMode.Prerender },
  { path: 'local-development', renderMode: RenderMode.Prerender },
  { path: 'checkbox', renderMode: RenderMode.Prerender },
  { path: 'radios', renderMode: RenderMode.Prerender },
  { path: 'form-fields', renderMode: RenderMode.Prerender },
  { path: 'select', renderMode: RenderMode.Prerender },
  { path: 'list', renderMode: RenderMode.Prerender },
  { path: 'chips', renderMode: RenderMode.Prerender },
  { path: 'menu', renderMode: RenderMode.Prerender },
  { path: 'date-picker', renderMode: RenderMode.Prerender },
  { path: 'buttons', renderMode: RenderMode.Prerender },
  { path: 'dialogs', renderMode: RenderMode.Prerender },
  { path: 'snackbar', renderMode: RenderMode.Prerender },
  { path: 'tooltips', renderMode: RenderMode.Prerender },
  { path: 'expansion-panel', renderMode: RenderMode.Prerender },
  { path: 'tabcontrol', renderMode: RenderMode.Prerender },
  { path: 'navbar', renderMode: RenderMode.Prerender },
  { path: 'tree', renderMode: RenderMode.Prerender },
  { path: 'drawer', renderMode: RenderMode.Prerender },
  { path: 'scroller', renderMode: RenderMode.Prerender },
  { path: 'table', renderMode: RenderMode.Prerender },
  { path: 'virtualize', renderMode: RenderMode.Prerender },
  { path: 'monaco', renderMode: RenderMode.Prerender },
  { path: 'css', renderMode: RenderMode.Prerender },
  { path: 'icons', renderMode: RenderMode.Prerender },
  { path: 'clipboard', renderMode: RenderMode.Prerender },
  { path: '**', renderMode: RenderMode.Client },
];

What waits for the browser

The server has no layout and no user, so what measures, observes or asks the browser starts after the first render there.

WhatOn the server
The table and tab-virtualize They render without rows: load() and reload() measure first, so on the server they load nothing and resolve false. Call load() once the view is drawn, as the table page does.
The Monaco editorMonaco loads, and the editor is created, after the first render in the browser.
ThemeService.initialize()It does nothing, so the server's page is light at the default font size; the browser then applies the user's stored theme.
The form field, the arrow scroll, the tab group, the tree, the menu button group, the resize watcherThey measure and observe after the first render, in the browser only.
ClipboardService It uses navigator.clipboard: call it from what the user does, such as a click, never while rendering.

Dialogs and snacks on the server

Their services show nothing on the server, and answer so that code waiting on them goes on.

MethodOn the server
DialogService's openModal(), openTemplateModal(), openDialog(), openTemplateDialog() A DialogRef for a dialog that is never shown; closing it still emits closed$.
openConfirmationMessageDialog(), openConfirmationTemplateDialog() They resolve false at once, so a guard or a resolver that awaits one doesn't hold the render.
SnackService's openSnack(), openSnackWithAction(), openSnackFromTemplate(), openSnackComponent() A SnackRef for a snack that is never shown.

Hydration

Hydration isn't wired yet. The library isn't tested with it, and this site doesn't call provideClientHydration(), so the browser renders each page again over the server's HTML.