条件分岐構文
#{if 条件分岐タグ}内容A#{end}
のように記述することで、条件を満たすとき内容Aが表示されるような条件分岐が可能です。条件分岐構文はレイアウトやパーツの上部HTML、下部HTMLで使用できます。条件分岐構文としてif
, elsif
, else
が使用できます。条件分岐タグは特定の内容を表示する条件を設定するために使用します。
条件分岐タグ | 説明 |
---|---|
is_page() | 表示中の画面がページならばtrue, それ以外はfalseを返します。 |
is_page(‘docs’) | 表示中の画面が、ファイル名(フルパス)がdocsから始まるかつページならばtrue, それ以外はfalseを返します。 |
is_node() | 表示中の画面がフォルダーならばtrue, それ以外はfalseを返します。 |
is_node(‘docs’) | 表示中の画面が、フォルダー名(フルパス)がdocsから始まるかつフォルダーならばtrue, それ以外はfalseを返します。 |
in_node(‘docs’) | 表示中の画面が、フォルダー名(フルパス)がdocsから始まるかつならばtrue, それ以外はfalseを返します。is_node(‘docs’)とは異なりページでもtrueを返します。 |
has_pages() | 表示中のフォルダーにページがある、または表示中のフォルダーのカテゴリーに所属しているならばtrue, それ以外はfalseを返します。 |
ページとフォルダーで表示を変えたい場合は以下のように記述します。
#{if is_page()}
<p>#{parent_name} > #{page_name}</p>
#{elsif is_node()}
<p>#{page_name}</p>
#{end}
yield と組み合わせる事でフォルダー内にページが無い場合の表示を記述できます。
#{if has_pages()}
{{ yield }}
#{else}
<p>記事はありません。</p>
#{end}
現在、以下の機能は未対応です。
- and, or関数
- 入れ子構造