This module provides some helperfunctions like onready, id-generator and templating engine
If you use NPM, you can install the module via npm install xassist-main
. Otherwise, you can download the latest minified file. Be aware any dependencies are not installed by default; you should consider downloading them yourself.
If you want, you can install the complete library from github xassist, this includes all dependencies you may need.
The module uses UMD and supports AMD, CommonJS and vanilla environments. Using vanilla: the xa
global is exported:
<script>
xa.id()
</script>
The function id() returns a unique identifier
xa.id() \\returns an unique identifier
xa.id("prefix") \\returns "prefix_"+unique identifier
id()
takes 1 parameters:
- prefix [
String
,defaults to:""
]:This parameter will be used as a prefix for the id.
The value it returns is a String
-formatted Number
The function adds a callback to the DOMContentLoaded-event, it get's executed when this event is triggered. or immediatly, when the DOM was allready ready.
ready(callBack::function [,thisArg])
ready()
returns nothing.
ready()
takes 2 parameters:
- callBack [
Function
]:The listener to be attached to the DOMContentLoaded-event - thisArg [any datatype,defaults to:
document
]:the execution-context of the function
xa.ready(cb) \\executes cb(eventDetails) (this inside cb references the document)
xa.ready(cb,thisArg) \\executes cb(eventDetails) (this inside cb references thisArg)
A basic templating engine, which replaces substrings in a String
based on a given object and his keys.
xa.template(txt,obj,strNotFound)
template()
takes 3 parameters:
- txt [
String
]:the base tekst where the templating-engine needs to change certain substrings (it replaces all${objKey}
) - obj [
Object
]:the lookup-object to find the defined key's in txt - strNotFound [
String
,defaults to:""
]:when the respective key is not found in the lookupObject, the template get's replaced by this string
the string with all its replaced substrings
xa.template('start${a}${b.c.d}${b.c.d.e}',{a:"OK",b:{c:{d:"VERYDEEP"}}},"notfound") \\returns 'startOKVERYDEEPnotfound'
- csv2readme: read csv file with fixed format and parse a readme markdown file
- jsdom: A JavaScript implementation of many web standards
- rimraf: A deep deletion module for node (like
rm -rf
) - rollup: Next-generation ES6 module bundler
- tape: tap-producing test harness for node and browsers
This module is licensed under the terms of GPL-3.0.