/ 
Reactive-Core-0.106
River stage one • 1 direct dependent • 1 total dependent
/ Reactive::Core::TemplateRenderer

render($self, $type, $template, %properties) This method is not expected to be called directly via userland code but instead will be called by Reactive::Core->_to_snapshot

This method must be overridden with a renderer specific implemenation, for example see Reactive::Mojo implementation

$type may be 'File' or 'Inline' (RENDER_TEMPLATE_FILE | RENDER_TEMPLATE_INLINE)

if 'File' then $template will be the path to the file
if 'Inline' then $template will be the inline template

%parameters will be the data that should be passed to the template
it will always include a key of 'self' which will be the component object
it will also include any data returned by $component->r_get_properties
which by default will include all public properties on the component

this method should return a string of html

escape($self, $string) This method is not expected to be called directly via userland code but instead will be called by Reactive::Core::TemplateRenderer->inject_attribute

will convert special characters in the string passed to their html entity equivilent
eg '<' => '&lt;'

should be overriden by the framework specific plugin,
eg Reactive::Mojo::TemplateRenderer overrides this with Mojo::Util->xml_escape

inject_snapshot($self, $html, $snapshot) This method is not expected to be called directly via userland code but instead will be called by Reactive::Core->initial_render

$html will be the string returned from ->render
$snapshot will be a HashRef containing various data about the state of the component

this method will embed that snapshot data into a `reactive:snapshot` attribute on the
root node of the html

inject_attribute($self, $html, $attribute, $value) This method is not expected to be called directly via userland code but instead will be called by ->inject_snapshot

$html will be the string returned from ->render
$attribute will be a string with the attribute name
$value will be a HashRef containing various data about the state of the component

this method will json encode the value and embed the result into the root node of the
html as $attribute

it will then return the resulting string of html

AUTHOR

Robert Moore, <robert at r-moore.tech>

BUGS

Please report any bugs or feature requests to bug-reactive-core at rt.cpan.org, or through the web interface at https://rt.cpan.org/NoAuth/ReportBug.html?Queue=Reactive-Core. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Reactive::Core

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

This software is Copyright (c) 2025 by Robert Moore.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)