Novadesk Docs

Appearance

RoundLine Element ​

Rounded arc elements (RoundLine) visualize progress with configurable angles and stroke styles.

Create one with ui.addRoundLine() and the shared General Elements Options.

js
ui.addRoundLine(options);

Table of Contents ​

RoundLine Options ​

value ​

  • Type: number
  • Default: 0.0
  • Description: Fill level (0.0 empty, 1.0 full).

radius ​

  • Type: number
  • Default: 0
  • Description: Arc radius; derived from width/height when 0.

thickness ​

  • Type: number
  • Default: 2
  • Description: Stroke thickness.

endThickness ​

  • Type: number
  • Default: -1
  • Description: Overwrites the end thickness when positive; -1 matches thickness.

startAngle ​

  • Type: number
  • Default: 0.0
  • Description: Start angle in degrees (0 = 12 o’clock).

totalAngle ​

  • Type: number
  • Default: 360.0
  • Description: Sweep angle in degrees.

clockwise ​

  • Type: boolean
  • Default: true
  • Description: Sweep direction.

capType ​

  • Type: string
  • Default: "flat"
  • Description: Sets both start and end caps.

Valid values ​

  • "flat"
  • "round"

startCap ​

  • Type: string
  • Default: "flat"
  • Description: Overrides capType for the start cap.

endCap ​

  • Type: string
  • Default: "flat"
  • Description: Overrides capType for the end cap.

dashArray ​

  • Type: string
  • Default: ""
  • Description: Comma-separated dash pattern (e.g., "10, 5").

ticks ​

  • Type: number
  • Default: 0
  • Description: Adds tick marks along the arc.

lineColor ​

  • Type: string
  • Default: "rgb(0, 255, 0)"
  • Description: Foreground arc color or gradient.

lineColorBg ​

  • Type: string
  • Default: "rgb(50, 50, 50)"
  • Description: Background arc color or gradient.

Example ​

javascript
import { widgetWindow } from "novadesk";

var exampleRoundLineWindow = new widgetWindow({
    id: "exampleRoundLine",
    width: 300,
    height: 200,
    backgroundColor: "rgba(20, 20, 20, 1)",
    script: "ui/script.ui.js"
});