Widgets

CupertinoAppBar

CupertinoAppBar

CupertinoAppBar control. Build it with the cupertino_app_bar helper.

Example

cupertino_app_bar(
  title: text("Title"),
  leading: icon("menu"),
  trailing: icon("chevron_right"),
  bgcolor: :surface_container_high
)

Properties

  • automatic_background_visibility — Sets the automatic background visibility property.
  • automatically_imply_leading — Sets the automatically imply leading property.
  • automatically_imply_title — Sets the automatically imply title property.
  • bgcolor — Background color.
  • border — Border definition.
  • brightness — Sets the brightness property.
  • enable_background_filter_blur — Sets the enable background filter blur property.
  • large — Sets the large property.
  • leading — Control placed before the main content (e.g. an icon or avatar).
  • padding — Inner spacing between the border and the content.
  • previous_page_title — Sets the previous page title property.
  • title — The control shown as the title.
  • trailing — Control placed after the main content.
  • transition_between_routes — Sets the transition between routes property.

Common layout and animation properties

  • badge — Badge drawn on the corner of the control.
  • col — Responsive column span (1-12) per breakpoint.
  • data — Arbitrary value you can attach to the control and read back in handlers.
  • disabled — Disables interaction when true.
  • expand — Fills the available space along the parent's main axis when true.
  • expand_loose — Like expand, but only grows up to the child's natural size.
  • key — Stable identity used to preserve state across rebuilds.
  • opacity — Opacity from 0.0 (transparent) to 1.0 (opaque).
  • rtl — Renders right-to-left when true.
  • tooltip — Text shown on hover/long-press.
  • visible — Hides the control when false.

Reference

  • Family: cupertinos
  • Widget type: cupertinoappbar
  • Helpers: cupertino_app_bar, cupertinoappbar