宏

Edusoho 主题的开发支持使用宏

宏的定义

example:
{% macro test(text) %}
    <p>{{ test }}</p>
{% endmacro %}

宏的引入

{% import 'macro.html.twig' as web_macro %}

提示

本页所有示例的宏的引入命名都为web_macro

官方提供的宏

• user_avatar_link
• user_avatar_img
• user_link
• flash_messages
• bytesToSize
• paginator
• star
• ajax_paginator
• link

user_avatar_link

user_avatar_link(user, size, options)

输出单个用户的头像链接。

参数：

名称	必需	说明
user array	是	用户对象
size string	是	图片规格 small，medium，large
options array	否	设置项 card(显示卡片)， _blank(新开窗口)， null_link(空链接)

用法：

输出带卡片，并新开窗口的头像的链接：

{{ web_macro.user_avatar_link(user, 'small', ['card', '_blank']) }}

输出链接为空的用户头像：

{{ web_macro.user_avatar_link(user, 'small', ['null_link']) }}

user_avatar_img

user_avatar_img(user, size)

输出单个用户含头像。

参数：

名称	必需	说明
user array	是	用户对象
size string	是	图片规格 small，medium，large

用法：

输出单个用户含头像：

{{ web_macro.user_avatar_img(user, 'small'}}

user_link

user_link(user, class, options)

输出单个用户昵称链接。

参数：

名称	必需	说明
user array	是	用户对象
class string	是	css
options array	否	设置项 card(显示卡片)， _blank(新开窗口)， null_link(空链接)

用例：

输出带卡片，并新开窗口的用户名的链接：

{{ web_macro.user_link(user, 'example-class', ['card', '_blank']}}

输出链接为空的用户名：

{{ web_macro.user_link(user, 'example-class', ['null_link']}}

flash_messages

flash_messages()

显示页面顶部弹条

参数：

无

用例：

显示当前页面的通知

{{ web_macro.flash_messages() }}

bytesToSize

bytesToSize(bytes)

自动将字节数(bytes)转换成KB、MB、GB、TB。

参数：

名称	必需	说明
bytes int	是	容量字节数

用例：

将字节数自动转换成合适的容量格式

{{ web_macro.bytesToSize(size) }}

paginator

paginator(paginator, class)

生成页面分页器

参数：

名称	必需	说明
paginator object	是	paginator对象
class string	否	默认值text-center CSS class<nav class="[class]"></nav>

用例：

显示分页

{{ paginator(paginator, 'text-center') }}

star

star(score)

生成1-5星级模块

参数：

名称	必需	说明
score int	是	星级数量 1~5

用例：

{{ web_macro.star(number) }}

ajax_paginator

ajax_paginator(paginator)

ajax加载页面的分页器

参数：

名称	必需	说明
paginator object	是	paginator对象

用例：

生成ajax分页器

{{ web_macro.ajax_paginator(paginator) }}

link

link(name, url, title = '', target = '_blnak')

生成链接

参数：

名称	必需	说明
name string	是	链接显示文案
url string	是	a.href
title string	是	a.title
target string	否	a.target

用例：

生成链接

{{ link(name, url, title = '', target = '_blnak') }}