WOString

Last modified by Ken Ishimoto on 2012/02/11 08:19

WOString はダイナミックに作り出された文字列としてHTMLページ内でそれ自体を表示します。


WOString {
value = aString;
[ formatter = formatterObj; ]
[ escapeHTML = aBoolean; ]
[ dateformat = dateFormatString; ]
[ numberformat = numberFormatString; ]
[ valueWhenEmpty = emptyString; ]
}

value

HTML ページ内で表示するテキスト。値は主に java.lang.String オブジェクトを割り当てられます。java.lang.String を戻すことで記述メッセージに返答するオブジェクト、又は java.lang.String を戻すメソッド。java.lang.String の内容は、このダイナミックエレメントによって占領された場所で 、HTML の中に代用されます。

escapeHTML

escapeHTML が true の場合、displayString によってレンダリングされた文字列は、HTMLコントロールキャラクターとして翻訳されるキャラクターが、エスケープした同値(これがデフォルト)になるために変換されます。このように、 displayString が"a <b>bold</b> idea"の場合、クライアントブラウザにパスされた文字列は


"a &lt;B&gt;bold&lt;/B&gt; idea"

になりますが、ブラウザー内で "a <b>bold</b> idea" として表示されます。escapeHTML が false の場合、WebObjects は単にクライアントブラウザへデータをそのままで渡します。この場合、上記の例は "a bold idea" としてクライアントブラウザ内で表示されます。アイテム内で文字列がキャラクターを持たないことが確かである場合、HTMLコントロールキャラクターとして翻訳されるかもしれません。escapeHTMLをfalseに設定する場合は、より良いパフォーマンスを得ます。

formatter

文字列として表示のためにオブジェクト値をフォーマットするために使用される NSFormatter サブクラスの例。この属性は事前設定されたフォーマッターオブジェクトを含む変数を指定すべきです。ユーザーが「 未フォーマット 」値を入力する場合、無効な値を示すエラーページを返送させて、WOString は無効な値をパスします。

dateformat

値が日付としてどのようにフォーマットされるべきかを指定するフォーマット文字列。日付フォーマットが使用される場合、値はNSTimestamp オブジェクト(java.lang.String オブジェクトを割り当てられる場合、NSTimestamp オブジェクトの文字列代理として保存されます)を割り当てられます。エレメントの値が指定するフォーマットに従って解釈不可能な場合、値は null に設定されます。日付フォーマット構文の記述のために、NSTimestamp クラスを参照して下さい。

numberformat

値が数としてどのようようにフォーマットされるべきかを指定するフォーマット文字列。エレメントの値が指定するフォーマットに従って解釈不可能な場合、値は null に設定されます。ナンバーフォーマット構文の記述のために、 NSNumberFormatter クラスを参照して下さい。

valueWhenEmpty

値が空の文字列であるとき、値の代用となる文字列。