CFPROCESSINGDIRECTIVE | |
説明
現在のページの処理方法に関して ColdFusion に以下の情報を与えます。
|
|
カテゴリ
データ出力タグ、ページ処理タグ | |
シンタックス<cfprocessingdirective pageencoding = "page-encoding literal string" /> または <cfprocessingdirective suppressWhiteSpace = "yes"、"no" pageEncoding = "page-encoding literal string"> CFML タグ </cfprocessingdirective> |
|
関連項目
cfcol、cfcontent、cfoutput、cfsetting、cfsilent、cftable、SetEncoding、『ColdFusion MX 開発ガイド』の第17章の「グローバル化アプリケーションの開発」 |
|
ヒストリ
ColdFusion MX:
|
|
使用方法
cfprocssingdirective タグには、使用する属性に依存する制限があります。このため、cfprocessingdirective タグでは、pageencoding 属性または suppresswhitespace 属性のいずれか一方だけを使用することをお勧めします。両方の値を指定する場合は、別々のタグを使用します。 ColdFusion コンポーネント (.cfc ファイル) では、cfprocessingdirective タグは cfcomponent タグの後に続く必要があります。 pageEncoding 属性を使用する場合は、次のルールが適用されます。
<cfif dynEncoding is not "dynamic encoding is not possible"> <cfprocessingdirective pageencoding=#dynEncoding#> </cfif> suppressWhiteSpace 属性を使用する場合は、次のルールが適用されます。
<!--- ColdFusion によって、実行時に削除オプションを設定できるようにする ---> <cfprocessingdirective suppresswhitespace=#whitespaceSetting#> 設定値がどの出力に適用されるのかをコーディングします。 </cfprocessingdirective> 次の例では、ネストされた cfprocessingdirective タグの使い方を示します。外側のタグは、大きなテーブルの計算時に不要な空白を削除します。内側のタグは空白を保持して、書式設定済みのテーブルを出力します。 |
|
例<cfprocessingdirective suppressWhiteSpace = "Yes"> <!--- CFML コード ---> <cfprocessingdirective suppressWhiteSpace = "No"> <cfoutput>#table_data# </cfoutput> </cfprocessingdirective> </cfprocessingdirective> 次の例では、pageencoding 属性の使い方を示します。 <cfprocessingdirective pageencoding = "shift_jis"> |
SUPPRESSWHITESPACE | |
オプション | |
ブール値です。cfprocessingdirective ブロック内の空白文字を削除するかどうかを指定します。空白文字は CFML タグによって生成され、HTML の外観にはほとんど影響しません。この設定は、HTML コード内の空白には適用されません。 |
PAGEENCODING | |
オプション | |
Default value: "文字エンコードはページの BOM (Byte Order Mark) によって識別され、BOM がない場合はシステムのデフォルトのエンコードが使用される"
文字列リテラルです。変数は使用できません。現在の CFML ページの文字エンコードを指定します。この属性は、cfprocessing タグ本文だけでなく、ページ全体に適用されます。この値を一重引用符または二重引用符で囲むこともできますが、囲まなくても問題ありません。 一般的に使用される値を次に示します。
文字エンコードの詳細については、www.w3.org/International/O-charset.html を参照してください。 |