チェックボックス検査 Widget のカスタマイズ
"SpryValidationCheckbox.css" ファイルには、チェックボックス検査 Widget のデフォルトのスタイル設定が用意されています。 該当する CSS ルールを変更することによって Widget をカスタマイズできます。 "SpryValidationCheckbox.css" ファイルの CSS ルールでは、Widget の HTML コードの関連するエレメントと同じクラス名が使用されるため、Widget とそのエラー状態に対応する CSS ルールを簡単に把握できます。
"SpryValidationCheckbox.css" ファイルは、カスタマイズを開始する前に Web サイトに配置しておく必要があります。 詳細については、ファイルの準備を参照してください。
チェックボックス検査 Widget のスタイル設定 (一般的な方法)
- "SpryValidationCheckbox.css" ファイルを開きます。
- Widget の変更する部分の CSS ルールを見つけます。 たとえば、チェックボックス Widget の必須状態の背景色を変更するには、"SpryValidationCheckbox.css" ファイルの .checkboxRequiredState ルールを編集します。
- CSS ルールを変更してファイルを保存します。
"SpryValidationCheckbox.css" ファイルには、特定のルールに対するコードと目的を説明するさまざまなコメントが含まれます。 詳細については、ファイル内のコメントを参照してください。
チェックボックス検査 Widget のエラーメッセージのテキストのスタイル設定
チェックボックス検査 Widget のエラーメッセージは、デフォルトでは、1 ピクセルの実線のボーダーで囲まれた赤いテキストで表示されます。
チェックボックス検査 Widget のエラーメッセージのテキストスタイルを変更するには、次の表を使用して適切な CSS ルールを見つけ、デフォルトのプロパティを変更するか、または独自のテキストスタイルプロパティおよび値を追加します。
|
スタイルを設定するテキスト |
関連する CSS ルール |
変更する関連プロパティ |
|---|---|---|
|
エラーメッセージのテキスト |
.checkboxRequiredState .checkboxRequiredMsg、.checkboxMinSelectionsState .checkboxMinSelectionsMsg、.checkboxMaxSelectionsState .checkboxMaxSelectionsMsg |
color: #CC3333; border: 1px solid #CC3333; |
状態関連のクラス名のカスタマイズ
CSS 内のルールと HTML コード内のクラス名を変更することによって、エラーメッセージ関連のクラス名を独自のクラス名に置き換えることはできますが、ビヘイビアは Spry フレームワークの一部としてハードコーディングされているため、状態関連のクラス名を変更または置換することはできません。 ただし、Widget コンストラクタの 3 番目のパラメータで新しい値を指定することによって、デフォルトの状態関連のクラス名を独自の名前で上書きすることができます。
Widget の状態関連のクラス名を変更するには、次のように、上書きを行うオプションのいずれかを Widget コンストラクタの 3 番目のパラメータに追加し、カスタムクラス名を指定します。
<script type="text/javascript">
var sprycheckbox1 = new Spry.Widget.ValidationCheckbox("sprycheckbox1", {requiredClass:"required"});
</script>
次の表に、組み込みの状態関連のクラス名を上書きするために使用できるオプションのリストを示します。
|
オプション |
説明 |
|---|---|
|
requiredClass |
"checkboxRequiredState" 組み込み値を上書きします。 |
|
minSelectionsClass |
"checkboxMinSelectionsState" 組み込み値を上書きします。 |
|
maxSelectionsClass |
"checkboxMaxSelectionsState" 組み込み値を上書きします。 |