aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/smarty/smarty/docs/designers/language-basic-syntax/language-syntax-attributes.md
blob: 0fa7c773458addc31929909ff198e6a24bc3ed16 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
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.