]> BookStack Code Mirror - bookstack/blob - resources/assets/js/services/dom.js
added rtl support for hebrew + added to localMap
[bookstack] / resources / assets / js / services / dom.js
1 /**
2  * Run the given callback against each element that matches the given selector.
3  * @param {String} selector
4  * @param {Function<Element>} callback
5  */
6 export function forEach(selector, callback) {
7     const elements = document.querySelectorAll(selector);
8     for (let element of elements) {
9         callback(element);
10     }
11 }
12
13 /**
14  * Helper to listen to multiple DOM events
15  * @param {Element} listenerElement
16  * @param {Array<String>} events
17  * @param {Function<Event>} callback
18  */
19 export function onEvents(listenerElement, events, callback) {
20     for (let eventName of events) {
21         listenerElement.addEventListener(eventName, callback);
22     }
23 }
24
25 /**
26  * Set a listener on an element for an event emitted by a child
27  * matching the given childSelector param.
28  * Used in a similar fashion to jQuery's $('listener').on('eventName', 'childSelector', callback)
29  * @param {Element} listenerElement
30  * @param {String} childSelector
31  * @param {String} eventName
32  * @param {Function} callback
33  */
34 export function onChildEvent(listenerElement, childSelector, eventName, callback) {
35     listenerElement.addEventListener(eventName, function(event) {
36         const matchingChild = event.target.closest(childSelector);
37         if (matchingChild) {
38             callback.call(matchingChild, event, matchingChild);
39         }
40     });
41 }
42
43 /**
44  * Look for elements that match the given selector and contain the given text.
45  * Is case insensitive and returns the first result or null if nothing is found.
46  * @param {String} selector
47  * @param {String} text
48  * @returns {Element}
49  */
50 export function findText(selector, text) {
51     const elements = document.querySelectorAll(selector);
52     text = text.toLowerCase();
53     for (let element of elements) {
54         if (element.textContent.toLowerCase().includes(text)) {
55             return element;
56         }
57     }
58     return null;
59 }