Skip to main content
A workspace-level tree view component that displays all data objects from the workspace in a hierarchical tree structure. This component provides a comprehensive view of data organization and relationships across the entire workspace, using the first available root-level group taxon by default.

​
Type

type: "workspaceDataTreeView"
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: workspaceDataTreeView
  id: workspaceTree
  properties:
    viewId: "workspace-view"
  layout:
    x: 0
    y: 0
    w: 12
    h: 12

​
Features

​
Automatic Taxon Selection

The component automatically:
  1. Discovers all enabled root-level group taxons from content taxonomies
  2. Selects the first available taxon
  3. Displays the tree view for that taxon
  4. Updates reactively when taxonomies change

​
Tree Display

The tree view uses KodexaWorkspaceDataObjectTreeContainer which provides:
  • Hierarchical display of data objects and attributes
  • Expand/collapse functionality
  • Visual distinction between groups, sections, and attributes
  • Inline editing capabilities
  • Search and filtering

​
Workspace-Level Data Access

Unlike view-scoped trees, this component:
  • Accesses workspace-level data store
  • Shows data across all documents
  • Includes data from all views
  • Provides complete workspace overview

​
Advanced Usage

​
Reactive Taxon Selection

The component uses a watcher that:
  • Monitors changes to group taxons
  • Automatically selects first available taxon
  • Triggers immediately on mount
  • Deep watches taxonomy structure changes

​
Data Object Source

The tree receives:
  • Raw data objects from workspace store (Map converted to Array)
  • All group taxon metadata for structure
  • Current view ID for context
  • First group taxon as the root

​
Tree Features

The underlying tree container provides:
  • Hierarchical data display
  • Search functionality
  • Filtering options
  • Context menu actions
  • Add/delete operations
  • Show in context integration

​
Example: Complete Workspace Data

- type: workspaceDataTreeView
  id: masterTreeView
  properties:
    viewId: "master-tree"
  layout:
    x: 0
    y: 0
    w: 4
    h: 14
This provides a comprehensive tree view of all workspace data, starting with the first root-level taxon.

​
Notes

  • This is a workspace-level component, not document-scoped
  • Automatically selects the first root-level group taxon
  • No tab interface (unlike workspace data grid)
  • The tree is keyed by taxon ID to ensure proper re-rendering
  • Component requires valid content taxonomies to function
  • Empty state is handled if no group taxons exist
  • Data objects are accessed from workspace store, not view store
  • Tree updates automatically when taxonomy or data changes
  • Supports all standard tree operations
  • Deep watcher ensures immediate updates on structure changes
  • The component focuses on a single taxon view rather than tabbed interface
  • Useful for understanding data hierarchy and relationships