イントロダクション
Google のブログサービス「Blogger」にて、サムネイル付きの新着情報の一覧を任意の件数表示できる「新着情報ガジェット」を作成していくことにしました。前回:
Blogger:JavaScript:新着情報を表示するガジェットを作成(4)-遅延実行機能を追加
http://upa-pc.blogspot.com/2015/03/blogger-new-post-list-gadget-javascript-4.html
今回は、いよいよサムネイル画像を新着記事一覧へ追加します。
新着情報を表示するガジェットを作成(5)-サムネイル画像を追加
記事のサムネイル画像を フィードのエントリーの media$thumbnail の url から取得します。
サムネイル画像が無い記事もあるため、記事にサムネイル画像が無い場合には、デフォルトで縦1ピクセル×横1ピクセルの透明 png 画像(base64エンコードしてコード中に埋め込んでいます)が表示されるようにしています。
これは、img タグに src 属性が無い場合には、一部環境では画像が読み込めなかった時の×マークのような画像が表示されてしまうためです。
それと、base64エンコードされた縦1ピクセル×横1ピクセルの透明 png 画像の部分を、任意の URL へ書き換えることで、独自の[NO IMAGE]画像などを設定できるようになります。
サムネイル画像を追加した、「記事タイトル(記事へのリンク付き)のみの一覧(css用のクラス名, 遅延実行機能付き)を作成する、新着情報ガジェット」の HTML/JavaScript コードは次のようになります。
なお、今回からスタイルシートが必須になります。
スタイルシート:
/* 新着記事の項目 */ .new-post-list-item { clear:both; } /* 新着記事の最下部 */ .new-post-list-items-end { clear:both; } /* 新着記事のサムネイル画像 */ .new-post-list-item-img { width:100px; height:100px; float:left; margin-right:1em; }
HTML/JavaScript コード:
<div id="new-post-list-container"> 新着読み込み中... </div> <script type="text/javascript"> <!-- setTimeout(function () { // --- Util --- // JavaScript動的挿入 function addScript(src) { var script = document.createElement("script"); script.setAttribute("type", "text/javascript"); script.setAttribute("src", src); header_setChild(script); } // <head>取得 function getHeader() { return document.getElementsByTagName("head")[0]; } // <head>に子要素を追加 function header_setChild(child) { var head = getHeader(); head.appendChild(child); } // --- Main --- // *** 設定可能なパラメータ (Feed 関連) ここから *** // 新着記事を表示する件数 // 上限は 500 件です var max_results = 5; // *** 設定可能なパラメータ (Feed 関連) ここまで *** // 記事一覧作成のトリガー loadFeed(); // Feed の読み込み function loadFeed() { var blogger_url = location.protocol + "//" + location.host; addScript(blogger_url + "/feeds/posts/summary?alt=json-in-script&callback=newpost_loader&max-results=" + max_results + "&start-index=1&redirect=false"); } }, 2000); // 遅延実行(ミリ秒) function newpost_loader(data) { // *** 設定可能なパラメータ (見た目 関連) ここから *** // サムネイル画像を表示するかどうか var show_thumbnail = true; // サムネイルがない場合に使用するイメージ // デフォルト:1x1 の透明png画像(base64エンコード) var not_thumbnail_img_src = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAACXBIWXMAAAsTAAALEwEAmpwYAAAABGdBTUEAALGOfPtRkwAAACBjSFJNAAB6JQAAgIMAAPn/AACA6QAAdTAAAOpgAAA6mAAAF2+SX8VGAAAAEElEQVR42mL4//8/A0CAAQAI/AL+26JNFgAAAABJRU5ErkJggg=="; // *** 設定可能なパラメータ (見た目 関連) ここまで *** // エントリーがある場合は、新着記事一覧の生成開始 if (data.feed.entry) { if (data.feed.entry.length > 0) { createNewPostsList(data); } } // 新着記事一覧生成 function createNewPostsList(data) { var obj_newPostList = document.createElement("div"); obj_newPostList.setAttribute("class", "new-post-list-items"); for (var i = 0; i < data.feed.entry.length; i++) { // リンク先の探索 var href = "javascript:void(0);"; for (var j = 0; j < data.feed.entry[i].link.length; j++) { if (data.feed.entry[i].link[j].rel == "alternate") { href = data.feed.entry[i].link[j].href; } } // 全体の要素作成 var obj_item = document.createElement("div"); obj_item.setAttribute("class", "new-post-list-item"); // 全体のリンク要素 var obj_link = document.createElement("a"); obj_link.setAttribute("href", href); obj_link.setAttribute("class", "new-post-list-item-link"); obj_item.appendChild(obj_link); if (show_thumbnail) { // サムネイル用イメージ要素作成 var obj_img = document.createElement("img"); obj_img.setAttribute("class", "new-post-list-item-img"); var img_src = not_thumbnail_img_src; // サムネイル画像 if (data.feed.entry[i].media$thumbnail) { if (data.feed.entry[i].media$thumbnail.url) { img_src = data.feed.entry[i].media$thumbnail.url; } } obj_img.setAttribute("src", img_src); obj_link.appendChild(obj_img); } // 記事タイトル用要素作成 var obj_title = document.createElement("div"); obj_title.appendChild(document.createTextNode(data.feed.entry[i].title.$t)); obj_title.setAttribute("class", "new-post-list-item-title"); obj_link.appendChild(obj_title); // 項目を連結 obj_newPostList.appendChild(obj_item); } // 最下部の要素 obj_end = document.createElement("div"); obj_end.setAttribute("class", "new-post-list-items-end"); obj_newPostList.appendChild(obj_end); // 画面上へ反映 var obj_output = document.getElementById("new-post-list-container"); obj_output.innerHTML = ""; obj_output.appendChild(obj_newPostList); } } //--> </script>
実行結果:
解説
サムネイル画像の取得
以下の部分で、サムネイル画像の url をフィードの json-in-script 形式のデータから取得し、img タグの src へ設定しています。if (show_thumbnail) { // サムネイル用イメージ要素作成 var obj_img = document.createElement("img"); obj_img.setAttribute("class", "new-post-list-item-img"); var img_src = not_thumbnail_img_src; // サムネイル画像 if (data.feed.entry[i].media$thumbnail) { if (data.feed.entry[i].media$thumbnail.url) { img_src = data.feed.entry[i].media$thumbnail.url; } } obj_img.setAttribute("src", img_src); obj_link.appendChild(obj_img); }
記事にサムネイル画像が無い場合には、data.feed.entry[i].media$thumbnail が無いため、それがある場合のみ、サムネイル画像の url を data.feed.entry[i].media$thumbnail.url より取得します。
サムネイル画像が無い場合には、デフォルトでセットしておいた、base64エンコードされた縦1ピクセル×横1ピクセルの透明 png 画像
// サムネイルがない場合に使用するイメージ // デフォルト:1x1 の透明png画像(base64エンコード) var not_thumbnail_img_src = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAACXBIWXMAAAsTAAALEwEAmpwYAAAABGdBTUEAALGOfPtRkwAAACBjSFJNAAB6JQAAgIMAAPn/AACA6QAAdTAAAOpgAAA6mAAAF2+SX8VGAAAAEElEQVR42mL4//8/A0CAAQAI/AL+26JNFgAAAABJRU5ErkJggg==";
をサムネイル画像として使用します。
サムネイル画像の配置
サムネイル画像のサイズや、位置はスタイルシートによって指定します。デフォルトでは、float 属性によって、サムネイル画像を左側に寄せています。
そして、記事タイトルがサムネイル画像の右側に回り込みます。
そして、一度設定した要素の回り込みを解除するために、clear:both; を新着記事項目ごとと、新着記事項目終了位置に設定しています。
設置方法
スタイルシートの設置:
(1) Blogger の設定のテンプレートにて、「カスタマイズ」をクリックします。(2) Blogger テンプレートデザイナーにて、「上級者向け」をクリックします。
(3) 「CSSを追加」をクリックします。
(4) カスタム CSS を追加の部分に、スタイルシートを追加します。
(5) 「ブログへ適用」ボタンをクリックします。
HTML/JavaScript コードの設置:
(1) Blogger の設定のレイアウトにて、「ガジェットを追加」を行います。(2) 追加するガジェットとして「HTML/JavaScript」ガジェットを選択します。
(3) タイトルに「新着情報」などと入力します。
(4) コンテンツに、上記の HTML/JavaScript コードを張り付けます。
(5) 「保存」をクリックします。
(6) プレビューを行い、期待通りの動作になっているか確認します。
(7) 新着情報ガジェットを配置したい位置へ移動した後、「配置を保存」をクリックします。
オプション設定
表示件数の変更
プログラム中の max_results の値を変更します。例)10 件分の新着情報を表示する場合:
var max_results = 10; // 新着記事を表示する件数
遅延実行時間
先頭の setTimeout 関数にしている、ミリ秒数を変更します。例) 5000ミリ秒(5秒) 後に、処理を開始する場合:
setTimeout(function () {
...
}, 5000); // 遅延実行
サムネイル画像を表示するかどうか
プログラム中の show_thumbnail の値を変更します。例)サムネイル画像を表示しない場合:
// サムネイル画像を表示するかどうか
var show_thumbnail = false;
サムネイル画像が記事に設定されていない場合に、代わりに使用する画像
プログラム中の show_thumbnail の値を変更します。base64エンコードされた画像や、web上の画像ファイルの URL を指定します。
// サムネイルがない場合に使用するイメージ
// デフォルト:1x1 の透明png画像(base64エンコード)
var not_thumbnail_img_src = "";
まとめ
今回は、前回作成した「記事タイトル(記事へのリンク付き)のみの一覧(css用のクラス名, 遅延実行機能付き)を作成する、新着情報ガジェット」に対して、サムネイル画像を追加しました。次回は、記事の投稿日を表示できるように、機能の追加を行います。
次回:
Blogger:JavaScript:新着情報を表示するガジェットを作成(6)-記事の投稿日を追加http://upa-pc.blogspot.com/2015/03/blogger-new-post-list-gadget-javascript-6.html
記事のタイトルが画像の下に来てしまう場合には、次の要因が考えられます。その時の対策を記載します。
返信削除(1) CSS がうまく機能していない
→ CSS が機能するように、修正を加えます。
(2) タイトルの表示領域の幅が狭すぎる
→ 表示領域の幅を広げます。
(3) タイトルに長い英数字の連続した文字列が含まれている
→ 表示領域の幅を広げます。