View Source Surface.Catalogue behaviour (surface v0.11.4)

A behaviour to provide additional information about the catalogue.

Optional for local catalogues. Usually required if you want to share your components as a library.

Summary

Callbacks

Returns a keyword list of config options to be used by the catalogue tool.

Functions

Loads a text file as module attribute so you can inject its content directly in head_css or head_js config options.

Callbacks

@callback config() :: keyword()

Returns a keyword list of config options to be used by the catalogue tool.

Available options:

  • head_css - CSS related content to be added to the <head>...</head> section of each example or playground.

  • head_js - JS related content to be added to the <head>...</head> section of each example or playground.

  • example - A keyword list of options to be applied for all examples in the catalogue.

  • playground - A keyword list of options to be applied for all playgrounds in the catalogue.

Functions

Link to this macro

load_asset(file, opts)

View Source (macro)

Loads a text file as module attribute so you can inject its content directly in head_css or head_js config options.

Useful to avoid depending on external css or js code. The path should be relative to the caller's folder.

Available options:

  • as - the name of the module attribute to be generated.