README

遗憾的是，原始 Fotorama 画廊已不再维护。如果 fotorama 适合您的项目，您仍然可以使用此扩展。有关替代方案，请查看 GitHub 线程。

Fotorama Yii2 小部件

此 yii2 扩展是功能强大的 jQuery 画廊 Fotorama 的包装器。

安装

使用 composer 安装此扩展。

composer require metalguardian/yii2-fotorama-widget

您应该在项目的 composer.json 中配置 asset-packagist 仓库或安装 fxp/composer-asset-plugin 插件。有关更多信息，请参阅 Yii2 bower/npm 资产手册

使用方法

第一种方法

    <?php 
    $fotorama = \metalguardian\fotorama\Fotorama::begin(
        [
            'options' => [
                'loop' => true,
                'hash' => true,
                'ratio' => 800/600,
            ],
            'spinner' => [
                'lines' => 20,
            ],
            'tagName' => 'span',
            'useHtmlData' => false,
            'htmlOptions' => [
                'class' => 'custom-class',
                'id' => 'custom-id',
            ],
        ]
    ); 
    ?>
        <img src="http://s.fotorama.io/1.jpg">    
        <img src="http://s.fotorama.io/2.jpg">
        <img src="http://s.fotorama.io/3.jpg">
        <img src="http://s.fotorama.io/4.jpg">
        <img src="http://s.fotorama.io/5.jpg">
    <?php \metalguardian\fotorama\Fotorama::end(); ?>

第二种方法

    <?php 
    echo \metalguardian\fotorama\Fotorama::widget(
        [
            'items' => [
                ['img' => 'http://s.fotorama.io/1.jpg', 'id' => 'id-one',],
                ['img' => 'http://s.fotorama.io/2.jpg',],
                ['img' => 'http://s.fotorama.io/3.jpg',],
                ['img' => 'http://s.fotorama.io/4.jpg',],
            ],
            'options' => [
                'nav' => 'thumbs',
            ]
        ]
    ); 
    ?>

要使用 CDNJS，请在运行小部件之前放置此代码，将使用当前版本

    <?php \metalguardian\fotorama\Fotorama::$useCDN = true; ?>

或选择自定义版本

    <?php \metalguardian\fotorama\Fotorama::$useCDN = '4.5.0'; ?>

要设置默认 Fotorama 小部件选项以供页面上的所有画廊使用

    <?php 
    \metalguardian\fotorama\Fotorama::setDefaults(
        [
            'nav' => 'thumbs',
            'spinner' => [
                'lines' => 20,
            ],
            'loop' => true,
            'hash' => true,
        ]
    );
    ?>

有关 Fotorama 和所有小部件选项的完整文档，请参阅 官方 Fotorama 页面

许可证

yii2-fotorama-widget 在 MIT 许可证下发布。有关详细信息，请参阅附带 LICENSE 文件。