MenuStyle

Defines the visual style/appearance of a menu.

Properties

• alignment(Alignment | None) –

  Determines the desired alignment of the submenu when opened relative to

• bgcolor(ControlStateValue[ColorValue] | None) –

  The menu's background fill color.

• elevation(ControlStateValue[Number | None] | None) –

  The menu's elevation, i.e. the size of the shadow below the menu.

• fixed_size(ControlStateValue[Size] | None) –

  The menu's size.

• max_size(ControlStateValue[Size] | None) –

  The maximum size of the menu itself.

• min_size(ControlStateValue[Size] | None) –

  The minimum size of the menu itself.

• mouse_cursor(ControlStateValue[MouseCursor] | None) –

  The cursor for a mouse pointer when it enters or is hovering over the menu.

• padding(ControlStateValue[PaddingValue] | None) –

  The padding between the menu's boundary and its child.

• shadow_color(ControlStateValue[ColorValue] | None) –

  The shadow color of the menu

• shape(ControlStateValue[OutlinedBorder] | None) –

  The menu's shape.

• side(ControlStateValue[BorderSide] | None) –

  The color and weight of the menu's outline.

• visual_density(VisualDensity | None) –

  Defines how compact the menu's layout will be.

Properties

alignment class-attribute instance-attribute

alignment: Alignment | None = None

Determines the desired alignment of the submenu when opened relative to the button that opens it.

If there isn't sufficient space to open the menu with the given alignment, and there's space on the other side of the button, then the alignment is swapped to it's opposite (1 becomes -1, etc.), and the menu will try to appear on the other side of the button. If there isn't enough space there either, then the menu will be pushed as far over as necessary to display as much of itself as possible, possibly overlapping the parent button.

bgcolor class-attribute instance-attribute

bgcolor: ControlStateValue[ColorValue] | None = None

The menu's background fill color.

elevation class-attribute instance-attribute

elevation: ControlStateValue[Number | None] | None = None

The menu's elevation, i.e. the size of the shadow below the menu.

fixed_size class-attribute instance-attribute

fixed_size: ControlStateValue[Size] | None = None

The menu's size.

This size is still constrained by the style's min_size and max_size. Fixed size dimensions whose value is float('inf') are ignored.

To specify menus with a fixed width and the default height use Size.from_width(320). Similarly, to specify a fixed height and the default width use Size.from_height(100).

max_size class-attribute instance-attribute

max_size: ControlStateValue[Size] | None = None

The maximum size of the menu itself.

A Size.infinite or None value for this property means that the menu's maximum size is not constrained.

This value must be greater than or equal to min_size.

min_size class-attribute instance-attribute

min_size: ControlStateValue[Size] | None = None

The minimum size of the menu itself.

This value must be less than or equal to max_size.

mouse_cursor class-attribute instance-attribute

mouse_cursor: ControlStateValue[MouseCursor] | None = None

The cursor for a mouse pointer when it enters or is hovering over the menu.

padding class-attribute instance-attribute

padding: ControlStateValue[PaddingValue] | None = None

The padding between the menu's boundary and its child.

shadow_color class-attribute instance-attribute

shadow_color: ControlStateValue[ColorValue] | None = None

The shadow color of the menu

The material's elevation shadow can be difficult to see for dark themes, so by default the menu classes add a semi-transparent overlay to indicate elevation.

shape class-attribute instance-attribute

shape: ControlStateValue[OutlinedBorder] | None = None

The menu's shape.

This shape is combined with side to create a shape decorated with an outline.

side class-attribute instance-attribute

side: ControlStateValue[BorderSide] | None = None

The color and weight of the menu's outline.

This value is combined with shape to create a shape decorated with an outline.

visual_density class-attribute instance-attribute

visual_density: VisualDensity | None = None

Defines how compact the menu's layout will be.