Skip to main content
A workspace-level grid component that displays all data objects from the workspace for a selected group taxon. This component provides a tabbed interface for switching between different root-level taxons and displays the data in an editable grid format. It operates at the workspace level rather than being scoped to a specific view or document.

​
Type

type: "workspaceDataGrid"
This component doesn’t have a registered metadata file.

​
Properties

PropertyTypeDescription
viewIdstringView identifier for state management

​
Layout

  • Default Width: 12 columns
  • Default Height: 10 rows
  • Supports Children: No

​
Configuration Example

- type: workspaceDataGrid
  id: allWorkspaceData
  properties:
    viewId: "workspace-view"
  layout:
    x: 0
    y: 0
    w: 12
    h: 12

​
Features

​
Automatic Tab Generation

The component automatically:
  1. Discovers all enabled root-level group taxons from content taxonomies
  2. Filters to only include taxons without ”/” in their path
  3. Creates a tab for each taxon
  4. Uses the taxon’s label as the tab name

​
Grid Display

Each tab displays a grid using KodexaWorkspaceDataObjectGridContainer with:
  • All data objects from the workspace
  • Filtered by the selected group taxon
  • Editable mode enabled
  • Access to all group taxons for context

​
Tab Switching

  • First taxon is selected by default
  • Clicking a tab switches to that taxon’s data
  • Tab state is managed locally
  • Grid updates reactively when switching tabs

​
Advanced Usage

​
Workspace-Level Data Access

Unlike view-scoped grids, this component:
  • Accesses workspace-level data store
  • Shows data across all documents in the workspace
  • Includes data from all views
  • Provides a comprehensive data overview

​
Data Object Source

The grid receives:
  • Raw data objects from workspace store (Map converted to Array)
  • All group taxon metadata for cross-referencing
  • Current view ID for context
  • Editable permissions

​
Grid Features

The underlying grid container provides:
  • Column configuration based on taxon structure
  • Inline editing capabilities
  • Sorting and filtering
  • Custom cell renderers
  • Data object management (add, edit, delete)

​
Example: Complete Workspace Overview

- type: workspaceDataGrid
  id: masterDataView
  properties:
    viewId: "master-view"
  layout:
    x: 0
    y: 0
    w: 12
    h: 14
This provides a master view of all data in the workspace, with tabs for each root-level taxon (e.g., “Invoices”, “Customers”, “Products”).

​
Notes

  • This is a workspace-level component, not document-scoped
  • Only root-level group taxons are shown (no nested groups)
  • The grid is editable by default
  • Data objects are accessed from workspace store, not view store
  • Tab list updates automatically when taxonomy structure changes
  • The first available taxon is auto-selected on mount
  • Component requires valid content taxonomies to function
  • Empty state is handled if no group taxons exist
  • The grid key changes with taxon selection to ensure proper re-rendering
  • Integrates with workspace store for data operations
  • Supports all standard grid operations (add, edit, delete)