MAIDR Documentation - v3.58.2
    Preparing search index...

    Interface MaidrLayer

    Layer/trace definition containing plot type, data, and rendering configuration.

    interface MaidrLayer {
        id: string;
        type: TraceType;
        title?: string;
        selectors?: string | string[] | CandlestickSelector | BoxSelector[];
        orientation?: Orientation;
        domMapping?: {
            order?: "row" | "column";
            groupDirection?: "reverse" | "forward";
            iqrDirection?: "reverse" | "forward";
        };
        axes?: { x?: string; y?: string; fill?: string; format?: FormatConfig };
        violinOptions?: ViolinOptions;
        data:
            | HeatmapData
            | BarPoint[]
            | BoxPoint[]
            | CandlestickPoint[]
            | HistogramPoint[]
            | LinePoint[][]
            | ScatterPoint[]
            | SegmentedPoint[][]
            | SmoothPoint[][]
            | ViolinKdePoint[][];
    }
    Index

    Properties

    id type title? selectors? orientation? domMapping? axes? violinOptions? data

    Properties

    id: string
    type: TraceType
    title?: string
    selectors?: string | string[] | CandlestickSelector | BoxSelector[]
    orientation?: Orientation
    domMapping?: {
        order?: "row" | "column";
        groupDirection?: "reverse" | "forward";
        iqrDirection?: "reverse" | "forward";
    }

    Optional DOM mapping hints. When provided, individual traces can opt-in to use these hints to map DOM elements to the internal row-major data grid without changing default behavior when omitted.

    Type Declaration

    • Optionalorder?: "row" | "column"

      Specify DOM flattening order for grid-like traces. 'row' => row-major, 'column' => column-major.

    • OptionalgroupDirection?: "reverse" | "forward"

      For segmented/dodged bars, control the per-column group/level iteration. 'forward' => iterate groups top-to-bottom (as previously domOrder='forward'). 'reverse' => iterate bottom-to-top (default).

    • OptionaliqrDirection?: "reverse" | "forward"

      For boxplots, control the Q1/Q3 edge mapping for IQR box. 'forward' => Q1=bottom, Q3=top (default for vertical) 'reverse' => Q1=top, Q3=bottom (for Base R vertical boxplots)

    axes?: { x?: string; y?: string; fill?: string; format?: FormatConfig }

    Axis configuration including labels and optional formatting.

    Type Declaration

    • Optionalx?: string
    • Optionaly?: string
    • Optionalfill?: string
    • Optionalformat?: FormatConfig

      Optional formatting configuration for axis values. When provided, values displayed in text descriptions will be formatted.

      format: {
        x: { function: "return new Date(value).toLocaleDateString()" },
        y: { type: "currency", decimals: 2 }
      }

    // Basic axis labels
    axes: { x: "Date", y: "Price" }

    // With formatting
    axes: {
      x: "Date",
      y: "Price",
      format: {
        y: { type: "currency", decimals: 2 }
      }
    }
    violinOptions?: ViolinOptions

    Optional display configuration for violin plot layers (VIOLIN_KDE and VIOLIN_BOX). Controls which summary statistics are shown in the violin box overlay.

    data:
        | HeatmapData
        | BarPoint[]
        | BoxPoint[]
        | CandlestickPoint[]
        | HistogramPoint[]
        | LinePoint[][]
        | ScatterPoint[]
        | SegmentedPoint[][]
        | SmoothPoint[][]
        | ViolinKdePoint[][]

    Settings

    Member Visibility

    On This Page

    Properties