|
| 1 | +'use strict'; |
| 2 | + |
| 3 | +var List = require('list.js'); |
| 4 | +var objectAssign = require('object-assign'); |
| 5 | +var Accordion = require('aria-accordion').Accordion; |
| 6 | + |
| 7 | +var KEYCODE_ENTER = 13; |
| 8 | +var KEYCODE_ESC = 27; |
| 9 | + |
| 10 | +// https://davidwalsh.name/element-matches-selector |
| 11 | +function selectorMatches(el, selector) { |
| 12 | + var p = Element.prototype; |
| 13 | + var f = p.matches || p.webkitMatchesSelector || p.mozMatchesSelector || p.msMatchesSelector || function(s) { |
| 14 | + return [].indexOf.call(document.querySelectorAll(s), this) !== -1; |
| 15 | + }; |
| 16 | + return f.call(el, selector); |
| 17 | +} |
| 18 | + |
| 19 | + |
| 20 | +// get nearest parent element matching selector |
| 21 | +function closest(el, selector) { |
| 22 | + while (el) { |
| 23 | + if (selectorMatches(el, selector)) { |
| 24 | + break; |
| 25 | + } |
| 26 | + el = el.parentElement; |
| 27 | + } |
| 28 | + return el; |
| 29 | +} |
| 30 | + |
| 31 | +function forEach(values, callback) { |
| 32 | + return [].forEach.call(values, callback); |
| 33 | +} |
| 34 | + |
| 35 | +var itemTemplate = function(values) { |
| 36 | + var id = 'glossary-term-' + values.termId; |
| 37 | + return '<li class="' + values.glossaryItemClass + '">' + |
| 38 | + '<button class="data-glossary-term ' + values.termClass + '" aria-controls="' + id + '">' + |
| 39 | + values.term + |
| 40 | + '</button>' + |
| 41 | + '<div id="' + id + '" class="' + values.definitionClass + '">' + values.definition + '</div>' + |
| 42 | + '</li>' |
| 43 | +} |
| 44 | + |
| 45 | +var defaultSelectors = { |
| 46 | + glossaryID: '#glossary', |
| 47 | + toggle: '.js-glossary-toggle', |
| 48 | + close: '.js-glossary-close', |
| 49 | + listClass: '.js-glossary-list', |
| 50 | + searchClass: '.js-glossary-search' |
| 51 | +}; |
| 52 | + |
| 53 | +var defaultClasses = { |
| 54 | + definitionClass: 'glossary__definition', |
| 55 | + glossaryItemClass: 'glossary__item', |
| 56 | + highlightedTerm: 'term--highlight', |
| 57 | + termClass: 'glossary__term' |
| 58 | +}; |
| 59 | + |
| 60 | +function removeTabindex(elm) { |
| 61 | + var elms = getTabIndex(elm); |
| 62 | + forEach(elms, function(elm) { |
| 63 | + elm.setAttribute('tabIndex', '-1'); |
| 64 | + }); |
| 65 | +} |
| 66 | + |
| 67 | +function restoreTabindex(elm) { |
| 68 | + var elms = getTabIndex(elm); |
| 69 | + forEach(elms, function(elm) { |
| 70 | + elm.setAttribute('tabIndex', '0'); |
| 71 | + }); |
| 72 | +} |
| 73 | + |
| 74 | +function getTabIndex(elm) { |
| 75 | + return elm.querySelectorAll('a, button, input, [tabindex]'); |
| 76 | +} |
| 77 | + |
| 78 | +/** |
| 79 | + * Glossary widget |
| 80 | + * @constructor |
| 81 | + * @param {Array} terms - Term objects with "glossary-term" and "glossary-definition" keys |
| 82 | + * @param {Object} selectors - CSS selectors for glossary components |
| 83 | + * @param {Object} classes - CSS classes to be applied for styling |
| 84 | + */ |
| 85 | +function Glossary(terms, selectors, classes) { |
| 86 | + this.terms = terms; |
| 87 | + this.selectors = objectAssign({}, defaultSelectors, selectors); |
| 88 | + this.classes = objectAssign({}, defaultClasses, classes); |
| 89 | + |
| 90 | + this.body = document.querySelector(this.selectors.glossaryID); |
| 91 | + this.toggleBtn = document.querySelector(this.selectors.toggle); |
| 92 | + this.closeBtn = document.querySelector(this.selectors.close); |
| 93 | + this.search = this.body.querySelector(this.selectors.searchClass); |
| 94 | + this.listElm = this.body.querySelector(this.selectors.listClass); |
| 95 | + this.selectedTerm = this.toggleBtn; |
| 96 | + |
| 97 | + // Initialize state |
| 98 | + this.isOpen = false; |
| 99 | + |
| 100 | + // Update DOM |
| 101 | + this.populate(); |
| 102 | + this.initList(); |
| 103 | + this.linkTerms(); |
| 104 | + |
| 105 | + // Remove tabindices |
| 106 | + removeTabindex(this.body); |
| 107 | + |
| 108 | + // Initialize accordions |
| 109 | + this.accordion = new Accordion(this.listElm, null, {contentPrefix: 'glossary'}); |
| 110 | + |
| 111 | + // Bind listeners |
| 112 | + this.listeners = []; |
| 113 | + this.addEventListener(this.toggleBtn, 'click', this.toggle.bind(this)); |
| 114 | + this.addEventListener(this.closeBtn, 'click', this.hide.bind(this)); |
| 115 | + this.addEventListener(this.search, 'input', this.handleInput.bind(this)); |
| 116 | + this.addEventListener(document.body, 'keyup', this.handleKeyup.bind(this)); |
| 117 | + this.addEventListener(document,'click', this.closeOpenGlossary.bind(this)); |
| 118 | +} |
| 119 | + |
| 120 | +Glossary.prototype.populate = function() { |
| 121 | + this.terms.forEach(function(term, i) { |
| 122 | + var opts = { |
| 123 | + term: term.term, |
| 124 | + definition: term.definition, |
| 125 | + definitionClass: this.classes.definitionClass, |
| 126 | + glossaryItemClass: this.classes.glossaryItemClass, |
| 127 | + termClass: this.classes.termClass, |
| 128 | + termId: i |
| 129 | + }; |
| 130 | + this.listElm.insertAdjacentHTML('beforeend', itemTemplate(opts)); |
| 131 | + }, this); |
| 132 | +}; |
| 133 | + |
| 134 | +/** Initialize list.js list of terms */ |
| 135 | +Glossary.prototype.initList = function() { |
| 136 | + var glossaryId = this.selectors.glossaryID.slice(1); |
| 137 | + var listClass = this.selectors.listClass.slice(1); |
| 138 | + var searchClass = this.selectors.searchClass.slice(1); |
| 139 | + var options = { |
| 140 | + valueNames: ['data-glossary-term'], |
| 141 | + listClass: listClass, |
| 142 | + searchClass: searchClass, |
| 143 | + }; |
| 144 | + this.list = new List(glossaryId, options); |
| 145 | + this.list.sort('data-glossary-term', {order: 'asc'}); |
| 146 | +}; |
| 147 | + |
| 148 | +/** Add links to terms in body */ |
| 149 | +Glossary.prototype.linkTerms = function() { |
| 150 | + var terms = document.querySelectorAll('[data-term]'); |
| 151 | + forEach(terms, function(term) { |
| 152 | + term.setAttribute('title', 'Click to define'); |
| 153 | + term.setAttribute('tabIndex', 0); |
| 154 | + term.setAttribute('data-term', (term.getAttribute('data-term') || '').toLowerCase()); |
| 155 | + }); |
| 156 | + document.body.addEventListener('click', this.handleTermTouch.bind(this)); |
| 157 | + document.body.addEventListener('keyup', this.handleTermTouch.bind(this)); |
| 158 | +}; |
| 159 | + |
| 160 | +Glossary.prototype.handleTermTouch = function(e) { |
| 161 | + if (e.which === KEYCODE_ENTER || e.type === 'click') { |
| 162 | + if (selectorMatches(e.target, '[data-term]')) { |
| 163 | + e.stopPropagation(); |
| 164 | + this.show(e); |
| 165 | + this.selectedTerm = e.target; |
| 166 | + this.findTerm(e.target.getAttribute('data-term')); |
| 167 | + } |
| 168 | + else { |
| 169 | + this.selectedTerm = this.toggleBtn; |
| 170 | + } |
| 171 | + } |
| 172 | +}; |
| 173 | + |
| 174 | +/** Highlight a term */ |
| 175 | +Glossary.prototype.findTerm = function(term) { |
| 176 | + this.search.value = term; |
| 177 | + var highlightClass = this.classes.highlightedTerm; |
| 178 | + |
| 179 | + // Highlight the term and remove other highlights |
| 180 | + forEach(this.body.querySelectorAll('.' + highlightClass), function(term) { |
| 181 | + term.classList.remove(highlightClass); |
| 182 | + }); |
| 183 | + forEach(this.body.querySelectorAll('span[data-term="' + term + '"]'), function(term) { |
| 184 | + term.classList.add(highlightClass); |
| 185 | + }); |
| 186 | + this.list.filter(function(item) { |
| 187 | + return item._values['data-glossary-term'].toLowerCase() === term; |
| 188 | + }); |
| 189 | + |
| 190 | + this.list.search(); |
| 191 | + var button = this.list.visibleItems[0].elm.querySelector('button'); |
| 192 | + this.accordion.expand(button); |
| 193 | +}; |
| 194 | + |
| 195 | +Glossary.prototype.toggle = function() { |
| 196 | + var method = this.isOpen ? this.hide : this.show; |
| 197 | + method.apply(this); |
| 198 | +}; |
| 199 | + |
| 200 | +Glossary.prototype.show = function() { |
| 201 | + this.body.setAttribute('aria-hidden', 'false'); |
| 202 | + this.toggleBtn.setAttribute('aria-expanded', 'true'); |
| 203 | + this.search.focus(); |
| 204 | + this.isOpen = true; |
| 205 | + restoreTabindex(this.body); |
| 206 | +}; |
| 207 | + |
| 208 | +Glossary.prototype.hide = function() { |
| 209 | + this.body.setAttribute('aria-hidden', 'true'); |
| 210 | + this.toggleBtn.setAttribute('aria-expanded', 'false'); |
| 211 | + this.selectedTerm.focus(); |
| 212 | + this.isOpen = false; |
| 213 | + removeTabindex(this.body); |
| 214 | +}; |
| 215 | + |
| 216 | +/** Remove existing filters on input */ |
| 217 | +Glossary.prototype.handleInput = function() { |
| 218 | + if (this.list.filtered) { |
| 219 | + this.list.filter(); |
| 220 | + } |
| 221 | +}; |
| 222 | + |
| 223 | +/** Close glossary on escape keypress */ |
| 224 | +Glossary.prototype.handleKeyup = function(e) { |
| 225 | + if (e.keyCode == KEYCODE_ESC) { |
| 226 | + if (this.isOpen) { |
| 227 | + this.hide(); |
| 228 | + } |
| 229 | + } |
| 230 | +}; |
| 231 | + |
| 232 | +// Close glossary when clicking outside of glossary |
| 233 | +Glossary.prototype.closeOpenGlossary = function(e) { |
| 234 | + if ( e.target !== this.toggleBtn && this.isOpen) { |
| 235 | + if (!(closest(e.target, this.selectors.glossaryID))) { |
| 236 | + this.hide(); |
| 237 | + } |
| 238 | + } |
| 239 | +}; |
| 240 | + |
| 241 | +Glossary.prototype.addEventListener = function(elm, event, callback) { |
| 242 | + if (elm) { |
| 243 | + elm.addEventListener(event, callback); |
| 244 | + this.listeners.push({ |
| 245 | + elm: elm, |
| 246 | + event: event, |
| 247 | + callback: callback |
| 248 | + }); |
| 249 | + } |
| 250 | +}; |
| 251 | + |
| 252 | +Glossary.prototype.destroy = function() { |
| 253 | + this.accordion.destroy(); |
| 254 | + this.listeners.forEach(function(listener) { |
| 255 | + listener.elm.removeEventListener(listener.event, listener.callback); |
| 256 | + }); |
| 257 | +}; |
| 258 | + |
| 259 | +module.exports = Glossary; |
0 commit comments