画像のスライドショーが簡単に作れるKwicksの使用方法

2013年12月27日 09時43分

201312270943HCSW00.png

はじめに

本グログでは、これまでにLightbox2Colorboxを解説していますが、今回は第三弾としてKwicksの使用方法を解説します。

前提条件

作業の前提条件は、下記のとおりです。

ソフトウエアバージョン
OSWindows 7 Ultimate 32bit
CygwinSetup Version 2.831

Colorboxの設置方法

  1. 環境設定

    設置に必要なアーカイブをダウンロードし、解凍します。

    $ cd /tmp/demo
    $ wget -q https://github.com/jmar777/kwicks/archive/master.zip
    $ unzip -q master.zip
    $ rm -f master.zip
    $ mv kwicks-master kwicks
    
  2. CSSファイルの指定

    Kwicksのスタイルシートを、HTMLファイル中に指定します。

    CTYPE html>
    <html lang="ja">
      <head>
        <meta charset="utf-8">
        <title>021-1</title>
        <link href="kwicks/jquery.kwicks.min.css" rel="stylesheet">
      </head>
    
      <body style="background:#000; width:720px;">
    
  3. jsファイルの指定とJavaScriptの追加

    jquery.kwicks.min.jsを、HTMLファイル中に指定し、Kwicksのロードを行うJavaScriptを 追加します。

        <script src = "jquery-1.10.2.min.js"></script>
        <script src = "kwicks/jquery.kwicks.min.js"></script>
        <script type = "text/javascript">
          $().ready(function() {
            $('.kwicks').kwicks({
              maxSize : 300,
              spacing: 0,
              behavior: 'menu'
            });
          });
        </script>
      </body>
    </html>
    
  4. メニュー形式で表示する

    表示する画像ファイルを、HTMLファイル中に指定します。
    ここでは、以前の記事で使用した画像を指定しま す。

    指定には、ul~liタグを使用し、ulタグにKwicksのクラスを指定します。

        <ul class = "kwicks kwicks-horizontal">
          <li><a href="img/016-01.png" target="_blank"><img src="img/016-01.png" width="300"></a></li>
          <li><a href="img/016-02.png" target="_blank"><img src="img/016-02.png" width="300"></a></li>
          <li><a href="img/016-03.png" target="_blank"><img src="img/016-03.png" width="300"></a></li>
          <li><a href="img/016-04.png" target="_blank"><img src="img/016-04.png" width="300"></a></li>
          <li><a href="img/016-05.png" target="_blank"><img src="img/016-05.png" width="300"></a></li>
          <li><a href="img/016-06.png" target="_blank"><img src="img/016-06.png" width="300"></a></li>
        </ul>
    
    11行目で画像のサイズを300pxに指定し、先のJavaScriptの24行目maxSizeでも同一サイズを指定します。
    これにより、画像をスライドした時に、指定した画像サイズで表示することができます。仮に、300pxよりも小さい値をmaxSizeに指定するとmaxSizeで指定したサイズでしか表示できません。
    25行目spacingでは、各画像間の隙間をゼロに指定しています。デフォルトが5pxですので画像間の隙間を無くす場合、ゼロを指定します。
    26行目behaviorが、画像の表示方法をメニュー形式または、スライドショー形式で指定します。デフォルトは、menuですが、slideshowを指定することもできます。

    ページを表示すると、画像がメニュー形式で表示され、クリックすると元画像が別ウインドウで表示されます。

    201312270943HCSW01.png
    デモは、021-1.htmlからご覧頂けます。
    ファイルは、021-1.zipからダウンロードできます。
  5. スライドショー形式で表示する

    画像を、スライドショー形式で表示します。
    24行目26行目を変更するだけで、スライドショー形式で表示できます。

          $().ready(function() {
            $('.kwicks').kwicks({
              minSize : 84,
              spacing: 0,
              behavior: 'slideshow'
            });
          });
        </script>
      </body>
    </html>
    
    24行目では、minSizeとして84pxを指定しています。
    これは、領域のサイズ(720px) = 画像サイズ(300px) + 5(枚)×画像の表示サイズ(84px)
    とするためです。
    もちろん、minSizeを元画像のサイズ(300px)で指定しても間違いではありませんが、この場合スライド幅がゼロになりますので、スライド表示できません。
    したがって、minSizeには、元画像のサイズ未満を指定し、なおかつ領域のサイズを越えないようにサイズを算出する必要があります。
    つまり、領域サイズ(R)に対して、1枚あたり(S)ピクセルの画像を(N)枚表示したい場合

    minSize = (R - S) / N

    で計算できます。

    ページを表示すると、画像がスライドショー形式で表示され、クリックすると元画像が別ウインドウで表示されます。

    201312270943HCSW02.png
    デモは、021-2.htmlからご覧頂けます。
    ファイルは、021-2.zipからダウンロードできます。

    なお、minSize10pxを指定し、width350pxを指定すると、クールなスライドショーになります。

      <body style="background:#000; width:350px;">
          $().ready(function() {
            $('.kwicks').kwicks({
              minSize : 10,
              spacing: 0,
              behavior: 'slideshow'
            });
          });
    
    201312270943HCSW03.png
    デモは、021-3.htmlからご覧頂けます。
    ファイルは、021-3.zipからダウンロードできます。