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.
| What | On 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 editor | Monaco 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 watcher | They 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.
| Method | On 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.