OudsLinearProgressIndicator class

Reference design version : 1.0.0

A linear progress indicator that shows the progress of a task as a horizontal bar. Supports both determinate and indeterminate modes and is best placed inside layouts where vertical space is available.

The component can optionally display:

• a stop indicator at the end of the active bar,
• helper text below the indicator,
• a percentage value,
• and custom horizontal alignment for the helper text.

Parameters

• progressType: Determinate or indeterminate display mode.
• status: Visual color status. Non-semantic (Neutral, Accent) for standard progress; semantic (Positive, Warning, Negative, Info) when the operation carries a meaning.
• animated: Enables smooth value-change animation (determinate only). Automatically disabled when the OS reduced-motion setting is on.
• value: Value between 0.0 and 1.0. Pass null for indeterminate.
• gapSize: Gap between the active bar and its track — OudsProgressIndicatorGapSize.
• track: Whether the background track bar is visible.
• semanticsLabel: Accessibility label for assistive technologies.
• stopIndicator: Displays a square (or circle when rounded) block at the end of the active bar.
• helperText: Optional OudsLinearProgressIndicatorHelperText displayed below the indicator, combining the progress percentage and/or a label. See OudsLinearProgressIndicatorHelperText for the alignment rules.

Example

OudsLinearProgressIndicator(
  progressType: OudsProgressIndicatorType.determinate,
  status: Positive(),
  value: 0.8,
  track: true,
  animated: true,
  stopIndicator: false,
  helperText: OudsLinearProgressIndicatorHelperText(
    label: 'Uploading file',
  ),
)