PhotoSwipe中文API(五)

Responsive Images

PhotoSwipe不支持<图片>或srcset，因为它要求所定义的图像的尺寸，并使用延迟加载。但是，随着图像动态加载，它很容易切换人士透露，即便是在旧的浏览器不支持srcset。
让我们假设你只有“中等”的图片和“原始”（“大”）的图像。首先，你需要存储在幻灯片对象的图像的路径和大小，例如像这样：

var items = [

    // Slide 1
    {
        mediumImage: {
            src: 'path/to/medium-image-1.jpg',
            w:800,
            h:600
        },
        originalImage: {
            src: 'path/to/large-image-1.jpg',
            w: 1400,
            h: 1050
        }
    },

    // Slide 2
    // {
    //     mediumImage: {
    //         src: 'path/to/medium-image-2.jpg',
    //         ...
    //     
    // ...

];

Then:

// initialise as usual
var gallery = new PhotoSwipe( pswpElement, PhotoSwipeUI_Default, items, options);

// create variable that will store real size of viewport
var realViewportWidth,
    useLargeImages = false,
    firstResize = true,
    imageSrcWillChange;

// beforeResize event fires each time size of gallery viewport updates
gallery.listen('beforeResize', function() {
    // gallery.viewportSize.x - width of PhotoSwipe viewport
    // gallery.viewportSize.y - height of PhotoSwipe viewport
    // window.devicePixelRatio - ratio between physical pixels and device independent pixels (Number)
    //                          1 (regular display), 2 (@2x, retina) ...


    // calculate real pixels when size changes
    realViewportWidth = gallery.viewportSize.x * window.devicePixelRatio;

    // Code below is needed if you want image to switch dynamically on window.resize

    // Find out if current images need to be changed
    if(useLargeImages && realViewportWidth < 1000) {
        useLargeImages = false;
        imageSrcWillChange = true;
    } else if(!useLargeImages && realViewportWidth >= 1000) {
        useLargeImages = true;
        imageSrcWillChange = true;
    }

    // Invalidate items only when source is changed and when it's not the first update
    if(imageSrcWillChange && !firstResize) {
        // invalidateCurrItems sets a flag on slides that are in DOM,
        // which will force update of content (image) on window.resize.
        gallery.invalidateCurrItems();
    }

    if(firstResize) {
        firstResize = false;
    }

    imageSrcWillChange = false;

});


// gettingData event fires each time PhotoSwipe retrieves image source & size
gallery.listen('gettingData', function(index, item) {

    // Set image source & size based on real viewport width
    if( useLargeImages ) {
        item.src = item.originalImage.src;
        item.w = item.originalImage.w;
        item.h = item.originalImage.h;
    } else {
        item.src = item.mediumImage.src;
        item.w = item.mediumImage.w;
        item.h = item.mediumImage.h;
    }

    // It doesn't really matter what will you do here, 
    // as long as item.src, item.w and item.h have valid values.
    // 
    // Just avoid http requests in this listener, as it fires quite often

});


// Note that init() method is called after gettingData event is bound
gallery.init();

你不一定要使用幻灯片对象，看起来酷似以上（含mediumImage和largeImage对象）的结构。例如，您可以直接在图像文件名（/path/to/large-image-600x500.jpg）存储图像的大小，然后在gettingData事件解析大小。只有item.src，item.w和item.h属性由PhotoSwipe读取和gettingData事件被触发之后。

较大的图像，不太流畅的动画外观。

尽量避免服务只是基于设备像素比或只是基于视口大小的图像，始终两者结合起来。

随意的打开PhotoSwipe缩略图使用srcset。

Image Gallery SEO

PhotoSwipe不强制HTML标记，你有完全控制权。简单的标记是链接到大的图像，最简单的例子缩略图列表：

<a href="large-image.jpg">
    <img src="small-image.jpg" alt="Image description" />
</a>
...

如果你有很长的标题，不适合在ALT或只是包含HTML标记，您可以使用<人物>和<figcaption>：

<figure>
    <a href="large-image.jpg">
        <img src="small-image.jpg" alt="Image description" />
    </a>
    <figcaption>Long image description</figcaption>
</figure>
...

你可以更进一步，使用Schema.org标记为ImageGallery和ImageObject，它应该是这样的：

<div itemscope itemtype="http://schema.org/ImageGallery">

    <figure itemprop="associatedMedia" itemscope itemtype="http://schema.org/ImageObject">
        <a href="large-image.jpg" itemprop="contentUrl">
            <img src="small-image.jpg" itemprop="thumbnail" alt="Image description" />
        </a>

        <!-- optionally use this method to store image dimensions for PhotoSwipe -->
        <meta itemprop="width" content="300">
        <meta itemprop="height" content="600">

        <figcaption itemprop="caption description">
            Long image description

            <!-- optionally define copyright -->
            <span itemprop="copyrightHolder">Photo: AP</span>
        </figcaption>
    </figure>

    <figure itemprop="associatedMedia" itemscope itemtype="http://schema.org/ImageObject">
        <a href="large-image.jpg" itemprop="contentUrl">
            <img src="small-image.jpg" itemprop="thumbnail" alt="Image description" />
        </a>
        <figcaption itemprop="caption description">Long image description</figcaption>
    </figure>

    ...

</div>

如果你不想缩略图是网页，例如可见你在画廊50幅图像，你只显示前3的缩略图+链接“查看所有图片（50）”，你一定要在链接元素的内容使用Schema.org标记，你应该有所有50个链接（文字，而不是缩略图）的DOM（你可能会显示隐藏：无）。 例：

<div itemscope itemtype="http://schema.org/ImageGallery">

    <figure itemprop="associatedMedia" itemscope itemtype="http://schema.org/ImageObject">
        <a href="large-image-1.jpg" itemprop="contentUrl">
            <figcaption itemprop="caption description">Long image description 1</figcaption>
        </a>
    </figure>

    <figure itemprop="associatedMedia" itemscope itemtype="http://schema.org/ImageObject">
        <a href="large-image-2.jpg" itemprop="contentUrl">
            <figcaption itemprop="caption description">Long image description 2</figcaption>
        </a>
    </figure>

    ...

</div>

在上述所有情况下，大image.jpg文件将被完全索引。 - 不要关键字东西它没有，只是不停的文本相关的，非垃圾邮件：即使你带显示隐藏的标题元素将被抓取。