TWIG模板使用说明

2024-05-06 09:32
文章标签 模板 使用 说明 twig

本文主要是介绍TWIG模板使用说明,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

Twig中有两种定界符{% ... %} 和 {{ ... }} , 前一种用来执行语句,比如for循环、IF判断、过滤等操作,后一种模版中用来显示变量。

Twig常用用法

可用符号

== != < > >= <= + - ~ * / // % ** | [] . .. and or not in is b-and b-or b-xor

部分符号的含义如下

~:连接两字符串,相当于 PHP 中的点号

//:整除

**:乘方,相当于 PHP 中的 ^

b-and、b-or、b-xor:按位与、按位或、按位异或

-:减法以及去除空白的简写用法,如 {{- 数据 }} => 去除左边的空白、{{ 数据 -}} => 去除右边的空白、{{- 数据 -}} => 去除两边的空白

注释

{# This is Twig Comment #}

变量

foo 为PHP赋值变量, 则模版中可以使用 {{ foo }}

如果该变量为数组或者对象,则可以使用 {{ foo.bar }}来表示,也可以直接调用类中的方法,如 {{ foo.getName }} 或当有参数传递时使用 {{ foo.getName(p1, p2, p3) }}

当模版中使用{{ foo.bar }}时,PHP会做如下判断来检测对应变量的值:

1. 检测foo是否是数组,并且bar是一个有效的KEY

2. 如果foo为对象,则检测bar是否为有效的属性

3. 如果foo为对象,但bar不是一个有效的属性,则检测bar是否为有效方法

4. 如果foo为对象,但bar不是一个有效的方法,则检测getBar是否为有效方法

5. 如果foo为对象,但getBar不是有效方法,则检测isBar是否为有效方法

6. 如果没有,则返回null

当foo为数组时,模版也可以这样使用:{{ foo['bar'] }}

变量未定义默认值设置:

{{ var|default('var is not defined') }}

可使用 {% set 变量名=变量值 %} 声明变量,也可写成 {% set 变量名 %} 变量值 {% endset %}

PHP 中非关联数组被映射成 [元素1, 元素2, ...],关联数组则被映射成 {键1: 值1, 键2: 值2, ...}

数组遍历

-- 按数组value遍历:

1 2 3

{% for value in foo %} {{ value }} {% endfor %}

-- 按数组key遍历:

1 2 3

{% for key in foo|keys %} {{ key }} {% endfor %}

-- 按key,value遍历

1 2 3

{% for key, value in foo %} {{ key}}:{{value }} {% endfor %}

-- 如果 foo 非数组,还可以使用else语句,如:

1 2 34 5

{% for key, value in foo %} {{ key}}:{{value }} {% else %} foo is Not a Array {% endfor %}

-- 也可以直接带条件,遍历二维数组时比较有用,可用value.field来判断:

1 2 3

{% for key, value in foo if value == 1%} {{ key}}:{{value }} {% endfor %}

循环体内部变量:

loop.index 循环的次数(从1开始)

loop.index0 循环的次数(从0开始)

loop.revindex 循环剩余次数(最小值为1)

loop.revindex0 循环剩余次数(最小值为0)

loop.first 当第一次循环的时候返回true

loop.last 当最后一次循环的时候返回true

loop.length 循环的总数

loop.parent 被循环的数组

条件语句

-- 需要使用 or 和 and 代替 ||、&&

1 2 3

{% if a == '1' or b == '2' %} a = 1 or b = 2 {% endif %}

-- 判断变量是否定义

1 2 3

{% if var is not defined %} {# do something #} {% endif %}

-- 是否为NULL

1 2 3

{% if var is null %} {# do something #} {% endif %}

-- 是否为false

1 2 3

{% if var is sameas(false) %} {# do something %} {% endif %}

解析定界符

1 2 34 5 67 8 9

{{ '{{' }} {% raw %} <ul> {% for item in seq %} <li>{{ item }}</li> {% endfor %} </ul> {% endraw %}

控制结构

{% if aaa %} xxx {% elseif bbb %} yyy {% else %} zzz:判断语句

{% for %} xxx {% endfor %}:迭代变量

{% do %}:没什么其他含义,{% do 1+2 %} 等同于 {{ 1+2 }}

{% flush %}:刷新输出缓冲,等同于 flush

{% include %}:包含模板

{% extends %}:扩展模板

{% embed %} xxx {% endembed %}:包含模板并扩展该模板的内容,相当于 include 和 extends 的结合体

{% use %}:包含模板,近似于多重继承

{% from aaa import bbb as ccc %}:从指定模板导入宏并设置别名

{% macro %} xxx {% endmacro %}:定义宏以便多次调用,与定义 PHP 函数无异

{% sandbox %} {% include xxx %} {% endsandbox %}:对导入的模板指定沙箱模式,只对 include 语句有效,只在沙箱模式已开启的情况下生效

{% block xxx %} 或 {% block %} xxx {% endblock %}:定义代码块或覆盖代码块

{% set xxx %} 或 {% set %} xxx {% endset %}:在模板内定义变量

{% filter %} xxx {% endfilter %}:多行过滤器

{% spaceless %} xxx {% endspaceless %}:去除 HTML 片段中的空格

{% autoescape %} xxx {% endautoescape %}:将字符串安全地处理成合法的指定数据

{% verbatim %} xxx {% endverbatim %}:阻止模板引擎的编译,是 raw 的新名字

内建过滤器

过滤器用来修饰数据,各过滤器可以用竖线分隔进行链式调用,用括号传递参数

也可以将过滤器当成单独的函数来用,形式如下:

1 2 3

{% filter 过滤器名 %} 待处理的数据 {% endfilter %}

batch:将数组按指定的个数分割成更小的数组,可选的第二个参数用来在元素不够的情况下进行填充。如 {{ [1, 2, 3, 4, 5]|batch(2, 'NoItem') }} => [[1, 2], [3, 4], [5, 'NoItem']]

date_modify:修改时间,常与 date 联用。如 {{ ''|date_modify('+3 days')|date('Y-m-d') }} => 将当前时间加3天后显示

default:当所修饰的数据不存在或为空时,提供默认值。如 {{ ''|default('Ruchee') }} => 'Ruchee'

escape:将字符串安全地处理成合法的指定数据,可简写为 e,支持多种转换模式,默认模式为 html,其他可选模式有 html_attr、js、css、url

first:返回数组的第一个元素或字符串的第一个字符。如 {{ {a: 1, b: 2, c: 3}|first }} => 1

last:返回数组的最后一个元素或字符串的最后一个字符。如 {{ {a: 1, b: 2, c: 3}|last }} => 3

replace:替换一个字符串中的指定内容。如 {{ '%s1 love %s2'|replace({'%s1': 'Ruchee', '%s2': 'Vim'}) }} => 'Ruchee love Vim'

raw:让数据在 autoescape 过滤器里失效

借用自PHP自带函数的过滤器

abs:取绝对值

nl2br:将字符串里的 \n 替换成 <br/>

join:将数组的各个元素按指定分隔符组成字符串

sort:对数组排序

trim:去除字符串首尾的指定字符,默认为空格

date:格式化时间,可处理与 strtotime 兼容的字符串,或 DateTime/DateInterval 的实例,可选的第二个参数用于指定时区,如果所修饰的数据为空则默认为当前时间

reverse:反转一个数组或字符串,在 array_reverse 的基础上增加了对字符串的处理

slice:截取数组或字符串的一部分,在 array_slice 的基础上增加了对字符串的处理

keys:将数组的全部键名提取成一个数组,等同于 array_keys

merge:合并两数组,近似于 array_merge 。如 {{ 数组1|merge(数组2) }}

length:返回数组元素的个数或字符串的长度,等同于 count 和 strlen 的结合体

capitalize:将字符串的首字母大写,等同于 ucfirst

title:将字符串中每个单词的首字母大写,等同于 ucwords

lower:将字符串所有字母全部变成小写,等同于 strtolower

upper:将字符串所有字母全部变成大写,等同于 strtoupper

split:将字符串分割成数组,等同于 str_split

striptags:去除字符串中的 HTML/PHP 标记,等同于 strip_tags

url_encode:编码链接字符串,等同于 urlencode

json_encode:编码 JSON 格式,等同于 json_encode

format:格式化一个字符串,近似于 printf 。如 {{ 'My name is %s, and I love %s'|format('Ruchee', 'Vim') }} => 'My name is Ruchee, and I love Vim'

number_format:格式化数值,等同于 number_format

convert_encoding:编码转换,第一个参数指定转换后的编码,第二个参数指定转换前的编码,近似于 iconv

内建函数

even:是否为偶数

odd:是否为奇数

empty:是否为空

null:是否为 null

defined:是否已定义

sameas:目标变量与指定值是否指向的是内存中的同一个地址,使用形式 if 变量值 is sameas(指定值)

divisibleby:目标数值是否能够被指定值整除,使用形式 if 目标数值 divisibleby(指定值),其中指定值不能为 0

iterable:目标变量是否是数组或者是否可迭代,使用形式 if 变量值 is iterable

attribute:动态获取变量属性值,两种使用形式为 attribute(数组, '元素名') 和 attribute(对象, '方法名', 可选参数)

block:重复引用指定代码块,如 {{ block('title') }}

constant:从字符串或对象取得常量值

cycle:循环显示一个数组的元素,调用形式为 cycle(数组, 一个循环变量)

date:格式化时间

dump:在开启调试模式的情况下显示详细的变量信息,等同于 var_dump

include:包含其他模板文件

parent:在覆盖代码片段时用于引用父片段的内容

random:制造一个随机数

range:返回一个指定区间的数组,可指定步长,Twig 使用 .. 作为其简用法,等同于 range

template_from_string:根据字符串加载模板

这篇关于TWIG模板使用说明的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/964011

相关文章

Go语言中make和new的区别及说明

《Go语言中make和new的区别及说明》:本文主要介绍Go语言中make和new的区别及说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1 概述2 new 函数2.1 功能2.2 语法2.3 初始化案例3 make 函数3.1 功能3.2 语法3.3 初始化

Spring IoC 容器的使用详解(最新整理)

《SpringIoC容器的使用详解(最新整理)》文章介绍了Spring框架中的应用分层思想与IoC容器原理,通过分层解耦业务逻辑、数据访问等模块,IoC容器利用@Component注解管理Bean... 目录1. 应用分层2. IoC 的介绍3. IoC 容器的使用3.1. bean 的存储3.2. 方法注

Python内置函数之classmethod函数使用详解

《Python内置函数之classmethod函数使用详解》:本文主要介绍Python内置函数之classmethod函数使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地... 目录1. 类方法定义与基本语法2. 类方法 vs 实例方法 vs 静态方法3. 核心特性与用法(1编程客

Linux中压缩、网络传输与系统监控工具的使用完整指南

《Linux中压缩、网络传输与系统监控工具的使用完整指南》在Linux系统管理中,压缩与传输工具是数据备份和远程协作的桥梁,而系统监控工具则是保障服务器稳定运行的眼睛,下面小编就来和大家详细介绍一下它... 目录引言一、压缩与解压:数据存储与传输的优化核心1. zip/unzip:通用压缩格式的便捷操作2.

java中新生代和老生代的关系说明

《java中新生代和老生代的关系说明》:本文主要介绍java中新生代和老生代的关系说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、内存区域划分新生代老年代二、对象生命周期与晋升流程三、新生代与老年代的协作机制1. 跨代引用处理2. 动态年龄判定3. 空间分

使用Python实现可恢复式多线程下载器

《使用Python实现可恢复式多线程下载器》在数字时代,大文件下载已成为日常操作,本文将手把手教你用Python打造专业级下载器,实现断点续传,多线程加速,速度限制等功能,感兴趣的小伙伴可以了解下... 目录一、智能续传:从崩溃边缘抢救进度二、多线程加速:榨干网络带宽三、速度控制:做网络的好邻居四、终端交互

Python中注释使用方法举例详解

《Python中注释使用方法举例详解》在Python编程语言中注释是必不可少的一部分,它有助于提高代码的可读性和维护性,:本文主要介绍Python中注释使用方法的相关资料,需要的朋友可以参考下... 目录一、前言二、什么是注释?示例:三、单行注释语法:以 China编程# 开头,后面的内容为注释内容示例:示例:四

Go语言数据库编程GORM 的基本使用详解

《Go语言数据库编程GORM的基本使用详解》GORM是Go语言流行的ORM框架,封装database/sql,支持自动迁移、关联、事务等,提供CRUD、条件查询、钩子函数、日志等功能,简化数据库操作... 目录一、安装与初始化1. 安装 GORM 及数据库驱动2. 建立数据库连接二、定义模型结构体三、自动迁

MySQL之InnoDB存储引擎中的索引用法及说明

《MySQL之InnoDB存储引擎中的索引用法及说明》:本文主要介绍MySQL之InnoDB存储引擎中的索引用法及说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐... 目录1、背景2、准备3、正篇【1】存储用户记录的数据页【2】存储目录项记录的数据页【3】聚簇索引【4】二

mysql中的数据目录用法及说明

《mysql中的数据目录用法及说明》:本文主要介绍mysql中的数据目录用法及说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1、背景2、版本3、数据目录4、总结1、背景安装mysql之后,在安装目录下会有一个data目录,我们创建的数据库、创建的表、插入的