Progress Bar widget

The progress bar widget can be used for any number field (integer or decimal) both in a form view and a grid view and graphically represents a percentage increase. Graphics rendering is enabled only when the field is read-only. In editable mode, the numeric value is displayed.

The possible values and the colors are configurable.

Definition:

<field name="progress" title="Progress" widget="Progress[min=5|max=90|colors=r:10,y:30,b:50,g:70]"/>

If minimum and maximum are provided, the value of the field is converted into a percentage using the formula:

(Value 100) / (max - min)*

The default values of the minimum and maximum are 0 and 100 if not provided.

The color of the progress bar can be set with the four colors below:

• red (r) - if percentage value in range [0, 10]
• yellow (y) - if percentage value in range [11, 30]
• blue (b) - if percentage value in range [31, 50]
• green (g) - if percentage value in range [51, 100]

Only four colors are available. The order of the colors can be changed but the terminals must be entered in ascending order.

Rendering example: