venveo / craft-retinafy
此包已被废弃,不再维护。未建议替代包。
markgoodyear 为 Craft 2.0 直接重制的 Craft Retinafy 插件。
1.0.0
2018-05-19 19:43 UTC
Requires
- craftcms/cms: ^3.0.0-RC1
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 在 MIT 许可证 下授权。