マニュアルキャンセル

cftextarea

検索

最終更新日 : 2022年1月19日 | 次にも適用 : ColdFusion

ColdFusion

アプリを開く

CFML リファレンスユーザーガイド
ColdFusion 関数
ColdFusion のタグ
1. ColdFusion タグの概要
2. カテゴリ別の ColdFusion タグ
  1. アプリケーションフレームワークタグ
    1. cfapplication
    2. cfassociate
    3. cferror
    4. cfimport
    5. cfinterface
    6. cflock
    7. CFScript の
    8. cfthread
  2. 通信タグ
  3. データベース操作タグ
  4. データ出力タグ
    1. cfchart
    1. cfchartdata
    2. cfchartseries
    3. cfchartset
    4. cfcol
    5. cfcontent
    6. cfdocument
    7. cfdocumentitem
    8. cfdocumentsection
    9. cfflush
    10. cfheader
    11. cflog
    12. cfoutput
    13. cfpresentation
    14. cfpresentationslide
    15. cfpresenter
    16. cfprocessingdirective
    17. cfprint
    18. cfreport
    19. cfreportparam
    20. cfsilent
    21. cftable
  5. デバッグタグ
    1. cfdump
    2. cftimer
    3. cftrace
  6. 例外処理タグ
    1. cfcatch
    2. cferror
    3. cffinally
    4. cfrethrow
    5. cfthrow
    6. cftry
  7. 拡張タグ
    1. cfchart
    2. cfchartdata
    3. cfchartseries
    4. cfcollection
    5. cfcomponent
    6. cfexecute
    7. cfftp
    8. function
    9. cfindex
    10. cfinterface
    11. cfinvoke
    12. cfinvokeargument
    13. cfobject
    14. cfproperty
    15. cfreport
    16. cfreportparam
    17. cfreturn
    18. cfsearch
    19. cfsharepoint
    20. cfspreadsheet
    21. cfwddx
    22. cfxml
  8. ファイル管理タグ
  9. フロー制御タグ
    1. cfabort
    2. cfbreak
    3. cfcase
    4. cfcontinue
    5. cfdefaultcase
    6. cfelse
    7. cfelseif
    8. cfexecute
    9. cfexit
    10. cfif
    11. cfinclude
    12. cflocation
    13. cfloop
    14. cfrethrow
    15. cfswitch
    16. cfthrow
    17. cftry
  10. フォームタグ
    1. cfapplet
    2. cfcalendar
    3. cffileupload
    4. cfform
    5. cfformgroup
    6. cfformitem
    7. cfgrid
    8. cfgridcolumn
    9. cfgridrow
    10. cfgridupdate
    11. cfinput
    12. cfpdf
    13. cfpdfform
    14. cfpdfformparam
    15. cfpdfparam
    16. cfpdfsubform
    17. cfselect
    18. cfslider
    19. cftextarea
    20. cftree
    21. cftreeitem
  11. インターネットプロトコルタグ
    1. cfajaximport
    2. cfajaxproxy
    3. cfftp
    4. cffeed
    5. cfimap
    6. cfhttp
    7. cfhttpparam
    8. cfldap
    9. cfmail
    10. cfmailparam
    11. cfmailpart
    12. cfpop
    13. cfsprydataset
  12. ページ処理タグ
    1. cfcache
    2. cfcontent
    3. cfflush
    4. cfheader
    5. cfhtmlhead
    6. cfinclude
    7. cfprocessingdirective
    8. cfsetting
    9. cfsilent
  13. セキュリティタグ
  14. 変数操作タグ
    1. cfcookie
    2. cfdump
    3. cfparam
    4. cfregistry
    5. cfsavecontent
    6. cfschedule
    7. cfset
    8. cfsetting
  15. その他のタグ
    1. cfimage
    2. cflog
    3. cfregistry
3. タグ a～b
4. タグ c
5. タグ f
6. タグ g～h
  1. cfgraph
  2. cfgraphdata
  3. cfgrid
  4. cfgridcolumn
  5. cfgridrow
  6. cfgridupdate
  7. cfheader
  8. cfhtmlhead
  9. cfhtmltopdf
  10. cfhtmltopdfitem
  11. cfhttp
  12. cfhttpparam
7. タグ i
  1. cfif
  2. cfimage
  3. cfimap
  4. cfimapfilter
  5. cfimpersonate
  6. cfimport
  7. cfinclude
  8. cfindex
  9. cfinput
  10. cfinsert
  11. cfinterface
  12. cfinvoke
  13. cfinvokeargument
8. タグ j～l
9. タグ m～o
10. タグ p～q
  1. cfparam
  2. cfpdf
  3. cfpdfform
  4. cfpdfformparam
  5. cfpdfparam
  6. cfpdfsubform
  7. cfpod
  8. cfpop
  9. cfpresentation
  10. cfpresentationslide
  11. cfpresenter
  12. cfprint
  13. cfprocessingdirective
  14. cfprocparam
  15. cfprocresult
  16. cfprogressbar
  17. cfproperty
  18. cfquery
  19. cfqueryparam
11. タグ r～s
  1. cfregistry
  2. cfreport
  3. cfreportparam
  4. cfrethrow
  5. cfreturn
  6. cfsavecontent
  7. cfschedule
  8. cfscript
  9. cfsearch
  10. cfselect
  11. cfservlet
  12. cfservletparam
  13. cfset
  14. cfsetting
  15. cfsharepoint
  16. cfsilent
  17. cfslider
  18. cfspreadsheet
  19. cfsprydataset
  20. cfstoredproc
  21. cfswitch
12. タグ t
  1. cftable
  2. cftextarea
  3. cftextinput
  4. cfthread
  5. cfthrow
  6. cftimer
  7. cftooltip
  8. cftrace
  9. cftransaction
  10. cftree
  11. cftreeitem
  12. cftry
13. タグ u～z
  1. cfupdate
  2. cfwddx
  3. cfwebsocket
  4. cfwindow
  5. cfxml
  6. cfzip
  7. cfzipparam
CFML リファレンス
クラウドサービス

説明

cfform タグ内に複数行のテキスト入力ボックスを配置し、表示仕様を制御します。さらにオプションで、HTML テキストの書式を制御するための設定可能なコントロールを含むリッチテキストエディタを表示します。

カテゴリ

フォームタグ

シンタックス

<cftextarea 
name=&quot;name&quot; 
basepath=&quot;path&quot; 
bind=&quot;bind expression&quot; 
bindAttribute=&quot;attribute name&quot; 
bindOnLoad=&quot;false|true&quot; 
disabled=&quot;true|false&quot; or no attribute value 
enabled=&quot;yes|no&quot; 
fontFormats=&quot;comma separated list&quot; 
fontNames=&quot;comma separated list&quot; 
fontSizes=&quot;comma separated list&quot; 
height=&quot;number of pixels&quot; 
html=&quot;no|yes&quot; 
label=&quot;text&quot; 
maxlength=&quot;number&quot; 
message=&quot;text&quot; 
onBindError = &quot;JavaScript function name&quot; 
onChange=&quot;JavaScript or ActionScript&quot; 
onClick=&quot;JavaScript or ActionScript&quot; 
onError=&quot;script name&quot; 
onKeyDown=&quot;JavaScript or ActionScript&quot; 
onKeyUp=&quot;JavaScript or ActionScript&quot; 
onMouseDown=&quot;JavaScript or ActionScript&quot; 
onMouseUp=&quot;JavaScript or ActionScript&quot; 
onValidate=&quot;script name&quot; 
pattern=&quot;regexp&quot; 
range=&quot;minimum value, maximum value&quot; 
required=&quot;yes|no&quot; 
richtext=&quot;no|yes&quot; 
secureUpload=&quot;true|false&quot; 
skin=&quot;default|silver|office2003|custom skin&quot; 
sourceForToolTip=&quot;URL&quot; 
style=&quot;style specification&quot; 
stylesXML=&quot;path&quot; 
templatesXML&quot;path&quot; 
toolbar=&quot;Default|Basic|custom toolbar&quot; 
toolbarOnFocus&quot;no|yes&quot; 
tooltip=&quot;tip text&quot; 
validate=&quot;data type&quot; 
validateAt= one or more of &quot;onBlur, onServer, onSubmit&quot; 
value=&quot;text&quot; 
visible=&quot;yes|no&quot; 
width=&quot;number of pixels&quot; 
wrap=&quot;off|hard|soft|virtual|physical&quot;> 

text 

</cftextarea>

一部の属性は、特定の表示形式のみに適用されます。詳細については、「属性」の表を参照してください。

注意：

このタグの属性は attributeCollection 属性で指定でき、その値は構造体になります。attributeCollection 属性で構造体の名前を指定し、タグの属性名を構造体のキーとして使用します。

履歴

ColdFusion 8:

HTML 形式フォームで bind 属性を使用できるようになりました（bindAttribute、bindOnLoad、onBindError 属性を含む）。
HTML 形式でツールヒントを使用できるようになりました（sourceForTooltip 属性など）。
HTML 形式でリッチテキストエディターを使用できるようになりました（richtext、basepath、fontFormats、fontNames、fontSizes、skin、stylesXML、templatesXML、toolbar、toolbarOnFocus 属性など）。height および width 属性のサポートが追加されました。ColdFusion MX 7：このタグが追加されました。

属性

次の表は、ColdFusion が直接使用する属性のリストです。HTML 形式では、このリストに記載されていない HTML textarea タグ属性もすべてサポートされ、ブラウザーに直接渡されます。

注意：

「すべて」または「XML」と記載されてない属性は、ColdFusion に同梱されているスキンでは処理されません。ただし、これらの属性は生成された XML に含まれます。

属性	必須／オプション、形式	デフォルト	説明
name	必須、すべて		cftextinput コントロールの名前。
basepath	オプション、HTML	cf_scripts/scripts/ajax /CKEditor	リッチテキストエディターが存在するディレクトリのパスです。エディターの設定ファイルは、このディレクトリのトップレベルにあります。richText 属性が true の場合にのみ意味があります。
bind	オプション、Flash、HTML		コントロールの属性をダイナミックに設定するバインド式です。詳細については、「使用方法」を参照してください。
bindAttribute	オプション、HTML	値	bind 属性を使用して値を設定する HTML タグ属性を指定します。ColdFusion 固有の属性ではなく、ブラウザーの HTML DOM ツリーに含まれる属性のみを指定できます。bind 属性がない場合は無視されます。
bindOnLoad	オプション、HTML	no	フォームを最初にロードするときに bind 属性の式を実行するかどうかを指定するブール値です。bind 属性がない場合は無視されます。
disabled	オプション、すべて	no	ユーザー入力を無効にし、コントロールを読み取り専用にします。入力を無効にするには、属性を省略して disabled を指定するか、disabled="yes"（または ColdFusion で使用する true などの真を表すブール値）を指定します。入力を有効にするには、属性を省略するか、disabled="no"（または ColdFusion で使用する false などの偽を表すブール値）を指定します。
enabled	オプション、Flash	yes	コントロールを有効にするかどうかを指定するブール値です。無効なコントロールはライトグレーで表示されます。disabled 属性の逆です。
fontFormats	オプション、HTML	すべての有効な形式	リッチテキストエディタの [形式] セレクタに表示されるフォント名のカンマ区切りリストです。形式を選択すると、入力または選択されたテキストに適用する HTML タグが決定されます。p、div、pre、address、h1、h2、h3、h4、h5、h6 の中から任意のタグを指定できます。
fontNames	オプション、HTML	すべての有効なフォント名	リッチテキストエディタの [フォント] セレクタに表示されるフォント名のカンマ区切りリストです。Arial、Comic Sans MS、Courier New、Tahoma、Times New Roman、Verdana の中から任意のフォントを指定できます。
FontSizes	オプション、HTML	「説明」を参照	リッチテキストエディタの [サイズ] セレクタに表示されるフォントサイズのカンマ区切りリストです。このリストのエントリは、「フォントサイズの値/説明テキスト」という形式で指定する必要があります。たとえば、フォントサイズ 1 を示すために "small font" というテキストを表示するには、"1/small font" と指定します。デフォルトでは、1/xx-small、2/x-small、3/small、4/medium、5/large、6/x-large、および 7/xx-large という値がセレクタに表示されます。
height	オプション、Flash、HTML		Flash フォームの場合は、コントロールの高さをピクセル単位で指定します。 HTML フォームの場合は、richtext="true" が指定されている場合にのみ効果を持ち、その場合はコントロール（コントロールバーやテキストボックスなど）の高さをピクセル単位で指定します。
html	オプション、Flash	no	テキスト領域に HTML が含まれるかどうかを指定するブール値です。
label	オプション、Flash および XML		フォーム内のコントロールの横に配置するラベルです。
maxLength	オプション、すべて		入力可能なテキストの最大長です。この属性は、 validate 属性で maxlength が指定されている場合にのみ効果を持ちます。
message	オプション、すべて		検証に失敗した場合に表示されるメッセージテキストです。
onBindError	オプション、HTML	「説明」を参照	バインド式の評価でエラーが発生した場合に実行する JavaScript 関数の名前です。この関数は 2 つの属性 (HTTP ステータスコードとメッセージ) を取る必要があります。発生したエラーが HTTP エラーでない場合、ステータスコードは -1 です。この属性を省略し、（ColdFusion.setGlobalErrorHandler 関数を使用して）グローバルエラーハンドラを指定すると、エラーメッセージが表示されます。それ以外の場合は、デフォルトのエラーポップアップが表示されます。
onChange	オプション、すべて		ユーザーのアクションに応じてコントロールに変化があったときに実行される JavaScript（HTML／XML の場合）または ActionScript（Flash の場合）です。
onClick	オプション、HTML および XML		ユーザーがコントロールをクリックしたときに実行される JavaScript です。
onError	オプション、HTML および XML		検証に失敗した場合に実行するカスタム JavaScript 関数です。
onKeyDown	オプション、すべて		ユーザーがコントロールでキーボードのキーを押したときに実行される JavaScript（HTML／XML の場合）または ActionScript（Flash の場合）です。
onKeyUp	オプション、すべて		ユーザーがコントロール内でキーボードのキーを放したときに実行される JavaScript（HTML／XML の場合）または ActionScript（Flash の場合）です。
onMouseDown	オプション、すべて		ユーザーがコントロール内でマウスボタンを放したときに実行される JavaScript（HTML／XML の場合）または ActionScript（Flash の場合）です。
onMouseUp	オプション、すべて		ユーザーがコントロール内でマウスボタンを押したときに実行される JavaScript（HTML／XML の場合）または ActionScript（Flash の場合）です。
onValidate	オプション、HTML および XML		ユーザー入力を検証するためのカスタム JavaScript です。JavaScript DOM フォームオブジェクト、入力オブジェクトおよび入力オブジェクト値が関数に渡されます。検証に成功すると true が返されます。検証に失敗すると false が返されます。この属性を指定した場合、ColdFusion は validate 属性を無視します。
pattern	{{validate = "正規表現"}} の場合必須、HTML および XML		入力を検証するための、JavaScript 正規表現のパターンです。先頭および末尾のスラッシュ記号は削除されます。この属性は、validate 属性で regex が指定されている場合にのみ効果を持ちます。例およびシンタックスについては、「cfform タグによるダイナミックフォームの作成」（『ColdFusion アプリケーションの開発』）を参照してください。
range	オプション、すべて		指定可能な数値の最大値と最小値です。この属性は、validate 属性に range が指定されている場合にのみ使用されます。単一の値を指定するか、単一の値の後にカンマを付けて指定した場合、その値は最小値として処理されます。最大値はありません。カンマの後に単一の値を指定した場合、その値は最大値として設定されます。最小値はありません。
required	オプション、すべて	no	yes：フィールドにはテキストが必要です。 no：フィールドは空白のままでもかまいません。
richText	オプション、HTML	no	このコントロールが、テキストの書式を制御するツールバーの付いたリッチテキストエディターであるかどうかを指定するブール値です。リッチテキストエディターの使用について詳しくは、『ColdFusion アプリケーションの開発』の「Ajax フォームのコントロールおよび機能の使用」の「リッチテキストエディターの使用」を参照してください。
skin	オプション、HTML	default	リッチテキストエディターで使用するスキンを指定します。デフォルトで有効な値は、default、silver および office2003 です。カスタムスキンを作成して、そのスキンをこの属性で指定することもできます。詳しくは、『ColdFusion アプリケーションの開発』の「Ajax フォームのコントロールおよび機能の使用」の「リッチテキストエディターの使用」を参照してください。
sourceForTooltip	オプション、HTML		ツールヒントとして表示するページの URL です。このページには内容と書式を制御するための CFML および HTML を含めることができ、ヒントにはイメージを含めることができます。この属性を指定すると、ヒントのロード中にアニメーションのアイコンと「ロード中...」というテキストが表示されます。
style	オプション、すべて		HTML または XML 形式フォームの場合、style 属性はブラウザーまたは XML に渡されます。 Flash 形式フォームでは、対応する Flash 要素について、Flex で使用するものと同じシンタックスおよびコンテンツを使用する CSS 形式のスタイル仕様でなければなりません。
stylesXML	オプション、HTML	/cfusion/wwwroot/ cf_scripts/scripts/ajax /CKEditor / ckstyles .xml	リッチテキストエディターの「スタイル」セレクタに表示されるスタイルを定義したファイルのパスです。ckeditor.html ファイルが存在するディレクトリ（通常は <ColdFusion の Web ルート>/cf_scripts/ajax/CKeditor/editor）からの相対パスです。/myApps/RTEeditor.mystyles.xml のように Web ルートから始まる絶対パスを指定できます。スタイルの設定について詳しくは、『ColdFusion アプリケーションの開発』の「Ajax フォームのコントロールおよび機能の使用」の「リッチテキストエディターの使用」を参照してください。
templatesXML	オプション、HTML	/cfusion/wwwroot/ cf_scripts/scripts/ajax /CKEditor / cktemplates .xml	リッチテキストエディターの「テンプレート」アイコンをクリックしたときに表示されるテンプレートを定義するファイルのパスです。パスについて詳しくは、stylesXML を参照してください。テンプレートの設定については、『ColdFusion アプリケーションの開発』の「リッチテキストエディターの使用」を参照してください。
toolbar	オプション、HTML	Default	リッチテキストエディターのツールバーを指定します。デフォルトで、この属性の有効な値は次のとおりです。 Default（すべてのコントロールのセット）および Basic（最低限の設定）。設定を追加できます。詳しくは、『ColdFusion アプリケーションの開発』の「Ajax フォームのコントロールおよび機能の使用」の「リッチテキストエディターの使用」を参照してください。メモ：この属性では大文字と小文字が区別されます。
toolbarOnFocus	オプション、HTML	no	リッチテキストエディターがフォーカスを持っているときにのみリッチテキストエディターツールバーのコントロールを展開して表示するかどうかを指定するブール値です。
tooltip	オプション、Flash、HTML		マウスポインタをコントロールの上に置いたときに表示されるテキストです。HTML 書式設定も使用できます。 sourceForTooltip 属性が指定されている場合は無視されます。
validate	オプション、すべて		実行する検証のタイプです。使用可能な検証のタイプとアルゴリズムは、形式によって異なります。詳しくは、 cfinput タグリファレンスの「使用方法」の節を参照してください。
validateAt	オプション、HTML および XML	onSubmit	検証の実行方法です。次の中から 1 つ以上を指定します。 onSubmit onServer onBlur Flash 形式フォームの場合、onSubmit と onBlur は同一です。検証はいずれもフォームの送信時に実行されます。複数の値を指定する場合は、カンマ区切りのリストを使用します。詳しくは、 cfinput タグリファレンスの「使用方法」の節を参照してください。
値	オプション、すべて		テキストコントロールに表示する初期値です。初期値は属性またはタグ本文を使って指定できますが、これら両方の場所で指定することはできません。属性として値を指定する場合は、 cftextarea 開始タグの直後に（間にスペースや改行をはさまずに） cftextarea 終了タグを置くか、 cftextarea 開始タグの末尾に終了のスラッシュを置きます。例：<cftextarea name="description" value="Enter a description."/>
visible	オプション、Flash	yes	コントロールを表示するかどうかを指定するブール値です。表示されないコントロールが使用するスペースは空白です。
width	オプション、Flash、HTML		コントロールの幅をピクセル単位で指定します。 HTML フォームの場合は、richtext="true" が指定されている場合にのみ効果を持ちます。
wrap	OptionalAll		hard: 長い行を折り返し、復帰文字をサーバーに送信します。 off: 長い行を折り返しません。 physical: 長い行を折り返し、すべての折り返し点でテキストをサーバーに伝送します。 soft: 長い行を折り返しますが、復帰文字をサーバーに送信しません。 virtual: 長い行を折り返しますが、復帰文字をサーバーに送信しません。

使用方法

HTML 形式でこのタグを正しく動作させるには、JavaScript 対応のブラウザを使用する必要があります。
テキストをタグ本文に配置すると、コントロールでは cftextarea の開始タグと終了タグの間にあるすべてのテキスト文字が表示されます。したがって、改行や空白を使ってソーステキストの形式を設定した場合、それらはコントロールに表示されます。cfform の preserveData 属性が「yes」で、フォームが同じページに送信される場合は、value 属性の値ではなく cftextinput コントロールの送信された値が使用されます。

Validation

validation 属性、および ColdFusion がサポートする検証のタイプについて詳しくは、cfinput タグリファレンスの「使用方法」を参照してください。ColdFusion の検証方法について詳しくは、『ColdFusion アプリケーションの開発』の「データの検証」を参照してください。

Flash フォームデータのバインディング

bind 属性を使用すると、フォームフィールドに他のフォームフィールドの内容を挿入できます。cftextarea の bind 属性で他の Flash フォームフィールドのテキストを指定するには、{sourceTagName.text} の形式を使用します。例えば、次の例では、ユーザーが userName フィールドに入力したテキスト値が、コメントテキストボックスの挨拶で使用されます。ユーザーはこのメッセージを変更できます。

<cfformitem type=&quot;text&quot;>
Enter your name here</cfformitem>
<cftextarea name=&quot;userName&quot; height=&quot;20&quot; Width=&quot;500&quot;/>
<cftextarea name=&quot;comment&quot; height=&quot;100&quot; Width=&quot;500&quot;
bind=&quot;Hello {userName.text}! ここにコメントを入力します。&quot;/>
</cfform>

HTML フォームデータのバインディング

bind 属性を使用すると、別のフォームコントロールの値を使用したり、CFC 関数または JavaScript 関数を呼び出すことによって、cftextarea の属性をダイナミックに設定することができます。デフォルトでは、コントロールの value 属性が設定されますが、bindAttribute 属性を使用することで、他の属性を設定することもできます。バインディングについて詳しくは、『ColdFusion アプリケーションの開発』の「フォームフィールドへのデータのバインディング」を参照してください。

例

この例には 2 つの cftextarea コントロールがあります。フォームが送信されると、1 番目のコントロールから 2 番目のコントロールにテキストがコピーされます。onBlur maxlength 検証により、100 文字を超えて入力しないように制限されます。cftextarea 開始タグを閉じる > 文字、タグ本文内のテキストおよび cftextarea 終了タグは、目的のテキストのみが表示されるように 1 行に収められますが、この例では、形式設定を行うために行が分割されています。

<h3>cftextarea の例</h3> 
<cfparam name=&quot;text2&quot; default=&quot;&quot;> 
<cfif isdefined(&quot;form.textarea1&quot;) AND (form.textarea1 NEQ &quot;&quot;)> 
<cfset text2=form.textarea1> 
</cfif> 

<cfform name=&quot;form1&quot;> 
<cftextarea name=&quot;textarea1&quot; wrap=&quot;virtual&quot; rows=&quot;5&quot; cols=&quot;25&quot; 
validate=&quot;maxlength&quot; validateAt=&quot;onBlur&quot; maxlength=&quot;100&quot; 
>このテキストを置換します。最大の長さは 100 文字で、このテキストの長さは現在 99 文字です。 
</cftextarea> 
<cftextarea name=&quot;textarea2&quot; wrap=&quot;virtual&quot; rows=&quot;5&quot; cols=&quot;50&quot; value=&quot;#text2#&quot; /><br><br> 
<input type=&quot;submit&quot; value=&quot;submit field&quot;><br> 
</cfform>

ヘルプをすばやく簡単に入手

新規ユーザーの場合

cftextarea

説明

カテゴリ

シンタックス

関連項目

履歴

属性

使用方法

Validation

Flash フォームデータのバインディング

HTML フォームデータのバインディング

例

ヘルプをすばやく簡単に入手

このページを共有

アドビサポートコミュニティ

サポート