ボタンテキストボックス
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
ButtonTextBoxコントロールは、テキスト ボックスとボタンの組み合わせです。ユーザーはテキストボックス部分にテキスト文字列を入力し、ボタン部分をクリックできます。ButtonTextBoxコントロールを使用して、たとえば検索ボックスを作成します。
ウォーターマークまたはButtonTextBoxコントロールに表示されるデフォルトのテキストを設定できます。ウォーターマークは、ButtonTextBoxコントロールが空のときに表示される編集不可能なテキストです。ユーザーが入力できる内容を理解するのに役立つテキストを入力できます。ウォーターマークは、ユーザーが文字を入力するとすぐに消え、以前に入力した文字をすべて削除すると再び表示されます。
既定のテキストはコントロールに表示されるテキストですが、ユーザーはこのテキストを変更および削除できます。ウォーターマークと既定のテキストの両方を指定すると、ButtonTextBoxコントロールには最初は既定のテキストが表示されますが、ユーザーがこのテキストをすべて削除すると、ウォーターマークが表示されます。
Typeプロパティをpasswordに設定すると、ButtonTextBoxコントロールはユーザー入力をマスクします。ほとんどのブラウザーでは、ユーザーが入力した文字が * (アスタリスク) 文字に置き換えられます。
ButtonTypeプロパティを使用して、ボタン パーツの外観を示します。これは単なる目安であり、SPEAKが適用するスタイリングによって、実際の外観が決まります。デフォルト、プライマリ、および インバース を選択できます。
Clickプロパティを使用して、ユーザーがボタンをクリックしたときの動作を指定します。
プロパティ
プロパティ
|
Name |
Description |
Default |
|---|---|---|
|
Appearance | ||
|
ボタン画像URL |
アイコンのSitecoreパスを設定します (たとえば、/sitecore/content/homeアイテムに表示されるアイコンのNetwork/16x16/home.png)。 | |
|
ボタンテキスト |
ボタン部分に表示させたいテキストを設定します。静的テキストを入力するか、PageCodeからテキストを設定するか、このプロパティを別のコントロールのプロパティにバインドできます。 | |
|
ボタンタイプ |
デフォルト、プライマリ、または インバース を選択します。 |
デフォルト |
|
テキスト |
コントロールに表示される既定のテキストを指定します。ユーザーはこのテキストを編集および削除できます。 | |
|
種類 |
textまたはpasswordを指定します。 |
テキスト |
|
透かし |
ユーザーからの入力がない場合にコントロールに表示されるテキストを指定します。テキストは編集できず、ユーザー入力がある場合には表示されません。 | |
|
幅ポリシー |
SPEAKがコントロールの幅を解釈する方法を指定します。以下を指定できます。
|
デフォルト。 |
|
Behavior | ||
|
読み取り専用 |
Trueの場合、ユーザーはテキストを入力できません。 |
偽 |
|
必須です |
Trueの場合、ButtonTextBoxコントロールは "必須" としてマークされます。論理的な効果はありませんが、一部のブラウザーではテキスト ボックスのスタイルが異なります。 |
偽 |
|
最大長 |
ユーザーがButtonTextBoxコントロールに入力できる最大文字数を指定します。コントロールは、文字数がこの数に達すると、それ以上の入力を受け入れません。 | |
|
Events | ||
|
クリック |
ユーザーがボタンをクリックしたときにSPEAKが実行されるJavaScriptを指定します。 | |
構成
構成
ButtonTextBoxコントロールの構成項目を作成するには、ButtonTextBox Parametersテンプレートに基づいて項目を作成します。
構成アイテムには、次の特定のフィールドがあります。
-
テキスト
-
種類
-
透かし
-
ボタン画像URL
-
ボタンテキスト
-
ボタンタイプ
次のフィールドを継承します。
-
クリック
-
イズ・イネーブルド
-
目に見える
-
アクセスキー
-
ツールチップ
-
動作
-
身分証明書