ストックイメージ
グレーのプレースホルダーがヒーロー画像の代わりに表示されているランディングページは未完成です。この文書では、商用利用が無料で、デザインにマッチし、他のユーザーがページを読み込んでも壊れない実際の写真を入手する方法を説明します。
誰もが最初に試すエンドポイントは死んでいる
https://source.unsplash.com/1600x900/?coffee → HTTP 503
source.unsplash.com — キー不要のランダム画像エンドポイントは 廃止 されました。このエンドポイントは今でもブログ記事や古いテンプレートに溢れていますが、現在は503を返します。コードベースでこれを見つけた場合、それは壊れた画像であり、動作するものではありません。
キーなしで動作するのは、写真IDが既に分かっている場合のCDNです:
https://images.unsplash.com/photo-1447933601403-0c6688de566e?auto=format&fit=crop&w=1600&q=80
これは実際の画像を返します。しかし、キーなしでは検索できず、写真IDをでっち上げても機能しません。そこで:
キーの取得(2分、無料)
- https://unsplash.com/oauth/applications → New Application → 利用規約に同意
- アクセスキーをコピー
- エクスポートする — コミットしてはいけません:
export UNSPLASH_ACCESS_KEY="your_access_key"
デモティアは1時間あたり50リクエストで、ランディングページには十分です。ユーザーがキーを持っていない場合は、その旨を伝えて質問してください — 静かにグレーボックスにフォールバックしたり、URLをでっち上げたりしないでください。
curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
"https://api.unsplash.com/search/photos?query=coastal+fog&orientation=landscape&per_page=8" \
| python3 -c "
import json,sys
for p in json.load(sys.stdin)['results']:
print(p['id'], p['width'], p['height'], '|', (p.get('alt_description') or '')[:60])
print(' ', p['urls']['raw'])
print(' ', p['user']['name'], p['links']['download_location'])
"
見落としがちな2つのAPIルール
1. APIが返すURLをホットリンクする。 Unsplash APIの利用規約では、ファイルを再ホストするのではなく、CDNのURLを使用する必要があります。これは通常のローカル最適化アセットを提供するアドバイスと矛盾しますが、APIを使用している間は規約が優先されます。クライアントが自己ホストファイルを必要とする場合は、Unsplash+を通じて写真をライセンスするか、他の場所で購入してください — 静かに再ホストして期待するのはやめてください。
2. 写真が実際に使用されたときにダウンロードエンドポイントをトリガーする。 プレビュー時ではなく、出荷時です。これにより写真家の利用がクレジットされ、APIの条件であり、好意ではありません。
curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
"$DOWNLOAD_LOCATION" # 検索結果のlinks.download_locationの値
ライセンスの境界
Unsplashライセンスは、許可や必須の帰属表示なしで、商用および非商用利用を許可します。未改変のコピーを販売することは許可されておらず、競合する写真サービスを構築することも許可されていません。写真には識別可能な人物、商標、アートワークが含まれる場合があります — Unsplashはモデルリリースやプロパティリリースをクリアしていないため、推薦を示唆するもの(顧客のように見える人物、推薦の写真)については、代わりにリリース済みの画像を使用してください。
帰属表示は必須ではありませんが、1行で済み、適切なことです:
<!-- Photo: Jane Doe / Unsplash -->
適切な選択
名詞そのものを検索すると、ページがテンプレートのように見えます。「コーヒー」と検索すると、一万枚の同じようなラテアートの真上からの写真が返ってきます。
被写体ではなく、ムードを検索する。 コーヒー焙煎所の場合:warm industrial workshop、hands working、morning light interior。資産管理アドバイザリーの場合:still architecture、quiet minimal interior、long shadows。
その後、デザインが実際に制約する3つの要素でフィルタリングします:
- 向きと被写体の配置。
object-fit: coverでクロップするヒーロー画像は、被写体が中央からずれているか、上部にスペースがないと、クロップで被写体の頭部が切れてしまいます。選択する前に被写体の位置を確認してください — フレーミングの計算については、../landing-page/references/traps.mdを参照してください。 - トーン範囲。 テキストを重ねる場合、その背後にある領域が一貫して明るいか、一貫して暗い必要があります。忙しい中間トーンの写真では、すべてのテキスト色が合わなくなります。
- 1人の写真家、または1つのルック。 1つのセクションに3人の異なる写真家の3枚の画像があると、ストック写真に見えます。1回の撮影からの複数のフレーム、または一貫したグレードを優先してください。
サイジング
Unsplash CDNパラメータでリサイズを行うため、表示するサイズをリクエストします:
?auto=format&fit=crop&w=1600&q=80 ヒーロー
?auto=format&fit=crop&w=800&q=80 カード
?auto=format&fit=crop&w=192&h=192&q=80 アバター(正方形)
auto=formatは、受け入れるブラウザにWebP/AVIFを提供します。レスポンシブヒーローの場合は、1つの2000pxファイルをスマートフォンに送信するのではなく、800/1200/1600/2000でsrcsetを出力してください。
Altテキスト
altは、画像が何を示しているかを、画像を見ることができない誰かのために説明します。キーワードスロットではなく、写真のタイトルでもありません。
<!-- ダメ -->
<img alt="コーヒー焙煎所ランディングページヒーロー画像">
<!-- 良い -->
<img alt="焙煎所で緑色の豆をドラム焙煎機に投入する焙煎士">
画像が装飾的で、周囲のテキストですでにすべてが説明されている場合は、alt=""を使用してスクリーンリーダーがスキップするようにします。空のaltは正しいです。altがないのは正しくありません。
チェックリスト
-
UNSPLASH_ACCESS_KEYが設定され、コミットされていない - 名詞そのものではなく、ムードを検索した
- 被写体の配置をスロットのクロップに対して確認した
- トーン範囲が重ねられたテキストの下で機能する
- 1つのセクションの画像が一貫したルックを持っている
- CDN URLがAPIの要件通りにホットリンクされている — 再ホストされていない
- 出荷されたすべての写真に対して
download_locationがトリガーされた - サイズパラメータが表示サイズに一致している。レスポンシブヒーローには
srcsetを使用 - 実際のaltテキスト、または装飾的な場合は
alt="" - 推薦を示唆するものについて、モデル/プロパティリリースの前提がない