svelte-rough-notation
v0.1.5
Published
This is a Svelte wrapper around the [rough-notation](https://github.com/rough-stuff/rough-notation) library.
Downloads
918
Readme
This is a Svelte wrapper around the rough-notation library.
It exposes both a wrapper component using a slot, and an action that can be used on a DOM element with Svelte's use:
syntax.
Wrapper Component
The component can be toggled by setting the visible
boolean property, or through the same show
and hide
API exposed by the original component. It also has properties for each configuration option exposed by rough-notation, and these can be updated after the component is created.
<script>
import Annotation from 'svelte-rough-notation';
import { onMount } from 'svelte';
let rn;
let visible = false;
onMount(() => {
setTimeout(() => {
visible = true; // or rn.visible = true or rn.show()
}, 1000);
});
</script>
<Annotation bind:visible bind:this={rn} type="box" padding={10}>Some text</Annotation>
Annotation groups work as well. The rough-notation
group implementation uses an undocumented attribute of the annotation, but this Svelte wrapper supports it, so you can just pass the component instance directly to the annotation group.
<script>
import Annotation from "svelte-rough-notation";
import { annotationGroup } from "rough-notation";
import { onMount } from "svelte";
let groupAnnotations = [];
onMount(() => {
ag = annotationGroup(groupAnnotations);
});
</script>
<button on:click={() => ag.show()}>Show Group</button>
Here we have
<Annotation bind:this={groupAnnotations[0]} type="underline" color="red">some important things</Annotation>
and also
<Annotation bind:this={groupAnnotations[1]} type="box" color="green">some more things</Annotation>
Svelte Action
The action's configuration can contain all the options exposed by rough-notation, as well as a visible
property that controls the show/hide behavior of the annotation. Updates to the configuration will be applied to the annotation.
Annotation groups are not supported with the action version of the Svelte wrapper.
<script>
import { annotate } from 'svelte-rough-notation';
</script>
<span use:annotate={{ type: 'box', iterations: 2, visible: true }}>Some text</span>
Example
There is a small sample app in the site
directory of this repository, or you can check it out in the Svelte REPL!