Edge 辅助函数和标签
在本指南中，我们将了解 AdonisJS 官方包为 Edge 贡献的 辅助函数和标签。本指南不涵盖 Edge 自带的辅助函数，如需了解，请参考 Edge 文档。
request
引用当前 HTTP 请求 的实例。该属性仅在使用 ctx.view.render 方法渲染模板时可用。
{{ request.url() }}
{{ request.input('signature') }}
route/signedRoute
用于使用 URL 构建器 为路由创建 URL 的辅助函数。与 URL 构建器不同，视图辅助函数没有流畅的 API，并接受以下参数。
| 位置 | 描述 |
| 第 1 个 | 路由标识符或路由模式 |
| 第 2 个 | 路由参数定义为数组或对象。 |
| 第 3 个 |
包含以下属性的选项对象。
|
<a href="{{ route('posts.show', [post.id]) }}">
查看帖子
</a>
<a href="{{
signedRoute('unsubscribe', [user.id], {
expiresIn: '3 days',
prefixUrl: 'https://blog.adonisjs.com'
})
}}">
取消订阅
</a>
app
引用 应用程序实例。
{{ app.getEnvironment() }}
config
一个用于在 Edge 模板中引用配置值的 辅助函数。你可以使用 config.has 方法检查某个键的值是否存在。
@if(config.has('app.appUrl'))
<a href="{{ config('app.appUrl') }}"> 首页 </a>
@else
<a href="/"> 首页 </a>
@end
session
会话对象 的只读副本。你不能在 Edge 模板中修改会话数据。session 属性仅在使用 ctx.view.render 方法渲染模板时可用。
帖子浏览量：{{ session.get(`post.${post.id}.visits`) }}
flashMessages
会话闪存消息 的只读副本。flashMessages 属性仅在使用 ctx.view.render 方法渲染模板时可用。
@if(flashMessages.has('inputErrorsBag.title'))
<p>{{ flashMessages.get('inputErrorsBag.title') }}</p>
@end
@if(flashMessages.has('notification'))
<div class="notification {{ flashMessages.get('notification').type }}">
{{ flashMessages.get('notification').message }}
</div>
@end
old
old 方法是 flashMessages.get 方法的简写。
<input
type="text"
name="email"
value="{{ old('name') || '' }}"
/>
t
t 方法由 @adonisjs/i18n 包提供，用于使用 i18n 类 显示翻译内容。该方法接受翻译键标识符、消息数据和备用消息作为参数。
<h1> {{ t('messages.greeting') }} </h1>
i18n
引用使用应用程序默认区域设置配置的 I18n 类实例。但是，DetectUserLocaleMiddleware 会用为当前 HTTP 请求区域设置创建的实例覆盖此属性。
{{ i18n.formatCurrency(200, { currency: 'USD' }) }}
auth
引用由 InitializeAuthMiddleware 共享的 ctx.auth 属性。你可以使用此属性访问已登录用户的信息。
@if(auth.isAuthenticated)
<p> {{ auth.user.email }} </p>
@end
如果你在公共页面（不受身份验证中间件保护）上显示已登录用户的信息，那么你可能希望首先静默检查用户是否已登录。
{{-- 检查用户是否已登录 --}}
@eval(await auth.use('web').check())
@if(auth.use('web').isAuthenticated)
<p> {{ auth.use('web').user.email }} </p>
@end
asset
解析由 Vite 处理的资源的 URL。了解更多关于 在 Edge 模板中引用资源 的信息。
<img src="{{ asset('resources/images/hero.jpg') }}" />
embedImage / embedImageData
embedImage 和 embedImageData 辅助函数由 mail 包添加，仅在渲染用于发送电子邮件的模板时可用。
<img src="{{
embedImage(app.makePath('assets/hero.jpg'))
}}" />
@flashMessage
@flashMessage 标签为有条件地读取给定键的闪存消息提供了更好的开发体验。
无需编写条件语句
@if(flashMessages.has('notification'))
<div class="notification {{ flashMessages.get('notification').type }}">
{{ flashMessages.get('notification').message }}
</div>
@end
你可能更喜欢使用标签
@flashMessage('notification')
<div class="notification {{ $message.type }}">
{{ $message.message }}
</div>
@end
@error
@error 标签为读取存储在 flashMessages 中的 errorsBag 键下的错误消息提供了更好的开发体验。
无需编写条件语句
@if(flashMessages.has('errorsBag.E_BAD_CSRF_TOKEN'))
<p>{{ flashMessages.get('errorsBag.E_BAD_CSRF_TOKEN') }}</p>
@end
你可能更喜欢使用标签
@error('E_BAD_CSRF_TOKEN')
<p>{{ $message }}</p>
@end
@inputError
@inputError 标签为读取存储在 flashMessages 中的 inputErrorsBag 键下的验证错误消息提供了更好的开发体验。
无需编写条件语句
@if(flashMessages.has('inputErrorsBag.title'))
@each(message in flashMessages.get('inputErrorsBag.title'))
<p>{{ message }}</p>
@end
@end
summary:
你可能更喜欢使用标签
@inputError('title')
@each(message in $messages)
<p>{{ message }}</p>
@end
@end
@vite
@vite 标签接受一个入口点路径数组，并返回相应的 script 和 link 标签。提供给 @vite 标签的路径应与 vite.config.js 文件中注册的路径完全匹配。
export default defineConfig({
plugins: [
adonisjs({
entrypoints: ['resources/js/app.js'],
}),
]
})
@vite(['resources/js/app.js'])
你可以将脚本标签属性定义为第二个参数。例如：
@vite(['resources/js/app.js'], {
defer: true,
})
@viteReactRefresh
@viteReactRefresh 标签返回一个 用于启用 React HMR 的脚本标签，适用于使用 @vitejs/plugin-react 包的项目。
@viteReactRefresh()
输出 HTML
<script type="module">
import RefreshRuntime from 'http://localhost:5173/@react-refresh'
RefreshRuntime.injectIntoGlobalHook(window)
window.$RefreshReg$ = () => {}
window.$RefreshSig$ = () => (type) => type
window.__vite_plugin_react_preamble_installed__ = true
</script>
@can/@cannot
@can 和 @cannot 标签允许你在 Edge 模板中通过引用能力名称或策略名称（作为字符串）来编写授权检查。
第一个参数是能力或策略引用，后面是检查所接受的参数。
另请参阅：预注册能力和策略
@can('editPost', post)
{{-- Can edit post --}}
@end
@can('PostPolicy.edit', post)
{{-- Can edit post --}}
@end
@cannot('editPost', post)
{{-- Cannot edit post --}}
@end
@cannot('editPost', post)
{{-- Cannot edit post --}}
@end