30:Ta3b,function Scrubber(values, { format = value => value, initial = 0, direction = 1, delay = null, autoplay = true, loop = true, loopDelay = null, alternate = false } = {}) { values = Array.from(values); const form = html``; let frame = null; let timer = null; let interval = null; function start() { form.b.textContent = "Pause"; if (delay === null) frame = requestAnimationFrame(tick); else interval = setInterval(tick, delay); } function stop() { form.b.textContent = "Play"; if (frame !== null) cancelAnimationFrame(frame), frame = null; if (timer !== null) clearTimeout(timer), timer = null; if (interval !== null) clearInterval(interval), interval = null; } function running() { return frame !== null || timer !== null || interval !== null; } function tick() { if (form.i.valueAsNumber === (direction > 0 ? values.length - 1 : direction < 0 ? 0 : NaN)) { if (!loop) return stop(); if (alternate) direction = -direction; if (loopDelay !== null) { if (frame !== null) cancelAnimationFrame(frame), frame = null; if (interval !== null) clearInterval(interval), interval = null; timer = setTimeout(() => (step(), start()), loopDelay); return; } } if (delay === null) frame = requestAnimationFrame(tick); step(); } function step() { form.i.valueAsNumber = (form.i.valueAsNumber + direction + values.length) % values.length; form.i.dispatchEvent(new CustomEvent("input", {bubbles: true})); } form.i.oninput = event => { if (event && event.isTrusted && running()) stop(); form.value = values[form.i.valueAsNumber]; form.o.value = format(form.value, form.i.valueAsNumber, values); }; form.b.onclick = () => { if (running()) return stop(); direction = alternate && form.i.valueAsNumber === values.length - 1 ? -1 : 1; form.i.valueAsNumber = (form.i.valueAsNumber + direction) % values.length; form.i.dispatchEvent(new CustomEvent("input", {bubbles: true})); start(); }; form.i.oninput(); if (autoplay) start(); else stop(); Inputs.disposal(form).then(stop); return form; }31:[] 2e:{"title":"Scrubber","cells":[{"id":0,"value":"md`# Scrubber\n\nThis reusable input is intended to drive animations while providing the reader interactive control on demand: the animation pauses when the user interacts with the slider, but can be resumed by clicking the play button. For examples, see [Bar Chart Race](/@mbostock/bar-chart-race-with-scrubber), [The Wealth & Health of Nations](/@mbostock/the-wealth-health-of-nations), [Solar Path](/@mbostock/solar-path), or [Animated Treemap](/@d3/animated-treemap).`","pinned":false,"hidden":false,"mode":"ojs"},{"id":183,"value":"md`To use in your notebook:\n\n~~~js\nimport {Scrubber} from \"@mbostock/scrubber\"\n~~~\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":37,"value":"viewof i = Scrubber(numbers)","pinned":true,"hidden":false,"mode":"ojs"},{"id":88,"value":"numbers = Array.from({length: 256}, (_, i) => i)","pinned":true,"hidden":false,"mode":"ojs"},{"id":86,"value":"md`The current value of *i* is ${i}.`","pinned":true,"hidden":false,"mode":"ojs"},{"id":109,"value":"md`Given an array of *values* representing the discrete frames of the animation, such as an array of numbers or dates, Scrubber returns a [view-compatible input](/@observablehq/introduction-to-views). (It uses the [disposal promise](/@mbostock/disposal) to stop the animation automatically on invalidation.)`","pinned":false,"hidden":false,"mode":"ojs"},{"id":140,"value":"md`## Options\n\nScrubber has several options which you can pass as the second argument.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":91,"value":"autoplay = md`The *autoplay* option, which defaults to true, specifies whether the animation plays automatically. Set it to false to require the reader to click on the play button.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":101,"value":"Scrubber(numbers, {autoplay: false})","pinned":true,"hidden":false,"mode":"ojs"},{"id":122,"value":"loop = md`The *loop* option, which defaults to true, specifies whether the animation should automatically restart from the beginning after the end is reached. Set it to false to require the reader to click the play button to restart the animation after it ends.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":127,"value":"Scrubber(numbers, {loop: false})","pinned":true,"hidden":false,"mode":"ojs"},{"id":179,"value":"md`The *alternate* option, which defaults to false, specifies whether the animation should reverse direction when it reaches the end, rather than repeat from the start.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":178,"value":"Scrubber(numbers, {loop: false, alternate: true})","pinned":true,"hidden":false,"mode":"ojs"},{"id":117,"value":"delay = md`The *delay* option, which defaults to null, specifies how long to wait between frames in milliseconds. A null value means to use [requestAnimationFrame](https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame), which typically means sixty times per second (about 17ms). Non-null delays use [setInterval](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/setInterval).`","pinned":false,"hidden":false,"mode":"ojs"},{"id":43,"value":"Scrubber([\"red\", \"green\", \"blue\"], {delay: 1000})","pinned":true,"hidden":false,"mode":"ojs"},{"id":239,"value":"loopDelay = md`The *loopDelay* option, which defaults to 0, specifies how long to wait before looping in milliseconds. This can be paired with the *initial* option to show the ending value before the animation starts anew from the beginning.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":244,"value":"Scrubber(numbers, {initial: numbers.length - 1, loopDelay: 1000})","pinned":true,"hidden":false,"mode":"ojs"},{"id":132,"value":"format = md`The *format* option, which defaults to the identity function, specifies how to display the currently-selected value. The *format* function is passed the current value, the current (zero-based) index, and the values array.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":135,"value":"dates = Array.from({length: 365}, (_, i) => {\n const date = new Date(2019, 0, 1);\n date.setDate(i + 1);\n return date;\n})","pinned":true,"hidden":false,"mode":"ojs"},{"id":10,"value":"viewof date = Scrubber(dates, {\n autoplay: false,\n format: date => date.toLocaleString(\"en\", {month: \"long\", day: \"numeric\"})\n})","pinned":true,"hidden":false,"mode":"ojs"},{"id":169,"value":"md`If you have suggestions for other options you’d like to see, please let me know!`","pinned":false,"hidden":false,"mode":"ojs"},{"id":95,"value":"md`---\n\n## Implementation`","pinned":false,"hidden":false,"mode":"ojs"},{"id":4,"value":"$30","pinned":true,"hidden":false,"mode":"ojs"}],"files":"$W31","stdlib":"1","titling":"auto"}