trikoder/assets-manifest-bundle

此包最新版本(v1.0.1)没有可用的许可证信息。

Symfony 扩展包,用于生成我们新的前端静态资产构建工具的资产 URL

安装: 10

依赖项: 0

建议者: 0

安全性: 0

星标: 0

关注者: 7

分支: 0

开放问题: 0

类型:symfony-bundle

v1.0.1 2018-11-27 11:33 UTC

This package is auto-updated.

Last update: 2024-08-28 05:28:14 UTC


README

此扩展包提供用于生成静态公共资产 URL 的 Twig 辅助函数。

它从简单的 JSON 配置文件中读取信息。示例文件在 manifest.json 中。

用法

扩展包提供两个 Twig 函数 - manifestAsset 和 manifestAssetInline。

manifestAsset 需要 2 个参数

  • 资产 URL,格式为 @BundleName:path/to/asset 或命名空间路径 @BundleName/path/to/asset
  • 可选的选项数组
    • 目前只有选项: "absolute" => 如果为 true,函数返回绝对 URI

示例用法

<link href="{{ manifestAsset('@AppBundle:css/bundles/home.css') }}" rel="stylesheet" type="text/css">

<script async src="{{ manifestAsset('@AppBundle:js/home.js') }}"></script>

manifestAssetInline 需要 1 个参数

  • 资产 URL,格式为 @BundleName:path/to/asset 或命名空间路径 @BundleName/path/to/asset

它返回资产的内容。

示例用法

<style>{{ manifestAssetInline('@AppBundle:css/bundles/home.css') }}</style>

使用自定义 Twig 命名空间

首先,您需要注册您的 Twig 命名空间

twig:
    paths:
        '%kernel.project_dir%/src/App/Resources': SomeTwigNamepace

然后,您可以使用

<style>{{ manifestAsset('@SomeTwigNamepace/css/home.css') }}</style>
<style>{{ manifestAssetInline('@SomeTwigNamepace/js/home.js') }}</style>

注意:Twig 命名空间引用不包含分隔符 :,如扩展包。有关更多详细信息,请参阅 此链接

运行测试和代码检查器

为了运行测试和代码检查器,有一个包含 php 和所有必需工具的完整 Docker 环境。要设置环境,请使用

bin/dev/docker-compose build
bin/dev/composer install

运行测试(在构建环境之后)

bin/dev/composer test

运行代码检查器

bin/dev/phpcsfixer fix --dry-run .

要自动修复编码标准,只需省略 --dry-run 参数。

致谢

版权 (C) 2017 Trikoder

作者:Alen Pokos, Damir Brekalo, Krešo Kunjas。

贡献者:Branimir Đurek

许可证

此包根据 MIT 许可证 许可。