Plugins

Using plugins

CLI

kossr --plugin ./my-ssr-plugin.js ...

API

import ssrPlugin from './my-ssr-plugin.js'; 

await render(..., {
  plugins: [
    ssrPlugin 
  ],
});

Writing plugins

Plugins are written as modules, which can either be imported, or passed to the --plugin flag in the CLI. The module should export a Plugin object as the default export.

For example, you can integrate your i18n framework by creating a plugin similar to the below.

import { Plugin, utils } from "@kolint/ssr";

const i18n: Plugin = {
  // Look for bindings with name "i18n". Once the plugin claims the bindings,
  // no other plugins will touch it.
  filter: (binding) => binding.name === "i18n",

  // This method is called when server-side rendering.
  ssr: ({ binding, generated, value }) => {
    // `value()` is the evaluation of the binding expression.
    const translated = i18next.t(value());

    // Get the inner range (children) of the element of the binding.
    const inner = utils.getInnerRange(binding.parent, generated.original);
    // Replace the inner range with the translated text.
    generated.update(...inner.offset, utils.escapeHtml(translated));
  },
};

export default i18n;