soy文件的语法规则

1.声明全局的命名空间

 

{namespace examples.simple}

 

2.声明模板自己的名称

 

{template .helloWorld}  ...  {/template}

 

 

3.在备注中，声明模板体中的参数：@param 参数名

    @param？ 表示可选参数

   在模板体中，声明参数： { @param 参数名：参数说明 }   

   3.1  引用已经声明的参数：$ 参数名

   例如：引用名为“folders”的map集合中第一个元素的key为“name”对应的值，表示为：

   $folders.0.name    OR    $folders[0].name     OR   $folders[0]['name']

 

/**
 * Greets a person using "Hello" by default.
 * @param name The name of the person.
 * @param? greetingWord Optional greeting word to use instead of "Hello".
 */
{template .helloName}
  {if not $greetingWord}
    Hello {$name}!
  {else}
    {$greetingWord} {$name}!
  {/if}
{/template}

 

 

/**
 * Says hello to a person.
 */
{template .helloName}
  {@param name: string} /** Name of the person to say hello to. */
  Hello {$name}!
{/template}

    3.2自动注入子模板中的数据：$ij

 

    3.3 基本引用和空值安全引用

    基本引用：$a[0] 、$a.b

    空值安全引用：$a?[0]、$a?.b  【当左侧（？之前的部分）未定义或为null时，空值安全访问将计算为null】

     3.4 注意：不带$符号的是全局数据。（全局是不作为参数显式传递到模板中的数据）

 

4.模板之间的调用：call

 

/**
 * Greets a person and optionally a list of other people.
 * @param name The name of the person.
 * @param additionalNames The additional names to greet. May be an empty list.
 */
{template .helloNames}
  // Greet the person.
  {call .helloName data="all" /}<br>            //data="all"表示把调用模板的所有数据都导过来
  // Greet the additional people.
  {foreach $additionalName in $additionalNames}
    {call .helloName}
      {param name: $additionalName /}
    {/call}
    {if not isLast($additionalName)}
      <br>  // break after every line except the last
    {/if}
  {ifempty}
    No additional people to greet.
  {/foreach}
{/template}

 

5. 调用函数以获取模板内容：  模板全名（） 或者    模板全名（{ 参数名：参数值 }） 

 

 

 // Exercise the .helloWorld template
    document.write(examples.simple.helloWorld());
    // Exercise the .helloName template
    document.write('<hr>' + examples.simple.helloName({name: 'Ana'}));
    // Exercise the .helloNames template
    document.write('<hr>' + examples.simple.helloNames( {name: 'Ana', additionalNames: ['Bob', 'Cid', 'Dee']} ) ); 

 

6.基本数据类型

 

Null，Boolean，Integer，String，Float

List 例如：[1, 'two', [3, false]]，[]表示空list

Map 例如：['aaa': 42, 'bbb': 'hello']， [:]表示空map

 

7.在soy文件中调用国际化.properties文件配置的key-value值：

 

{ getText('confluence.tutorial.soy.templates.intro') }getText('confluence.tutorial.soy.templates.intro') }