b13/vh_imagedata
Composer 安装命令:
composer require b13/vh_imagedata
包简介
Viewhelper for accessing data of a (processed) image for further use (like <img>-tag w/ lazy loading etc.)
关键字:
README 文档
README
Viewhelper to build custom <img>-Tag
This viewhelper calculates an image based on <f:image> without rendering an image tag, making the data available in the
content of the viewhelper for manual use or rendering custom image tags. The rendering takes all crop settings into
account.
Basic useage example
<html xmlns:id="http://typo3.org/ns/B13/VhImagedata/ViewHelpers" data-namespace-typo3-fluid="true">
<id:imagedata src="{file.uid}" treatIdAsReference="1" width="300" as="imageData">
<div class="b_lazyloading__background" style="padding-bottom: {1 / imageData.ratio}%;">
<img src="transparent.gif" data-imageurl="{imageData.uri}" width="{imageData.width}" height="{imageData.height}"
class="b_lazyloading__image bJS_lazyloading"
alt="{imageData.alt}" title="{imageData.title}" />
</div>
</id:imagedata>
</html>
Allowed attributes
The following attributes can be passed to the ViewHelper. All attributes normally allowed for f:image can be passed
but not all make sense.
| Argument | Type | Info |
|---|---|---|
| as | string | Name of variable to create. Defaults to imageData |
| alt | string | Specifies an alternate text for an image' |
| title | string | Tooltip text of element |
| src | string | a path to a file, a combined FAL identifier or an uid (int). If $treatIdAsReference is set, the integer is considered the uid of the sys_file_reference record. If you already got a FAL object, consider using the $image parameter instead |
| treatIdAsReference | bool | given src argument is a sys_file_reference record |
| image | object | a FAL object |
| crop | string | bool |
| cropVariant | string | select a cropping variant, in case multiple croppings have been specified or stored in FileReference |
| width | string | width of the image. This can be a numeric value representing the fixed width of the image in pixels. But you can also perform simple calculations by adding "m" or "c" to the value. See imgResource.width for possible options. |
| height | string | height of the image. This can be a numeric value representing the fixed height of the image in pixels. But you can also perform simple calculations by adding "m" or "c" to the value. See imgResource.width for possible options. |
| minWidth | int | minimum width of the image |
| minHeight | int | minimum width of the image |
| maxWidth | int | minimum width of the image |
| maxHeight | int | minimum width of the image |
| absolute | bool | Force absolute URL |
| value | mixed | Value to assign. If not in arguments then taken from tag content |
Returned data
The ViewHelper returns an array with all the image data as {imageData} or the variable name you set in argument as.
The array contains these values:
| Key | Info |
|---|---|
| width | Width of the rendered image |
| height | Height of the rendered image |
| uri | URL of the image rendered |
| alt | Alt tag for the image, taken from the sys_file_record, the sys_file_reference or from the "alt"-argument of the viewhelper |
| title | Title tag for the image, taken from the sys_file_record, the sys_file_reference or from the "title"-argument of the viewhelper |
| ratio | The ratio of the cropped/rendered image (width / height), meaning 1.77777 for an image with 16:9 ratio |
| heightRatio | The ratio of height to width, for use in inline styles of containers for responsive images |
| link | Value of the link field from sys_file_reference |
| processingInstructions | Original processing instructions used for image rendering (including crop-values as array) |
| processedImage | The processed file |
| originalImage | The original file |
Installing
Use Composer to add to your project:
composer require b13/vh_imagedata
Set the namespace the ViewHelper in your Fluid template where needed:
<html xmlns:id="http://typo3.org/ns/B13/VhImagedata/ViewHelpers" data-namespace-typo3-fluid="true">
b13/vh_imagedata 适用场景与选型建议
b13/vh_imagedata 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 5 次下载、GitHub Stars 达 0, 最近一次更新时间为 2019 年 11 月 04 日, 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向: 「TYPO3 CMS」 「B13base」 等业务场景。在实际项目中,围绕这些方向常见需要落地的问题包括:接口对接、性能调优、并发安全、与既有框架(Laravel / ThinkPHP / Yii / Webman 等)的兼容适配,以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 b13/vh_imagedata 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。
基于 b13/vh_imagedata 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。
与 b13/vh_imagedata 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐,方便对比选型:
GraphQL authentication for your headless Craft CMS applications.
Set Links with a specific language parameter
Supercharged text field validation.
TYPO3 CMS extension to create gallery content element with preset crop ratios and pagination
An interactive tour through the TYPO3 backend.
Integrate with Snipcart.
统计信息
- 总下载量: 5
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 0
- 点击次数: 8
- 依赖项目数: 0
- 推荐数: 0
其他信息
- 授权协议: GPL-2.0-or-later
- 更新时间: 2019-11-04