Repository files navigation

🎛️Svelte Tweakpane UI wraps user-interface elements from the excellentTweakpane library in a collection of 33 idiomatic, reactive, type-safe, carefully-crafted, and obsessively-documentedSvelte components.

The library makes it easy to quickly and declaratively add knobs and dials to your projects using components that feel like they were made for Svelte. It also augments Tweakpane with a fewextra features for your convenience and enjoyment.

The components should be useful for integrating controls and value monitoring in parametrically driven artworks, data visualizations, creative tools, simulations, etc.

The library is compatible with both Svelte 4 and Svelte 5.

Please see the documentation site for much more information:
https://kitschpatrol.com/svelte-tweakpane-ui

1. AddSvelte Tweakpane UI to your Svelte project:

npm install svelte-tweakpane-ui

2. Import and use Tweakpane components in your.svelte files:

<scriptlang="ts">import {Button }from'svelte-tweakpane-ui'</script><Buttonon:click={()=>alert('🎛️')} />

• Binding
  Wraps the TweakpaneaddBinding method.
• Blade
  Wraps the TweakpaneaddBlade method.
• Folder
  Organize multiple controls into a collapsable folder.
• Pane
  The root<Pane> component, used for organizing controls into a single group and controlling how and where the Tweakpane is displayed.
• Separator
  A convenience component providing a subtle visual separator between controls, in the spirit of the HTML<hr> element.
• TabGroup
  Contains a collection of<TabPage> components to be presented as a tabs.
• TabPage
  Contains a collection of Tweakpane controls to be presented as a single group inside a<TabGroup> component.

• Button
  A humble but effective push button.
• ButtonGrid
  A grid of<Button> components.
• Checkbox
  A checkbox.
• Color
  A color picker.
• CubicBezier
  A control for editing a bezier curve. Ideal for tweaking animation easing values.
• File
  A file input control.
• Image
  An image input control.
• IntervalSlider
  A twin-handled slider control for specifying range values.
• List
  An option list picker, similar to an HTML<select> element.
• Point
  Wraps the Tweakpanepoint bindings.
• RadioGrid
  A grid of radio buttons.
• Ring
  A control evoking the focus ring on a proper camera lens.
• RotationEuler
  Integrates theeuler rotation control from0b5vr'stweakpane-plugin-rotation.
• RotationQuaternion
  Integrates thequaternion rotation control from0b5vr'stweakpane-plugin-rotation.
• Slider
  A slider component providing fine-grained control over numeric values.
• Stepper
  A control for simple incremental value changes.
• Text
  A text field, in the spirit of the HTML<input type="text"> element.
• Textarea
  A multi-line text input field, in the spirit of the HTML<textarea> element.
• Wheel
  A control evoking a dial on a proper camera body.

• FpsGraph
  A control for monitoring and graphing frame rates over time.
• Monitor
  Wraps the Tweakpanemonitor binding functionality forboolean,number, andstring values.
• Profiler
  Measure and visualize multiple quantities over time.
• WaveformMonitor
  Visualize multiple numeric values as a waveform.

• AutoObject
  Rapid-development component which automatically creates a set of Tweakpane controls for an arbitrary object.
• AutoValue
  Rapid-development component which automatically creates a Tweakpane control for an arbitrary value.
• Element
  A component for embedding arbitrary HTML elements into a pane.

@kitschpatrol

Thank you toHiroki Kokubun for creating theTweakpane library.

Additional acknowledgments are listedon the documentation site.

Issues and pull requests are welcome.

MIT © Eric Mika

Note: This library is not to be confused with Karl Moore'ssvelte-tweakpane.