slider · H3lp Yours3lf Docs

Builds a meter-based horizontal track. Pointer presses and drags map to min..max, clamp to the range, and optionally round to step.

Example

local util = require 'openmw.util'

local value = 50
local readout = ui.text {
  text = '50%',
}

ui.column {
  children = {
    ui.slider {
      value = value,
      min = 0,
      max = 100,
      step = 5,
      props = {
        size = util.vector2(240, 18),
      },
      onChange = function(nextValue)
        value = nextValue
        readout.props.text = tostring(nextValue) .. '%'
      end,
    },
    readout,
  },
}

Parameters

Field	Type	Description
`value`	number?	Initial value; defaults to `min`.
`min`	number?	Lower bound; defaults to `0`.
`max`	number?	Upper bound; defaults to `1`.
`step`	number?	Optional rounding increment.
`trackWidth`	number?	Rendered width for relative tracks.
`fillProps`	table?	Properties for the filled portion.
`emptyProps`	table?	Properties for the empty portion.
`onChange`	function?	Receives the normalized value.
`template`	openmw.ui.Template?	Replaces the default H3UI meter template.

Common layout fields are documented on the UI Components overview. Invalid ranges and non-positive steps raise an error during construction.

Example

Parameters

See also