Struct vega_lite_4::Header
source · pub struct Header {Show 32 fields
pub format: Option<Format>,
pub format_type: Option<String>,
pub label_align: Option<TitleAlignUnion>,
pub label_anchor: Option<TitleAnchorEnum>,
pub label_angle: Option<f64>,
pub label_baseline: Option<TextBaseline>,
pub label_color: Option<Box<Color>>,
pub label_expr: Option<String>,
pub label_font: Option<Box<Color>>,
pub label_font_size: Option<CornerRadiusUnion>,
pub label_font_style: Option<Box<Color>>,
pub label_font_weight: Option<FontWeightUnion>,
pub label_limit: Option<CornerRadiusUnion>,
pub label_line_height: Option<CornerRadiusUnion>,
pub label_orient: Option<Orient>,
pub label_padding: Option<CornerRadiusUnion>,
pub labels: Option<bool>,
pub orient: Option<Orient>,
pub title: RemovableValue<LegendText>,
pub title_align: Option<TitleAlignUnion>,
pub title_anchor: Option<TitleAnchorEnum>,
pub title_angle: Option<f64>,
pub title_baseline: Option<TextBaseline>,
pub title_color: Option<Box<Color>>,
pub title_font: Option<Box<Color>>,
pub title_font_size: Option<CornerRadiusUnion>,
pub title_font_style: Option<Box<Color>>,
pub title_font_weight: Option<FontWeightUnion>,
pub title_limit: Option<CornerRadiusUnion>,
pub title_line_height: Option<CornerRadiusUnion>,
pub title_orient: Option<Orient>,
pub title_padding: Option<CornerRadiusUnion>,
}
Expand description
An object defining properties of a facet’s header.
Headers of row / column channels for faceted plots.
Fields§
§format: Option<Format>
When used with the default "number"
and "time"
format type, the text formatting
pattern for labels of guides (axes, legends, headers) and text marks.
- If the format type is
"number"
(e.g., for quantitative fields), this is D3’s number format pattern. - If the format type is"time"
(e.g., for temporal fields), this is D3’s time format pattern.
See the format documentation for more examples.
When used with a custom
formatType
, this
value will be passed as format
alongside datum.value
to the registered function.
Default value: Derived from numberFormat config for number format and from timeFormat config for time format.
format_type: Option<String>
The format type for labels. One of "number"
, "time"
, or a registered custom format
type.
Default value: - "time"
for temporal fields and ordinal and nominal fields with
timeUnit
. - "number"
for quantitative fields as well as ordinal and nominal fields
without timeUnit
.
label_align: Option<TitleAlignUnion>
Horizontal text alignment of header labels. One of "left"
, "center"
, or "right"
.
label_anchor: Option<TitleAnchorEnum>
The anchor position for placing the labels. One of "start"
, "middle"
, or "end"
. For
example, with a label orientation of top these anchor positions map to a left-, center-,
or right-aligned label.
label_angle: Option<f64>
The rotation angle of the header labels.
Default value: 0
for column header, -90
for row header.
label_baseline: Option<TextBaseline>
The vertical text baseline for the header labels. One of "alphabetic"
(default),
"top"
, "middle"
, "bottom"
, "line-top"
, or "line-bottom"
. The "line-top"
and
"line-bottom"
values operate similarly to "top"
and "bottom"
, but are calculated
relative to the titleLineHeight
rather than titleFontSize
alone.
label_color: Option<Box<Color>>
The color of the header label, can be in hex color code or regular color name.
label_expr: Option<String>
Vega expression for customizing labels.
Note: The label text and value can be assessed via the label
and value
properties
of the header’s backing datum
object.
label_font: Option<Box<Color>>
The font of the header label.
label_font_size: Option<CornerRadiusUnion>
The font size of the header label, in pixels.
label_font_style: Option<Box<Color>>
The font style of the header label.
label_font_weight: Option<FontWeightUnion>
The font weight of the header label.
label_limit: Option<CornerRadiusUnion>
The maximum length of the header label in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.
Default value: 0
, indicating no limit
label_line_height: Option<CornerRadiusUnion>
Line height in pixels for multi-line header labels or title text with "line-top"
or
"line-bottom"
baseline.
label_orient: Option<Orient>
The orientation of the header label. One of "top"
, "bottom"
, "left"
or "right"
.
label_padding: Option<CornerRadiusUnion>
The padding, in pixel, between facet header’s label and the plot.
Default value: 10
labels: Option<bool>
A boolean flag indicating if labels should be included as part of the header.
Default value: true
.
orient: Option<Orient>
Shortcut for setting both labelOrient and titleOrient.
title: RemovableValue<LegendText>
A title for the field. If null
, the title will be removed.
Default value: derived from the field’s name and transformation function
(aggregate
, bin
and timeUnit
). If the field has an aggregate function, the function
is displayed as part of the title (e.g., "Sum of Profit"
). If the field is binned or
has a time unit applied, the applied function is shown in parentheses (e.g., "Profit (binned)"
, "Transaction Date (year-month)"
). Otherwise, the title is simply the field
name.
Notes:
-
You can customize the default field title format by providing the
fieldTitle
property in the config orfieldTitle
function via thecompile
function’s options. -
If both field definition’s
title
and axis, header, or legendtitle
are defined, axis/header/legend title will be used.
title_align: Option<TitleAlignUnion>
Horizontal text alignment (to the anchor) of header titles.
title_anchor: Option<TitleAnchorEnum>
The anchor position for placing the title. One of "start"
, "middle"
, or "end"
. For
example, with an orientation of top these anchor positions map to a left-, center-, or
right-aligned title.
title_angle: Option<f64>
The rotation angle of the header title.
Default value: 0
.
title_baseline: Option<TextBaseline>
The vertical text baseline for the header title. One of "alphabetic"
(default),
"top"
, "middle"
, "bottom"
, "line-top"
, or "line-bottom"
. The "line-top"
and
"line-bottom"
values operate similarly to "top"
and "bottom"
, but are calculated
relative to the titleLineHeight
rather than titleFontSize
alone.
Default value: "middle"
title_color: Option<Box<Color>>
Color of the header title, can be in hex color code or regular color name.
title_font: Option<Box<Color>>
Font of the header title. (e.g., "Helvetica Neue"
).
title_font_size: Option<CornerRadiusUnion>
Font size of the header title.
title_font_style: Option<Box<Color>>
The font style of the header title.
title_font_weight: Option<FontWeightUnion>
Font weight of the header title. This can be either a string (e.g "bold"
, "normal"
)
or a number (100
, 200
, 300
, …, 900
where "normal"
= 400
and "bold"
=
700
).
title_limit: Option<CornerRadiusUnion>
The maximum length of the header title in pixels. The text value will be automatically truncated if the rendered size exceeds the limit.
Default value: 0
, indicating no limit
title_line_height: Option<CornerRadiusUnion>
Line height in pixels for multi-line header title text or title text with "line-top"
or
"line-bottom"
baseline.
title_orient: Option<Orient>
The orientation of the header title. One of "top"
, "bottom"
, "left"
or "right"
.
title_padding: Option<CornerRadiusUnion>
The padding, in pixel, between facet header’s title and the label.
Default value: 10