JS function for finding, highlighting and annotating abbreviations in HTML text.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Ondřej Hruška 744c9dcee0 improved readme 10 years ago
.gitignore added code 10 years ago
LICENSE Initial commit 10 years ago
README.md improved readme 10 years ago
abbr.js added code 10 years ago
example.html added code 10 years ago

README.md

ABBR

Abbr is a JavaScript library / function for finding, highlighting and annotating abbreviations in text.

It goes through text and wrapps acronyms (or anything you want) in <abbr> tags (or other of choice), and gives them title attribute with explanation (again, customizable).

It needs no extra markup, all is done automatically. Just tell it what words you want to explain, and it'll do it.

Usage

Abbr takes the following (default) arguments:

{
	// selector in which to search for abbreviations
	where: 'body',
	// abbreviation list - word: explanation
	words: {},
	// Tag used to mark the matches
	tag: 'abbr',
	// Attribute holding the "description" to be added to the tag
	attr: 'title',
	// Case insensitive
	ci: true,
	// tags that shall not be traversed (in addition to opts.tag)
	excluded: ['script', 'style', 'code', 'head', 'textarea', 'embed'],
	// Extra excluded (doesn't overwrite the original list)
	exclude: []
}

All config options are optional (though, obviously, you don't want to leave words empty).

To run it, simply call (example):

abbr({
	where: 'article',
	words: {
		'NSA': 'National Spying Agency',
		'Putin': 'Bear rider'
	}
});