宏
Edusoho 主题的开发支持使用宏
宏的定义
example:
{% macro test(text) %}
<p>{{ test }}</p>
{% endmacro %}
宏的引入
{% import 'macro.html.twig' as web_macro %}
提示
本页所有示例的宏的引入命名都为web_macro
官方提供的宏
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') }}
当前内容版权归 EduSoho官方文档 或其关联方所有,如需对内容或内容相关联开源项目进行关注与资助,请访问 EduSoho官方文档 .