Provides an interface for registering and inserting content into simple logic-less string templates.
Used by several helpers to provide simple flexible templates for generating HTML and other content.
array
List of attributes that can be made compact.
array
Contains the list of compiled templates
array
Runtime config
bool
Whether the config property has already been configured with defaults
array
A stack of template sets that have been stashed temporarily.
array
The default templates this instance holds.
Formats an individual attribute, and returns the string value of the composed attribute.
Merge provided config with existing config. Unlike config()
which does a recursive merge for nested keys, this method does a simple merge.
Returns a space-delimited string with items of the $options array. If a key of $options array happens to be one of those listed in StringTemplate::$_compactAttributes
and its value is one of:
__construct(array $config)
Constructor.
array
$config optional A set of templates to add.
_compileTemplates(array $templates)
Compile templates into a more efficient printf() compatible format.
string[]
$templates optional The template names to compile. If empty all templates will be compiled.
_configDelete(string $key)
Deletes a single config key.
string
$key Key to delete.
Cake\Core\Exception\Exception
_configRead(?string $key)
Reads a config key.
string|null
$key Key to read.
mixed
_configWrite(mixed $key, mixed $value, mixed $merge)
Writes a config key.
string|array
$key Key to write to.
mixed
$value Value to write.
bool|string
$merge optional True to merge recursively, 'shallow' for simple merge, false to overwrite, defaults to false.
Cake\Core\Exception\Exception
_formatAttribute(string $key, mixed $value, mixed $escape)
Formats an individual attribute, and returns the string value of the composed attribute.
Works with minimized attributes that have the same value as their name such as 'disabled' and 'checked'
string
$key The name of the attribute to create
string|string[]
$value The value of the attribute to create.
bool
$escape optional Define if the value must be escaped
string
The composed attribute.
add(array $templates)
Registers a list of templates by name
$templater->add([ 'link' => '<a href="{{url}}">{{title}}</a>' 'button' => '<button>{{text}}</button>' ]);
string[]
$templates An associative list of named templates.
$this
addClass(mixed $input, mixed $newClass, string $useIndex)
Adds a class and returns a unique list either in array or space separated
array|string
$input The array or string to add the class to
array|string
$newClass the new class or classes to add
string
$useIndex optional if you are inputting an array with an element other than default of 'class'.
string|string[]
configShallow(mixed $key, mixed $value)
Merge provided config with existing config. Unlike config()
which does a recursive merge for nested keys, this method does a simple merge.
Setting a specific value:
$this->configShallow('key', $value);
Setting a nested value:
$this->configShallow('some.nested.key', $value);
Updating multiple config settings at the same time:
$this->configShallow(['one' => 'value', 'another' => 'value']);
string|array
$key The key to set, or a complete array of configs.
mixed|null
$value optional The value to set.
$this
format(string $name, array $data)
Format a template string with $data
string
$name The template name.
array
$data The data to insert.
string
Formatted string
RuntimeException
formatAttributes(?array $options, ?array $exclude)
Returns a space-delimited string with items of the $options array. If a key of $options array happens to be one of those listed in StringTemplate::$_compactAttributes
and its value is one of:
Then the value will be reset to be identical with key's name. If the value is not one of these 4, the parameter is not output.
'escape' is a special option in that it controls the conversion of attributes to their HTML-entity encoded equivalents. Set to false to disable HTML-encoding.
If value for any option key is set to null
or false
, that option will be excluded from output.
This method uses the 'attribute' and 'compactAttribute' templates. Each of these templates uses the name
and value
variables. You can modify these templates to change how attributes are formatted.
array|null
$options Array of options.
array|null
$exclude optional Array of options to be excluded, the options here will not be part of the return.
string
Composed attributes.
getConfig(?string $key, mixed $default)
Returns the config.
Reading the whole config:
$this->getConfig();
Reading a specific value:
$this->getConfig('key');
Reading a nested value:
$this->getConfig('some.nested.key');
Reading with default value:
$this->getConfig('some-key', 'default-value');
string|null
$key optional The key to get or null for the whole config.
mixed
$default optional The return value when the key does not exist.
mixed
Configuration data at the named key or null if the key does not exist.
getConfigOrFail(string $key)
Returns the config for this specific key.
The config value for this key must exist, it can never be null.
string
$key The key to get.
mixed
Configuration data at the named key
InvalidArgumentException
load(string $file)
Load a config file containing templates.
Template files should define a $config
variable containing all the templates to load. Loaded templates will be merged with existing templates.
string
$file The file to load
pop()
Restore the most recently pushed set of templates.
push()
Push the current templates into the template stack.
remove(string $name)
Remove the named template.
string
$name The template to remove.
setConfig(mixed $key, mixed $value, mixed $merge)
Sets the config.
Setting a specific value:
$this->setConfig('key', $value);
Setting a nested value:
$this->setConfig('some.nested.key', $value);
Updating multiple config settings at the same time:
$this->setConfig(['one' => 'value', 'another' => 'value']);
string|array
$key The key to set, or a complete array of configs.
mixed|null
$value optional The value to set.
bool
$merge optional Whether to recursively merge or overwrite existing config, defaults to true.
$this
Cake\Core\Exception\Exception
List of attributes that can be made compact.
array
Contains the list of compiled templates
array
Runtime config
array
Whether the config property has already been configured with defaults
bool
A stack of template sets that have been stashed temporarily.
array
The default templates this instance holds.
array
© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.1/class-Cake.View.StringTemplate.html