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文件将被完全索引。 - 不要关键字东西它没有，只是不停的文本相关的，非垃圾邮件：即使你带显示隐藏的标题元素将被抓取。