Global Configuration

config = { height: 420, scrollMode: 'paging', sortMode: 'client' };

config = { height: 420, scrollMode: 'paging', sortMode: 'client',
           rowHeight: 32 };

provideGridDefaults()

Call once in ApplicationConfig.providers. Every <gridcraft> in the app inherits these values. Per-grid [config] always takes precedence.

It accepts any GridConfig option — all 61 of them. But they do not all combine with a grid's own [config] in the same way, and the difference is worth knowing before you rely on it.

How a global value combines with a per-grid one

Three behaviours, and every option falls into exactly one of them.

1 · Combined option by option — messages and icons

These two combine key by key. Set the loading text globally and the empty text on one grid, and that grid shows both. Only the keys you repeat get overridden.

provideGridDefaults({ messages: { loading: 'Loading...', empty: 'Nothing here' } })

// This grid gets its own empty text and KEEPS the global loading text.
config = { messages: { empty: 'No employees match' } };

2 · Changeable while the app runs — dir, theme, messages

These three can also be swapped after the app has started, through GridDirectionService below — for a language switcher or a dark-mode toggle. A grid that sets the option itself keeps its own value and ignores the switch.

3 · Replaced completely — every other option

For the rest, a grid that sets the option at all replaces the global value entirely. For a plain value like rowHeight that is exactly what you would expect. For an option that holds a group of settings, it is the part that catches people out:

provideGridDefaults({
  rowSelection: { mode: 'multi', checkboxColumn: false },
})

// This grid meant to change nothing but the mode - but the whole group is
// replaced, so checkboxColumn: false is gone and the checkbox column is back.
config = { rowSelection: { mode: 'single' } };

// Repeat what you want to keep:
config = { rowSelection: { mode: 'single', checkboxColumn: false } };

GridDirectionService

A root-level signal service. Calling setDir('rtl') and setMessages({ records: 'سجل', loading: '...' }) updates all grids that don't have an explicit per-grid override — no page refresh needed.

Whenever your app's active language changes — whether driven by a signal, a service, a URL parameter, or any other mechanism — call setDir() and setMessages() together. All grids update in the same tick. Click the button above to see it live.

effect(() => {
  const l = lang();
  gridLocale.setDir(RTL_LOCALES.has(l) ? 'rtl' : 'ltr');
  gridLocale.setMessages(GRID_MESSAGES[l] ?? GRID_MESSAGES['en']);
});

Priority (highest wins)

1. Per-grid [config]="{ dir: 'rtl' }" — explicit override for one grid
2. GridDirectionService.setDir() — reactive app-level direction
3. provideGridDefaults({ dir: '...' }) — static app-level default
4. 'ltr' — built-in fallback