Skip to content

Chart Interactions

Charts support hover interactions with tooltips. Click interactions for drill-downs are planned for a future release.

Hover Tooltips

Charts automatically display tooltips when hovering over data points. Tooltips show the values for the hovered element.

charts:
  sales_chart:
    title: "Hover for Details"
    query: queries.sales
    type: bar
    x: month
    y: total_revenue

Cross-File Query References

You can reference queries from external files using the file.yml#query_name syntax:

charts:
  sales_chart:
    query: _doc_examples.yaml#sales  # External file reference
    type: bar
    x: product
    y: revenue

This is useful for: - Sharing queries across multiple dashboards - Keeping doc examples short by referencing common queries - Organizing large projects with separate query definition files

Paths are resolved relative to the current file's directory.

Click Interactions (Coming Soon)

Planned Feature

Click interactions are planned but not yet implemented. The YAML schema supports them, but they don't function yet.

The planned syntax for click interactions:

charts:
  month_selector:
    query: queries.sales
    type: bar
    title: Click a Month to Select
    x: date
    y: revenue
    interactions:           # Not yet functional
      click:
        action: set_variable
        target: "selected_month"
        value_map:
          field: "date"

Planned click action types:

  • set_variable - Update a variable when clicking a chart element
  • filter - Filter other charts based on clicked value
  • link - Navigate to a URL
  • drill - Navigate to a detail dashboard