README

Blur Hash

Statamic 的插件，用于编码、解码和生成 Blur Hash 图片，用作图片加载期间的占位符。

安装

首先，将 BlurHash 作为 Composer 依赖项要求

composer require thoughtco/statamic-blurhash

可选，您可以发布此插件所使用的 BlurHash 库的配置文件，允许您更精细地控制图像输出。

php artisan vendor:publish --provider="Bepsvpt\Blurhash\BlurHashServiceProvider"

使用方法

此插件提供了一些标签

输出 BlurHash 图片

{{ blur_hash:image }}

或

{{ blur_hash :image="asset" }}

或

{{ blur_hash :url="url" }}

或

{{ blur_hash :id="asset_id" }}

或

{{ blur_hash :path="local_path" }}

此标签将输出以下格式的编码图像

<img src="data:image/png;base64,iVBOR…8f8luO3RPLKe4AAAAAElFTkSuQmCC" />

您传递的任何其他参数都将添加到标签中，例如

{{ blur_hash:image width="640" height="640" onload="console.log('loaded')" }}

将输出为

<img src="data:image/png;base64,iVBOR…8f8luO3RPLKe4AAAAAElFTkSuQmCC" width="640" height="640" onload="console.log('loaded')" />

如果您想覆盖输出，可以通过运行以下命令将视图发布到您自己的视图文件夹

php artisan vendor:publish --tag="statamic-blurhash"

它将位于 resources/views/vendor/statamic-blurhash/output.blade.php

编码 BlurHash 图片

{{ blur_hash:encode image="path_or_asset" }}

或

{{ blur_hash:encode :url="url" }}

或

{{ blur_hash:encode :id="asset_id" }}

或

{{ blur_hash:encode :path="path" }}

这将返回一个编码的 BlurHash URL，如果您想将其返回给 JavaScript 或第三方服务（如 Algolia）很有用。

解码 BlurHash 图片

{{ blur_hash:decode hash="string" }}

这将解码一个 BlurHash 字符串到一个图像，遵循与 输出 BlurHash 图片 相同的约定。

支持

BlurHash 是一个免费的插件，因此支持是在我们有能力的基础上提供的。如果您有功能请求或遇到错误，请在 GitHub 上打开一个问题。

仅支持此插件的最新版本。如果您使用旧版本打开错误报告，您的问题将被关闭。

thoughtco / statamic-blurhash

维护者

详细信息