Documentation Index
Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
Use this file to discover all available pages before exploring further.
Page loader
v1.0.0 | View in StorybookWhen to use
- When loading entire pages or the primary content area after a navigation action.
- When the content load time is noticeable (typically > 1s) and might cause uncertainty without visual feedback.
- During transitions between major sections of the product where the context completely changes, such as navigating to a new application or page.
When to use something else
- For small, localized loads in Menu, Button, Card, Data grid cells, or inline lists: use skeleton or inline spinner patterns instead.
- For background work while the user keeps working: use Progress or a subtle inline status indicator.
- For imperceptibly fast loads (< ~1s): skip the loader to avoid flicker.
- For long loads (> ~4s): prefer Progress or explicit completion messaging.
Behavior
- Covers the targeted region (full page or main pane) until loading finishes; should not steal focus unless paired with a cancelable operation that needs attention.
Often used with
- Full-page or pane skeleton UI; for indeterminate waits pair messaging with Progress when a % or cancel is available.