Webサイトの動的な画像操作は、ユーザーエクスペリエンスを向上させる重要な要素です。JavaScriptを使用してimg要素のsrc属性を動的に変更することで、インタラクティブな画像ギャラリーや、ユーザーの操作に応じて変化する視覚的要素を実現できます。この記事では、JavaScriptを使用してimg要素のsrc属性を効果的に変更する方法について、初心者から上級者まで理解できるよう、詳細に解説していきます。
1. はじめに
JavaScript でimg要素のsrc属性を動的に変更する重要性
Webサイトにおいて、画像は情報伝達や視覚的魅力を高める上で欠かせない要素です。しかし、静的な画像だけでは、ユーザーの興味を引き付け続けることは難しいでしょう。ここで重要になるのが、JavaScriptを使用してimg要素のsrc属性を動的に変更する技術です。
この技術を活用することで、以下のような多彩な表現が可能になります:
- ユーザーの操作に応じて画像を切り替える
- 時間経過とともに自動的に画像をスライドショー表示する
- マウスオーバー時に画像を変更し、視覚的フィードバックを提供する
- 大量の画像を効率的に管理し、必要に応じて読み込む
これらの機能は、ウェブサイトの使いやすさを向上させ、ユーザーエンゲージメントを高めることにつながります。
この記事で学べること
本記事では、JavaScriptを使用してimg要素のsrc属性を動的に変更するための知識、技術を提供します。具体的には以下の内容を学ぶことができます:
- img要素とsrc属性の基本的な理解
- JavaScriptでのDOM操作と画像要素の取得方法
- src属性を変更する複数の手法とその比較
- 実践的なシナリオでの画像変更の実装方法
- パフォーマンス最適化とベストプラクティス
- クロスブラウザ互換性の確保
- 一般的なトラブルシューティング
- 高度な応用例と発展的なトピック
これらの知識を身につけることで、より洗練されたWebアプリケーションの開発が可能になり、ユーザー体験の向上に貢献できるでしょう。
2. img要素とsrc属性の基本
HTML における img要素の役割
img要素は、HTMLにおいて画像を表示するための基本的な要素です。この要素を使用することで、Webページに写真、イラスト、アイコンなどの視覚的コンテンツを埋め込むことができます。
img要素の基本的な構造は以下の通りです:
<img src="画像のURL" alt="画像の説明">
img要素は自己終了タグであり、開始タグと終了タグの間にコンテンツを持ちません。代わりに、属性を使用して画像に関する情報を指定します。
src属性の重要性と基本的な使い方
src属性は、img要素の中で最も重要な属性の一つです。この属性は、表示する画像ファイルの場所(URL)を指定します。ブラウザは、このURLを使用して画像ファイルをダウンロードし、ページ上に表示します。
src属性の基本的な使い方は以下の通りです:
- 同じドメイン内の画像を表示する場合:

- 外部サイトの画像を表示する場合:
!<https://example.com/images/sample.png>
- データURIを使用して画像を直接埋め込む場合:
[data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAACklEQVR4nGMAAQAABQABDQottAAAAABJRU5ErkJggg==](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAACklEQVR4nGMAAQAABQABDQottAAAAABJRU5ErkJggg==)
src属性は、画像の表示に直接影響を与えるため、この属性を動的に変更することで、ユーザーの操作や特定の条件に応じて画像を切り替えることが可能になります。
次のセクションでは、JavaScriptを使用してこのsrc属性を操作する方法について詳しく説明します。
3. JavaScriptでimg要素を操作する方法

JavaScriptを使用してimg要素を操作するためには、まずDOM(Document Object Model)の基本を理解し、目的の要素を取得する方法を知る必要があります。
3.1. DOM操作の基本
DOMは、HTMLドキュメントをプログラムから操作するためのインターフェースです。JavaScriptを使用してDOMを操作することで、Webページの内容を動的に変更できます。
DOMツリーは、Webページの構造を表現しており、各HTML要素はDOMツリー上のノードとして扱われます。JavaScriptを使用してこれらのノードにアクセスし、その属性や内容を変更することができます。
3.2. img要素の取得方法
JavaScriptでimg要素を操作するためには、まずその要素を取得する必要があります。以下に、主要な要素取得方法を紹介します。
getElementById
getElementByIdメソッドは、指定したIDを持つ要素を取得します。この方法は、単一の特定の要素を取得する場合に最適です。
const myImage = document.getElementById('myImageId');
querySelector
querySelectorメソッドは、CSS セレクタに一致する最初の要素を返します。これにより、ID、クラス、タグ名など、さまざまな条件で要素を取得できます。
const myImage = document.querySelector('#myImageId'); const firstImage = document.querySelector('img'); const specialImage = document.querySelector('.special-image');
getElementsByClassName
getElementsByClassNameメソッドは、指定したクラス名を持つすべての要素をHTMLCollectionとして返します。複数の要素を一度に取得する場合に便利です。
const specialImages = document.getElementsByClassName('special-image');
これらの方法を使用して取得したimg要素に対して、JavaScriptを使用してsrc属性を変更することができます。次のセクションでは、具体的なsrc属性の変更方法について説明します。
4. src属性を変更する主な方法
JavaScriptを使用してimg要素のsrc属性を変更する方法は主に2つあります。ここでは、それぞれの方法とその特徴について説明します。
4.1. element.src プロパティを使用する方法
最も直接的で簡単な方法は、img要素のsrcプロパティを直接変更することです。
const myImage = document.getElementById('myImageId'); myImage.src = 'new-image.jpg';
この方法の特徴:
- 簡潔で直感的
- コードが短く、読みやすい
- ブラウザの互換性が高い
4.2. setAttribute() メソッドを使用する方法
setAttribute()メソッドを使用して、src属性を変更することもできます。
const myImage = document.getElementById('myImageId'); myImage.setAttribute('src', 'new-image.jpg');
この方法の特徴:
- すべての属性に対して一貫した方法で使用できる
- 属性名を文字列として指定するため、動的な属性操作に適している
- カスタム属性の設定にも使用可能
4.3. 各方法の利点と欠点
element.srcプロパティを使用する方法
利点:
- コードが簡潔で読みやすい
- 直接プロパティにアクセスするため、わずかに高速
欠点:
- src属性以外の属性を変更する場合、異なる方法を使用する必要がある
setAttribute()メソッドを使用する方法
利点:
- すべての属性に対して統一された方法で使用できる
- 動的な属性名の操作に適している
欠点:
- コードがやや冗長になる
- プロパティ直接アクセスと比べてわずかにパフォーマンスが劣る場合がある
実際の使用においては、コードの一貫性やプロジェクトの要件に応じて適切な方法を選択することが重要です。多くの場合、両方の方法を状況に応じて使い分けることになるでしょう。
次のセクションでは、これらの方法を使用して実際に画像を動的に変更する具体的なシナリオについて説明します。
5. 動的に画像を変更する実践的なシナリオ
ここでは、JavaScriptを使用してimg要素のsrc属性を動的に変更する実践的なシナリオをいくつか紹介します。これらの例を通じて、実際のWebアプリケーションでどのように画像を動的に操作できるかを理解しましょう。
5.1. ボタンクリックで画像を切り替える
ユーザーがボタンをクリックすると画像が切り替わる機能は、多くのWebサイトで見られる一般的な実装です。以下に、この機能を実現するためのコード例を示します。
HTML:
<img id="changeableImage" src="image1.jpg" alt="変更可能な画像"> <button id="changeImageBtn">画像を変更</button>
JavaScript:
const image = document.getElementById('changeableImage'); const button = document.getElementById('changeImageBtn'); let isFirstImage = true;
button.addEventListener('click', () => { if (isFirstImage) { image.src = 'image2.jpg'; } else { image.src = 'image1.jpg'; } isFirstImage = !isFirstImage; });
この例では、ボタンがクリックされるたびに画像が切り替わります。isFirstImage変数を使用して、現在表示されている画像を追跡しています。
5.2. マウスオーバーで画像を変更する
マウスオーバー時に画像を変更する機能は、インタラクティブな要素やホバー効果を作成する際に役立ちます。
HTML:
<img id="hoverImage" src="normal.jpg" alt="ホバー効果のある画像">
JavaScript:
const image = document.getElementById('hoverImage');
image.addEventListener('mouseover', () => { image.src = 'hover.jpg'; });
image.addEventListener('mouseout', () => { image.src = 'normal.jpg'; });
この例では、ユーザーがマウスを画像の上に乗せると画像が変更され、マウスを外すと元の画像に戻ります。
5.3. タイマーを使用して自動的に画像を切り替える
自動的に画像を切り替えるスライドショー機能は、多くのWebサイトのヘッダーやギャラリーセクションで使用されています。
HTML:
<img id="slideshowImage" src="slide1.jpg" alt="スライドショー画像">
JavaScript:
const image = document.getElementById('slideshowImage'); const images = ['slide1.jpg', 'slide2.jpg', 'slide3.jpg', 'slide4.jpg']; let currentIndex = 0;
function changeImage() { currentIndex = (currentIndex + 1) % images.length; image.src = images[currentIndex]; }
setInterval(changeImage, 3000); // 3秒ごとに画像を切り替え
この例では、setInterval関数を使用して3秒ごとに画像を自動的に切り替えています。currentIndex変数を使用して現在の画像のインデックスを追跡し、配列の長さで割ることで循環的に画像を切り替えています。
これらの実践的なシナリオは、基本的な画像の動的変更から始まり、より複雑なインタラクションやアニメーションへと発展させることができます。次のセクションでは、これらの機能をさらに改善するための画像のプリロードテクニックについて説明します。
6. 画像のプリロードテクニック
画像を動的に変更する際、特に大きなサイズの画像や多数の画像を扱う場合、プリロードテクニックを活用することで、ユーザーエクスペリエンスを大幅に向上させることができます。
6.1. なぜプリロードが重要か
画像のプリロードは以下の理由で重要です:
- ユーザーエクスペリエンスの向上:画像が即座に表示されるため、ユーザーはスムーズな遷移を体験できます。
- パフォーマンスの最適化:画像の読み込み待ちによる遅延を最小限に抑えられます。
- 帯域幅の効率的な使用:必要な画像を事前に読み込むことで、ユーザーの操作時の待ち時間を減らせます。
6.2. JavaScriptを使用した画像のプリロード方法
JavaScript以下は、JavaScriptを使用した画像のプリロード方法についての続きです。
6.2. JavaScriptを使用した画像のプリロード方法
画像をプリロードするには、主に以下の2つの方法があります:
1. Image オブジェクトを使用する方法
function preloadImage(url) { const img = new Image(); img.src = url; }
// 使用例 preloadImage('large-image.jpg'); preloadImage('next-slide.png');
この方法は簡単で直接的ですが、画像の読み込み状態を追跡することはできません。
2. Promise を使用する方法
function preloadImage(url) { return new Promise((resolve, reject) => { const img = new Image(); img.onload = () => resolve(img); img.onerror = reject; img.src = url; }); }
// 使用例 preloadImage('large-image.jpg') .then(img => console.log('画像のプリロードが完了しました')) .catch(error => console.error('画像のプリロードに失敗しました', error));
この方法では、画像の読み込み完了や失敗を確実に把握できます。
6.3. 実践的なプリロード実装例
スライドショーの画像を事前に読み込む例を見てみましょう:
const slideshowImages = ['slide1.jpg', 'slide2.jpg', 'slide3.jpg', 'slide4.jpg']; const preloadedImages = [];
function preloadSlideImages() {
slideshowImages.forEach(url => {
preloadImage(url)
.then(img => {
preloadedImages.push(img);
console.log(画像 ${url} のプリロードが完了しました);
})
.catch(error => console.error(画像 ${url} のプリロードに失敗しました, error));
});
}
// スライドショーの開始前に画像をプリロード preloadSlideImages();
この実装により、スライドショーの全画像が事前に読み込まれ、スムーズな画像切り替えが可能になります。
7. パフォーマンスとベストプラクティス

画像の動的変更を効率的に行うためのベストプラクティスをいくつか紹介します:
適切な画像フォーマットと圧縮の使用
- JPEG, PNG, WebP などの適切なフォーマットを選択し、画質と容量のバランスを取る。
レスポンシブ画像の使用
srcset属性を活用し、デバイスの画面サイズに応じて最適な画像を提供する。
遅延読み込みの実装
- 画面外の画像は必要になるまで読み込みを遅らせる。
キャッシュの活用
- ブラウザのキャッシュを効果的に使用し、繰り返しの画像読み込みを最小限に抑える。
CDNの利用
- 大規模なウェブサイトでは、CDNを使用して画像の配信を最適化する。
これらの手法を組み合わせることで、画像の動的変更を効率的に行い、ウェブサイトのパフォーマンスを最適化できます。
8. まとめ
JavaScriptを使用したimg要素のsrc属性の動的変更は、インタラクティブで魅力的なウェブエクスペリエンスを作成する上で非常に重要なテクニックです。基本的な属性変更から、高度なプリロードテクニック、パフォーマンス最適化まで、この記事で紹介した方法を活用することで、より洗練されたウェブアプリケーションの開発が可能になります。
ユーザーの期待に応える高品質なウェブサイトを構築するためには、これらのテクニックを適切に組み合わせ、継続的に改善していくことが重要です。常に最新のウェブ技術とベストプラクティスに注目し、ユーザーエクスペリエンスの向上に努めましょう。
