cupper-hugo-theme/content/patterns/coding/code-blocks.md

+++
title = "Code blocks"
weight = 1
+++

Markdown already supports code samples both inline (using single backticks like \`some code here\`) and in blocks. **Infusion** will syntax highlight HTML, CSS, and JavaScript if you provide the correct language in the formulation of the block.

So, this&hellip;

{{<codeBlock>}}
```html
&lt;button aria-pressed="false">toggle me&lt;/button>
```
{{</codeBlock>}}

&hellip; will result in this:

```html
<button aria-pressed="false">toggle me</button>
```

Note that the syntax highlighting uses a greyscale theme. **Infusion** is careful not to use color as part of its own design, because these colors may clash with those of the design being illustrated and discussed.

{{% note %}}
To preserve the wrapping inside code blocks, horizontal scrolling is implemented. To make sure scrolling is keyboard accessible, code blocks are focusable. An `aria-label` is provided to identify the code block to screen reader users.
{{% /note %}}

## Annotated

{{<html>}}
<ul>
  <li>Here's a thing</li>
  <li ((role="separator"))>Here's a thing</li>
  <li>Here's a ((thing))</li>
  <li>Here's a thing <span ((aria-hidden="true"))></span></li>
</ul>
{{</html>}}
code documentation advice 2017-06-28 17:46:25 +02:00			`+++`
			`title = "Code blocks"`
better starter pattern 2017-07-04 12:17:09 +02:00			`weight = 1`
code documentation advice 2017-06-28 17:46:25 +02:00			`+++`

			Markdown already supports code samples both inline (using single backticks like \`some code here\`) and in blocks. Infusion will syntax highlight HTML, CSS, and JavaScript if you provide the correct language in the formulation of the block.

			`So, this…`

			`{{<codeBlock>}}`
			```html
			`<button aria-pressed="false">toggle me</button>`
			```
			`{{</codeBlock>}}`

			`… will result in this:`

			```html
			`<button aria-pressed="false">toggle me</button>`
			```

			`Note that the syntax highlighting uses a greyscale theme. Infusion is careful not to use color as part of its own design, because these colors may clash with those of the design being illustrated and discussed.`

note on kbd for code blocks 2017-08-15 10:55:30 +02:00			`{{% note %}}`
			To preserve the wrapping inside code blocks, horizontal scrolling is implemented. To make sure scrolling is keyboard accessible, code blocks are focusable. An `aria-label` is provided to identify the code block to screen reader users.
			`{{% /note %}}`
basic highlighting implemented 2017-10-07 11:36:18 +02:00
			`## Annotated`

			`{{<html>}}`
			`<ul>`
			`<li>Here's a thing</li>`
			`<li ((role="separator"))>Here's a thing</li>`
			`<li>Here's a ((thing))</li>`
			`<li>Here's a thing <span ((aria-hidden="true"))></span></li>`
			`</ul>`
			`{{</html>}}`