Skip to main content

 

 

 

 

Template:OutSystems/Documentation_KB/Breadcrumb_New_Layout

 

 

Template:OutSystems/OSLanguageSwitcher

 

Applies only to Mobile Apps and Reactive Web Apps

 

 

OutSystems

Progress Circle Fraction

Template:OutSystems/Documentation_KB/ContentCollaboration
  • Edit
    Collaborate with us
    Edit this page on GitHub
  • Use the Progress Circle Fraction UI Pattern to show the current progress of an operation flow. The progress is incremented in fractions of the circular badge.

    How to use the Progress Circle UI Pattern

    In this example, we create a button that increments the progress circle fraction each time it's clicked.

    1. In Service Studio, in the Toolbox, search for Progress Circle Fraction.

      The Progress Circle Fraction widget is displayed.

    2. From the Toolbox, drag the Progress Circle Fraction widget into the Main Content area of your application's screen.

    3. Right-click your screen name, select Add Local Variable, and enter a name. In this example, we enter Count.

    4. Select the Progress Circle widget, and on the Properties tab, enter values for the Numerator and Denominator properties.

      In this example, we enter the Count variable as the numerator value, and 25 as the denominator value.

    5. From the Toolbox, drag the Button widget into the Main Content area of your application's screen. In this example, call the button Increment and set the On Click property to a New Client Action that assigns the Count variable to Count + 1.

    6. Select the Progress Circle Fraction widget, and on the Properties tab, you can change the Progress Circle Fraction's look and feel by setting the (optional) properties, for example, the color settings.

    After following these steps and publishing the module, you can test the pattern in your app. The result of this example should look someting like the following:

    Properties

    Property Description
    Progress (Integer): Mandatory Progress percentage to display. You can use functions or local variables. Usually a number between 0 and 100.
    Text (Text): Optional Text that displays inside the circle. If no text is specified, the progress percentage is displayed.
    ProgressColor (Text): Optional The color of the stroke on progress circle. The default value is: "rgba (0,0,0,0.6)".
    TrailColor (Text): Optional The color of the empty part of the progress circle. The default value is "rgba (0,0,0,0.2)".
    TextColor (Text): Optional The color of the text inside the circle. The default value is "#333".
    CircleThickness (Integer): Optional The thickness of the circle that marks the progress.

    Examples

    • Blank - The circle thickness is 8px. This is the default value.
    • 4 - The circle thickness is 8px.
    AnimateInitialProgress (Boolean): Optional If set to True, the progress from zero to the progress value is animated. This is the default. If set to False, the progress is not animated.
    ExtendedClass (Text): Optional Add custom style classes to the Progress Circle UI Pattern. You define your custom style classes in your application using CSS.

    Examples

    • Blank - No custom styles are added (default value).
    • "myclass" - Adds the myclass style to the Progress Circle UI styles being applied.
    • "myclass1" "myclass2" - Adds the myclass1 and myclass2 styles to the Progress Circle UI styles being applied.
    • Was this article helpful?