Troubleshooting

Common issues and solutions when using AudioUI components.

Control not displaying with adaptive sizing

If a control using adaptiveSize={true} (or the default adaptive behavior) does not appear, the parent container may have no dimension constraints. Adaptive sizing relies on container queries; without a bounded container, the control has nothing to size against.

Solutions:

  • Use a fixed size when the component supports it (e.g. adaptiveSize={false} with size="xlarge" for Knob or Slider).
  • Wrap the control in a container with explicit width and height so the control has a bounded area to size within.

Knob value strip roundness is only square or round

The Knob's value strips (the arc indicating the current value) do not support a continuous roundness scale. Roundness is effectively on/off: roundness={0.0} gives a square linecap, and any non-zero value gives a round linecap. The correct behaviour has been achieved internally but does not pass our performance requirements, so the binary behaviour is used. If you need intermediate roundness on the knob ring outline, the prop still applies there; only the value strip uses the binary behaviour.