Ghost/core/frontend/helpers/plural.js
Hannah Wolfe fd20f90cca
Divided f/e proxy into true proxy + rendering service
- The original intention of the proxy was to collect up all the requires in our helpers into one place
- This has since been expanded and used in more places, in more ways
- In hindsight there are now multiple different types of requires in the proxy:
   - One: true frontend rendering framework requires (stuff from deep inside theme-engine)
   - Two: data manipulation/sdk stuff, belongs to the frontend, ways to process API data
   - Three: actual core stuff from Ghost, that we wish wasn't here / needs to be passed in a controlled way
- This commit pulls out One into a new rendering service, so at least that stuff is managed independently
- This draws the lines clearly between what's internal to the frontend and what isn't
- It also highlights that the theme-engine needs to be divided up / refactored so that we don't have these deep requires
2021-09-29 13:10:14 +01:00

38 lines
1.6 KiB
JavaScript

// # Plural Helper
// Usage example: `{{plural ../pagination.total empty='No posts' singular='1 post' plural='% posts'}}`
// or for translatable themes, with (t) translation helper's subexpressions:
// `{{plural ../pagination.total empty=(t "No posts") singular=(t "1 post") plural=(t "% posts")}}`
//
// Pluralises strings depending on item count
//
// The 1st argument is the numeric variable which the helper operates on
// The 2nd argument is the string that will be output if the variable's value is 0
// The 3rd argument is the string that will be output if the variable's value is 1
// The 4th argument is the string that will be output if the variable's value is 2+
const {SafeString} = require('../services/rendering');
const errors = require('@tryghost/errors');
const tpl = require('@tryghost/tpl');
const isUndefined = require('lodash/isUndefined');
const messages = {
valuesMustBeDefined: 'All values must be defined for empty, singular and plural'
};
module.exports = function plural(number, options) {
if (isUndefined(options.hash) || isUndefined(options.hash.empty) ||
isUndefined(options.hash.singular) || isUndefined(options.hash.plural)) {
throw new errors.IncorrectUsageError({
message: tpl(messages.valuesMustBeDefined)
});
}
if (number === 0) {
return new SafeString(options.hash.empty.replace('%', number));
} else if (number === 1) {
return new SafeString(options.hash.singular.replace('%', number));
} else if (number >= 2) {
return new SafeString(options.hash.plural.replace('%', number));
}
};