@schafevormfenster/data-text-mapper v0.1.0
data-text-mapper
The data-text-mapper
contains some utility functions to convert a structured text with link, tag, scope, and image metadata into a combined plain text or html. As well it's made for encode and decode in both directions.
An example use case it was made for is to convert structured data given e.g. in ics event data to simplier google events by encoding the metadata within the description body.
Examples
dataToText()
const data: TextWithData = {
description: "Lorem Ipsum",
url: "https://www.domain.com/",
tags: ["One", "Two", "Three"],
scopes: ["One", "Two", "Three"],
image: "https://www.domain.com/image.jpg"
};
dataToText(data);
returns
Lorem Ipsum
https://www.domain.com/image.jpg
https://www.domain.com/
#One #Two #Three @One @Two @Three
textToData()
Transforms back the given html to a data object.
dataToHtml()
const data: TextWithData = {
description: "Lorem Ipsum",
url: "https://www.domain.com/",
tags: ["One", "Two"],
scopes: ["Three", "Four"],
image: "https://www.domain.com/image.jpg",
};
dataToHtml(data)
returns
<p class="p-description">Lorem Ipsum</p>
<img class="p-photo" src="https://www.domain.com/image.jpg" />
<p class="link"><a class="u-url" href="https://www.domain.com/">https://www.domain.com/</a></p>
<p class="taxonomy"><span class="p-category">#One</span> <span class="p-category">#Two</span> <span class="p-scope">@Three</span> <span class="p-scope">@Four</span></p>
htmlToData()
Transforms back the given html to a data object.
More details
For more details and edge case description please take a look into the unit tests.
Disclaimer
Not all functions are written that clean as expected. Improvements will we tracked in github issues. Please mention that 'data-text-mapper' is part of the upcoming 'events-api'.