エックスアンテナ

【保存版】記事で使えるコンポーネント一覧と使い方

この記事は、ブログで利用できるすべてのコンポーネントの使い方リファレンスです。記事を書くときにコピー&ペーストしてご活用ください。


コードブロック

コードブロックは言語を指定するとシンタックスハイライトが適用されます。右上の「コピー」ボタンでクリップボードにコピーできます。

JavaScript

javascript
function greet(name) {
  return `こんにちは、${name}さん!`;
}

console.log(greet('世界'));

TypeScript

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();
};

シェルコマンド

bash
# 依存パッケージをインストール
pnpm install

# 開発サーバーを起動
pnpm dev

CSS

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です。重大な問題や取り返しのつかない操作の前に使います。

書き方

plaintext
{% callout type="info" %}
ここにテキストを書く
{% /callout %}

type には info / tip / warning / danger が指定できます。


タイムライン

出来事の流れや変遷を時系列で見せるときに使います。

  1. ブログ開設

    WordPress でブログを始める。記事を書く楽しさに目覚める。

  2. 月間1万PV達成

    SEOを意識した記事作りが実を結び、月間アクセスが1万を突破。

  3. 独自システムへ移行

    Astro + Keystatic の静的サイトに移行。表示速度が大幅に改善。

  4. ダークモード対応

    ついにダークモードを実装。夜の読書体験がぐっと快適になった。

書き方

plaintext
{% timeline %}
{% timelineItem date="2024年1月" title="タイトル" %}
ここに内容を書く
{% /timelineItem %}
{% /timeline %}

会話吹き出し

対話形式で説明したいときや、Q&Aコンテンツに使えます。

読者

ダークモードってどうやって切り替えるの?

筆者

ヘッダーの右上にある月アイコンをクリックするだけです!設定は自動的に保存されます。

読者

簡単すぎる!次回アクセスしても覚えてくれるの?

筆者

はい、ブラウザに保存されるので次回も同じモードで表示されます。

書き方

plaintext
{% chat %}
{% bubble speaker="left" name="相手の名前" %}
テキスト
{% /bubble %}

{% bubble speaker="right" name="自分の名前" %}
テキスト
{% /bubble %}
{% /chat %}

speaker="left" が相手側、speaker="right" が自分側です。nameavatarUrl は省略可能です。


アフィリエイトボックス

Amazon・楽天・Yahoo!ショッピングなどの商品リンクをきれいに表示できます。

PR・広告

Kindle Paperwhite(16GB)

Kindle Paperwhite(16GB)

防水設計で読書に特化した最高の電子書籍リーダー。バッテリーが最大10週間持続し、外出先でも快適に読書できます。

書き方

plaintext
{% 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)も自動で出力されます。

Q

無料で使えますか?

A

はい、基本機能はすべて無料でご利用いただけます。上位プランへのアップグレードで追加機能が使えます。

Q

解約はいつでもできますか?

A

いつでも解約可能です。契約期間の縛りはなく、解約した月末まではサービスをご利用いただけます。

Q

スマートフォンでも使えますか?

A

はい、iOS・Android ともに対応しています。ブラウザからアクセスするだけでお使いいただけます。

書き方

plaintext
{% FAQ %}
{% FAQItem question="質問文をここに書く" %}
回答文をここに書く。**マークダウン**も使えます。
{% /FAQItem %}
{% /FAQ %}

question 属性に質問文を入れ、タグの中に回答を書くだけです。FAQPage JSON-LD は自動的に <head> に挿入されます。


CTAセクション

記事の途中や最後に、読者に行動を促すボタンを置けます。

Kindle Unlimitedを試してみませんか?

月額980円で200万冊以上が読み放題。30日間の無料体験あり。

無料体験をはじめる

variant には primary(青)/ secondary(インディゴ)/ accent(アンバー)が指定できます。


比較表

商品やサービスを横並びで比較するときに使います。

比較表データが設定されていません。


YouTube 埋め込み

YouTube の URL を貼るだけで動画を埋め込めます。広告オーバーレイ機能付きです。

シンプルな埋め込み

plaintext
{% YouTube url="https://youtu.be/jNQXAC9IVRw" /%}

広告オーバーレイあり

再生開始から指定秒数後に広告がふわっと表示されます。ユーザーが「×」をタップすると閉じます。

plaintext
{% YouTube
   url="https://youtu.be/jNQXAC9IVRw"
   adImageUrl="https://placehold.co/400x100/f59e0b/ffffff?text=広告サンプル"
   adLinkUrl="https://example.com"
   adDelay=5
   adPosition="bottom"
/%}
広告広告

オプション一覧

オプション説明デフォルト
urlYouTube URL(必須)
adImageUrl広告画像URLなし
adLinkUrl広告クリック先URLなし
adDelay広告を表示するまでの秒数5
adPosition広告の表示位置 top / center / bottombottom
adLabel広告ラベルのテキスト広告

X(旧Twitter)埋め込み

X のポストは ExternalHtmlEmbed コンポーネントに公式の埋め込みコードを貼り付けて使います。

使い方

  1. X でポストを開き「…」→「ポストを埋め込む」から埋め込みコードをコピーする
  2. 以下のように ExternalHtmlEmbedhtml 属性に貼り付ける
plaintext
{% ExternalHtmlEmbed html="<blockquote class=\"twitter-tweet\"><p lang=\"ja\" dir=\"ltr\">ポストの本文</p>&mdash; 名前 (@handle) <a href=\"https://twitter.com/handle/status/123456789\">日付</a></blockquote><script async src=\"https://platform.twitter.com/widgets.js\" charset=\"utf-8\"></script>" /%}

ポイント: 埋め込みコード内のダブルクォート "\" にエスケープしてください。


見出しのアンカーリンク

各見出しにカーソルを合わせると # が表示されます。クリックするとその見出しへの直リンクをコピーできます。特定のセクションをシェアするときに便利です。


以上が現在使用できるコンポーネントの一覧です。新しいコンポーネントが追加されたらこの記事も更新します。