media list・media get で画像を調べる

PNGだけを一覧にして、登録済み画像のID、寸法、代替テキストを確認します。件数が多いときの続きを読む方法も引けます。

目次

「管理画面に入れた写真は何ピクセル?」「代替テキストは保存された?」というときは、media list で画像を探し、media get でその1枚の登録内容を読めます。

写真付き一覧の実習で「管理画面で写真を入れる」まで済ませてください。以下のコマンドは、練習サイトを起動したまま、もう一つのコマンド入力画面を weekend-note フォルダーで開いて実行します。接続先の 4350 は練習サイトの起動時に表示されるポート番号です。

PNG画像を一覧にする

npx emdash media list --mime image/png --limit 5 --url http://127.0.0.1:4350 --json

--mime でファイルの種類を、--limit で一度に読む上限を指定します。この例はPNGを最大5件読みます。--json を付けると、各項目の名前と値が分かる形式で表示されます。

結果の items に画像が並びます。教材の画像を登録していれば、filename が sample.png の項目を探してください。その項目の id が、次のコマンドで使う画像の管理用IDです。

1枚の寸法と代替テキストを確認する

次の MEDIA_ID は、先ほどの id の値に置き換えてください。

npx emdash media get MEDIA_ID --url http://127.0.0.1:4350 --json

今度は1枚分の情報がそのまま表示されます。教材の画像では次の値を読み取れました。

項目確認できること練習サイトの例
filename・mimeType登録時のファイル名と種類sample.png・image/png
width・height元の画像の幅と高さ(ピクセル)320・180
sizeファイルの大きさ(バイト)1285
alt画像に登録した代替テキスト散歩の練習用画像。自分で付けた説明が入ります

一覧で条件に合うものが0件なら items は空の配列 [] です。1枚を指定して Media item not found と表示されたら、同じ接続先の一覧を開き、画像の id をコピーし直してください。

件数が多いときは続きを読む

たとえばPNGが2枚以上あるときは、最初のコマンドの --limit 5 を --limit 1 に変えてみてください。結果の nextCursor は「次の1件をどこから読むか」を示す文字列です。下の CURSOR をその値に置き換え、同じ条件で実行します。

npx emdash media list --mime image/png --limit 1 --cursor CURSOR --url http://127.0.0.1:4350 --json

検証では、PNGを2枚登録して1枚ずつ取得できました。最後の結果には nextCursor が付きません。画像を読者向けページに表示する方法は、Image部品のリファレンスで確認できます。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。