1.0.1 • Published 10 months ago

textarea-code-block v1.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
10 months ago

textarea-code-block

Web Component for making a Textarea element into a syntax highlighted codeblock!

Based on Font with Built-In Syntax Highlighting, this component allows you to progressively enhance any <textarea> elements with code into easy-to-read code blocks.

Features

  • Syntax Highlights HTML, JS, and CSS based on font rules (does not clutter DOM)
  • Progressively enhances textarea elements, allowing non-JS experiences to still work
  • Pre-baked with sane styling, and easy to add to your own

How to use

Import the component using your CDN of choice or installing from npm, and then wrap any textarea with code in the new <code-block> element!

<script defer src="https://unpkg.com/textarea-code-block@1"></script>

<code-block>
  <textarea>
    <hello-world>
      <div>Better Testing</div>
    </hello-world>
    <script>console.error('danger!')</script>
  </textarea>
</code-block>

If you are dynamically creating or changing the textarea element, you can run .processTextarea() to update the <code-block> element based on the new content.

<script src="https://unpkg.com/textarea-code-block@1"></script>

<code-block id="cb">
  <textarea id="t"></textarea>
</code-block>

<script>
  t.innerHTML = `
    <!-- this is dynamically added content -->
    <style>
      h1 { color: blue; }
    </style>
    <h1>Hello World</h1>
  `;
  cb.processTextarea();
</script>

Definition Loading & Defer

Using defer in the script tag is required if you have DOM content in your template you want to process automatically. If you are using .processTextarea, you'll need to either also defer those scripts, or import the definition without defer.

If you have ideas on how to make that more elegant, feel free to reach out!

Credit

The font included is from Heikki Lotvonen's Font with Built-In Syntax Highlighting.

1.0.1

10 months ago

1.0.0

10 months ago