Ghost/core/server/helpers/foreach.js
Vikas Potluri d989d62c10 Migrated encode, facebook_url and foreach helpers to es6 (#10655)
refs #9589 

* updated encode helper to use newer code standards
* updated facebook_url helper to use newer code standards
* updated foreach helper to use newer code standards
2019-04-22 17:54:42 +02:00

105 lines
3.1 KiB
JavaScript

// # Foreach Helper
// Usage: `{{#foreach data}}{{/foreach}}`
//
// Block helper designed for looping through posts
const _ = require('lodash');
const {logging, i18n, models, hbs} = require('./proxy');
const {Utils: hbsUtils, handlebars: {createFrame}} = hbs;
function filterItemsByVisibility(items, options) {
const visibilityArr = models.Base.Model.parseVisibilityString(options.hash.visibility);
return models.Base.Model.filterByVisibility(items, visibilityArr, !!options.hash.visibility);
}
module.exports = function foreach(items, options) {
if (!options) {
logging.warn(i18n.t('warnings.helpers.foreach.iteratorNeeded'));
}
if (hbsUtils.isFunction(items)) {
items = items.call(this);
}
// Exclude items which should not be visible in the theme
items = filterItemsByVisibility(items, options);
// Initial values set based on parameters sent through. If nothing sent, set to defaults
const {fn, inverse, hash, data, ids} = options;
let {columns, limit, from, to} = hash;
let length = _.size(items);
let output = '';
let frame;
let contextPath;
limit = parseInt(limit, 10) || length;
from = parseInt(from, 10) || 1;
to = parseInt(to, 10) || length;
// If a limit option was sent through (aka not equal to default (length))
// and from plus limit is less than the length, set to to the from + limit
if ((limit < length) && ((from + limit) <= length)) {
to = (from - 1) + limit;
}
if (data && ids) {
contextPath = hbsUtils.appendContextPath(data.contextPath, ids[0]) + '.';
}
if (data) {
frame = createFrame(data);
}
function execIteration(field, index, last) {
if (frame) {
frame.key = field;
frame.index = index;
frame.number = index + 1;
frame.first = index === from - 1; // From uses 1-indexed, but array uses 0-indexed
frame.last = !!last;
frame.even = index % 2 === 1;
frame.odd = !frame.even;
frame.rowStart = index % columns === 0;
frame.rowEnd = index % columns === (columns - 1);
if (contextPath) {
frame.contextPath = contextPath + field;
}
}
output = output + fn(items[field], {
data: frame,
blockParams: hbsUtils.blockParams([items[field], field], [contextPath + field, null])
});
}
function iterateCollection(context) {
// Context is all posts on the blog
let current = 1;
// For each post, if it is a post number that fits within the from and to
// send the key to execIteration to set to be added to the page
_.each(context, (_, key) => {
if (current < from) {
current += 1;
return;
}
if (current <= to) {
execIteration(key, current - 1, current === to);
}
current += 1;
});
}
if (items && typeof items === 'object') {
iterateCollection(items);
}
if (length === 0) {
output = inverse(this);
}
return output;
};