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.
• semanticLabel: Accessibility label for assistive technologies.
• stopIndicator: Displays a square (or circle when rounded) block at the end of the active bar.
• helperText: Optional text displayed below the indicator.
• helperTextAlignment: Horizontal alignment of the helper text — OudsProgressIndicatorHelperTextAlignment.
• percentage: When true, the helper text is generated from value and formatted as a percentage; when false, helperText is used.
• spaceBeforePercentage: Inserts a non-breaking space before the % symbol when percentage is true (e.g. 75 % instead of 75%).

Example

OudsLinearProgressIndicator(
  progressType: OudsProgressIndicatorType.determinate,
  status: Positive(),
  progress: 0.8,
  track: true,
  animated: true,
  stopIndicator: false,
  helperText: 'Uploading file',
  helperTextAlignment: OudsProgressIndicatorHelperTextAlignment.center,
  percentage: false,
  spaceBeforePercentage: false,
)