Design/Whiteboards/Progress Indicators

    From The Document Foundation Wiki

    This page was marked as inactive and is retained for historical reference.
    Either the page is no longer relevant or consensus on its purpose has become unclear. To revive discussion, seek broader input via a forum such as one of our mailing lists.


    This whiteboard page derived from a "Calc performance" related discussion. It was concluded that progress bar drawing consumes a lot of time - so a few proposals were made (visual design, behavioral design). See also the discuson thread Performance improvements for calcs' sheet actions .

    Specifications and Related Documents

    UI Related Specifications

    Human Interaction Guidelines (Progress Bars):

    Text (General):

    Related Documents

    Collection of progress indicators: Matthias Müller Prove: Progress Indicators in (OOo Specification Project), October 2007


    Progress Bar in Status Bar


    Example for Writer loading a document (LibreOffice 3.3.2 on Ubuntu) ...

    DesignTeam Whiteboard ProgressIndicators StatusBar Example.png
    [ $ProgressText... OOOOOOOOOOOOOooooooooooooooooooooooooooooooooooooooooooooo ]

    The progress bar spans the full width of the status bar. Symbols:

    • [ = status bar area start
    • $ProgressText = text explaining the current action
    • ... = ellipsis (without space between $ProgressText and ellipsis according UITSG, required for such actions, may already be contained in $ProgressText)
    • O = progress bar "done"
    • o = progress bar "todo"
    • ] = status bar area end

    Proposed Behavior


    • Progress bar will be right-aligned (distance to the right like today)
    • Width of the progress bar is 200px
    • $ProgressText is right aligned to the progress bar (distance to the right like today)
    [                                             $ProgressText... OOOOOooooooooo ]

    Few Space: If the width of the status bar does not allow to show all items, then ...

    • Reduce the width of the progress bar to to show the full text
    • The minimum width of the progress bar is 50px
                                                      [ $ProgressText... OOoooooo ]

    Open Questions

    • Is there a need to define the behavior if there is even less space (very small status bar)? Currently, the status bar items are simply "cut off".
    • Currently we remove all items in the status when a progress bar is being shown. Are there any actions that (theoretically) could be performed while an action performs (e.g. using the zoom slider during loading a document)?

    Design Rationale

    • Position of the text: $ProgressText shall be placed  to the left of the progress bar (GHIG, WUXIG)
    • Size of the progress bar: The 200px are a rough guess what might be looking good - it is a bit larger then the zoom slider (approx 185px).
    • Position of the progress bar:
      • The position and size of the progress bar is always constant and thus predictable for the user (easier to guess the current progress). Furthermore, progress bars for subsequent items don't move the progress bars (e.g. Calc; first loading, then calculating the document).
      • Enables to add (later) an abort button which position is always the same (at the right side)
      • Note: It is accepted that the readability of the text is reduced, due to the different positions (length of the progress text varies)

    Related Issues

    General: Issue Tracker:

    • i#111905 - Save progress bar should remain until UI is enabled
    • i#19986 - progress bar/indicator needed during data insert in Calc
    • i#13402 - improve the open/save progress bar

    LibreOffice Issue Tracker:

    • tdf#32476 - No progress bar when opening password protected documents from WIN Explorer