liquidjs-lite

Shopify's Liquid template engine, but less powerful


Keywords
liquid, shopify, template, hacktoberfest, liquid-templating-engine, template-engine
License
MPL-2.0
Install
npm install liquidjs-lite@1.0.3

Documentation

liquidless

Shopify's Liquid template engine, but less powerful. Perfect for configuration files

Get Started

Install the dependency from npm:

npm i liquidless

Import the renderString function

import { renderString } from 'liquidless'

Usage

Example: Rendering a string

renderString('Hello, {{ world }}', { world: 'world!' })

Outputs:

Hello, world!

Example: Using filters

renderString('Hello, {{ world | upcase }}', { world: 'world!' })

Outputs:

Hello, WORLD!

Example: Supplying custom filters

renderString('Hello, {{ world | something: 1, 2, 3 }}', { world: 'world!' }, {
  filters: {
    something: (value, args, variable) => `${value} ${args.join(', ')} (${variable})`
  }
})

Outputs:

Hello, world! 1, 2, 3 (world)

Example: Rending values in an object

import { renderObject } from 'liquidless'
renderObject([{hello: {world: '{{ world }}'}}], { world: 'world!' })

Outputs

[{hello: {world: 'world!'}}]

Filters

  • append - Adds a given string to the end of a string.
  • base64_decode - Decodes a string in Base64 format.
  • base64_encode - Encodes a string to Base64 format.
  • camelize - Converts a string to CamelCase.
  • capitalize - Capitalizes the first word in a string and downcases the remaining characters.
  • downcase - Converts a string to all lowercase characters.
  • escape - Escapes special characters in HTML, such as <>, ', and &, and converts characters into escape sequences.
  • hmac_sha1 - Converts a string into an SHA-1 hash using a hash message authentication code (HMAC).
  • hmac_sha256 - Converts a string into an SHA-256 hash using a hash message authentication code (HMAC).
  • lstrip - Strips all whitespace from the left of a string.
  • md5 - Converts a string into an MD5 hash.
  • newline_to_br - Converts newlines (\n) in a string to HTML line breaks (<br>).
  • pluralize - Outputs the singular or plural version of a string based on a given number.
  • prepend - Adds a given string to the beginning of a string.
  • remove - Removes any instance of a substring inside a string.
  • remove_first - Removes the first instance of a substring inside a string.
  • remove_last - Removes the last instance of a substring inside a string.
  • replace - Replaces any instance of a substring inside a string with a given string.
  • replace_first - Replaces the first instance of a substring inside a string with a given string.
  • replace_last - Replaces the last instance of a substring inside a string with a given string.
  • rstrip - Strips all whitespace from the right of a string.
  • sha1 - Converts a string into an SHA-1 hash using a hash message authentication code (HMAC).
  • sha256 - Converts a string into an SHA-256 hash using a hash message authentication code (HMAC).
  • slice - Returns a substring or series of array items, starting at a given 0-based index.
  • split - Splits a string into an array of substrings based on a given separator.
  • strip - Strips all whitespace from the left and right of a string.
  • strip_html - Strips all HTML tags from a string.
  • strip_newlines - Strips all newline characters (line breaks) from a string.
  • toInt - Converts a value to Int
  • toFloat - Converts a value to Float
  • toString - Converts a value to String
  • upcase - Converts a string to all uppercase characters.
  • url_decode - Decodes a string to URL-safe format by converting percent-encoded characters to special characters.
  • url_encode - Encodes a string to URL-safe format by converting special characters to percent-encoded characters.