ボタンテキストボックス
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
ButtonTextBoxコントロールはテキストボックスとボタンの組み合わせです。ユーザーはテキストボックス部分に文字列を入力し、ボタン部分をクリックできます。例えば、ButtonTextBoxコントロールを使って検索ボックスを作成できます。
ウォーターマークやButtonTextBoxコントロールで表示されるデフォルトのテキストを設定することができます。ウォーターマークとは、ButtonTextBoxコントロールが空のときに表示する編集不可のテキストのことです。ユーザーが入力できる内容を理解するのに役立つテキストを入力できます。ウォーターマークはユーザーがキャラクターを入力するとすぐに消え、以前入力したすべての文字を削除した場合に再び現れます。
デフォルトテキストとは、コントロールに表示されるテキストですが、ユーザーがこのテキストを変更・削除することができます。ウォーターマークとデフォルトテキストの両方を指定すると、ButtonTextBoxコントロールは最初デフォルトテキストを表示しますが、ユーザーがこれらすべてを削除するとウォーターマークが表示されます。
Typeプロパティをpasswordに設定すると、ButtonTextBoxコントロールはユーザーの入力を覆い隠します。ほとんどのブラウザはユーザーが入力した文字を*(アステリックス)文字に置き換えます。
ボタン部分の見た目を示すためにButtonTypeプロパティを使用します。これはあくまで参考に過ぎません。SPEAKが適用するスタイリングによって実際の見た目が決まります。デフォルト、プライマリー、逆を選択できます。
ユーザーがボタンをクリックしたときに何が起こるかを指定するには、Clickプロパティを使っています。
性質
名称
概要
デフォルト
外見
ButtonImageUrl
アイコンのSitecoreパスを設定します(例えば、/sitecore/content/homeアイテムのアイコンはNetwork/16x16/home.png)。
ボタンテキスト
ボタン部分で表示したいテキストを設定してください。静的テキストを入力するか、PageCodeでテキストを設定するか、このプロパティを別のコントロールのプロパティに割り当てることもできます。
ボタンタイプ
デフォルト、プライマリ、または逆を選択します。
デフォルト
本文
コントロールに表示されるデフォルトのテキストを指定します。ユーザーはこのテキストを編集・削除できます。
種類
textかpasswordのどちらかを指定します。
本文
ウォーターマーク
ユーザーからの入力がない場合にコントロールに表示されるテキストを指定します。テキストは編集できず、ユーザー入力があれば表示されません。
WidthPolicy
SPEAKがコントロールの幅をどのように解釈するかを指定します。以下を指定できます:
- デフォルト。
- BlockLevel。コントロールはコンテナを水平に満たします。
デフォルト。
行動
IsReadonly(読み書き)
もし真の場合、ユーザーはテキストを入力できません。
間違いです
必要です
もしTrueの場合、 ButtonTextBox コントロールは「必須」としてマークされます。論理的な効果はありませんが、ブラウザによってはテキストボックスのスタイルが異なります。
間違いです
最大長さ
ButtonTextBoxコントロールでユーザーが入力できる最大文字数を指定します。この数に達した時点で、コントロールはこれ以上の入力を受け付けません。
イベント
カチッ
ユーザーがボタンをクリックしたときにSPEAKが実行するJavaScriptを指定します。
構成
ButtonTextBoxコントロールの設定項目は、ButtonTextBoxパラメータテンプレートに基づいてアイテムを作成することで作成できます。
設定項目には以下の特定のフィールドがあります:
- 本文
- 種類
- ウォーターマーク
- ButtonImageUrl
- ボタンテキスト
- ボタンタイプ
以下の場を継承します:
- カチッ
- IsEnabled
- IsVisible(見えるもの)
- アクセスキー
- ツールチップ
- 行動
- ID