CHAPTER 05

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から除去されます。