/**
* Utilclass for compiling
*/
class ContentCompiler {
/**
* @param {cheerio} $
* @param {Logger} logger
*/
constructor($, logger) {
this.$ = $;
this._logger = logger;
}
/**
* Replaces all divs with tables
* @param {cheerio} $
* @static
* @private
*/
divHelper($) {
const elements = $('div');
elements.each((i, _el) => {
const el = $(_el);
const td = $('<td>');
const tr = $('<tr>').append(td);
const tbody = $('<tbody>').append(tr);
const table = $('<table>').append(tbody);
table.attr(el.attr());
table.addClass('w-100');
td.html(el.html());
el.replaceWith(table);
});
}
/**
* Replaces all margin classes to equivalent spacer elements
* @param {cheerio} $
* @private
*/
marginHelper($) {
const elements = $('*[class*=my-], *[class*=mx-], *[class*=mt-], *[class*=mb-], *[class*=ml-], *[class*=mr-]').not('.mx-auto');
const regex = /m[btylrx]{1}-(lg-)?(\d)/i;
elements.each((i, _el) => {
const el = $(_el);
const cssDisplay = el.css('display');
if ((cssDisplay === undefined && !helper.blockElements.includes(_el.name)) || cssDisplay === 'inline') {
console.warn('Inline-Elements does not support margins. Got ' + _el.name);
return;
}
const marginClasses = el.attr('class').split(' ').filter(classname => classname.match(regex));
el.removeClass(marginClasses.join(' '));
const appendClasses = marginClasses.map(classname => 's' + classname.substr(1));
appendClasses.push('w-100');
BootstrapEmail._wrapElement(el, 'spacing', {
classes: appendClasses,
attributes: {'data-src': 'margin'}
});
});
}
/**
* Handles all padding classes. If padding-element is not a table, wrap a table around
* @param {cheerio} $
* @private
*/
paddingHelper($) {
const elements = $('*[class*=p-], *[class*=pt-], *[class*=pr-], *[class*=pb-], *[class*=pl-], *[class*=px-], *[class*=py-]');
const regex = /p[btylrx]{1}-(lg-)?(\d)/i;
elements.each((i, _el) => {
const el = $(_el);
const paddingClasses = el.attr('class').split(' ').filter(classname => classname.match(regex));
el.removeClass(paddingClasses.join(' '));
const cssDisplay = el.css('display');
const appendClasses = paddingClasses.map(classname => 's' + classname.substr(1));
if ((helper.blockElements.includes(_el.name) && cssDisplay === undefined) || cssDisplay === 'block') {
appendClasses.push('w-100');
}
if (helper.voidElements.includes(_el.tagName)) {
BootstrapEmail._wrapElement(el, 'spacing', {
classes: appendClasses,
attributes: {'data-src': 'padding'}
});
} else {
BootstrapEmail._wrapContent(el, 'spacing', {
classes: appendClasses,
attributes: {'data-src': 'padding'}
});
}
});
}
/**
* Handles floats and centered elements
* @param {cheerio} $
* @param {string} selector
* @param {('left' | 'center' | 'right')} direction
* @private
*/
alignmentHelper($, selector, direction) {
$(selector).each((i, _el) => {
const el = $(_el);
if (direction === 'center') {
BootstrapEmail._wrapElement(el, 'center');
} else {
if (_el.name === 'table') {
el.attr('align', direction);
} else {
BootstrapEmail._wrapElement(el, 'table', {
attributes: {
align: direction
}
});
}
}
});
}
/**
* Adds border, cellspacing and cellpadding attributes to all table elements
* @param {cheerio} $
* @private
*/
tableHelper($) {
const tables = $('table');
tables.each((i, _el) => {
$(_el).attr({
border: 0,
cellpadding: 0,
cellspacing: 0
});
});
}
/**
* Replaces preview tag with hidden div and extend content to 100 characters
* @param {cheerio} $
* @private
*/
preview($) {
const preview = $('preview');
if (preview.length > 0) {
const content = preview.html();
preview.html(content + ' '.repeat(Math.max(100 - content.length, 0)));
preview.addClass('preview');
preview[0].tagName = 'div';
}
}
/**
* Replaces rows and columns to tables and set according separators
* @param {cheerio} $ - ElementHelper in which the rows and cols should be replaced
* @param {number} columns - Amount of allowed columns in a row
* @private
*/
gridHelper($, columns) {
$('.row').each((rowIndex, _row) => {
const row = $(_row);
const desktopGrid = BootstrapEmail._generateGrid($, row.clone(), columns, true);
const mobileGrid = BootstrapEmail._generateGrid($, row, columns, false);
row.empty().append(desktopGrid).append(mobileGrid);
mobileGrid.before('<!--[if !mso]><!-->').after('<!--<![endif]-->');
});
}
/**
* @param $
* @param rowSrc
* @param columns
* @param isLG
* @return {this | void | jQuery}
* @private
*/
_generateGrid($, rowSrc, columns, isLG) {
const regex = /col-(lg-)?(\d){1,2}/i;
const gridBody = $('<tbody>');
const grid = $('<table>')
.addClass('bte-grid')
.addClass('bte-grid--' + (isLG ? 'desktop' : 'mobile'))
.append(gridBody);
const cols = rowSrc.children('*[class*="col"]');
for (let colIndex = 0; colIndex < cols.length;) {
const row = $('<tr>').addClass('row');
const rowBody = $('<tbody>').append(row);
const rowTable = $('<table>').addClass('bte-grid__inner').append(rowBody);
const gridCell = $('<td>').append(rowTable);
const gridRow = $('<tr>').append(gridCell);
// TODO: add support for different col amounts
for (let rowCols = 0; colIndex < cols.length; colIndex++) {
const col = $(cols[colIndex]);
let colSize = 0;
(col.attr('class') || '').split(' ').forEach(classname => {
const match = classname.match(regex);
if (match) {
const size = parseInt(match.pop());
const isColLG = !!match.pop();
if (isNaN(size)) {
// TODO: Implement better error message
console.warn('Malformed column name. Ignored');
} else if (isColLG === isLG || (isLG && !colSize)) {
colSize = size;
}
}
});
if (!colSize) {
colSize = columns;
}
rowCols += colSize;
if (rowCols > columns) {
break;
}
if (rowCols > colSize && !rowSrc.hasClass('no-gutters')) {
row.append('<td class="bte-col-separator"> </td>');
}
const cell = $('<td>')
.addClass(`bte-col-${colSize}`)
.append(col);
col.attr('class').split(' ').forEach(classname => {
if (regex.test(classname)) {
BootstrapEmail._removeClass(col, classname);
}
});
row.append(cell).attr('data-cols', rowCols);
}
const colOffset = columns - parseInt(row.attr('data-cols'));
if (colOffset > 0) {
const cell = $('<td>').addClass('col-' + colOffset);
row.append(cell);
}
gridBody.append(gridRow);
}
BootstrapEmail._removeClass(rowSrc, 'row');
return grid;
}
}
module.exports = ContentCompiler;