nswdpc/silverstripe-imageselection-field

Silverstripe 的图像选择字段。

维护者

详细信息

github.com/nswdpc/silverstripe-imageselection-field

源代码

问题

安装: 60

依赖关系: 0

建议者: 0

安全: 0

星标: 0

关注者: 1

分支: 1

开放性问题: 0

类型:silverstripe-vendormodule

v1.0.0 2024-07-29 23:04 UTC

Requires

Requires (Dev)

BSD-3-Clause acf566f0b8b4a6b5fed2d4ae9f79f42b61da454d

imageformsilverstripefieldnswselect image

This package is auto-updated.

Last update: 2024-08-29 23:18:16 UTC

README

这是一个基本的单选选择字段，选项集中的每个项目都可以与一个图像相关联。

适用于允许人们根据上传到文件库的图像选择选项。

用法

$imageList = $app->getImageList();// DataList of Image records
$width = $app->getImageWidth();
$height = $app->getImageHeight();
$sampleImageField = ImageSelectionField::create(
    'SelectedImageID',
    _t(
        'myapp.CHOOSE_AN_IMAGE',
        'Choose an image'
    )
)->setDescription(
    _t(
        'myapp.CHOOSE_AN_IMAGE_HELP',
        'Choose an image that is most relevant.'
    )
)->setImageList($imageList)
->setImageDimensions($width, $height);

该模块使用示例 flexbox 布局提供样式表。你几乎肯定想使用自己的样式表，所以使用 Requirements::block 来阻止加载 field.css 样式表，然后在你的项目中包含自己的样式表。

要包含你自己的模板，以通常的 Silverstripe 方式在你的项目或主题中覆盖它，使用相同的文件路径，然后刷新缓存。

模板方法

在字段的作用域内

  • {$Thumbnail($ID)} 返回当前图像调整到请求的图像宽/高，传递 Image.ID 值到该方法
  • {$Image($ID)} 返回当前图像，传递 Image.ID 值到该方法
  • {$Images} 返回图像列表
  • {$ImageWidth} 返回指定的图像宽度
  • {$ImageHeight} 返回指定的图像高度

安装

composer require nswdpc/silverstripe-imageselection-field

许可协议

BSD-3-Clause

配置

你可以在项目配置中设置默认图像宽/高

维护者

错误追踪器

我们欢迎对项目的错误报告、拉取请求和功能请求。请在 Github 问题跟踪器上提交。

在提交新问题之前，请查看 行为准则。

安全

如果你发现了此模块的安全问题，请首先通过电子邮件 digital[@]dpc.nsw.gov.au 报告，并详细说明你的发现。

开发和贡献

如果你想为此模块做出贡献，请确保提出拉取请求并与模块维护者讨论。

在完成拉取请求之前，请查看 行为准则。