{% flash %}
The {% flash %}
and {% endflash %}
tags will render any flash messages stored in the user session, set by the Flash
PHP class. The message
variable inside will contain the flash message text and the markup inside will repeat for multiple flash messages.
<ul>
{% flash %}
<li>{{ message }}</li>
{% endflash %}
</ul>
You can use the type
variable that represents the flash message type - success
, error
, info
or warning
.
{% flash %}
<div class="alert alert-{{ type }}">
{{ message }}
</div>
{% endflash %}
You can also specify the type
to filter flash messages of a given type. The next example will show only success
messages, if there is an error
message it won't be displayed.
{% flash success %}
<div class="alert alert-success">{{ message }}</div>
{% endflash %}
If you are using the Snowboard Flash utility in your theme, you should use the following code to ensure that flash messages are handled correctly by this utility:
{% flash %}
<p
data-control="flash-message"
class="flash-message fade"
data-flash-type="{{ type }}"
data-flash-duration="5">
{{ message }}
</p>
{% endflash %}
Setting flash messages
Flash messages can be set by Components or inside the page or layout PHP section with the Flash
class.
<?php
function onSave()
{
// Sets a successful message
Flash::success('Settings successfully saved!');
// Sets an error message
Flash::error('Error saving settings');
// Sets a warning message
Flash::warning('There was a problem but no worries');
// Sets an informative message
Flash::info('Just a heads up about the settings');
}