30:T578,md`# Inputs

*a.k.a “The Grand Input 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\` * \`button\` * \`select\` * \`color\` * \`date\` * \`file\` * \`text\` * \`textarea\` * \`radio\` * \`checkbox\` * \`number\` *Although hopefully we’ll have a better way to send patches soon — for now, please fork and message me any improvements you’d like to see incorporated here.* ## My modifications * There's a quirk I found using checkboxes: when no option is selected, the value is \`undefined\`. This is ok in general, but it makes Observable think that the cell associated with the checkbox is undefined, and a function that depends on that cell is marked with an error. This is easily solved by setting the default value to \`false\` rather than \`undefined\`. * Added the \`id\` attribute to the slider input so that I can access the input element from another cell. `31:T63e,function input(config) { let {form, type = "text", attributes = {}, action, getValue, title, description, format, submit, options} = config; 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) => { e && e.preventDefault(); const value = getValue ? getValue(input) : input.value; if (form.output) form.output.value = format ? format(value) : value; form.value = value; if (verb !== "oninput") form.dispatchEvent(new CustomEvent("input")); }; if (verb !== "oninput") input.oninput = e => e && e.stopPropagation() && e.preventDefault(); if (verb !== "onsubmit") form.onsubmit = (e) => e && e.preventDefault(); form[verb](); } return form; }32:[] 2e:{"title":"Inputs","cells":[{"id":0,"value":"$30","pinned":false,"hidden":false,"mode":"ojs"},{"id":128,"value":"md`---\n## Sliders\n\n\\`import {slider} from \"@jashkenas/inputs\"\\``","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":50,"value":"viewof a2 = 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 a3 = 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 a4 = slider({\n min: 0.9,\n max: 1.1,\n precision: 3,\n submit: true,\n description: \"The same as a3, but only changes value on submit\"\n})","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, format, submit, id} = config;\n if (typeof config == \"number\") value = config;\n if (value == null) value = (max + min) / 2;\n precision = Math.pow(10, precision);\n return input({\n type: \"range\", title, description, submit, format,\n attributes: {min, max, step, value, id}, \n getValue: input => Math.round(input.valueAsNumber * precision) / precision\n });\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":678,"value":"md`---\n## Buttons\n\n\\`import {button} from \"@jashkenas/inputs\"\\``","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":"md`---\n## Dropdown Menus and Multiselects\n\n\\`import {select} from \"@jashkenas/inputs\"\\``","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":922,"value":"function select(config = {}) {\n let {value: formValue, title, description, submit, multiple, size, options} = config;\n if (Array.isArray(config)) options = config;\n options = options.map(o => typeof o === \"string\" ? {value: o, label: o} : o);\n const form = input({\n type: \"select\", title, description, submit, \n getValue: input => {\n const selected = Array.prototype.filter.call(input.options, i => i.selected).map(i => i.value);\n return multiple ? selected : selected[0];\n },\n form: html`\n \n `\n });\n form.output.remove();\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":153,"value":"md`---\n## Color Pickers\n\n*value: a hexadecimal string: * \\`\"#bada55\"\\` \n\n\\`import {color} from \"@jashkenas/inputs\"\\``","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} = config;\n if (typeof config == \"string\") value = config;\n if (value == null) value = '#000000';\n const form = input({\n type: \"color\", title, description, submit,\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":"md` ---\n## Dates\n\n*value: a YYYY-MM-DD formatted string: * \\`\"2016-11-08\"\\` \n\n\\`import {date} from \"@jashkenas/inputs\"\\``","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} = config;\n if (typeof config == \"string\") value = config;\n return input({\n type: \"date\", title, description,\n attributes: {min, max, value}\n });\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":249,"value":"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":"md`---\n## Text Inputs\n\n\\`import {text} from \"@jashkenas/inputs\"\\``","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 {value, title, description, autocomplete, maxlength, minlength, pattern, placeholder, size, submit} = config;\n if (typeof config == \"string\") value = config;\n const form = input({\n type: \"text\", title, description, submit,\n attributes: {value, autocomplete, maxlength, minlength, pattern, placeholder, size}\n });\n form.output.remove();\n form.input.style.fontSize = \"1em\";\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":482,"value":"md`---\n## Textareas\n\n\\`import {textarea} from \"@jashkenas/inputs\"\\``","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({title: \"Your Great American Novel\", placeholder: \"Insert story here...\", spellcheck: true, submit: \"Publish\"})","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, 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 (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":"md`---\n## Radio Buttons\n\n\\`import {radio} from \"@jashkenas/inputs\"\\``","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":"function radio(config = {}) {\n let {value: formValue, title, description, submit, options} = config;\n if (Array.isArray(config)) options = config;\n options = options.map(o => typeof o === \"string\" ? {value: o, label: o} : o);\n const form = input({\n type: \"radio\", title, description, submit, \n getValue: input => {\n const checked = Array.prototype.find.call(input, radio => radio.checked);\n return checked ? checked.value : undefined;\n }, \n form: html`\n \n `\n });\n form.output.remove();\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":840,"value":"md`---\n## Checkboxes\n\n\\`import {checkbox} from \"@jashkenas/inputs\"\\``","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: [\n { value: 'toggle', label: 'On' }\n ],\n value: 'toggle'\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":874,"value":"ch3","pinned":false,"hidden":false,"mode":"ojs"},{"id":844,"value":"function checkbox(config = {}) {\n let {value: formValue, title, description, submit, options} = config;\n if (Array.isArray(config)) options = config;\n options = options.map(o => typeof o === \"string\" ? {value: o, label: o} : o);\n const form = input({\n type: \"checkbox\", title, description, submit, \n getValue: input => {\n if (input.length) return Array.prototype.filter.call(input, i => i.checked).map(i => i.value);\n return input.checked ? input.value : false;\n }, \n form: html`\n \n `\n });\n form.output.remove();\n return form;\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":630,"value":"md`---\n## Numbers\n\n\\`import {number} from \"@jashkenas/inputs\"\\``","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":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.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":376,"value":"$31","pinned":true,"hidden":false,"mode":"ojs"},{"id":1475,"value":"d3format = require(\"d3-format\")","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":"$W32","stdlib":"1","titling":"auto"}