OudsLinearProgressIndicatorHelperText class

Optional helper text displayed below an OudsLinearProgressIndicator.

The helper text can show the progress value formatted as a percentage (progress), a custom label, or both at once.

Alignment rules

• progressAlignment and labelAlignment each control where their own item is positioned (start, center or end) when that item is the only one displayed.
• By default, only the progress percentage is shown, centered below the indicator (progressAlignment defaults to OudsProgressIndicatorHelperTextAlignment.center).
• When both progress and label would be displayed and one of them requests OudsProgressIndicatorHelperTextAlignment.center, that one is shown alone (centered) and the other is silently ignored — a centered item cannot share the line with another item.
• When both are displayed and neither requests center, label is positioned according to labelAlignment — start or end — and the progress percentage automatically takes the opposite side (progressAlignment is ignored in that case).

The progress percentage is never shown when the indicator is indeterminate (progressType: OudsProgressIndicatorType.indeterminate), since there is no meaningful value to format — only label is displayed in that case.

Example

OudsLinearProgressIndicator(
  value: 0.75,
  helperText: OudsLinearProgressIndicatorHelperText(
    label: 'Uploading file',
    labelAlignment: OudsProgressIndicatorHelperTextAlignment.end,
  ),
)