What is a macro?
Textbox.io provides a Macro API enabling you to create functions that detect particular content in the editor as a user types, and perform meaningful actions to manipulate the content. Specifically macros are evaluated when the user presses the space or the enter keys.
Currently, Textbox provides the ability to add a "Simple" macro, using:
editor.macros.addSimpleMacro('startString', 'endString', callback)
where any text entered before the spacebar is pressed that begins with
startString and ends with
endString forms a pattern. When a match is found,
callback is applied with the match as an argument.
callback can return a replacement (if one is necessary), or the original that was matched.
A collection of macros are enabled by default. The list of macros, and how to control their availability, is documented in the macros configuration object.
Example: Red text
In the example provided below, we match on any text that begins with
[red] and ends with
[/red], and wrap the text in a
span where the color is set to red. For example, any of the following would be matches:
[red] She sells sea shells by the sea shore[/red]
macros configuration object
editor.macros runtime API