Progress Circle

Last update: Edit

1 Introduction

The Progress Circle widget displays a progress in a circle.

1.1 Features

  • Show percentage based on the progress value and maximum progress value
  • Animate on load and on update
  • Open a page or run a microflow on click
  • Show the progress circle with different colors

1.2 Demo App Project

For a demo app project that has been deployed with this widget, see here.

2 Usage

Place the widget in the context of an object that has attributes for Value attribute and Maximum value attribute: * If Value attribute is not set, Value static will be used to calculate the progress * If Maximum value attribute is not set, the maximum value defaults to Maximum value static

3 Developing This App Store Component

  1. Install the following:
  2. Fork and clone the mendixlabs/progress-circle repository. The code is in Typescript.
  3. Set up the development environment by running npm install.
  4. Create a folder named dist in the project root.
  5. Create a Mendix test project in the dist folder and rename its root folder to dist/MxTestProject, or get the test project from mendixlabs/progress-circle. Changes to the widget code will be automatically pushed to this test project.
  6. To automatically compile, bundle, and push code changes to the running test project, run grunt.
  7. To run the project unit tests with code coverage (results can be found at dist/testresults/coverage/index.html), run: npm test
  8. Run the test continuously during development via karma start.

We are actively maintaining this widget. Please report any issues or suggestions for improvement at mendixlabs/progress-circle.