搜索craftsnippets / javascript-helpers
在模板中处理 JavaScript 的 Twig 工具
Requires
- craftcms/cms: ^5.0.0
This package is not auto-updated.
Last update: 2024-09-22 16:32:18 UTC
README
此插件允许您将所有静态翻译消息输出到 JavaScript 对象，并轻松将任何 Twig 变量传输到 JavaScript。
要求
此插件需要 Craft CMS 5.0.0 或更高版本。
安装
要安装插件，请按照以下说明操作。
-
打开您的终端并转到您的 Craft 项目
cd /path/to/project -
然后告诉 Composer 加载插件
composer require craftsnippets/javascript-helpers -
在控制面板中，转到设置 → 插件，并为 Javascript helpers 点击“安装”按钮。
JavaScript helpers 概述
JavaScript helpers 插件提供两个 Twig 变量和一个过滤器。
Twig 变量
-
craft.jsHelpers.getMessages('locale_code')- 返回所有静态消息翻译作为 Twig 数组。默认情况下，它返回当前站点的语言环境，但您可以通过传递特定的语言环境代码作为可选参数来覆盖它。 -
craft.jsHelpers.outputMessages('array_name', 'locale_code')- 将静态消息翻译输出到模板作为 JavaScript 数组，在<body>标签的末尾。第一个参数指定 JavaScript 数组名称。默认情况下，返回当前站点的语言环境的静态消息翻译，但您可以通过传递特定的语言环境代码作为可选的第二个参数来覆盖它。
Twig 过滤器
jsVar('variable_name')- 将 Twig 变量输出为 JavaScript 变量，在<body>标签的末尾。例如
{{someTwigVariable|jsVar('some_js_variable')}}
将输出名为 some_js_variable 的 JavaScript 变量到模板中，包含 someTwigVariable 的内容。适用于具有单个值的变量，也适用于数组或对象。
提示：您也可以通过使用以下方法实现相同的效果，而不需要此插件：
{% do view.registerJsVar('some_js_variable', someTwigVariable, POS_END) %}
免责声明
由 Piotr Pogorzelski 提供
插件图标由 Benjamin J sperry 设计。