data-aihp 属性リファレンス
HTMLに記述する各種 data-aihp-* 属性の仕様、記法、ループ処理、カスタム項目の出力方法一覧です。
data-aihp 属性リファレンス
記事詳細の値
<h1 data-aihp="title">記事タイトル</h1>
<div data-aihp-html="content">記事本文</div>
<time data-aihp="fields.event_date">2026-08-14</time>
<img data-aihp-src="fields.eye_catch" src="/assets/img/noimage.png" alt="">
| やりたいこと | 属性 |
|---|---|
| 要素内へテキストを入れる | data-aihp="title" |
| 本文HTMLを入れる | data-aihp-html="content" |
hrefへ値を入れる | data-aihp-href="url" |
srcへ値を入れる | data-aihp-src="fields.image" |
content属性へ値を入れる | data-aihp-content="fields.description" |
主な標準キーはtitle、content、slug、status、created_at、updated_at、published_at、urlです。
カスタム項目はfields.を付けても、付けなくても指定できます。
<time data-aihp="fields.event_date">2026-08-14</time>
<time data-aihp="event_date">2026-08-14</time>
標準キーに無い名前は、カスタム項目として探します。loop.を付けた一覧の中や、data-aihp-loopの指定でも同じです。
<dl data-aihp-loop="faq_list">
<dt data-aihp="loop.question">仮質問</dt>
</dl>
カスタム項目に標準キーと同じ名前は使えません。コンテンツタイプ設定で保存時に拒否されるため、どちらを指すか曖昧になることはありません。
将来CMSへ標準キーが追加された場合、同じ名前のカスタム項目があると指す先が変わります。長く使うテンプレートではfields.を付けておくと確実です。
metaタグ
<meta name="description" content=""
data-aihp-content="fields.meta_description">
<meta property="og:title" content=""
data-aihp-content="title">
<meta property="og:image" content=""
data-aihp-content="fields.eye_catch">
CMSは使用するフィールドを自動選択しません。値が空ならcontent=""となり、本文からdescriptionを自動生成しません。
通常の記事一覧
<ul class="news-list" data-aihp-list="info" data-aihp-limit="3">
<li>
<time data-aihp="loop.created_at">2026-01-01</time>
<a data-aihp="loop.title"
data-aihp-href="loop.url">記事タイトル</a>
</li>
</ul>
| 属性 | 内容 |
|---|---|
data-aihp-list="info" | type.path = infoの公開記事 |
data-aihp-limit="3" | 最新3件 |
data-aihp-limit="all" | 全件 |
data-aihp-category="important" | 指定カテゴリslugへ直接所属する記事 |
data-aihp-limit省略時も全件です。並び順は作成日時の新しい順です。下書きは一覧へ出ません。
インライン一覧内では、loop.title、loop.url、loop.fields.event_dateのようにloop.を付けます。
親カテゴリを指定しても、子・孫カテゴリの記事は自動的に含みません。
一覧1件分を外部パーツにする
呼び出し元:
<ul data-aihp-list="info"
data-aihp-limit="5"
data-aihp-template="parts/_info_item.html"></ul>
src/parts/_info_item.html:
<li>
<time data-aihp="created_at">2026-01-01</time>
<a data-aihp="title" data-aihp-href="url">記事タイトル</a>
</li>
外部パーツ内ではloop.titleではなくtitle、loop.fields.xxxではなくfields.xxxを使用します。data-aihp-templateもsrc/を起点に指定し、src/や..は書きません。
特定の公開記事1件
<article data-aihp-entry="info/notice-01">
<h2 data-aihp="title">記事タイトル</h2>
<div data-aihp-html="content">記事本文</div>
<a data-aihp-href="url">詳しく見る</a>
</article>
指定形式は{type.path}/{article.slug}です。先頭/、カテゴリ、末尾.htmlは書きません。
type.path: products
公開URL: /products/pc/laptop/model-x.html
指定値: products/model-x
存在しない記事、下書き、不正指定の場合はコンテナを公開HTMLから除去し、再構築を継続します。data-aihp-entryの入れ子は使用できません。
1記事内の繰り返し
<dl data-aihp-loop="fields.faq_list">
<div>
<dt data-aihp="loop.question">質問</dt>
<dd data-aihp="loop.answer">回答</dd>
</div>
</dl>
対象が空なら、ループ要素の中身は空になります。repeaterの入れ子は使用できません。
属性値が空の場合
data-aihp: 要素の中身を空にします。元HTMLの仮テキストは公開されません。data-aihp-href: 要素ごと削除します。 リンク先がないと押せないテキストが残るためです。data-aihp-src: 要素ごと削除します。 画像がないと壊れた表示になるためです。data-aihp-content:content=""にします。data-aihp-html: 要素内を空にします。
一覧リンクには、仮のhref="#"を書かないことを推奨します。
要素ごと削除されたとき
親要素が空で残ります。
<li><a data-aihp-href="fields.link_url">詳しくはこちら</a></li>
↓ link_url が空のとき
<li></li>
詳細ページがないコンテンツタイプでは
loop.urlを使わないでください。
_entry.htmlがないコンテンツタイプの記事には詳細ページがないため、loop.urlは常に空です。data-aihp-href="loop.url"を書くと、一覧の項目ごと消えます。使えません <li><a data-aihp-href="loop.url" data-aihp="loop.title">仮タイトル</a></li> 正しい書き方 <li data-aihp="loop.title">仮タイトル</li>
ページネーションを有効にする
一覧へdata-aihp-pagination="on"と数値のdata-aihp-limitを付けます。
<ul data-aihp-list="news"
data-aihp-limit="10"
data-aihp-pagination="on">
<li>
<a data-aihp="loop.title"
data-aihp-href="loop.url">記事タイトル</a>
</li>
</ul>
| 指定 | 結果 |
|---|---|
data-aihp-limit="10" | 最新10件だけ。2ページ目なし |
data-aihp-limit="10" data-aihp-pagination="off" | 最新10件だけ。2ページ目なし |
data-aihp-limit="10" data-aihp-pagination="on" | 1ページ10件。11件以上で_2.htmlを生成 |
data-aihp-limit="all" | 全件を1ページへ表示 |
data-aihp-limit="all" data-aihp-pagination="on" | エラーで再構築停止 |
1つの元HTMLでページ分割できる一覧は1つです。ページ分割しない通常一覧は同じHTMLへ併設できます。
ページ送りの最小構成
<nav data-aihp-page-nav>
<a data-aihp-page-number>1</a>
</nav>
3ページの2ページ目では次の形になります。
<nav>
<a href="index.html">1</a>
<a href="index_2.html" class="current" aria-current="page">2</a>
<a href="index_3.html">3</a>
</nav>
元のclassは維持され、現在ページにだけcurrentとaria-current="page"が追加されます。
戻る・次へ
<nav class="pagination" data-aihp-page-nav>
<a class="prev" data-aihp-page-part="prev">← 戻る</a>
<a class="number" data-aihp-page-number>1</a>
<a class="next" data-aihp-page-part="next">次へ →</a>
</nav>
prevとnextは任意です。先頭ページのprevと最終ページのnextは要素ごと除去されます。無効状態用の要素を別に用意する必要はありません。
タグ名は自由です。ul・li、nav・a、divなどを使用できます。属性を囲み要素へ付ける場合、その内側のリンクは1つにします。
<li data-aihp-page-number><a>1</a></li>
1ページしかない場合は、data-aihp-page-navを付けた要素全体を出力しません。
アーカイブの種類
アーカイブ生成元は対象タイプのsrc/{type.path}/配下へ置きます。ファイル名は自由です。
全件
<ul data-aihp-list="news" data-aihp-limit="10" data-aihp-pagination="on">...</ul>
元がsrc/news/index.htmlなら、/news/index.html、/news/index_2.htmlを生成します。全件アーカイブは元HTML自身を1ページ目にするため、_なしのファイル名を使用します。
カテゴリ別
<ul data-aihp-list="news" data-aihp-limit="10" data-aihp-pagination="on"
data-aihp-archive-group="category">...</ul>
src/news/_category.htmlなどへ置きます。カテゴリproducts/pcなら、/news/products/pc/index.html、index_2.htmlを生成します。公開記事0件のカテゴリは生成しません。
カテゴリ名は次で表示できます。
<span data-aihp="archive.category_name">カテゴリ名</span>
年別・月別
<ul data-aihp-list="news" data-aihp-limit="10" data-aihp-pagination="on"
data-aihp-archive-group="year">...</ul>
<ul data-aihp-list="news" data-aihp-limit="10" data-aihp-pagination="on"
data-aihp-archive-group="month">...</ul>
- 年別:
/news/2026.html、/news/2026_2.html - 月別:
/news/202608.html、/news/202608_2.html - 表示キー:
archive.year、archive.month - 分類には公開日時、空なら作成日時を使用
カテゴリ・年・月の生成元自体は公開せず、生成URLだけを公開します。_category.html、_year.html、_month.htmlを推奨しますが、用途の正本は属性です。
アーカイブのtitleとcanonicalには次を使用できます。descriptionは元HTMLへ直接書き、CMSは自動生成しません。
<title data-aihp="archive.title">ニュース一覧</title>
<link rel="canonical" href="/news/index.html"
data-aihp-href="archive.canonical">
<meta name="description" content="ニュースの一覧です。">
ページネーションの注意
data-aihp-page-nav内にdata-aihp-page-numberを1つだけ置きます。data-aihp-page-partはprevまたはnextだけです。data-aihp-page-navは入れ子にしません。srcへ生成先と同名のindex_2.htmlなどを置くと、再構築を停止します。- CMS用のページネーション属性は生成後の公開HTMLから除去されます。