カードコンポーネント

使用方法

{{< cards >}}
  {{< card link="../callout" title="コールアウト" icon="warning" >}}
  {{< card link="../callout" title="タグ付きカード" icon="tag" tag= "カスタムタグ" >}}
  {{< card link="/" title="アイコンなし" >}}
{{< /cards >}}
{{< cards >}}
  {{< card link="/" title="画像カード" image="https://source.unsplash.com/featured/800x600?landscape" subtitle="Unsplashの風景画像" >}}
  {{< card link="/" title="ローカル画像" image="/images/card-image-unprocessed.jpg" subtitle="staticディレクトリ下の未加工画像。" >}}
  {{< card link="/" title="ローカル画像" image="images/space.jpg" subtitle="assetsディレクトリ下の画像、Hugoで処理済み。" method="Resize" options="600x q80 webp" >}}
{{< /cards >}}

カードパラメータ

パラメータ説明
linkURL(内部または外部)。
titleカードのタイトル見出し。
subtitleサブタイトル見出し(Markdown対応)。
iconアイコンの名前。
tagタグ内のテキスト。
tagColorタグの色: gray(デフォルト)、yellowredblue

画像カード

さらに、カードは画像の追加と以下のパラメータを通じた処理をサポートします:

パラメータ説明
imageカードの画像URLを指定します。
methodHugoの画像処理メソッドを設定します。
optionsHugoの画像処理オプションを設定します。

カードは3種類の画像をサポートします:

  1. リモート画像: imageパラメータに完全なURLを指定。
  2. 静的画像: Hugoのstatic/ディレクトリ内の相対パスを使用。
  3. 処理済み画像: Hugoのassets/ディレクトリ内の相対パスを使用。

Hextraはビルド時に画像処理が必要かどうかを自動検出し、optionsパラメータまたはデフォルト設定(Resize、800x、品質80、WebPフォーマット)を適用します。 現在サポートされているmethodResizeFitFillCropです。

Hugoの組み込み画像処理コマンド、メソッド、オプションの詳細については、画像処理ドキュメントを参照してください。

タグ

カードはタグの追加をサポートしており、追加のステータス情報を表示するのに役立ちます。

{{< cards >}}
  {{< card link="../callout" title="デフォルトタグ色付きカード" tag="タグテキスト" >}}
  {{< card link="../callout" title="デフォルト赤タグ付きカード" tag="タグテキスト" tagType="error" >}}
  {{< card link="../callout" title="青タグ付きカード" tag="タグテキスト" tagType="info" >}}
  {{< card link="../callout" title="黄色タグ付きカード" tag="タグテキスト" tagType="warning" >}}
{{< /cards >}}

cardsショートコードにcolsパラメータを渡すことで、カードが広がる最大列数を指定できます。ただし、小さい画面では列は折りたたまれます。

{{< cards cols="1" >}}
  {{< card link="/" title="上部カード" >}}
  {{< card link="/" title="下部カード" >}}
{{< /cards >}}

{{< cards cols="2" >}}
  {{< card link="/" title="左カード" >}}
  {{< card link="/" title="右カード" >}}
{{< /cards >}}
最終更新日