30:T6a2,md`# Inputs

*a.k.a “The Grand Native Inputs Bazaar”*

A collection of assorted fancy inputs, odds and ends — with which to produce values to feed your burgeoning sketches. All inputs support optional **titles** and **descriptions**; where it makes sense, inputs also support a **submit** option, which allows you to prevent the value from updating until the input has been finalized. Wares we have on offer: * [\`slider\`](#sliderDemo) * [\`button\`](#buttonDemo) * [\`select\`](#selectDemo) * [\`color\`](#colorDemo) * [\`date\`](#dateDemo) * [\`file\`](#fileDemo) * [\`text\`](#textDemo) * [\`textarea\`](#textareaDemo) * [\`radio\`](#radioDemo) * [\`checkbox\`](#checkboxDemo) * [\`number\`](#numberDemo) * [\`password\`](#passwordDemo) #### Friends & Family: - For fully custom forms, combining various inputs into a single reactive cell, try [@mbostock/form-input](https://beta.observablehq.com/@mbostock/form-input). - For data-driven range sliders, displaying a histogram of the distribution and allowing you to filter out a range of a dataset along a given attribute, try: [@bumbeishvili/data-driven-range-sliders](https://beta.observablehq.com/@bumbeishvili/data-driven-range-sliders) *If you have an improvement to the bazaar that you’d like to suggest, [please make your change in a fork](https://beta.observablehq.com/@observablehq/fork-share-merge), then email me the link so that I can merge the fix in...*`31:T438,function select(config = {}) { let { value: formValue, title, description, submit, multiple, size, options } = config; if (Array.isArray(config)) options = config; options = options.map( o => (typeof o === "object" ? o : { value: o, label: o }) ); const form = input({ type: "select", title, description, submit, getValue: input => { const selected = Array.prototype.filter .call(input.options, i => i.selected) .map(i => i.value); return multiple ? selected : selected[0]; }, form: html` ` }); form.output.remove(); return form; }32:T41a,function radio(config = {}) { let { value: formValue, title, description, submit, options } = config; if (Array.isArray(config)) options = config; options = options.map( o => (typeof o === "string" ? { value: o, label: o } : o) ); const form = input({ type: "radio", title, description, submit, getValue: input => { const checked = Array.prototype.find.call(input, radio => radio.checked); return checked ? checked.value : undefined; }, form: html` ` }); form.output.remove(); return form; }33:T45d,function checkbox(config = {}) { let { value: formValue, title, description, submit, options } = config; if (Array.isArray(config)) options = config; options = options.map( o => (typeof o === "string" ? { value: o, label: o } : o) ); const form = input({ type: "checkbox", title, description, submit, getValue: input => { if (input.length) return Array.prototype.filter .call(input, i => i.checked) .map(i => i.value); return input.checked ? input.value : false; }, form: html` ` }); form.output.remove(); return form; }34:T96c,function input(config) { let { form, type = "text", attributes = {}, action, getValue, title, description, format, display, submit, options, submitOnRelease = false } = config; console.log(config.submitOnRelease); if (!form) form = html``; const input = form.input; Object.keys(attributes).forEach(key => { const val = attributes[key]; if (val != null) input.setAttribute(key, val); }); if (submit) form.append( html`` ); form.append( html`` ); if (title) form.prepend( html`

${title}

` ); if (description) form.append( html`

${description}

` ); if (format) format = d3format.format(format); if (action) { action(form); } else { const verb = submit ? "onsubmit" : type == "button" ? "onclick" : type == "checkbox" || type == "radio" ? "onchange" : "oninput"; form[verb] = e => { console.log(verb, submitOnRelease, config); e && e.preventDefault(); console.log(e); const value = getValue ? getValue(input) : input.value; if (form.output) form.output.value = display ? display(value) : format ? format(value) : value; if (!submitOnRelease) form.value = value; if (verb !== "oninput") form.dispatchEvent(new CustomEvent("input", { bubbles: true })); }; form["onclick"] = e => { e && e.preventDefault(); console.log("onclick"); if (submitOnRelease) { const value = getValue ? getValue(input) : input.value; console.log(value); form.value = value; form.dispatchEvent(new CustomEvent("input", { bubbles: true })); } } if (verb !== "oninput") input.oninput = e => e && e.stopPropagation() && e.preventDefault(); if (verb !== "onsubmit") form.onsubmit = e => e && e.preventDefault(); form[verb](); } return form; }35:[] 2e:{"title":"Inputs","cells":[{"id":0,"value":"$30","pinned":false,"hidden":false,"mode":"ojs"},{"id":128,"value":"sliderDemo = md`---\n## Sliders\n\n~~~js\nimport {slider} from \"@jashkenas/inputs\"\n~~~`","pinned":false,"hidden":false,"mode":"ojs"},{"id":26,"value":"viewof a = slider()","pinned":false,"hidden":false,"mode":"ojs"},{"id":1492,"value":"viewof a1 = slider({\n min: 0, \n max: 1, \n step: 0.01, \n format: \".0%\",\n description: \"Zero to one, formatted as a percentage\"\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":1539,"value":"viewof a2 = slider({\n min: 0,\n max: 1e9,\n step: 1000,\n value: 3250000,\n format: \",\",\n description:\n \"Zero to one billion, in steps of one thousand, formatted as a (US) number\"\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":50,"value":"viewof a3 = slider({\n min: 0, \n max: 100, \n step: 1, \n value: 10, \n title: \"Integers\", \n description: \"Integers from zero through 100\"\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":120,"value":"viewof a4 = slider({\n min: 0.9,\n max: 1.1,\n precision: 3,\n description: \"A high precision slider example\"\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":553,"value":"viewof a5 = slider({\n min: 0.9,\n max: 1.1,\n precision: 3,\n submit: false,\n title: 'carbon tax',\n submitOnRelease: true,\n format: '$',\n description: \"The same as a4, but only changes value on submit\"\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":1685,"value":"a5","pinned":false,"hidden":false,"mode":"ojs"},{"id":1591,"value":"md`More [fancy slider techniques](https://beta.observablehq.com/@mootari/prime-numbers-slider).`","pinned":false,"hidden":false,"mode":"ojs"},{"id":6,"value":"function slider(config = {}) {\n let {value, min = 0, max = 1, step = \"any\", precision = 2, title, description, getValue, format, display, submit, submitOnRelease=false} = config;\n if (typeof config == \"number\") value = config;\n if (value == null) value = (max + min) / 2;\n precision = Math.pow(10, precision);\n if (!getValue) getValue = input => Math.round(input.valueAsNumber * precision) / precision;\n return input({\n type: \"range\", title, description, submit, format, display,\n attributes: {min, max, step, value},\n getValue,\n submitOnRelease\n });\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":678,"value":"buttonDemo = md`---\n## Buttons\n\n~~~js\nimport {button} from \"@jashkenas/inputs\"\n~~~`","pinned":false,"hidden":false,"mode":"ojs"},{"id":685,"value":"viewof b = button()","pinned":false,"hidden":false,"mode":"ojs"},{"id":697,"value":"{\n b\n return !this;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":707,"value":"viewof b1 = button({value: \"Click me\", description: \"We use a reference to the button below to record the time you pressed it.\"})","pinned":false,"hidden":false,"mode":"ojs"},{"id":714,"value":"{\n b1;\n return new Date(Date.now()).toUTCString()\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":682,"value":"function button(config = {}) {\n let {value, title, description, disabled} = config;\n if (typeof config == \"string\") value = config;\n if (!value) value = \"Ok\";\n const form = input({\n type: \"button\", title, description,\n attributes: {disabled, value}\n });\n form.output.remove();\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":913,"value":"selectDemo = md`---\n## Dropdown Menus and Multiselects\n\n~~~js\nimport {select} from \"@jashkenas/inputs\"\n~~~`","pinned":false,"hidden":false,"mode":"ojs"},{"id":918,"value":"viewof dd = select([\"Spring\", \"Summer\", \"Fall\", \"Winter\"])","pinned":false,"hidden":false,"mode":"ojs"},{"id":920,"value":"dd","pinned":false,"hidden":false,"mode":"ojs"},{"id":947,"value":"viewof dd1 = select({\n title: \"Stooges\",\n description: \"Please pick your favorite stooge.\",\n options: [\"Curly\", \"Larry\", \"Moe\", \"Shemp\"],\n value: \"Moe\"\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":955,"value":"dd1","pinned":false,"hidden":false,"mode":"ojs"},{"id":960,"value":"viewof dd2 = select({\n description: \"As a child, which vegetables did you refuse to eat?\",\n options: [\"Spinach\", \"Broccoli\", \"Brussels Sprouts\", \"Cauliflower\", \"Kale\", \"Turnips\", \"Green Beans\", \"Asparagus\"],\n multiple: true\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":986,"value":"dd2","pinned":false,"hidden":false,"mode":"ojs"},{"id":1524,"value":"viewof dd3 = {\n const dd3 = select({\n title: \"How are you feeling today?\",\n options: [\n { label: \"🤷\", value: \"shrug\" },\n { label: \"😂\", value: \"tears-of-joy\" },\n { label: \"😍\", value: \"loving-it\" },\n { label: \"🤔\", value: \"hmmm\" },\n { label: \"😱\", value: \"yikes\" },\n { label: \"😈\", value: \"mischievous\" },\n { label: \"💩\", value: \"poo\" }\n ],\n value: \"hmmm\"\n });\n dd3.input.style.fontSize = \"30px\";\n dd3.input.style.marginTop = \"8px\";\n return dd3;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":1527,"value":"dd3","pinned":false,"hidden":false,"mode":"ojs"},{"id":922,"value":"$31","pinned":false,"hidden":false,"mode":"ojs"},{"id":153,"value":"colorDemo = md`---\n## Color Pickers\n\n*value: a hexadecimal string: * \\`\"#bada55\"\\` \n\n~~~js\nimport {color} from \"@jashkenas/inputs\"\n~~~`","pinned":false,"hidden":false,"mode":"ojs"},{"id":141,"value":"viewof c = color()","pinned":false,"hidden":false,"mode":"ojs"},{"id":165,"value":"viewof c1 = color({\n value: \"#0000ff\",\n title: \"Background Color\",\n description: \"This color picker starts out blue\"\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":130,"value":"function color(config = {}) {\n let {value, title, description, submit, display} = config;\n if (typeof config == \"string\") value = config;\n if (value == null) value = '#000000';\n const form = input({\n type: \"color\", title, description, submit, display,\n attributes: {value}\n });\n if (title || description) form.input.style.margin = \"5px 0\";\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":193,"value":"dateDemo = md` ---\n## Dates\n\n*value: a YYYY-MM-DD formatted string: * \\`\"2016-11-08\"\\` \n\n~~~js\nimport {date} from \"@jashkenas/inputs\"\n~~~`","pinned":false,"hidden":false,"mode":"ojs"},{"id":208,"value":"viewof d = date()","pinned":false,"hidden":false,"mode":"ojs"},{"id":210,"value":"viewof d1 = date({\n title: \"2017\", \n min: \"2017-01-01\",\n max: \"2017-12-31\",\n value: \"2017-01-01\",\n description: \"Only dates within the 2017 calendar year are allowed\"\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":200,"value":"function date(config = {}) {\n let {min, max, value, title, description, display} = config;\n if (typeof config == \"string\") value = config;\n return input({\n type: \"date\", title, description, display,\n attributes: {min, max, value}\n });\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":249,"value":"fileDemo = md`---\n## File Upload\n*Use the JavaScript [File API](https://developer.mozilla.org/en-US/docs/Web/API/File/Using_files_from_web_applications) to work with uploaded file contents.*\n\n\\`import {file} from \"@jashkenas/inputs\"\\``","pinned":false,"hidden":false,"mode":"ojs"},{"id":257,"value":"viewof e = file()","pinned":false,"hidden":false,"mode":"ojs"},{"id":297,"value":"viewof e1 = file({\n title: \"Photographs\",\n description: \"Only .jpg files are allowed in this example. Choose some images, and they’ll appear in the cell below.\",\n accept: \".jpg\",\n multiple: true,\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":328,"value":"{\n const div = html`

`;\n for (var j = 0; j < e1.length; j++) {\n let file = e1[j];\n let img = html``\n img.src = await Files.url(e1[j]);\n div.append(img);\n }\n return div;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":252,"value":"function file(config = {}) {\n let {multiple, accept, title, description} = config;\n const form = input({\n type: \"file\", title, description,\n attributes: {multiple, accept},\n action: form => {\n form.input.onchange = () => {\n form.value = multiple ? form.input.files : form.input.files[0];\n form.dispatchEvent(new CustomEvent(\"input\"));\n };\n }\n });\n form.output.remove();\n form.input.onchange();\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":433,"value":"textDemo = md`---\n## Text Inputs\n\n~~~js\nimport {text} from \"@jashkenas/inputs\"\n~~~`","pinned":false,"hidden":false,"mode":"ojs"},{"id":442,"value":"viewof f = text()","pinned":false,"hidden":false,"mode":"ojs"},{"id":474,"value":"viewof f1 = text({title: \"A Text Input\", placeholder: \"Placeholder text\", description: \"Note that text inputs don’t show output on the right\"})","pinned":false,"hidden":false,"mode":"ojs"},{"id":576,"value":"f1","pinned":false,"hidden":false,"mode":"ojs"},{"id":571,"value":"viewof f2 = text({placeholder: \"Placeholder text\", description: \"This input only changes value on submit\", submit: \"Go\"})","pinned":false,"hidden":false,"mode":"ojs"},{"id":578,"value":"f2","pinned":false,"hidden":false,"mode":"ojs"},{"id":435,"value":"function text(config = {}) {\n const {\n value,\n title,\n description,\n autocomplete = \"off\",\n maxlength,\n minlength,\n pattern,\n placeholder,\n size,\n submit\n } = config;\n if (typeof config == \"string\") value = config;\n const form = input({\n type: \"text\",\n title,\n description,\n submit,\n attributes: {\n value,\n autocomplete,\n maxlength,\n minlength,\n pattern,\n placeholder,\n size\n }\n });\n form.output.remove();\n form.input.style.fontSize = \"1em\";\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":482,"value":"textareaDemo = md`---\n## Textareas\n\n~~~js\nimport {textarea} from \"@jashkenas/inputs\"\n~~~`","pinned":false,"hidden":false,"mode":"ojs"},{"id":489,"value":"viewof g = textarea()","pinned":false,"hidden":false,"mode":"ojs"},{"id":619,"value":"g","pinned":false,"hidden":false,"mode":"ojs"},{"id":520,"value":"viewof g1 = textarea({\n title: \"Your Great American Novel\", \n placeholder: \"Insert story here...\", \n spellcheck: true,\n width: \"100%\",\n rows: 10,\n submit: \"Publish\"\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":617,"value":"g1","pinned":false,"hidden":false,"mode":"ojs"},{"id":485,"value":"function textarea(config = {}) {\n let {value, title, description, autocomplete, cols = 45, rows = 3, width, height, maxlength, placeholder, spellcheck, wrap, submit} = config;\n if (typeof config == \"string\") value = config;\n if (value == null) value = \"\";\n const form = input({\n form: html``, \n title, description, submit,\n attributes: {autocomplete, cols, rows, maxlength, placeholder, spellcheck, wrap}\n });\n form.output.remove();\n if (width != null) form.input.style.width = width;\n if (height != null) form.input.style.height = height;\n if (submit) form.submit.style.margin = \"0\";\n if (title || description) form.input.style.margin = \"3px 0\";\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":764,"value":"radioDemo = md`---\n## Radio Buttons\n\n~~~js\nimport {radio} from \"@jashkenas/inputs\"\n~~~`","pinned":false,"hidden":false,"mode":"ojs"},{"id":831,"value":"viewof r = radio([\"Lust\", \"Gluttony\", \"Greed\", \"Sloth\", \"Wrath\", \"Envy\", \"Pride\"])","pinned":false,"hidden":false,"mode":"ojs"},{"id":835,"value":"r","pinned":false,"hidden":false,"mode":"ojs"},{"id":780,"value":"viewof r1 = radio({\n title: 'Contact Us',\n description: 'Please select your preferred contact method',\n options: [\n { label: 'By Email', value: 'email' },\n { label: 'By Phone', value: 'phone' },\n { label: 'By Pager', value: 'pager' },\n ],\n value: 'pager'\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":793,"value":"r1","pinned":false,"hidden":false,"mode":"ojs"},{"id":761,"value":"$32","pinned":false,"hidden":false,"mode":"ojs"},{"id":840,"value":"checkboxDemo = md`---\n## Checkboxes\n\n~~~js\nimport {checkbox} from \"@jashkenas/inputs\"\n~~~`","pinned":false,"hidden":false,"mode":"ojs"},{"id":858,"value":"viewof ch = checkbox([\"Lust\", \"Gluttony\", \"Greed\", \"Sloth\", \"Wrath\", \"Envy\", \"Pride\"])","pinned":false,"hidden":false,"mode":"ojs"},{"id":864,"value":"ch","pinned":false,"hidden":false,"mode":"ojs"},{"id":852,"value":"viewof ch1 = checkbox({\n title: 'Colors',\n description: 'Please select your favorite colors',\n options: [\n { value: 'r', label: 'Red' },\n { value: 'o', label: 'Orange' },\n { value: 'y', label: 'Yellow' },\n { value: 'g', label: 'Green' },\n { value: 'b', label: 'Blue' },\n { value: 'i', label: 'Indigo' },\n { value: 'v', label: 'Violet' },\n ],\n value: ['r','g','b']\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":856,"value":"ch1","pinned":false,"hidden":false,"mode":"ojs"},{"id":871,"value":"viewof ch3 = checkbox({\n description: \"Just a single checkbox to toggle\",\n options: [{ value: \"toggle\", label: \"On\" }],\n value: \"toggle\"\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":874,"value":"ch3","pinned":false,"hidden":false,"mode":"ojs"},{"id":844,"value":"$33","pinned":false,"hidden":false,"mode":"ojs"},{"id":630,"value":"numberDemo = md`---\n## Numbers\n\n~~~js\nimport {number} from \"@jashkenas/inputs\"\n~~~`","pinned":false,"hidden":false,"mode":"ojs"},{"id":640,"value":"viewof h = number()","pinned":false,"hidden":false,"mode":"ojs"},{"id":662,"value":"h","pinned":false,"hidden":false,"mode":"ojs"},{"id":650,"value":"viewof h1 = number({placeholder: \"13+\", title: \"Your Age\", submit: true})","pinned":false,"hidden":false,"mode":"ojs"},{"id":656,"value":"h1","pinned":false,"hidden":false,"mode":"ojs"},{"id":636,"value":"function number(config = {}) {\n const {value, title, description, placeholder, submit, step, min, max} = config;\n if (typeof config == \"number\") value = config;\n const form = input({\n type: \"number\", title, description, submit,\n attributes: {value, placeholder, step, min, max},\n getValue: (input) => input.valueAsNumber\n });\n form.output.remove();\n form.input.style.width = \"auto\";\n form.input.style.fontSize = \"1em\";\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":1626,"value":"passwordDemo = md`---\n## Passwords\n\n~~~js\nimport {password} from \"@jashkenas/inputs\"\n~~~`","pinned":false,"hidden":false,"mode":"ojs"},{"id":1629,"value":"viewof i = password({value: \"password\"})","pinned":false,"hidden":false,"mode":"ojs"},{"id":1635,"value":"i","pinned":false,"hidden":false,"mode":"ojs"},{"id":1638,"value":"viewof i1 = password({\n title: \"Your super secret password\", \n description: \"Less than 12 characters, please.\",\n minlength: 6,\n maxlength: 12\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":1641,"value":"i1","pinned":false,"hidden":false,"mode":"ojs"},{"id":1624,"value":"function password(config = {}) {\n const {\n value,\n title,\n description,\n autocomplete = \"off\",\n maxlength,\n minlength,\n pattern,\n placeholder,\n size,\n submit\n } = config;\n if (typeof config == \"string\") value = config;\n const form = input({\n type: \"password\",\n title,\n description,\n submit,\n attributes: {\n value,\n autocomplete,\n maxlength,\n minlength,\n pattern,\n placeholder,\n size\n }\n });\n form.output.remove();\n form.input.style.fontSize = \"1em\";\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":362,"value":"md`---\n## TK (Patches welcome!)\n\n* 2D coordinate input (using a <canvas>)\n* 3D coordinate input (for say, positioning a camera in a WebGL sketch)\n* Degrees or radians input, for circular things.\n* Other useful formatting options.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":376,"value":"$34","pinned":true,"hidden":false,"mode":"ojs"},{"id":1475,"value":"d3format = require(\"d3-format@1\")","pinned":false,"hidden":false,"mode":"ojs"},{"id":228,"value":"md`*Clip art courtesy [ClipArt ETC](https://etc.usf.edu/clipart/), radio buttons and checkboxes courtesy [Amit Sch](https://beta.observablehq.com/@meetamit/multiple-choice-inputs).*`","pinned":false,"hidden":false,"mode":"ojs"}],"files":"$W35","stdlib":"1","titling":"auto"}