この記事は、ブログで利用できるすべてのコンポーネントの使い方リファレンスです。記事を書くときにコピー&ペーストしてご活用ください。
コードブロック
コードブロックは言語を指定するとシンタックスハイライトが適用されます。右上の「コピー」ボタンでクリップボードにコピーできます。
JavaScript
function greet(name) {
return `こんにちは、${name}さん!`;
}
console.log(greet('世界')); TypeScript
type User = {
id: number;
name: string;
email: string;
};
const getUser = async (id: number): Promise<User> => {
const res = await fetch(`/api/users/${id}`);
return res.json();
}; シェルコマンド
# 依存パッケージをインストール
pnpm install
# 開発サーバーを起動
pnpm dev CSS
.card {
border-radius: 0.75rem;
padding: 1.5rem;
background: white;
box-shadow: 0 1px 3px rgb(0 0 0 / 0.1);
} Callout(注意書き)
情報・注意・警告・ヒントの4種類があります。
情報
これは 情報(info) のCalloutです。補足情報や豆知識を伝えるときに使います。
ヒント
これは ヒント(tip) のCalloutです。便利な使い方やおすすめの方法を伝えるときに使います。
注意
これは 注意(warning) のCalloutです。気をつけてほしいことを伝えるときに使います。
警告
これは 警告(danger) のCalloutです。重大な問題や取り返しのつかない操作の前に使います。
書き方
{% callout type="info" %}
ここにテキストを書く
{% /callout %} type には info / tip / warning / danger が指定できます。
タイムライン
出来事の流れや変遷を時系列で見せるときに使います。
-
ブログ開設
WordPress でブログを始める。記事を書く楽しさに目覚める。
-
月間1万PV達成
SEOを意識した記事作りが実を結び、月間アクセスが1万を突破。
-
独自システムへ移行
Astro + Keystatic の静的サイトに移行。表示速度が大幅に改善。
-
ダークモード対応
ついにダークモードを実装。夜の読書体験がぐっと快適になった。
書き方
{% timeline %}
{% timelineItem date="2024年1月" title="タイトル" %}
ここに内容を書く
{% /timelineItem %}
{% /timeline %} 会話吹き出し
対話形式で説明したいときや、Q&Aコンテンツに使えます。
ダークモードってどうやって切り替えるの?
ヘッダーの右上にある月アイコンをクリックするだけです!設定は自動的に保存されます。
簡単すぎる!次回アクセスしても覚えてくれるの?
はい、ブラウザに保存されるので次回も同じモードで表示されます。
書き方
{% chat %}
{% bubble speaker="left" name="相手の名前" %}
テキスト
{% /bubble %}
{% bubble speaker="right" name="自分の名前" %}
テキスト
{% /bubble %}
{% /chat %} speaker="left" が相手側、speaker="right" が自分側です。name と avatarUrl は省略可能です。
アフィリエイトボックス
Amazon・楽天・Yahoo!ショッピングなどの商品リンクをきれいに表示できます。
PR・広告
書き方
{% AffiliateBox
productName="商品名"
description="商品の説明文"
imageUrl="https://..."
amazonUrl="https://..."
rakutenUrl="https://..."
yahooUrl="https://..."
customUrl="https://..."
customLabel="ショップ名で見る" /%} imageUrl description amazonUrl rakutenUrl yahooUrl customUrl はすべて省略可能です。
FAQ(よくある質問)
よくある質問とその回答を、Q・A アイコン付きで表示できます。SEO 用の FAQPage 構造化データ(JSON-LD)も自動で出力されます。
無料で使えますか?
はい、基本機能はすべて無料でご利用いただけます。上位プランへのアップグレードで追加機能が使えます。
解約はいつでもできますか?
いつでも解約可能です。契約期間の縛りはなく、解約した月末まではサービスをご利用いただけます。
スマートフォンでも使えますか?
はい、iOS・Android ともに対応しています。ブラウザからアクセスするだけでお使いいただけます。
書き方
{% FAQ %}
{% FAQItem question="質問文をここに書く" %}
回答文をここに書く。**マークダウン**も使えます。
{% /FAQItem %}
{% /FAQ %} question 属性に質問文を入れ、タグの中に回答を書くだけです。FAQPage JSON-LD は自動的に <head> に挿入されます。
CTAセクション
記事の途中や最後に、読者に行動を促すボタンを置けます。
variant には primary(青)/ secondary(インディゴ)/ accent(アンバー)が指定できます。
比較表
商品やサービスを横並びで比較するときに使います。
比較表データが設定されていません。
YouTube 埋め込み
YouTube の URL を貼るだけで動画を埋め込めます。広告オーバーレイ機能付きです。
シンプルな埋め込み
{% YouTube url="https://youtu.be/jNQXAC9IVRw" /%} 広告オーバーレイあり
再生開始から指定秒数後に広告がふわっと表示されます。ユーザーが「×」をタップすると閉じます。
{% YouTube
url="https://youtu.be/jNQXAC9IVRw"
adImageUrl="https://placehold.co/400x100/f59e0b/ffffff?text=広告サンプル"
adLinkUrl="https://example.com"
adDelay=5
adPosition="bottom"
/%} オプション一覧
| オプション | 説明 | デフォルト |
|---|---|---|
url | YouTube URL(必須) | — |
adImageUrl | 広告画像URL | なし |
adLinkUrl | 広告クリック先URL | なし |
adDelay | 広告を表示するまでの秒数 | 5 |
adPosition | 広告の表示位置 top / center / bottom | bottom |
adLabel | 広告ラベルのテキスト | 広告 |
X(旧Twitter)埋め込み
X のポストは ExternalHtmlEmbed コンポーネントに公式の埋め込みコードを貼り付けて使います。
使い方
- X でポストを開き「…」→「ポストを埋め込む」から埋め込みコードをコピーする
- 以下のように
ExternalHtmlEmbedのhtml属性に貼り付ける
{% ExternalHtmlEmbed html="<blockquote class=\"twitter-tweet\"><p lang=\"ja\" dir=\"ltr\">ポストの本文</p>— 名前 (@handle) <a href=\"https://twitter.com/handle/status/123456789\">日付</a></blockquote><script async src=\"https://platform.twitter.com/widgets.js\" charset=\"utf-8\"></script>" /%} ポイント: 埋め込みコード内のダブルクォート
"は\"にエスケープしてください。
見出しのアンカーリンク
各見出しにカーソルを合わせると # が表示されます。クリックするとその見出しへの直リンクをコピーできます。特定のセクションをシェアするときに便利です。
以上が現在使用できるコンポーネントの一覧です。新しいコンポーネントが追加されたらこの記事も更新します。