apex:inputTextarea
テキストエリア入力要素です。このコンポーネントを使用して、値にテキストエリアが必要な、Salesforce オブジェクトの項目に対応しないコントローラメソッドのユーザ入力を取得します。
このコンポーネントでは、「html-」プレフィックスを使用した HTML パススルー属性がサポートされています。パススルー属性は、生成された <textarea> タグに適用されます。
例
1<!-- For this example to render properly, you must associate the Visualforce page
2with a valid contract record in the URL.
3For example, if 001D000000IRt53 is the contract ID, the resulting URL should be:
4https://Salesforce_instance/apex/myPage?id=001D000000IRt53
5See the Visualforce Developer's Guide Quick Start Tutorial for more information. -->
6
7<apex:page standardController="Contract">
8 <apex:form id="changeDescription">
9 <apex:pageBlock>
10 <p>Current description: {!contract.description}</p>
11 <p>Change description to:</p>
12 <apex:inputTextarea id="newDesc" value="{!contract.description}"/><p/>
13 <apex:commandButton value="Save" action="{!save}"/>
14 </apex:pageBlock>
15 </apex:form>
16</apex:page>上述の例では次の HTML を表示します。
1<!-- changes the value of {!contract.description} on save -->
2
3<form id="j_id0:changeDescription" name="j_id0:changeDescription" method="post" action="/apex/sandbox" enctype="application/x-www-form-urlencoded">
4 <input type="hidden" name="j_id0:changeDescription" value="j_id0:changeDescription" />
5 <!-- opening div tags -->
6 <p>Current description: To facilitate better deals</p>
7 <p>Change description to:</p>
8 <textarea id="j_id0:changeDescription:j_id1:newDesc" name="j_id0:changeDescription:j_id1:newDesc"/>
9 <input type="submit" name="j_id0:changeDescription:j_id1:j_id4" value="Save" class="btn" />
10 <!-- closing div tags -->
11</form>属性
| 属性名 | 属性型 | 説明 | 必須かどうか | API バージョン | 通用範囲 |
|---|---|---|---|---|---|
| accesskey | String | テキストエリアにフォーカスを置くキーボードアクセスキー。テキストエリアにフォーカスが置かれている場合は、値を入力できます。 | 10.0 | グローバル | |
| cols | Integer | 項目の幅。1 行に一度に表示可能な文字数で表されます。 | 10.0 | グローバル | |
| dir | String | 生成された HTML コンポーネントの読み取り方向。可能な値には「RTL」 (右から左) または「LTR」 (左から右) などがあります。 | 10.0 | グローバル | |
| disabled | Boolean | このテキストエリアを無効な状態で表示するかどうかを指定する boolean 値。true に設定されている場合、テキストエリアは無効な状態で表示されます。指定されていない場合、この値はデフォルトの false に設定されます。 | 10.0 | グローバル | |
| id | String | ページの他のコンポーネントがチェックボックスコンポーネントを参照できるようにする識別子。 | 10.0 | グローバル | |
| label | String | コントロールの横に表示ラベルを表示し、エラーメッセージ内のコントロールを参照できるようにするテキスト値。 | 23.0 | ||
| lang | String | 「en」または「en-US」など、生成された HTML 出力の基本言語。この属性についての詳細は、W3C 仕様を参照してください。 | 10.0 | グローバル | |
| onblur | String | onblur イベントが発生した場合 (フォーカスがテキストエリアから離れた場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onchange | String | onchange イベントが発生した場合 (ユーザがテキストエリアのコンテンツを変更した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onclick | String | onclick イベントが発生した場合 (ユーザがテキストエリアをクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| ondblclick | String | ondblclick イベントが発生した場合 (ユーザがテキストエリアをダブルクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onfocus | String | onfocus イベントが発生した場合 (フォーカスがテキストエリアにある場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeydown | String | onkeydown イベントが発生した場合 (ユーザがキーボードのキーを押した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeypress | String | onkeypress イベントが発生した場合 (ユーザがキーボードのキーを押したか、押したままにした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeyup | String | onkeyup イベントが発生した場合 (ユーザがキーボードのキーを放した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmousedown | String | onmousedown イベントが発生した場合 (ユーザがマウスボタンをクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmousemove | String | onmousemove イベントが発生した場合 (ユーザがマウスポインタを移動した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseout | String | onmouseout イベントが発生した場合 (ユーザがテキストエリアからマウスポインタを移動した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseover | String | onmouseover イベントが発生した場合 (ユーザがマウスポインタをテキストエリアに重ねた場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseup | String | onmouseup イベントが発生した場合 (ユーザがマウスボタンを放した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onselect | String | onselect イベントが発生した場合 (ユーザがテキストエリアのテキストを選択した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| readonly | Boolean | このテキストエリアを参照のみとして表示するかどうかを指定する boolean 値。true に設定されている場合、テキストエリアの値を変更することはできません。選択されていない場合、この値はデフォルトの false に設定されます。 | 10.0 | グローバル | |
| rendered | Boolean | コンポーネントをページに表示するかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの true に設定されます。 | 10.0 | グローバル | |
| required | Boolean | このテキストエリアが必須項目であるかどうかを指定する boolean 値。true に設定されている場合、このテキストエリアの値を指定する必要があります。選択されていない場合、この値はデフォルトの false に設定されます。 | 10.0 | グローバル | |
| richText | Boolean | このテキストエリアをリッチテキストまたはプレーンテキストのどちらで保存するかを指定する boolean 値。true に設定されている場合、この値はリッチテキストとして保存されます。選択されていない場合、この値はデフォルトの false に設定されます。 | 10.0 | グローバル | |
| rows | Integer | テキストエリアの高さ。一度に表示可能な行数で表されます。 | 10.0 | グローバル | |
| style | String | テキストエリアコンポーネントの表示に使用されるスタイル。主に、インライン CSS スタイルを追加するために使用されます。 | 10.0 | グローバル | |
| styleClass | String | テキストエリアコンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| tabindex | String | ユーザが Tab キーを繰り返し押したときに、他のページコンポーネントと比較して、このテキストエリアが選択される順序。この値は、ユーザが Tab キーを押したときに選択される最初のコンポーネントを 0 として、0 ~ 32767 の整数である必要があります。 | 10.0 | グローバル | |
| title | String | ユーザがコンポーネントにマウスポインタを重ねたときにツールチップとして表示されるテキスト。 | 10.0 | グローバル | |
| value | Object | このテキストエリアに関連付けられているコントローラクラス変数を参照する差し込み項目。たとえば、コントローラクラスの関連付けられている変数の名前が myLongDescription である場合、この変数を参照するには value="{!myLongDescription}" を使用します。 | 10.0 | グローバル |