Module h2o_wave.types

Classes

Breadcrumb

class Breadcrumb(name: str, label: str)

Create a breadcrumb for a h2o_q.types.BreadcrumbsCard().

Static methods

load

def load(_Breadcrumb__d: Dict) ‑> Breadcrumb

Creates an instance of this class using the contents of a dict.

Instance variables

var label

The label to display.

var name

The name of this item. Prefix the name with a '#' to trigger hash-change navigation.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

BreadcrumbsCard

class BreadcrumbsCard(box: str, items: List[Breadcrumb], commands: Union[List[Command], NoneType] = None)

Create a card containing breadcrumbs. Breadcrumbs should be used as a navigational aid in your app or site. They indicate the current page’s location within a hierarchy and help the user understand where they are in relation to the rest of that hierarchy. They also afford one-click access to higher levels of that hierarchy. Breadcrumbs are typically placed, in horizontal form, under the masthead or navigation of an experience, above the primary content area.

Static methods

load

def load(_BreadcrumbsCard__d: Dict) ‑> BreadcrumbsCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var items

A list of h2o_q.types.Breadcrumb instances to display. See h2o_q.ui.breadcrumb()

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Button

class Button(name: str, label: Union[str, NoneType] = None, caption: Union[str, NoneType] = None, value: Union[str, NoneType] = None, primary: Union[bool, NoneType] = None, disabled: Union[bool, NoneType] = None, link: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a button.

Buttons are best used to enable a user to commit a change or complete steps in a task. They are typically found inside forms, dialogs, panels or pages. An example of their usage is confirming the deletion of a file in a confirmation dialog.

When considering their place in a layout, contemplate the order in which a user will flow through the UI. As an example, in a form, the individual will need to read and interact with the form fields before submitting the form. Therefore, as a general rule, the button should be placed at the bottom of the UI container which holds the related UI elements.

Buttons may be placed within a "buttons" component which will lay out the buttons horizontally, or used individually and they will be stacked vertically.

While buttons can technically be used to navigate a user to another part of the experience, this is not recommended unless that navigation is part of an action or their flow.

Static methods

load

def load(_Button__d: Dict) ‑> Button

Creates an instance of this class using the contents of a dict.

Instance variables

var caption

The caption displayed below the label. Setting a caption renders a compound button.

var disabled

True if the button should be disabled.

var label

The text displayed on the button.

True if the button should be rendered as link text and not a standard button.

var name

An identifying name for this component. If the name is prefixed with a '#', the button sets the location hash to the name when clicked.

var primary

True if the button should be rendered as the primary button in the set.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var value

A value for this button. If a value is set, it is used for the button's submitted instead of a boolean True.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Buttons

class Buttons(items: List[ForwardRef('Component')], justify: Union[str, NoneType] = None)

Create a set of buttons to be layed out horizontally.

Static methods

load

def load(_Buttons__d: Dict) ‑> Buttons

Creates an instance of this class using the contents of a dict.

Instance variables

var items

The button in this set.

var justify

Specifies how to lay out buttons horizontally. One of 'start', 'end', 'center', 'between', 'around'.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Checkbox

class Checkbox(name: str, label: Union[str, NoneType] = None, value: Union[bool, NoneType] = None, indeterminate: Union[bool, NoneType] = None, disabled: Union[bool, NoneType] = None, trigger: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a checkbox.

A checkbox allows users to switch between two mutually exclusive options (checked or unchecked, on or off) through a single click or tap. It can also be used to indicate a subordinate setting or preference when paired with another component.

A checkbox is used to select or deselect action items. It can be used for a single item or for a list of multiple items that a user can choose from. The component has two selection states: unselected and selected.

For a binary choice, the main difference between a checkbox and a toggle switch is that the checkbox is for status and the toggle switch is for action.

Use multiple checkboxes for multi-select scenarios in which a user chooses one or more items from a group of choices that are not mutually exclusive.

Static methods

load

def load(_Checkbox__d: Dict) ‑> Checkbox

Creates an instance of this class using the contents of a dict.

Instance variables

var disabled

True if the checkbox is disabled.

var indeterminate

True if the selection is indeterminate (neither selected nor unselected).

var label

Text to be displayed alongside the checkbox.

var name

An identifying name for this component.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var trigger

True if the form should be submitted when the checkbox value changes.

var value

True if selected, False if unselected.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Checklist

class Checklist(name: str, label: Union[str, NoneType] = None, values: Union[List[str], NoneType] = None, choices: Union[List[Choice], NoneType] = None, trigger: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a set of checkboxes. Use this for multi-select scenarios in which a user chooses one or more items from a group of choices that are not mutually exclusive.

Static methods

load

def load(_Checklist__d: Dict) ‑> Checklist

Creates an instance of this class using the contents of a dict.

Instance variables

var choices

The choices to be presented.

var label

Text to be displayed above the component.

var name

An identifying name for this component.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var trigger

True if the form should be submitted when the checklist value changes.

var values

The names of the selected choices.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Choice

class Choice(name: str, label: Union[str, NoneType] = None, disabled: Union[bool, NoneType] = None)

Create a choice for a checklist, choice group or dropdown.

Static methods

load

def load(_Choice__d: Dict) ‑> Choice

Creates an instance of this class using the contents of a dict.

Instance variables

var disabled

True if the checkbox is disabled.

var label

Text to be displayed alongside the component.

var name

An identifying name for this component.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

ChoiceGroup

class ChoiceGroup(name: str, label: Union[str, NoneType] = None, value: Union[str, NoneType] = None, choices: Union[List[Choice], NoneType] = None, required: Union[bool, NoneType] = None, trigger: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a choice group. The choice group component, also known as radio buttons, let users select one option from two or more choices. Each option is represented by one choice group button; a user can select only one choice group in a button group.

Choice groups emphasize all options equally, and that may draw more attention to the options than necessary. Consider using other components, unless the options deserve extra attention from the user. For example, if the default option is recommended for most users in most situations, use a dropdown instead.

If there are only two mutually exclusive options, combine them into a single Checkbox or Toggle switch. For example, use a checkbox for "I agree" instead of choice group buttons for "I agree" and "I don't agree."

Static methods

load

def load(_ChoiceGroup__d: Dict) ‑> ChoiceGroup

Creates an instance of this class using the contents of a dict.

Instance variables

var choices

The choices to be presented.

var label

Text to be displayed alongside the component.

var name

An identifying name for this component.

var required

True if this field is required.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var trigger

True if the form should be submitted when the selection changes.

var value

The name of the selected choice.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

ColorPicker

class ColorPicker(name: str, label: Union[str, NoneType] = None, value: Union[str, NoneType] = None, choices: Union[List[str], NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a color picker.

A date picker allows a user to pick a color value. If the 'choices' parameter is set, a swatch picker is displayed instead of the standard color picker.

Static methods

load

def load(_ColorPicker__d: Dict) ‑> ColorPicker

Creates an instance of this class using the contents of a dict.

Instance variables

var choices

A list of colors (CSS-compatible strings) to limit color choices to.

var label

Text to be displayed alongside the component.

var name

An identifying name for this component.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var value

The selected color (CSS-compatible string)

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Combobox

class Combobox(name: str, label: Union[str, NoneType] = None, placeholder: Union[str, NoneType] = None, value: Union[str, NoneType] = None, choices: Union[List[str], NoneType] = None, error: Union[str, NoneType] = None, disabled: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a combobox.

A combobox is a list in which the selected item is always visible, and the others are visible on demand by clicking a drop-down button or by typing in the input. They are used to simplify the design and make a choice within the UI.

When closed, only the selected item is visible. When users click the drop-down button, all the options become visible. To change the value, users open the list and click another value or use the arrow keys (up and down) to select a new value. When collapsed the user can select a new value by typing.

Static methods

load

def load(_Combobox__d: Dict) ‑> Combobox

Creates an instance of this class using the contents of a dict.

Instance variables

var choices

The choices to be presented.

var disabled

True if this field is disabled.

var error

Text to be displayed as an error below the text box.

var label

Text to be displayed alongside the component.

var name

An identifying name for this component.

var placeholder

A string that provides a brief hint to the user as to what kind of information is expected in the field.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var value

The name of the selected choice.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Command

class Command(name: str, label: Union[str, NoneType] = None, caption: Union[str, NoneType] = None, icon: Union[str, NoneType] = None, items: Union[List[ForwardRef('Command')], NoneType] = None, data: Union[str, NoneType] = None)

Create a command.

Commands are typically displayed as context menu items or toolbar button.

Static methods

load

def load(_Command__d: Dict) ‑> Command

Creates an instance of this class using the contents of a dict.

Instance variables

var caption

The caption for this command (typically a tooltip).

var data

Data associated with this command, if any.

var icon

The icon to be displayed for this command.

var items

Sub-commands, if any

var label

The text displayed for this command.

var name

An identifying name for this component. If the name is prefixed with a '#', the command sets the location hash to the name when executed.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Component

class Component(text: Union[Text, NoneType] = None, text_xl: Union[TextXl, NoneType] = None, text_l: Union[TextL, NoneType] = None, text_m: Union[TextM, NoneType] = None, text_s: Union[TextS, NoneType] = None, text_xs: Union[TextXs, NoneType] = None, label: Union[Label, NoneType] = None, separator: Union[Separator, NoneType] = None, progress: Union[Progress, NoneType] = None, message_bar: Union[MessageBar, NoneType] = None, textbox: Union[Textbox, NoneType] = None, checkbox: Union[Checkbox, NoneType] = None, toggle: Union[Toggle, NoneType] = None, choice_group: Union[ChoiceGroup, NoneType] = None, checklist: Union[Checklist, NoneType] = None, dropdown: Union[Dropdown, NoneType] = None, combobox: Union[Combobox, NoneType] = None, slider: Union[Slider, NoneType] = None, spinbox: Union[Spinbox, NoneType] = None, date_picker: Union[DatePicker, NoneType] = None, color_picker: Union[ColorPicker, NoneType] = None, button: Union[Button, NoneType] = None, buttons: Union[Buttons, NoneType] = None, file_upload: Union[FileUpload, NoneType] = None, table: Union[Table, NoneType] = None, link: Union[Link, NoneType] = None, tabs: Union[Tabs, NoneType] = None, expander: Union[Expander, NoneType] = None, frame: Union[Frame, NoneType] = None, markup: Union[Markup, NoneType] = None, template: Union[Template, NoneType] = None, picker: Union[Picker, NoneType] = None, range_slider: Union[RangeSlider, NoneType] = None, stepper: Union[Stepper, NoneType] = None, visualization: Union[Visualization, NoneType] = None, vega_visualization: Union[VegaVisualization, NoneType] = None)

Create a component.

Static methods

load

def load(_Component__d: Dict) ‑> Component

Creates an instance of this class using the contents of a dict.

Instance variables

var button

Button.

var buttons

Button set.

var checkbox

Checkbox.

var checklist

Checklist.

var choice_group

Choice group.

var color_picker

Color picker.

var combobox

Combobox.

var date_picker

Date picker.

var dropdown

Dropdown.

var expander

Expander.

var file_upload

File upload.

var frame

Frame.

var label

Label.

Link.

var markup

Markup

var message_bar

Message bar.

var picker

Picker.

var progress

Progress bar.

var range_slider

Range Slider.

var separator

Separator.

var slider

Slider.

var spinbox

Spinbox.

var stepper

Stepper.

var table

Table.

var tabs

Tabs.

var template

Template

var text

Text block.

var text_l

Large sized text block.

var text_m

Medium sized text block.

var text_s

Small sized text block.

var text_xl

Extra-large sized text block.

var text_xs

Extra-small sized text block.

var textbox

Textbox.

var toggle

Toggle.

var vega_visualization

Vega-lite Visualization.

var visualization

Visualization.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

DatePicker

class DatePicker(name: str, label: Union[str, NoneType] = None, placeholder: Union[str, NoneType] = None, value: Union[str, NoneType] = None, disabled: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a date picker.

A date picker allows a user to pick a date value.

Static methods

load

def load(_DatePicker__d: Dict) ‑> DatePicker

Creates an instance of this class using the contents of a dict.

Instance variables

var disabled

True if this field is disabled.

var label

Text to be displayed alongside the component.

var name

An identifying name for this component.

var placeholder

A string that provides a brief hint to the user as to what kind of information is expected in the field.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var value

The date value in YYYY-MM-DD format.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Dropdown

class Dropdown(name: str, label: Union[str, NoneType] = None, placeholder: Union[str, NoneType] = None, value: Union[str, NoneType] = None, values: Union[List[str], NoneType] = None, choices: Union[List[Choice], NoneType] = None, required: Union[bool, NoneType] = None, disabled: Union[bool, NoneType] = None, trigger: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a dropdown.

A dropdown is a list in which the selected item is always visible, and the others are visible on demand by clicking a drop-down button. They are used to simplify the design and make a choice within the UI. When closed, only the selected item is visible. When users click the drop-down button, all the options become visible.

To change the value, users open the list and click another value or use the arrow keys (up and down) to select a new value.

Note: Use either the 'value' parameter or the 'values' parameter. Setting the 'values' parameter renders a multi-select dropdown.

Static methods

load

def load(_Dropdown__d: Dict) ‑> Dropdown

Creates an instance of this class using the contents of a dict.

Instance variables

var choices

The choices to be presented.

var disabled

True if this field is disabled.

var label

Text to be displayed alongside the component.

var name

An identifying name for this component.

var placeholder

A string that provides a brief hint to the user as to what kind of information is expected in the field.

var required

True if this is a required field.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var trigger

True if the form should be submitted when the dropdown value changes.

var value

The name of the selected choice.

var values

The names of the selected choices. If this parameter is set, multiple selections will be allowed.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Expander

class Expander(name: str, label: Union[str, NoneType] = None, expanded: Union[bool, NoneType] = None, items: Union[List[ForwardRef('Component')], NoneType] = None)

Creates a new expander.

Expanders can be used to show or hide a group of related components.

Static methods

load

def load(_Expander__d: Dict) ‑> Expander

Creates an instance of this class using the contents of a dict.

Instance variables

var expanded

True if expanded, False if collapsed.

var items

List of components to be hideable by the expander.

var label

The text displayed on the expander.

var name

An identifying name for this component.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

FileUpload

class FileUpload(name: str, label: Union[str, NoneType] = None, multiple: Union[bool, NoneType] = None, file_extensions: Union[List[str], NoneType] = None, max_file_size: Union[float, NoneType] = None, max_size: Union[float, NoneType] = None, height: Union[str, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a file upload component. A file upload component allows a user to browse, select and upload one or more files.

Static methods

load

def load(_FileUpload__d: Dict) ‑> FileUpload

Creates an instance of this class using the contents of a dict.

Instance variables

var file_extensions

List of allowed file extensions, e.g. pdf, docx, etc.

var height

The height of the file upload, e.g. '400px', '50%', etc.

var label

Text to be displayed alongside the component.

var max_file_size

Maximum allowed size (Mb) per file. Defaults to no limit.

var max_size

Maximum allowed size (Mb) for all files combined. Defaults to no limit.

var multiple

True if the component should allow multiple files to be uploaded.

var name

An identifying name for this component.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

FlexCard

class FlexCard(box: str, item_view: str, item_props: Union[dict, str], data: Union[Data, str], direction: Union[str, NoneType] = None, justify: Union[str, NoneType] = None, align: Union[str, NoneType] = None, wrap: Union[str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

EXPERIMENTAL. DO NOT USE. Create a card containing other cards laid out using a one-dimensional model with flexible alignemnt and wrapping capabilities.

Static methods

load

def load(_FlexCard__d: Dict) ‑> FlexCard

Creates an instance of this class using the contents of a dict.

Instance variables

var align

Layout strategy for cross axis. One of 'start', 'end', 'center', 'baseline', 'stretch'.

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var direction

Layout direction. One of 'horizontal', 'vertical'.

var item_props

The child card properties.

var item_view

The child card type.

var justify

Layout strategy for main axis. One of 'start', 'end', 'center', 'between', 'around'.

var wrap

Wrapping strategy. One of 'start', 'end', 'center', 'between', 'around', 'stretch'.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

FormCard

class FormCard(box: str, items: Union[List[Component], str], commands: Union[List[Command], NoneType] = None)

Create a form.

Static methods

load

def load(_FormCard__d: Dict) ‑> FormCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var items

The components in this form.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Frame

class Frame(path: Union[str, NoneType] = None, content: Union[str, NoneType] = None, width: Union[str, NoneType] = None, height: Union[str, NoneType] = None)

Create a new inline frame (an iframe).

Static methods

load

def load(_Frame__d: Dict) ‑> Frame

Creates an instance of this class using the contents of a dict.

Instance variables

var content

The HTML content of the page. A string containing <html>...</html>.

var height

The height of the frame, e.g. 200px, 50%, etc. Defaults to 150px.

var path

The path or URL of the web page, e.g. /foo.html or http://example.com/foo.html

var width

The width of the frame, e.g. 200px, 50%, etc. Defaults to 100%.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

FrameCard

class FrameCard(box: str, title: str, path: Union[str, NoneType] = None, content: Union[str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Render a card containing a HTML page inside an inline frame (an iframe).

Either a path or content can be provided as arguments.

Static methods

load

def load(_FrameCard__d: Dict) ‑> FrameCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var content

The HTML content of the page. A string containing <html>...</html>

var path

The path or URL of the web page, e.g. /foo.html or http://example.com/foo.html

var title

The title for this card.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

GraphicsCard

class GraphicsCard(box: str, view_box: str, stage: Union[List[dict], str, NoneType] = None, scene: Union[Data, str, NoneType] = None, width: Union[str, NoneType] = None, height: Union[str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a card for displaying vector graphics.

Static methods

load

def load(_GraphicsCard__d: Dict) ‑> GraphicsCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var height

The displayed height of the rectangular viewport. (Not the height of its coordinate system.)

var scene

Foreground layer for rendering dynamic SVG elements.

var stage

Background layer for rendering static SVG elements. Must be packed to conserve memory.

var view_box

The position and dimension of the SVG viewport, in user space. A space-separated list of four numbers: min-x, min-y, width and height. For example, '0 0 400 300'. See: https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/viewBox

var width

The displayed width of the rectangular viewport. (Not the width of its coordinate system.)

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

GridCard

class GridCard(box: str, title: str, cells: Union[Data, str], data: Union[Data, str], commands: Union[List[Command], NoneType] = None)

EXPERIMENTAL. DO NOT USE.

Static methods

load

def load(_GridCard__d: Dict) ‑> GridCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var cells

EXPERIMENTAL. DO NOT USE.

var commands

Contextual menu commands for this component.

var data

EXPERIMENTAL. DO NOT USE.

var title

EXPERIMENTAL. DO NOT USE.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

HeaderCard

class HeaderCard(box: str, title: str, subtitle: str, icon: Union[str, NoneType] = None, icon_color: Union[str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Render a card containing a HTML page inside an inline frame (iframe).

Either a path or content can be provided as arguments.

Static methods

load

def load(_HeaderCard__d: Dict) ‑> HeaderCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var icon

The icon type, displayed to the left.

var icon_color

The icon's color.

var subtitle

The subtitle, displayed below the title.

var title

The title.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

IconTableCellType

class IconTableCellType(color: Union[str, NoneType] = None)

Create a cell type that renders a column's cells as icons instead of plain text. If set on a column, the cell value is interpreted as the name of the icon to be displayed.

Static methods

load

def load(_IconTableCellType__d: Dict) ‑> IconTableCellType

Creates an instance of this class using the contents of a dict.

Instance variables

var color

Icon color.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

ImageCard

class ImageCard(box: str, title: str, type: str, image: str, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a card that displays a base64-encoded image.

Static methods

load

def load(_ImageCard__d: Dict) ‑> ImageCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var image

Image data, base64-encoded.

var title

The card's title.

var type

The image MIME subtype. One of apng, bmp, gif, x-icon, jpeg, png, webp.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Label

class Label(label: str, required: Union[bool, NoneType] = None, disabled: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a label.

Labels give a name or title to a component or group of components. Labels should be in close proximity to the component or group they are paired with. Some components, such as textboxes, dropdowns, or toggles, already have labels incorporated, but other components may optionally add a Label if it helps inform the user of the component’s purpose.

Static methods

load

def load(_Label__d: Dict) ‑> Label

Creates an instance of this class using the contents of a dict.

Instance variables

var disabled

True if the label should be disabled.

var label

The text displayed on the label.

var required

True if the field is required.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

LargeBarStatCard

class LargeBarStatCard(box: str, title: str, caption: str, value: str, aux_value: str, value_caption: str, aux_value_caption: str, progress: float, plot_color: Union[str, NoneType] = None, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a large captioned card displaying a primary value, an auxiliary value and a progress bar, with captions for each value.

Static methods

load

def load(_LargeBarStatCard__d: Dict) ‑> LargeBarStatCard

Creates an instance of this class using the contents of a dict.

Instance variables

var aux_value

The auxiliary value, typically a target value.

var aux_value_caption

The caption displayed below the auxiliary value.

var box

A string indicating how to place this component on the page.

var caption

The card's caption.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var plot_color

The color of the progress bar.

var progress

The value of the progress bar, between 0 and 1.

var title

The card's title.

var value

The primary value displayed.

var value_caption

The caption displayed below the primary value.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

LargeStatCard

class LargeStatCard(box: str, title: str, value: str, aux_value: str, caption: str, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a stat card displaying a primary value, an auxiliary value and a caption.

Static methods

load

def load(_LargeStatCard__d: Dict) ‑> LargeStatCard

Creates an instance of this class using the contents of a dict.

Instance variables

var aux_value

The auxiliary value displayed next to the primary value.

var box

A string indicating how to place this component on the page.

var caption

The caption displayed below the primary value.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var title

The card's title.

var value

The primary value displayed.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Link

class Link(label: Union[str, NoneType] = None, path: Union[str, NoneType] = None, disabled: Union[bool, NoneType] = None, download: Union[bool, NoneType] = None, button: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a hyperlink.

Hyperlinks can be internal or external. Internal hyperlinks have paths that begin with a / and point to URLs within the Q UI. All other kinds of paths are treated as external hyperlinks.

Static methods

load

def load(_Link__d: Dict) ‑> Link

Creates an instance of this class using the contents of a dict.

Instance variables

var button

True if the link should be rendered as a button.

var disabled

True if the link should be disabled.

var download

True if the link should be used for file download.

var label

The text to be displayed. If blank, the path is used as the label.

var path

The path or URL to link to.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

ListCard

class ListCard(box: str, title: str, item_view: str, item_props: Union[dict, str], data: Union[Data, str], commands: Union[List[Command], NoneType] = None)

EXPERIMENTAL. DO NOT USE. Create a card containing other cards laid out in the form of a list (vertically, top-to-bottom).

Static methods

load

def load(_ListCard__d: Dict) ‑> ListCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var item_props

The child card properties.

var item_view

The child card type.

var title

The title for this card.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

ListItem1Card

class ListItem1Card(box: str, title: str, caption: str, value: str, aux_value: str, data: Union[dict, str], commands: Union[List[Command], NoneType] = None)

EXPERIMENTAL. DO NOT USE.

Static methods

load

def load(_ListItem1Card__d: Dict) ‑> ListItem1Card

Creates an instance of this class using the contents of a dict.

Instance variables

var aux_value

EXPERIMENTAL. DO NOT USE.

var box

A string indicating how to place this component on the page.

var caption

EXPERIMENTAL. DO NOT USE.

var commands

Contextual menu commands for this component.

var data

EXPERIMENTAL. DO NOT USE.

var title

EXPERIMENTAL. DO NOT USE.

var value

EXPERIMENTAL. DO NOT USE.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Mark

class Mark(coord: Union[str, NoneType] = None, type: Union[str, NoneType] = None, x: Union[str, float, int, NoneType] = None, x0: Union[str, float, int, NoneType] = None, x1: Union[str, float, int, NoneType] = None, x2: Union[str, float, int, NoneType] = None, x_min: Union[float, NoneType] = None, x_max: Union[float, NoneType] = None, x_nice: Union[bool, NoneType] = None, x_scale: Union[str, NoneType] = None, x_title: Union[str, NoneType] = None, y: Union[str, float, int, NoneType] = None, y0: Union[str, float, int, NoneType] = None, y1: Union[str, float, int, NoneType] = None, y2: Union[str, float, int, NoneType] = None, y_min: Union[float, NoneType] = None, y_max: Union[float, NoneType] = None, y_nice: Union[bool, NoneType] = None, y_scale: Union[str, NoneType] = None, y_title: Union[str, NoneType] = None, color: Union[str, NoneType] = None, color_range: Union[str, NoneType] = None, color_domain: Union[List[str], NoneType] = None, shape: Union[str, NoneType] = None, shape_range: Union[str, NoneType] = None, size: Union[str, float, int, NoneType] = None, size_range: Union[str, NoneType] = None, stack: Union[str, NoneType] = None, dodge: Union[str, NoneType] = None, curve: Union[str, NoneType] = None, fill_color: Union[str, NoneType] = None, fill_opacity: Union[float, NoneType] = None, stroke_color: Union[str, NoneType] = None, stroke_opacity: Union[float, NoneType] = None, stroke_size: Union[float, NoneType] = None, stroke_dash: Union[str, NoneType] = None, label: Union[str, NoneType] = None, label_offset: Union[float, NoneType] = None, label_offset_x: Union[float, NoneType] = None, label_offset_y: Union[float, NoneType] = None, label_rotation: Union[str, NoneType] = None, label_position: Union[str, NoneType] = None, label_overlap: Union[str, NoneType] = None, label_fill_color: Union[str, NoneType] = None, label_fill_opacity: Union[float, NoneType] = None, label_stroke_color: Union[str, NoneType] = None, label_stroke_opacity: Union[float, NoneType] = None, label_stroke_size: Union[float, NoneType] = None, label_font_size: Union[float, NoneType] = None, label_font_weight: Union[str, NoneType] = None, label_line_height: Union[float, NoneType] = None, label_align: Union[str, NoneType] = None, ref_stroke_color: Union[str, NoneType] = None, ref_stroke_opacity: Union[float, NoneType] = None, ref_stroke_size: Union[float, NoneType] = None, ref_stroke_dash: Union[str, NoneType] = None)

Create a specification for a layer of graphical marks such as bars, lines, points for a plot. A plot can contain multiple such layers of marks.

Static methods

load

def load(_Mark__d: Dict) ‑> Mark

Creates an instance of this class using the contents of a dict.

Instance variables

var color

Mark color field or value.

var color_domain

The unique values in the data (labels or categories or classes) to map colors to, e.g. ['high', 'medium', 'low']. If this is not provided, the unique values are automatically inferred from the color attribute.

var color_range

Mark color range for multi-series plots. A string containing space-separated colors, e.g. '#fee8c8 #fdbb84 #e34a33'

var coord

Coordinate system. rect is synonymous to cartesian. theta is transposed polar. One of 'rect', 'cartesian', 'polar', 'theta', 'helix'.

var curve

Curve type for line and area mark types. One of 'none', 'smooth', 'step-before', 'step', 'step-after'.

var dodge

Field to dodge marks by, or 'auto' to infer.

var fill_color

Mark fill color.

var fill_opacity

Mark fill opacity.

var label

Label field or value.

var label_align

Label text alignment. One of 'left', 'right', 'center', 'start', 'end'.

var label_fill_color

Label fill color.

var label_fill_opacity

Label fill opacity.

var label_font_size

Label font size.

var label_font_weight

Label font weight.

var label_line_height

Label line height.

var label_offset

Distance between label and mark.

var label_offset_x

Horizontal distance between label and mark.

var label_offset_y

Vertical distance between label and mark.

var label_overlap

Strategy to use if labels overlap. One of 'hide', 'overlap', 'constrain'.

var label_position

Label position relative to the mark. One of 'top', 'bottom', 'middle', 'left', 'right'.

var label_rotation

Label rotation angle, in degrees, or 'none' to disable automatic rotation. The default behavior is 'auto' for automatic rotation.

var label_stroke_color

Label stroke color.

var label_stroke_opacity

Label stroke opacity.

var label_stroke_size

Label stroke size (line width or pen thickness).

var ref_stroke_color

Reference line stroke color.

var ref_stroke_dash

Reference line stroke dash style. A string containing space-separated integers that specify distances to alternately draw a line and a gap (in coordinate space units). If the number of elements in the array is odd, the elements of the array get copied and concatenated. For example, [5, 15, 25] will become [5, 15, 25, 5, 15, 25].

var ref_stroke_opacity

Reference line stroke opacity.

var ref_stroke_size

Reference line stroke size (line width or pen thickness).

var shape

Mark shape field or value for point mark types. Possible values are 'circle', 'square', 'bowtie', 'diamond', 'hexagon', 'triangle', 'triangle-down', 'cross', 'tick', 'plus', 'hyphen', 'line'.

var shape_range

Mark shape range for multi-series plots using point mark types. A string containing space-separated shapes, e.g. 'circle square diamond'

var size

Mark size field or value.

var size_range

Mark size range. A string containing space-separated integers, e.g. '4 30'

var stack

Field to stack marks by, or 'auto' to infer.

var stroke_color

Mark stroke color.

var stroke_dash

Mark stroke dash style. A string containing space-separated integers that specify distances to alternately draw a line and a gap (in coordinate space units). If the number of elements in the array is odd, the elements of the array get copied and concatenated. For example, [5, 15, 25] will become [5, 15, 25, 5, 15, 25].

var stroke_opacity

Mark stroke opacity.

var stroke_size

Mark stroke size.

var type

Graphical geometry. One of 'interval', 'line', 'path', 'point', 'area', 'polygon', 'schema', 'edge', 'heatmap'.

var x

X field or value.

var x0

X base field or value.

var x1

X bin lower bound field or value. For histograms.

var x2

X bin upper bound field or value. For histograms.

var x_max

X axis scale maximum.

var x_min

X axis scale minimum.

var x_nice

Whether to nice X axis scale ticks.

var x_scale

X axis scale type. One of 'linear', 'cat', 'category', 'identity', 'log', 'pow', 'time', 'timeCat', 'quantize', 'quantile'.

var x_title

X axis title.

var y

Y field or value.

var y0

Y base field or value.

var y1

Y bin lower bound field or value. For histograms.

var y2

Y bin upper bound field or value. For histograms.

var y_max

Y axis scale maximum.

var y_min

Y axis scale minimum.

var y_nice

Whether to nice Y axis scale ticks.

var y_scale

Y axis scale type. One of 'linear', 'cat', 'category', 'identity', 'log', 'pow', 'time', 'timeCat', 'quantize', 'quantile'.

var y_title

Y axis title.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

MarkdownCard

class MarkdownCard(box: str, title: str, content: str, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a card that renders Markdown content.

Github-flavored markdown is supported. HTML markup is allowed in markdown content. URLs, if found, are displayed as hyperlinks. Copyright, reserved, trademark, quotes, etc. are replaced with language-neutral symbols.

Static methods

load

def load(_MarkdownCard__d: Dict) ‑> MarkdownCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var content

The markdown content. Supports Github Flavored Markdown (GFM): https://guides.github.com/features/mastering-markdown/

var data

Additional data for the card.

var title

The title for this card.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Markup

class Markup(content: str)

Render HTML content.

Static methods

load

def load(_Markup__d: Dict) ‑> Markup

Creates an instance of this class using the contents of a dict.

Instance variables

var content

The HTML content.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

MarkupCard

class MarkupCard(box: str, title: str, content: str, commands: Union[List[Command], NoneType] = None)

Render HTML content.

Static methods

load

def load(_MarkupCard__d: Dict) ‑> MarkupCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var content

The HTML content.

var title

The title for this card.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

MessageBar

class MessageBar(type: Union[str, NoneType] = None, text: Union[str, NoneType] = None)

Create a message bar.

A message bar is an area at the top of a primary view that displays relevant status information. You can use a message bar to tell the user about a situation that does not require their immediate attention and therefore does not need to block other activities.

Static methods

load

def load(_MessageBar__d: Dict) ‑> MessageBar

Creates an instance of this class using the contents of a dict.

Instance variables

var text

The text displayed on the message bar.

var type

The icon and color of the message bar. One of 'info', 'error', 'warning', 'success', 'danger', 'blocked'.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

MetaCard

class MetaCard(box: str, title: Union[str, NoneType] = None, refresh: Union[int, NoneType] = None, notification: Union[str, NoneType] = None, redirect: Union[str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Represents page-global state.

This card is invisible. It is used to control attributes of the active page.

Static methods

load

def load(_MetaCard__d: Dict) ‑> MetaCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var notification

Display a desktop notification to the user.

var redirect

Redirect the page to a new URL.

var refresh

Refresh rate in seconds. A value of 0 turns off live-updates. Values != 0 are currently ignored (reserved for future use).

var title

The title of the page.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

NavCard

class NavCard(box: str, items: List[NavGroup], commands: Union[List[Command], NoneType] = None)

Create a card containing a navigation pane.

Static methods

load

def load(_NavCard__d: Dict) ‑> NavCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var items

The navigation groups contained in this pane.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

NavGroup

class NavGroup(label: str, items: List[NavItem])

Create a group of navigation items.

Static methods

load

def load(_NavGroup__d: Dict) ‑> NavGroup

Creates an instance of this class using the contents of a dict.

Instance variables

var items

The navigation items contained in this group.

var label

The label to display for this group.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

NavItem

class NavItem(name: str, label: str)

Create a navigation item.

Static methods

load

def load(_NavItem__d: Dict) ‑> NavItem

Creates an instance of this class using the contents of a dict.

Instance variables

var label

The label to display.

var name

The name of this item. Prefix the name with a '#' to trigger hash-change navigation.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Picker

class Picker(name: str, choices: List[Choice], label: Union[str, NoneType] = None, values: Union[List[str], NoneType] = None, max_choices: Union[int, NoneType] = None, disabled: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a picker. Pickers are used to select one or more choices, such as tags or files, from a list. Use a picker to allow the user to quickly search for or manage a few tags or files.

Static methods

load

def load(_Picker__d: Dict) ‑> Picker

Creates an instance of this class using the contents of a dict.

Instance variables

var choices

The choices to be presented.

var disabled

Controls whether the picker should be disabled or not.

var label

Text to be displayed above the component.

var max_choices

Maximum number of selectable choices. Defaults to no limit.

var name

An identifying name for this component.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var values

The names of the selected choices.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

PixelArtCard

class PixelArtCard(box: str, title: str, data: Union[dict, str], commands: Union[List[Command], NoneType] = None)

Create a card displaying a collaborative Pixel art tool, just for kicks.

Static methods

load

def load(_PixelArtCard__d: Dict) ‑> PixelArtCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

The data for this card.

var title

The title for this card.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Plot

class Plot(marks: List[Mark])

Create a plot. A plot is composed of one or more graphical mark layers.

Static methods

load

def load(_Plot__d: Dict) ‑> Plot

Creates an instance of this class using the contents of a dict.

Instance variables

var marks

The graphical mark layers contained in this plot.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

PlotCard

class PlotCard(box: str, title: str, data: Union[dict, str], plot: Plot, commands: Union[List[Command], NoneType] = None)

Create a card displaying a plot.

Static methods

load

def load(_PlotCard__d: Dict) ‑> PlotCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var plot

The plot to be displayed in this card.

var title

The title for this card.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Progress

class Progress(label: str, caption: Union[str, NoneType] = None, value: Union[float, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a progress bar.

Progress bars are used to show the completion status of an operation lasting more than 2 seconds. If the state of progress cannot be determined, do not set a value. Progress bars feature a bar showing total units to completion, and total units finished. The label appears above the bar, and the caption appears below. The label should tell someone exactly what the operation is doing.

Examples of formatting include: [Object] is being [operation name], or [Object] is being [operation name] to [destination name] or [Object] is being [operation name] from [source name] to [destination name]

Status text is generally in units elapsed and total units. Real-world examples include copying files to a storage location, saving edits to a file, and more. Use units that are informative and relevant to give the best idea to users of how long the operation will take to complete. Avoid time units as they are rarely accurate enough to be trustworthy. Also, combine steps of a complex operation into one total bar to avoid “rewinding” the bar. Instead change the label to reflect the change if necessary. Bars moving backwards reduce confidence in the service.

Static methods

load

def load(_Progress__d: Dict) ‑> Progress

Creates an instance of this class using the contents of a dict.

Instance variables

var caption

The text displayed below the bar.

var label

The text displayed above the bar.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var value

The progress, between 0.0 and 1.0, or -1 (default) if indeterminate.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

ProgressTableCellType

class ProgressTableCellType(color: Union[str, NoneType] = None)

Create a cell type that renders a column's cells as progress bars instead of plain text. If set on a column, the cell value must be between 0.0 and 1.0.

Static methods

load

def load(_ProgressTableCellType__d: Dict) ‑> ProgressTableCellType

Creates an instance of this class using the contents of a dict.

Instance variables

var color

Color of the progress arc.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

RangeSlider

class RangeSlider(name: str, label: Union[str, NoneType] = None, min: Union[float, NoneType] = None, max: Union[float, NoneType] = None, step: Union[float, NoneType] = None, min_value: Union[float, NoneType] = None, max_value: Union[float, NoneType] = None, disabled: Union[bool, NoneType] = None, trigger: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a range slider.

A range slider is an element used to select a value range. It provides a visual indication of adjustable content, as well as the current setting in the total range of content. It is displayed as a horizontal track with options on either side. Knobs or levers are dragged to one end or the other to make the choice, indicating the current max and min value.

Static methods

load

def load(_RangeSlider__d: Dict) ‑> RangeSlider

Creates an instance of this class using the contents of a dict.

Instance variables

var disabled

True if this field is disabled.

var label

Text to be displayed alongside the component.

var max

The maximum value of the slider. Defaults to 100.

var max_value

The upper bound of the selected range.

var min

The minimum value of the slider. Defaults to 0.

var min_value

The lower bound of the selected range.

var name

An identifying name for this component.

var step

The difference between two adjacent values of the slider.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var trigger

True if the form should be submitted when the slider value changes.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

RepeatCard

class RepeatCard(box: str, item_view: str, item_props: Union[dict, str], data: Union[Data, str], commands: Union[List[Command], NoneType] = None)

EXPERIMENTAL. DO NOT USE. Create a card containing other cards.

Static methods

load

def load(_RepeatCard__d: Dict) ‑> RepeatCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var item_props

The child card properties.

var item_view

EXPERIMENTAL. DO NOT USE.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Separator

class Separator(label: Union[str, NoneType] = None)

Create a separator.

A separator visually separates content into groups.

Static methods

load

def load(_Separator__d: Dict) ‑> Separator

Creates an instance of this class using the contents of a dict.

Instance variables

var label

The text displayed on the separator.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Slider

class Slider(name: str, label: Union[str, NoneType] = None, min: Union[float, NoneType] = None, max: Union[float, NoneType] = None, step: Union[float, NoneType] = None, value: Union[float, NoneType] = None, disabled: Union[bool, NoneType] = None, trigger: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a slider.

A slider is an element used to set a value. It provides a visual indication of adjustable content, as well as the current setting in the total range of content. It is displayed as a horizontal track with options on either side. A knob or lever is dragged to one end or the other to make the choice, indicating the current value. Marks on the slider bar can show values and users can choose where they want to drag the knob or lever to set the value.

A slider is a good choice when you know that users think of the value as a relative quantity, not a numeric value. For example, users think about setting their audio volume to low or medium — not about setting the value to two or five.

The default value of the slider will be zero or be constrained to the min and max values. The min will be returned if the value is set under the min and the max will be returned if set higher than the max value.

Static methods

load

def load(_Slider__d: Dict) ‑> Slider

Creates an instance of this class using the contents of a dict.

Instance variables

var disabled

True if this field is disabled.

var label

Text to be displayed alongside the component.

var max

The maximum value of the slider.

var min

The minimum value of the slider.

var name

An identifying name for this component.

var step

The difference between two adjacent values of the slider.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var trigger

True if the form should be submitted when the slider value changes.

var value

The current value of the slider.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

SmallSeriesStatCard

class SmallSeriesStatCard(box: str, title: str, value: str, plot_data: Union[Data, str], plot_value: str, plot_zero_value: Union[float, NoneType] = None, plot_category: Union[str, NoneType] = None, plot_type: Union[str, NoneType] = None, plot_curve: Union[str, NoneType] = None, plot_color: Union[str, NoneType] = None, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a small stat card displaying a primary value and a series plot.

Static methods

load

def load(_SmallSeriesStatCard__d: Dict) ‑> SmallSeriesStatCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var plot_category

The data field to use for x-axis values (ignored if plot_type is area; must be provided if plot_type is interval). Defaults to 'x'.

var plot_color

The plot's color.

var plot_curve

The plot's curve style. Defaults to linear. One of 'linear', 'smooth', 'step', 'step-after', 'step-before'.

var plot_data

The plot's data.

var plot_type

The type of plot. Defaults to area. One of 'area', 'interval'.

var plot_value

The data field to use for y-axis values.

var plot_zero_value

The base value to use for each y-axis mark. Set this to 0 if you want to pin the x-axis at y=0. If not provided, the minimum value from the data is used.

var title

The card's title.

var value

The primary value displayed.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

SmallStatCard

class SmallStatCard(box: str, title: str, value: str, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a stat card displaying a single value.

Static methods

load

def load(_SmallStatCard__d: Dict) ‑> SmallStatCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var title

The card's title.

var value

The primary value displayed.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Spinbox

class Spinbox(name: str, label: Union[str, NoneType] = None, min: Union[float, NoneType] = None, max: Union[float, NoneType] = None, step: Union[float, NoneType] = None, value: Union[float, NoneType] = None, disabled: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a spinbox.

A spinbox allows the user to incrementally adjust a value in small steps. It is mainly used for numeric values, but other values are supported too.

Static methods

load

def load(_Spinbox__d: Dict) ‑> Spinbox

Creates an instance of this class using the contents of a dict.

Instance variables

var disabled

True if this field is disabled.

var label

Text to be displayed alongside the component.

var max

The maximum value of the spinbox.

var min

The minimum value of the spinbox.

var name

An identifying name for this component.

var step

The difference between two adjacent values of the spinbox.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var value

The current value of the spinbox.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Step

class Step(label: str, icon: Union[str, NoneType] = None, done: Union[bool, NoneType] = None)

Create a step for a stepper.

Static methods

load

def load(_Step__d: Dict) ‑> Step

Creates an instance of this class using the contents of a dict.

Instance variables

var done

Indicates whether this step has already been completed.

var icon

Icon to be displayed.

var label

Text displayed below icon.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Stepper

class Stepper(name: str, items: List[Step], tooltip: Union[str, NoneType] = None)

Create a component that displays a sequence of steps in a process. The steps keep users informed about where they are in the process and how much is left to complete.

Static methods

load

def load(_Stepper__d: Dict) ‑> Stepper

Creates an instance of this class using the contents of a dict.

Instance variables

var items

The sequence of steps to be displayed.

var name

An identifying name for this component.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Tab

class Tab(name: str, label: Union[str, NoneType] = None, icon: Union[str, NoneType] = None)

Create a tab.

Static methods

load

def load(_Tab__d: Dict) ‑> Tab

Creates an instance of this class using the contents of a dict.

Instance variables

var icon

The icon displayed on the tab.

var label

The text displayed on the tab.

var name

An identifying name for this component.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

TabCard

class TabCard(box: str, items: List[Tab], value: Union[str, NoneType] = None, link: Union[bool, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a card containing tabs for navigation.

Static methods

load

def load(_TabCard__d: Dict) ‑> TabCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var items

Items to render.

True if tabs should be rendered as links and not a standard tab.

var value

The name of the tab to select.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Table

class Table(name: str, columns: List[TableColumn], rows: List[TableRow], multiple: Union[bool, NoneType] = None, groupable: Union[bool, NoneType] = None, downloadable: Union[bool, NoneType] = None, resettable: Union[bool, NoneType] = None, height: Union[str, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create an interactive table.

This table differs from a markdown table in that it supports clicking or selecting rows. If you simply want to display a non-interactive table of information, use a markdown table.

If multiple is set to False (default), each row in the table is clickable. When a row is clicked, the form is submitted automatically, and q.args.table_name is set to [row_name], where table_name is the name of the table, and row_name is the name of the row that was clicked on.

If multiple is set to True, each row in the table is selectable. A row can be selected by clicking on it. Multiple rows can be selected either by shift+clicking or using marquee selection. When the form is submitted,q.args.table_name is set to [row1_name, row2_name, …] where table_name is the name of the table, and row1_name, row2_name are the name of the rows that were selected. Note that if multiple is set to True, the form is not submitted automatically, and one or more buttons are required in the form to trigger submission.

Static methods

load

def load(_Table__d: Dict) ‑> Table

Creates an instance of this class using the contents of a dict.

Instance variables

var columns

The columns in this table.

var downloadable

Indicates whether the contents of this table can be downloaded and saved as a CSV file. Defaults to False.

var groupable

True to allow group by feature.

var height

The height of the table, e.g. '400px', '50%', etc.

var multiple

True to allow multiple rows to be selected.

var name

An identifying name for this component.

var resettable

Indicates whether a Reset button should be displayed to reset search / filter / group-by values to their defaults. Defaults to False.

var rows

The rows in this table.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

TableCellType

class TableCellType(progress: Union[ProgressTableCellType, NoneType] = None, icon: Union[IconTableCellType, NoneType] = None)

Defines cell content to be rendered instead of a simple text.

Static methods

load

def load(_TableCellType__d: Dict) ‑> TableCellType

Creates an instance of this class using the contents of a dict.

Instance variables

var icon

No documentation available.

var progress

No documentation available.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

TableColumn

class TableColumn(name: str, label: str, min_width: Union[str, NoneType] = None, max_width: Union[str, NoneType] = None, sortable: Union[bool, NoneType] = None, searchable: Union[bool, NoneType] = None, filterable: Union[bool, NoneType] = None, link: Union[bool, NoneType] = None, cell_type: Union[TableCellType, NoneType] = None)

Create a table column.

Static methods

load

def load(_TableColumn__d: Dict) ‑> TableColumn

Creates an instance of this class using the contents of a dict.

Instance variables

var cell_type

Defines how to render each cell in this column. Defaults to plain text.

var filterable

Indicates whether the contents of this column are displayed as filters in a dropdown.

var label

The text displayed on the column header.

Indicates whether each cell in this column should be displayed as a clickable link.

var max_width

The maximum width of this column, e.g. '100px'. Only px units are supported at this time.

var min_width

The minimum width of this column, e.g. '50px'. Only px units are supported at this time.

var name

An identifying name for this column.

var searchable

Indicates whether the contents of this column can be searched through. Enables a search box for the table if true.

var sortable

Indicates whether the column is sortable.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

TableRow

class TableRow(name: str, cells: List[str])

Create a table row.

Static methods

load

def load(_TableRow__d: Dict) ‑> TableRow

Creates an instance of this class using the contents of a dict.

Instance variables

var cells

The cells in this row (displayed left to right).

var name

An identifying name for this row.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Tabs

class Tabs(name: str, value: Union[str, NoneType] = None, items: Union[List[Tab], NoneType] = None)

Create a tab bar.

Static methods

load

def load(_Tabs__d: Dict) ‑> Tabs

Creates an instance of this class using the contents of a dict.

Instance variables

var items

The tabs in this tab bar.

var name

An identifying name for this component.

var value

The name of the tab to select.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

TallGaugeStatCard

class TallGaugeStatCard(box: str, title: str, value: str, aux_value: str, progress: float, plot_color: Union[str, NoneType] = None, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a tall stat card displaying a primary value, an auxiliary value and a progress gauge.

Static methods

load

def load(_TallGaugeStatCard__d: Dict) ‑> TallGaugeStatCard

Creates an instance of this class using the contents of a dict.

Instance variables

var aux_value

The auxiliary value displayed next to the primary value.

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var plot_color

The color of the progress gauge.

var progress

The value of the progress gauge, between 0 and 1.

var title

The card's title.

var value

The primary value displayed.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

TallSeriesStatCard

class TallSeriesStatCard(box: str, title: str, value: str, aux_value: str, plot_data: Union[Data, str], plot_value: str, plot_zero_value: Union[float, NoneType] = None, plot_category: Union[str, NoneType] = None, plot_type: Union[str, NoneType] = None, plot_curve: Union[str, NoneType] = None, plot_color: Union[str, NoneType] = None, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a tall stat card displaying a primary value, an auxiliary value and a series plot.

Static methods

load

def load(_TallSeriesStatCard__d: Dict) ‑> TallSeriesStatCard

Creates an instance of this class using the contents of a dict.

Instance variables

var aux_value

The auxiliary value displayed below the primary value.

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var plot_category

The data field to use for x-axis values (ignored if plot_type is area; must be provided if plot_type is interval). Defaults to 'x'.

var plot_color

The plot's color.

var plot_curve

The plot's curve style. Defaults to linear. One of 'linear', 'smooth', 'step', 'step-after', 'step-before'.

var plot_data

The plot's data.

var plot_type

The type of plot. Defaults to area. One of 'area', 'interval'.

var plot_value

The data field to use for y-axis values.

var plot_zero_value

The base value to use for each y-axis mark. Set this to 0 if you want to pin the x-axis at y=0. If not provided, the minimum value from the data is used.

var title

The card's title.

var value

The primary value displayed.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Template

class Template(content: str, data: Union[dict, str, NoneType] = None)

Render dynamic content using a HTML template.

Static methods

load

def load(_Template__d: Dict) ‑> Template

Creates an instance of this class using the contents of a dict.

Instance variables

var content

The Handlebars template. https://handlebarsjs.com/guide/

var data

Data for the Handlebars template

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

TemplateCard

class TemplateCard(box: str, title: str, content: str, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Render dynamic content using a HTML template.

Static methods

load

def load(_TemplateCard__d: Dict) ‑> TemplateCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var content

The Handlebars template. https://handlebarsjs.com/guide/

var data

Data for the Handlebars template

var title

The title for this card.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Text

class Text(content: str, size: Union[str, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create text content.

Static methods

load

def load(_Text__d: Dict) ‑> Text

Creates an instance of this class using the contents of a dict.

Instance variables

var content

The text content.

var size

The font size of the text content. One of 'xl', 'l', 'm', 's', 'xs'.

var tooltip

Tooltip message.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

TextL

class TextL(content: str, tooltip: Union[str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create large sized text content.

Static methods

load

def load(_TextL__d: Dict) ‑> TextL

Creates an instance of this class using the contents of a dict.

Instance variables

var commands

Contextual menu commands for this component.

var content

The text content.

var tooltip

Tooltip message.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

TextM

class TextM(content: str, tooltip: Union[str, NoneType] = None)

Create medium sized text content.

Static methods

load

def load(_TextM__d: Dict) ‑> TextM

Creates an instance of this class using the contents of a dict.

Instance variables

var content

The text content.

var tooltip

Tooltip message.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

TextS

class TextS(content: str, tooltip: Union[str, NoneType] = None)

Create small sized text content.

Static methods

load

def load(_TextS__d: Dict) ‑> TextS

Creates an instance of this class using the contents of a dict.

Instance variables

var content

The text content.

var tooltip

Tooltip message.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

TextXl

class TextXl(content: str, tooltip: Union[str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create extra-large sized text content.

Static methods

load

def load(_TextXl__d: Dict) ‑> TextXl

Creates an instance of this class using the contents of a dict.

Instance variables

var commands

Contextual menu commands for this component.

var content

The text content.

var tooltip

Tooltip message.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

TextXs

class TextXs(content: str, tooltip: Union[str, NoneType] = None)

Create extra-small sized text content.

Static methods

load

def load(_TextXs__d: Dict) ‑> TextXs

Creates an instance of this class using the contents of a dict.

Instance variables

var content

The text content.

var tooltip

Tooltip message.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Textbox

class Textbox(name: str, label: Union[str, NoneType] = None, placeholder: Union[str, NoneType] = None, value: Union[str, NoneType] = None, mask: Union[str, NoneType] = None, icon: Union[str, NoneType] = None, prefix: Union[str, NoneType] = None, suffix: Union[str, NoneType] = None, error: Union[str, NoneType] = None, required: Union[bool, NoneType] = None, disabled: Union[bool, NoneType] = None, readonly: Union[bool, NoneType] = None, multiline: Union[bool, NoneType] = None, password: Union[bool, NoneType] = None, trigger: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a text box.

The text box component enables a user to type text into an app. It's typically used to capture a single line of text, but can be configured to capture multiple lines of text. The text displays on the screen in a simple, uniform format.

Static methods

load

def load(_Textbox__d: Dict) ‑> Textbox

Creates an instance of this class using the contents of a dict.

Instance variables

var disabled

True if the text box is disabled.

var error

Text to be displayed as an error below the text box.

var icon

Icon displayed in the far right end of the text field.

var label

The text displayed above the field.

var mask

The masking string that defines the mask's behavior. A backslash will escape any character. Special format characters are: '9': [0-9] 'a': [a-zA-Z] '*': [a-zA-Z0-9].

var multiline

True if the text box should allow multi-line text entry.

var name

An identifying name for this component.

var password

True if the text box should hide text content.

var placeholder

A string that provides a brief hint to the user as to what kind of information is expected in the field. It should be a word or short phrase that demonstrates the expected type of data, rather than an explanatory message.

var prefix

Text to be displayed before the text box contents.

var readonly

True if the text box is a read-only field.

var required

True if the text box is a required field.

var suffix

Text to be displayed after the text box contents.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var trigger

True if the form should be submitted when the text value changes.

var value

Text to be displayed inside the text box.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Toggle

class Toggle(name: str, label: Union[str, NoneType] = None, value: Union[bool, NoneType] = None, disabled: Union[bool, NoneType] = None, trigger: Union[bool, NoneType] = None, tooltip: Union[str, NoneType] = None)

Create a toggle. Toggles represent a physical switch that allows users to turn things on or off. Use toggles to present users with two mutually exclusive options (like on/off), where choosing an option results in an immediate action.

Use a toggle for binary operations that take effect right after the user flips the Toggle. For example, use a Toggle to turn services or hardware components on or off. In other words, if a physical switch would work for the action, a Toggle is probably the best component to use.

Static methods

load

def load(_Toggle__d: Dict) ‑> Toggle

Creates an instance of this class using the contents of a dict.

Instance variables

var disabled

True if the checkbox is disabled.

var label

Text to be displayed alongside the component.

var name

An identifying name for this component.

var tooltip

An optional tooltip message displayed when a user clicks the help icon to the right of the component.

var trigger

True if the form should be submitted when the toggle value changes.

var value

True if selected, False if unselected.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

ToolbarCard

class ToolbarCard(box: str, items: List[Command], secondary_items: Union[List[Command], NoneType] = None, overflow_items: Union[List[Command], NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a card containing a toolbar.

Static methods

load

def load(_ToolbarCard__d: Dict) ‑> ToolbarCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var items

Items to render.

var overflow_items

Items to render in an overflow menu.

var secondary_items

Items to render on the right side (or left, in RTL).

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

VegaCard

class VegaCard(box: str, title: str, specification: str, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a card containing a Vega-lite plot.

Static methods

load

def load(_VegaCard__d: Dict) ‑> VegaCard

Creates an instance of this class using the contents of a dict.

Instance variables

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for the plot, if any.

var specification

The Vega-lite specification.

var title

The title of this card.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

VegaVisualization

class VegaVisualization(specification: str, data: Union[dict, str, NoneType] = None, width: Union[str, NoneType] = None, height: Union[str, NoneType] = None)

Create a Vega-lite plot for display inside a form.

Static methods

load

def load(_VegaVisualization__d: Dict) ‑> VegaVisualization

Creates an instance of this class using the contents of a dict.

Instance variables

var data

Data for the plot, if any.

var height

The height of the visualization. Defaults to 300px.

var specification

The Vega-lite specification.

var width

The width of the visualization. Defaults to 100%.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

Visualization

class Visualization(plot: Plot, data: Union[dict, str], width: Union[str, NoneType] = None, height: Union[str, NoneType] = None)

Create a visualization for display inside a form.

Static methods

load

def load(_Visualization__d: Dict) ‑> Visualization

Creates an instance of this class using the contents of a dict.

Instance variables

var data

Data for this visualization.

var height

The height of the visualization. Defaults to 300px.

var plot

The plot to be rendered in this visualization.

var width

The width of the visualization. Defaults to 100%.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

WideBarStatCard

class WideBarStatCard(box: str, title: str, value: str, aux_value: str, progress: float, plot_color: Union[str, NoneType] = None, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a wide stat card displaying a primary value, an auxiliary value and a progress bar.

Static methods

load

def load(_WideBarStatCard__d: Dict) ‑> WideBarStatCard

Creates an instance of this class using the contents of a dict.

Instance variables

var aux_value

The auxiliary value displayed next to the primary value.

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var plot_color

The color of the progress bar.

var progress

The value of the progress bar, between 0 and 1.

var title

The card's title.

var value

The primary value displayed.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

WideGaugeStatCard

class WideGaugeStatCard(box: str, title: str, value: str, aux_value: str, progress: float, plot_color: Union[str, NoneType] = None, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a wide stat card displaying a primary value, an auxiliary value and a progress gauge.

Static methods

load

def load(_WideGaugeStatCard__d: Dict) ‑> WideGaugeStatCard

Creates an instance of this class using the contents of a dict.

Instance variables

var aux_value

The auxiliary value displayed next to the primary value.

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var plot_color

The color of the progress gauge.

var progress

The value of the progress gauge, between 0 and 1.

var title

The card's title.

var value

The primary value displayed.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.

WideSeriesStatCard

class WideSeriesStatCard(box: str, title: str, value: str, aux_value: str, plot_data: Union[Data, str], plot_value: str, plot_zero_value: Union[float, NoneType] = None, plot_category: Union[str, NoneType] = None, plot_type: Union[str, NoneType] = None, plot_curve: Union[str, NoneType] = None, plot_color: Union[str, NoneType] = None, data: Union[dict, str, NoneType] = None, commands: Union[List[Command], NoneType] = None)

Create a wide stat card displaying a primary value, an auxiliary value and a series plot.

Static methods

load

def load(_WideSeriesStatCard__d: Dict) ‑> WideSeriesStatCard

Creates an instance of this class using the contents of a dict.

Instance variables

var aux_value

The auxiliary value displayed below the primary value.

var box

A string indicating how to place this component on the page.

var commands

Contextual menu commands for this component.

var data

Data for this card.

var plot_category

The data field to use for x-axis values (ignored if plot_type is area; must be provided if plot_type is interval). Defaults to 'x'.

var plot_color

The plot's color.

var plot_curve

The plot's curve style. Defaults to linear. One of 'linear', 'smooth', 'step', 'step-after', 'step-before'.

var plot_data

The plot's data.

var plot_type

The type of plot. Defaults to area. One of 'area', 'interval'.

var plot_value

The data field to use for y-axis values.

var plot_zero_value

The base value to use for each y-axis mark. Set this to 0 if you want to pin the x-axis at y=0. If not provided, the minimum value from the data is used.

var title

The card's title.

var value

The primary value displayed.

Methods

dump

def dump(self) ‑> Dict

Returns the contents of this object as a dict.