31:[] 2f:{"title":"How To: Create and Update HTML Views","cells":[{"id":0,"value":"# How To: Create and Update HTML Views","pinned":false,"hidden":false,"mode":"md"},{"id":6,"value":"This notebook gives you a quick taste of how to use HTML in your own notebooks. For a more comprehensive review, check out https://observablehq.com/@observablehq/introduction-to-html","pinned":false,"hidden":false,"mode":"md"},{"id":10,"value":"## Ways to create HTML views","pinned":false,"hidden":false,"mode":"md"},{"id":13,"value":"There are several ways to make an HTML view","pinned":false,"hidden":false,"mode":"md"},{"id":17,"value":"output = html`

Like this

`","pinned":true,"hidden":false,"mode":"ojs"},{"id":20,"value":"Using the HTML cell type","pinned":true,"hidden":false,"mode":"html"},{"id":23,"value":"Using the **Markdown** cell type","pinned":true,"hidden":false,"mode":"md"},{"id":29,"value":"{\n let foo = document.createElement(\"div\");\n foo.innerHTML = \"Via native JavaScript\"\n return foo;\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":91,"value":"## Manipulating HTML Views","pinned":false,"hidden":false,"mode":"md"},{"id":34,"value":"A common practice is to create some HTML view for some code to operate on. If you `yield` the HTML it will then be available to manipulate:","pinned":false,"hidden":false,"mode":"md"},{"id":38,"value":"{\n // create a HTML block\n const out = html`

Some HTML:

`\n // then yield it\n yield out;\n // you can then manipulate it\n out.querySelector(\"span\").innerHTML=\"(Added later)\"\n // note out is a local variable here.\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":45,"value":"HTML created this way is also reactive when variable names change.","pinned":false,"hidden":false,"mode":"md"},{"id":44,"value":"{\n const out=html`The value is ${range}`\n yield out;\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":96,"value":"Move the slider to see the value change in HTML","pinned":true,"hidden":false,"mode":"md"},{"id":52,"value":"viewof range = Inputs.range([0, 100], {label: \"Amount\"})","pinned":true,"hidden":false,"mode":"ojs"},{"id":57,"value":"This also works for CSS applying to HTML","pinned":false,"hidden":false,"mode":"md"},{"id":62,"value":"

Hey, I'm some HTML!

","pinned":true,"hidden":false,"mode":"html"},{"id":65,"value":"html``","pinned":true,"hidden":false,"mode":"ojs"},{"id":74,"value":"Change the color on the fly with the picker below, you can drag the color swatch to see the color change in real time.","pinned":false,"hidden":false,"mode":"md"},{"id":69,"value":"viewof color = Inputs.color({label: \"Favorite color\", value: \"#4682b4\"})","pinned":false,"hidden":false,"mode":"ojs"},{"id":78,"value":"The CSS styles you create effect every HTML cell, and the current page.","pinned":false,"hidden":false,"mode":"md"},{"id":82,"value":"","pinned":true,"hidden":false,"mode":"html"},{"id":99,"value":"When updating HTML, try to leverage Observables reactive framework, instead of poking the DOM:","pinned":false,"hidden":false,"mode":"md"},{"id":109,"value":"### Variable Way","pinned":false,"hidden":false,"mode":"md"},{"id":106,"value":"added = \"I got added\" // each var it's own cell","pinned":true,"hidden":false,"mode":"ojs"},{"id":102,"value":"{\n const out=html`

${added}

`;\n yield out;\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":114,"value":"### DOM Poke Way","pinned":true,"hidden":false,"mode":"md"},{"id":118,"value":"{\n const out=html`

`;\n yield out;\n out.querySelector(\"b\").appendChild(html`I got added`)\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":124,"value":"Why is the first way \"better\"? Because you can look at the code and see the dynamic aspect. In the second case, scripts from all over the page could be poking the DOM for this cell, and you would not know where it came from. ","pinned":false,"hidden":false,"mode":"md"}],"files":"$W31","stdlib":"1","titling":"auto"}