ブログのテンプレート内で使用できる独自タグと変数の一覧です。
※HTML/CSS編集や、独自のカスタマイズに関する技術的サポートは一切行っておりませんので、予めご了承ください。
独自タグの基本文法
| <% %> | Seesaaブログ独自のタグです。 |
|---|---|
| <% 変数 %> | 変数の値を表示します。 |
| <% 変数 | 関数 %> | 変数を関数の種類に応じて整形します。 |
| <%- または -%> | [-]を使用すると直前直後の改行コードが削除されます。 |
変数の使用方法
変数には変数そのものが展開されるものと、ドット(.)をつないで展開されるものの2種類があります。
| 通常の変数 | <% page_name %> |
|---|---|
| オブジェクト型変数 | <% blog.title %> |
代表的な変数一覧(オブジェクト型)
| blog.name | ホスト名 |
|---|---|
| blog.title | ブログ名 |
| blog.description | ブログ説明 |
| blog.page_url | ブログURL |
| blog.keywords | ブログキーワード |
| blog.nickname | ブログニックネーム |
| article.subject | タイトル |
| article.body | 本文 |
| article.body_continue_text | 追記文のつなぎ文言 |
| article.body_more | 追記文 |
| article.first_body | 追記文言を含む本文 |
| article.entire_body | 本文と追記文をあわせたもの |
| article.disp_flag | 公開非公開フラグ |
| article.accept_comment | コメント受付フラグ |
| article.topics | キーワード(アフィリエイト) |
| article.createstamp | 投稿日時 |
| article.children_count | コメント数 |
| article.page_url | 記事ページURL |
| article.category | categoryオブジェクトを取得 |
| category.name | カテゴリ名 |
| category.article_count | 記事数 |
| category.page_url | カテゴリのURL |
条件分岐の使用方法
| <% if:条件 %> 〜 <% /if %> |
if文 条件が真(満たされる)の場合にifタグで囲まれた中のHTMLを表示します。 |
|---|---|
| <% unless:条件 %> 〜 <% /unless %> |
unless文 条件が偽(満たされない)の場合にブロック内unlessタグで囲まれた中のHTMLを表示します。 |
| <% if:条件 %> 〜 <% else %> 〜 <% /if %> |
else文 条件が偽(満たされない)の場合に使用します。unless文と同様です。 |
| <% loop:変数 %> 〜 <% /loop %> |
loop文 loopの中ではloopの値に応じて複数回繰り返しがおこなわれます。 |
ページの切り分け制御方法
ページの切り分けはpage_nameで制御が可能です。
使用例:<% if:page_name eq 'index' %>トップページにだけ表示したいHTML<% /if %>
| index | トップページに表示させる |
|---|---|
| article | /article/ 配下に表示させる |
| archive | /archive/配下に表示させる |
| category | /category/配下に表示させる |
| comment | /comment/配下に表示させる |
| search | /search/配下に表示させる |
| profile | /profile/配下に表示させる |
| tag | /tag/配下に表示させる |
関数の使用方法
関数は数珠繋ぎで利用することができます。
使用例:
<% foo | tag_break | shorten(100) | nl2br %>
fooの値からHTMLタグを取り除き、テキストサイズを100byteに切り詰めて、改行コードをタグに変換しています
代表的な関数
| clickable | http://で始まる文字列があった場合にその文字列をHTMLリンクにします。 |
|---|---|
| comma | 数字の三桁ごとにカンマを追加します。 使用例:1000 -> 1,000 |
| date_format | 日付文字列を指定フォーマットで表示します。 例 <% article.createstamp | data_format(%Y/%m) %> |
| html | HTMLエスケープ |
| nl2br | 改行コードを に変換します。 |
| ns2sp | 改行コードをスペースに変換します。 |
| oneline | 改行コードを抜いて一行にします。 |
| shorten | 指定byte以降を省略します。 |
| tag_bleak | b,i,img,aタグを許可し、その他のHTMLタグを抜きます。 |
| tag_strip | HTMLタグを全て抜きます。 |
| text_summary | HTMLタグを有効にした上でテキスト部分を指定byte以降を表示しないようにします。 使用例: <% foo | text_summary(100) %> |
日付の表示方法
日付はdata_format関数にフォーマット文を与えて整形します。
| <% article.createstamp | data_format("%Y年%m月") %> | 2014年10月 |
|---|---|
| <% article.createstamp | data_format("%Y/%m") %> | Oct-05 |
| <% article.createstamp | data_format("%Y/%m/%d") %> | 2014/10/05 |
| <% article.createstamp | data_format("%Y/%m/%d %a") %> | 2014/10/15 Wed |