特別なrequestスコープオブジェクト

Ymirでは以下のオブジェクトがrequestスコープにバインドされています。

したがって、例えばPageオブジェクトのtitleプロパティの値を参照したい場合は「self/title」と書けばよいことになります。

最初のセグメントの解決手順

Path式の最初のセグメント（「first/second/third」の「first」の部分） は次の順序に従って解決されます。

1. "first"の部分が正の数値文字列であれば文字列をIntegerに変換した値。
2. "first"の部分が"CONTEXTS"であれば組み込み変数CONTEXTSの値。
3. tal:defineやtal:repeatで生成された変数スコープに"first"という変数があればその値。変数スコープは一番近いものから外側に向けてグローバル変数スコープまで検索される。
4. "first"の部分がFreyjaの組み込み変数名（nothing、null、default、CONTEXTS、true、false、request、response、session、application、locale、element、attrs、repeat）であれば組み込み変数の値。
5. HttpServletRequest#getAttribute("first") の値がnullでなければその値。
6. セッションが張られていてかつHttpSession#getAttribute("first") の値がnullでなければその値。
7. ServletContext#getAttribute("first") の値がnullでなければその値。
8. "first"の部分がYmirの組み込み変数名（ymirRequest、container、messages、token、variables）であれば変数の値。
9. HttpServletRequest#getParameter("first") の値がnullでなければその値。
10. HttpServletRequest#getAttribute("self")の値がnullでなく、かつその値オブジェクトが"first"という名前のプロパティを持てばその値。
11. 上記のいずれにも該当しない場合はnull。

セグメントの解釈

例えばPath式で「self/name」と書いた場合、selfを解決した結果であるオブジェクトについてセグメント「name」を解釈した結果が最終結果になります。

セグメントは基本的にはオブジェクトのプロパティと解釈されます。したがって、例えば上記の例ではselfに対応するオブジェクトについてgetName()メソッドを呼び出した結果が最終結果になります。

オブジェクトの型によっては特別な解釈がなされますが、Ymirではさらに以下のような解釈が行なわれます。解釈は以下の表の上から順に適用され、結果がnullでExceptionがスローされなければさらに下の解釈が適用されます。

decorate式（Ymir-1.0.7以降）

decorate式はtal:attributesの中でclass属性の値を設定するためだけに利用できる式で、以下の構文で記述します:

decorate:*条件* with *[!]class属性に追加する値*

この式の値は、条件が真の場合は指定された値を現在のclass属性に追加したものになります。指定された値が既にclass属性の値に含まれている場合は何もしません。条件が偽の場合は、この式の値は現在のclass属性の値になります。

「条件」にはtal:conditionに書くような条件式を書くことができます。

「class属性に追加する値」には文字列で値を書いて下さい。

なお値の直前に「!」をつけると、既存のclass属性が置換されます。例えば項目「date」を表すinputタグについて、バリデーションエラーの時に動的にclass属性に「error」という値を追加するための記述例は以下の通りです:

<input type="text" name="date" tal:attributes="class decorate:notes/contains(date) with error" />

decorate-by-notes式（Ymir-1.0.7以降）

decorate-by-notes式はdecorate式とほぼ同じですが、メッセージ（Notes）表示に特化しています。具体的には、decorate式の条件部に「notes/contains(NAME)」と書く代わりに単に「NAME」と書くことができます（逆に、普通の条件式を書くことはできません。）:

decorate-by-notes:[*カテゴリ名*] with *[!]class属性に追加する値*

「カテゴリ名」で指定されたカテゴリに属するNoteが現在のNotesに存在する場合に、指定された値がclass属性に追加されます。

カテゴリ名は省略することができます。省略した場合、現在のNotesになんらかのメッセージが存在する場合に指定された値がclass属性に追加されます。例えば項目「date」を表すinputタグについて、バリデーションエラーの時に動的にclass属性に「error」という値を追加するための記述例は以下の通りです:

<input type="text" name="date" tal:attributes="class decorate-by-notes:date with error" />