venveo/craft-retinafy

此包已被废弃,不再维护。未建议替代包。

markgoodyear 为 Craft 2.0 直接重制的 Craft Retinafy 插件。

安装: 147

依赖项: 0

建议者: 0

安全: 0

星标: 0

关注者: 2

分支: 0

开放问题: 0

类型:craft-plugin

1.0.0 2018-05-19 19:43 UTC

This package is auto-updated.

Last update: 2022-08-07 21:17:34 UTC


README

注意

这是直接从 markgoodyear 的 Craft Retinafy for Craft 2 转移过来,以帮助 Craft 2 到 Craft 3 迁移。

Retinafy 仅在文件名中包含 @2x 的图片上工作。 @2x 表示其预期用途。

默认情况下,Retinafy 生成 2x 版本的 1x 版本。1x 版本用作图像标签的 src 属性,而上传的版本是 srcset 2x 版本。例如,如果你的图像要显示为 250x250px,上传 500x500px 的版本,Retinafy 将处理其余部分。

示例输出:

<img src="[generated_image_at_250x250].png"
     srcset="[uploaded_image_at_250x250].png 1x, [uploaded_image_at_500x500].png 2x">

用法

作为 Craft 变量

Retinafy 可以用作 Craft 变量

<img src="{{ craft.retinafy.image (assetFieldName) }}">

作为 Twig 过滤器

Retinafy 也可以用作 Twig 过滤器

<img src="{{ assetFieldName | retinafy }}">

选项

Retinafy 允许传入自定义的图像转换

{# As a Craft variable #}
<img src="{{ craft.retinafy.image(assetFieldName, 'transformHandle') }}">

{# As a Twig filter #}
<img src="{{ assetFieldName | retinafy('transformHandle') }}">

传入转换时,Retinafy 将生成的图像用作图像标签的 src,然后确定上传的图像是否可以用作 2x 版本。如果图像足够大,它将创建转换的 2x 版本并添加所需的 srcset 标记。

插件设置

Retinafy 当前提供插件设置以控制 2x 后缀以适应您的流程(@2x.2x 等),并在使用转换时绕过 2x 后缀。在转换中绕过 2x 后缀在许多情况下都很有用,例如在创建图像库的缩略图时,原始文件不一定需要 2x,但如果原始文件足够大,缩略图可以显示 2x 图像。

Retinafy settings page

许可证

Retinafy 在 MIT 许可证 下授权。