closure-templates表达式与控制流清单If/For/Let/Print实用技巧一篇全掌握【免费下载链接】closure-templatesA client- and server-side templating system that helps you dynamically build reusable HTML and UI elements项目地址: https://gitcode.com/gh_mirrors/clo/closure-templatesClosure TemplatesSoy是 Google 出品的客户端与服务端一体化模板系统而表达式与控制流正是写模板最先要掌握的核心技能。本文用一份实用清单带你快速吃透If / For / Let / Print四个最高频命令帮助新手一次性构建出可复用的动态 HTML 与 UI 组件。一、5 分钟理解模板表达式的基本构成Closure Templates 让你一套模板两端运行。模板由两种元素拼成表达式Expressions引用数据、计算中间值几乎每条命令里都能写命令Commands用{}包裹的指令其中if、for、let、print是控制流与输出的四大主力。四种常见表达式速览形式示例用途字面量true、3.14、hello固定常量变量$name、$user.age读取参数与字段运算符$a $b、$x ?? 0逻辑、比较、兜底默认值函数调用join(, , $list)调用内置函数加工数据 完整语法速查见 documentation/reference/expressions.md适合初学者的概念讲解在 documentation/concepts/expressions.md。二、If 条件判断输出控制的两种武器if是最直接的分支命令任一条件为 true 就执行该分支其余直接跳过。{if $score 60} 通过 {else} 再接再厉 {/if}实用技巧多分支就用elseif数量不限按单个值匹配多个分支时switch更清爽且空case不会像 Java/JS 那样向下穿透类型不确定的值可以先用instanceof判断类型再分支避免运行时报错。完整语法与更多例子见 documentation/reference/control-flow.md。三、For 循环遍历列表迭代三连招{for $name, $i in $names} {if $i ! 0}, {/if}{$name} {/for}实用技巧for的第二个变量是0 起始的位置索引用来加逗号、隔行变色非常方便只想输出一串数字range(5)直接生成0~4无需额外传数据列表为空就不渲染用{for-nonempty}天然跳过空列表循环变量只在循环体内有效出了作用域自动失效无需手动清理。官方示例 examples/simple.soy 里的helloNames模板就用「for 索引」串联多条问候语是最值得照抄的实战写法。四、Let 变量声明给中间值起个好名字的 3 种方式let把一个不可变的中间值绑定到变量名上作用域仅限当前代码块{let $isEnabled: $isAaa $isBbb 0 /} {if $isEnabled} ... {/if}实用技巧同一表达式多处使用时先用let提取少算一次、读起来也清爽想存渲染好的 HTML 片段用块形式{let $frag kindhtml}...{/let}块内只有一个{call}时可省略kind编译器会自动从被调模板推断类型重复声明同名let会直接编译报错——这是防误覆盖的刻意设计。语法细节见 documentation/reference/let.md。五、Print 输出简写语法与管道指令print是使用频率最高的命令命令名可以直接省略{$userName} // 等价于 {print $userName} {$userContent|cleanHtml:ul,li} // 管道指令对输出做后处理实用技巧输出会按上下文自动转义从源头降低 XSS 风险原理见 documentation/concepts/auto-escaping.md管道指令用|串联、按顺序生效cleanHtml适合给用户内容放行白名单标签指令还支持参数例如truncate:10截断过长文本列表页排版必备。全部指令清单见 documentation/reference/print-directives.md。六、高频表达式运算符一览表运算符作用新手友好示例? :三元选择$ok ? 是 : 否??空值兜底推荐替代or$label ?? . / ?.字段访问 / 空安全访问$user?.email \|\|短路逻辑旧写法and/or已弃用$a $binstanceof运行时类型判断$v instanceof string⚠️ 注意??只在左侧为null/undefined时才取右值0和空字符串不算空值别把它和||混用。完整运算符与优先级表见 documentation/reference/expressions.md。七、新手学习路线从零到一的三步先跑通阅读 examples/simple.soy 里的 helloWorld / helloName 示例最短路径理解模板结构再动手把本文 If / For / Let / Print 四个小节的片段各抄一遍并改改参数后查漏概念看 documentation/concepts/速查看 documentation/reference/项目全貌看 README.md。✅全篇清单回顾if/elseif/else管多条件switch/case管多取值空 case 不穿透for第二变量是索引range(n)生成数字序列空列表用for-nonemptylet不可变、块级作用域块形式可渲染为带类型的字符串{expr}即 print 简写|串联指令做后处理默认值用??、逻辑用 ||、安全取值用?.掌握 If / For / Let / Print 这四条命令就覆盖了 80% 的日常模板场景。再配上自动转义与消息国际化能力你可以放心地开始搭建动态页面了。【免费下载链接】closure-templatesA client- and server-side templating system that helps you dynamically build reusable HTML and UI elements项目地址: https://gitcode.com/gh_mirrors/clo/closure-templates创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考