Skip to main content
A specialized card that displays a single root-level data element (taxon) in a transposed grid format. This card simplifies the configuration by allowing you to select a specific taxon and automatically rendering it using the transposed grid component.

​
Type

type: "singleTaxon"

​
Properties

​
Required Properties

PropertyTypeDescription
taxonIdtaxonSelectorThe root data element to display (root-level taxons only)

​
Optional Properties

None

​
Layout

  • Default Width: 12 columns
  • Default Height: 10 rows
  • Supports Children: Yes (passed through to the transposed grid)

​
Configuration Example

- type: singleTaxon
  id: invoiceGrid
  properties:
    taxonId: "invoice-taxon-id-123"
  layout:
    x: 0
    y: 0
    w: 12
    h: 10

​
Advanced Usage

​
Taxon Selection

The component uses a taxonSelector which:
  • Shows only root-level (enabled) taxons
  • Filters for taxons without parent paths
  • Validates that selected taxon exists and is enabled

​
Automatic Grid Generation

When a valid taxon is selected, the component:
  1. Finds the taxon by ID in content taxonomies
  2. Validates the taxon is enabled
  3. Creates a transposed grid card configuration automatically
  4. Passes through parent data object and tag metadata
  5. Renders using the KodexaFormCardTransposedGrid component

​
Empty State

If no taxon is selected or the selected taxon is not available:
  • Shows a user-friendly message
  • Explains that no data element is selected
  • Provides gray-colored, centered text for clear feedback

​
Example with Children

- type: singleTaxon
  id: customerGrid
  properties:
    taxonId: "customer-123"
  layout:
    x: 0
    y: 0
    w: 12
    h: 10
  children:
    - type: dataAttributeEditor
      id: customerName
      properties:
        taxon: "customer/name"

​
Notes

  • This is essentially a wrapper around the transposed grid component
  • Simplifies configuration by reducing the number of properties needed
  • Only works with root-level data elements (no nested taxons)
  • The taxon must be enabled in a content taxonomy to be selectable
  • The generated grid card uses:
    • attributeLabel: Set to the taxon’s label
    • groupTaxon: Set to the taxon’s name
  • Children are supported and passed through to the transposed grid
  • If the taxonomy structure changes, the component reactively updates