-
Notifications
You must be signed in to change notification settings - Fork 0
/
DOMifyText.js
171 lines (145 loc) · 5.87 KB
/
DOMifyText.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
'use strict';
const DOMifyText = (() => {
// Private Properties
const inputText = Symbol("inputText");
const elementOptions = Symbol("elementOptions");
// Private Methods
const getRandomID = Symbol("getRandomID");
const getDOMElementGroups = Symbol("getDOMElementGroups");
const makeGroups = Symbol("makeGroups");
const combineClasses = Symbol("combineClasses");
const defaultOptions = {
elementType: "div",
elementClasses: [],
setIDs: false,
delimiter: " ",
group: {
elementsPerGroup: 1,
groupContainer: "div",
groupClasses: [],
groupElementClasses: []
}
};
return class DOMifier {
/**
* Create a DOMifier
* @class
* @param {string} text Text to be DOMified.
* @param {Object} [options] Parameters for the created elements.
* @param {string} [options.elementType] Element type to be created.
* @param {string|string[]} [options.elementClasses] Classes to be added to the DOM Element.
* @param {string|RegExp} [options.delimiter] A delimiter or a regular expression to divide words into elements.
* @param {boolean} [options.setIDs] When true, random(ish) IDs will be added to the generated elements.
* @param {Object} [options.group] Grouping options for the elements.
* @param {number} [options.group.elementsPerGroup] Defines a number of elements per group.
* @param {string} [options.group.groupContainer] Element type of a group.
* @param {string|string[]} [options.group.groupClasses] Classes to be added to the group DOM element.
* @param {string|string[]|Array<string[]>} [options.group.groupElementClasses] Classes to be added to the elements of the group.
*/
constructor (text = "", options = {}) {
this[inputText] = text;
// maybe one day will implement a deep merge...
this[elementOptions] = Object.assign({}, defaultOptions, options);
this[elementOptions].group = Object.assign({}, defaultOptions.group, options.group);
}
/**
* Gets an Array of DOM elements
* @readonly
* @returns {Array<DOMElement>} - An Array of DOMElements created from the intial text.
*/
get DOMElements() {
let elements = this[inputText]
.split(this[elementOptions].delimiter)
.map(word => {
const wordTextNode = document.createTextNode(word);
const options = this[elementOptions];
const element = document.createElement(options.elementType.toUpperCase());
if (options.elementClasses.length > 0) {
element.className = this[combineClasses](options.elementClasses);
}
if (options.setIDs === true) element.id = this[getRandomID]();
element.appendChild(wordTextNode);
return element;
});
if (this[elementOptions].group.elementsPerGroup > 1){
elements = this[getDOMElementGroups](elements);
}
return elements;
}
/**
* Sets a text to be DOMified.
* @param {string} newText - Text to be DOMified.
*/
set text(newText = "") {
this[inputText] = newText;
}
/**
* Sets new classes
* @param {sting[]} newClasses - new Element classes to be set.
*/
set classes (newClasses = []) {
this[elementOptions].elementClasses = newClasses;
}
/**
* Sets a new delimiter
* @param {string} delimiter A new delimiter
*/
set delimiter (newDelimiter = " ") {
this[elementOptions].delimiter = newDelimiter;
}
/**
* Appends more classes to the Elements.
* @param {string | string[]} classes A string or an array of classes to be added.
* @returns {DOMifier} An instance of DOMifier (for chaining purposes).
*/
addClasses (classes = []) {
this[elementOptions].elementClasses = this[combineClasses](this[elementOptions].elementClasses, classes);
return this;
}
[getRandomID]() {
//from https://codewithmark.com/easily-generate-random-alphanumeric-string-in-javascript
return Math.random().toString(36).replace('0.', '');
}
[makeGroups]([...elements], elementsPerGroup) {
const numberOfGroups = Math.ceil(elements.length / elementsPerGroup);
const groups = elements.reduce((acc, cur, index) => {
const groupIndex = Math.floor(index / elementsPerGroup);
acc[groupIndex].push(cur);
return acc;
}, Array.from({length: numberOfGroups}, () => []));
return groups;
}
[combineClasses](...classes) {
return classes.join(' ').replace(/[,]/g," ").trim();
}
[getDOMElementGroups]([...elements]) {
const grouping = this[elementOptions].group;
let groups = this[makeGroups](elements, grouping.elementsPerGroup);
const elementClasses = this[elementOptions].elementClasses;
const groupClasses = grouping.groupClasses;
const groupElementClasses = grouping.groupElementClasses;
groups = groups.map(group => {
const groupElement = document.createElement(grouping.groupContainer);
// If the group container has classes
if (groupClasses.length > 0) {
groupElement.className = this[combineClasses](elementClasses, groupClasses);
}
group.forEach((element, index) => {
// If group elements have classes
if (groupElementClasses.length > 0) {
if (groupElementClasses instanceof Array && groupElementClasses[index]) {
element.className = this[combineClasses](elementClasses, groupElementClasses[index]);
}
else if (groupElementClasses instanceof String || typeof(groupElementClasses) === "string") {
element.className = this[combineClasses](elementClasses, groupElementClasses);
}
}
// Add elements to the group container
groupElement.appendChild(element);
});
return groupElement;
});
return groups;
}
}
})();