Legends in Python

Marks with a name= participate in the chart legend. Add legend() to control the built-in legend's placement, columns, title, visibility, and DOM styling.

The legend is available by default when the chart contains named series. Use show=False to suppress it. If more than one legend component is present, the last one supplies the effective built-in configuration.

Giving each mark a name= is all it takes — a bare xy.legend() simply opts into the default placement for the named series.

loc= moves the legend to a corner such as "upper left", and title= adds a heading above the entries.

With many series, ncols=2 lays the entries out in two columns; the dashed baseline mark has no name=, so it stays out of the legend entirely.

class_name and style apply to the legend container. Chart-level class_names and styles can separately target legend, legend_item, and legend_swatch slots. Those are browser DOM hooks; native SVG and PNG use the legend options and renderable style values carried in the chart specification.

See Customize Each Part for the stable legend-slot contract.

The positional child or render= value is an opaque replacement object for a framework adapter:

Core XY neither imports nor serializes that object. The example is complete, but it only demonstrates storage: the shipped reflex_xy.chart adapter does not currently mount custom legend content. A custom adapter can read chrome_components() and mount the returned component. Standalone HTML keeps using safe built-in chrome, and the same object is also available through reflex_components().

Exact parameters and defaults are in Marks and components reference.

Give each mark a name=, e.g. xy.line(x, y, name="Actual") — a chart with named series shows the built-in legend by default. Add xy.legend() only when you want to configure placement, columns, title, visibility, or styling.

Pass loc= to xy.legend(), e.g. xy.legend(loc="upper right"). If more than one legend() component is present, the last one supplies the effective configuration.

Set ncols= on the legend, e.g. xy.legend(ncols=2, title="Series"), which lays the entries out in two columns under an optional legend title.

Use xy.legend(show=False) to suppress the legend entirely. Only marks with a name= participate in the legend, so omitting name= on a mark keeps that series out.