30:[] 2e:{"title":"Range Input / Observable Inputs","cells":[{"id":0,"value":"

Range Input / Observable Inputs

\n\n# Input: Range\n\nA Range input specifies a number between the given *min* and *max* (inclusive). This number can be adjusted roughly by sliding, or precisely by typing. A range input is also known as a slider.","pinned":false,"hidden":false,"mode":"md"},{"id":149,"value":"md`By default, a Range chooses a floating point number between 0 and 1 with full precision, which is often more precision than desired.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":6,"value":"viewof x = Inputs.range()","pinned":true,"hidden":false,"mode":"ojs"},{"id":38,"value":"x","pinned":true,"hidden":false,"mode":"ojs"},{"id":129,"value":"md`The current value of *x* is ${x.toLocaleString(\"en\")}.`","pinned":true,"hidden":false,"mode":"ojs"},{"id":77,"value":"md`The *step* option is strongly encouraged to set the desired precision (the interval between adjacent values). For integers, use *step* = 1. The up and down buttons in the number input will only work if a *step* is specified. To change the extent, pass [*min*, *max*] as the first argument.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":81,"value":"viewof y = Inputs.range([0, 255], {step: 1})","pinned":true,"hidden":false,"mode":"ojs"},{"id":125,"value":"md`The *min*, *max* and *step* options affect only the slider behavior, the number input’s buttons, and whether the browser shows a warning if a typed number is invalid; they do not constrain the typed number.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":86,"value":"md`The *value* option sets the initial value, which defaults to the middle of the range: (*min* + *max*) / 2.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":88,"value":"viewof z = Inputs.range([0, 255], {step: 1, value: 0})","pinned":true,"hidden":false,"mode":"ojs"},{"id":132,"value":"z","pinned":true,"hidden":false,"mode":"ojs"},{"id":75,"value":"md`To describe the meaning of the input, supply a *label*. A *placeholder* string may also be specified; it will only be visible when the number input is empty.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":33,"value":"viewof gain = Inputs.range([0, 11], {label: \"Gain\", step: 0.1, placeholder: \"0–11\"})","pinned":true,"hidden":false,"mode":"ojs"},{"id":45,"value":"gain","pinned":true,"hidden":false,"mode":"ojs"},{"id":109,"value":"md`For more control over typography, the *label* may be an HTML element.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":115,"value":"viewof n = Inputs.range([1, 10], {label: html`Top n`, step: 1})","pinned":true,"hidden":false,"mode":"ojs"},{"id":182,"value":"md`You can even use a ${tex`\\TeX`} label, if you’re into that sort of thing.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":110,"value":"viewof psir = Inputs.range([0, 1], {label: tex`\\psi(\\textbf{r})`})","pinned":true,"hidden":false,"mode":"ojs"},{"id":244,"value":"For an unbounded range, or simply to suppress the range input, you can use Inputs.number instead of Inputs.range. If you don’t specify an initial value, it defaults to undefined which causes referencing cells to wait for valid input.","pinned":false,"hidden":false,"mode":"md"},{"id":235,"value":"viewof m = Inputs.number([0, Infinity], {step: 1, label: \"Favorite integer\", placeholder: \"\"})","pinned":true,"hidden":false,"mode":"ojs"},{"id":242,"value":"m","pinned":true,"hidden":false,"mode":"ojs"},{"id":10,"value":"md`If differences in the numeric range are not uniformly interesting — for instance, when looking at log-distributed values — pass a *transform* function to produce a [nonlinear slider](https://mathisonian.github.io/idyll/nonlinear-sliders/). The built-in Math.log and Math.sqrt transform functions are recommended. If you supply a custom function, you should also provide an *invert* function that implements the inverse transform. (Otherwise, the Range will use [Newton’s method](https://en.wikipedia.org/wiki/Newton%27s_method) which may be inaccurate.)`","pinned":false,"hidden":false,"mode":"ojs"},{"id":12,"value":"Inputs.range([1, 100], {transform: Math.log})","pinned":true,"hidden":false,"mode":"ojs"},{"id":30,"value":"Inputs.range([0, 1], {transform: Math.sqrt})","pinned":true,"hidden":false,"mode":"ojs"},{"id":90,"value":"md`The *format* option allows you to specify a function that is called to format the displayed number. Note that the returned string must be a [valid floating-point number](https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#valid-floating-point-number) according to the HTML specification; no commas allowed!`","pinned":false,"hidden":false,"mode":"ojs"},{"id":92,"value":"viewof f = Inputs.range([0, 1], {format: x => x.toFixed(2)})","pinned":true,"hidden":false,"mode":"ojs"},{"id":95,"value":"f","pinned":true,"hidden":false,"mode":"ojs"},{"id":73,"value":"md`To prevent a Range’s value from being changed, use the *disabled* option.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":47,"value":"viewof d = Inputs.range([0, 1], {disabled: true})","pinned":true,"hidden":false,"mode":"ojs"},{"id":58,"value":"d","pinned":true,"hidden":false,"mode":"ojs"}],"files":"$W30","stdlib":"1","titling":"auto"}