aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/smarty/smarty/docs/designers/language-basic-syntax/language-syntax-attributes.md
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/smarty/smarty/docs/designers/language-basic-syntax/language-syntax-attributes.md')
-rw-r--r--vendor/smarty/smarty/docs/designers/language-basic-syntax/language-syntax-attributes.md50
1 files changed, 50 insertions, 0 deletions
diff --git a/vendor/smarty/smarty/docs/designers/language-basic-syntax/language-syntax-attributes.md b/vendor/smarty/smarty/docs/designers/language-basic-syntax/language-syntax-attributes.md
new file mode 100644
index 000000000..0fa7c7734
--- /dev/null
+++ b/vendor/smarty/smarty/docs/designers/language-basic-syntax/language-syntax-attributes.md
@@ -0,0 +1,50 @@
+Attributes {#language.syntax.attributes}
+==========
+
+Most of the [functions](#language.syntax.functions) take attributes that
+specify or modify their behavior. Attributes to Smarty functions are
+much like HTML attributes. Static values don\'t have to be enclosed in
+quotes, but it is required for literal strings. Variables with or
+without modifiers may also be used, and should not be in quotes. You can
+even use PHP function results, plugin results and complex expressions.
+
+Some attributes require boolean values (TRUE or FALSE). These can be
+specified as `true` and `false`. If an attribute has no value assigned
+it gets the default boolean value of true.
+
+
+ {include file="header.tpl"}
+
+ {include file="header.tpl" nocache} // is equivalent to nocache=true
+
+ {include file="header.tpl" attrib_name="attrib value"}
+
+ {include file=$includeFile}
+
+ {include file=#includeFile# title="My Title"}
+
+ {assign var=foo value={counter}} // plugin result
+
+ {assign var=foo value=substr($bar,2,5)} // PHP function result
+
+ {assign var=foo value=$bar|strlen} // using modifier
+
+ {assign var=foo value=$buh+$bar|strlen} // more complex expression
+
+ {html_select_date display_days=true}
+
+ {mailto address="smarty@example.com"}
+
+ <select name="company_id">
+ {html_options options=$companies selected=$company_id}
+ </select>
+
+
+
+> **Note**
+>
+> Although Smarty can handle some very complex expressions and syntax,
+> it is a good rule of thumb to keep the template syntax minimal and
+> focused on presentation. If you find your template syntax getting too
+> complex, it may be a good idea to move the bits that do not deal
+> explicitly with presentation to PHP by way of plugins or modifiers.