Web Development

CSS

BootstrapのCSS読み込んだ後、bootstrapFormValidation-x.x.x.cssを読み込んでください。

<link rel="stylesheet" type="text/css" href="//maxcdn.bootstrapcdn.com/bootstrap/2.3.1/css/bootstrap-combined.min.css">
<link rel="stylesheet" type="text/css" href="bootstrapFormValidationV2-x.x.x.css">

JavaScript

jQueryとBootstrapを読み込んだ後、bootstrapFormValidation-x.x.x.min.jsを読み込んでください。

<script type="text/javascript" charset="UTF-8" src="//ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js"></script>
<script type="text/javascript" charset="UTF-8" src="//maxcdn.bootstrapcdn.com/bootstrap/2.3.1/js/bootstrap.min.js"></script>
<script type="text/javascript" charset="UTF-8" src="bootstrapFormValidationV2-x.x.x.min.js"></script>

その後、ページがロードされたらフォームの事前準備をするために、対象のフォームに対しbootstrapFormValidation()を実行します。

<script type="text/javascript" charset="UTF-8">
$(document).ready(function() {
	$('#sampleForm').bootstrapFormValidation();
});
</script>

オプション指定

checkRealtime

デフォルト：'true' | 'false'
'true'の場合、対象エレメントからフォーカスが外れた際に、随時入力をチェックし警告メッセージを表示します。

alertMsgClass

デフォルト：'formAlert' | 任意の文字列
警告メッセージ全部に共通して付与されるクラス名。見た目デザイン変更などに使えます。任意のクラス名に変更可能です。但し、他の関係ないエレメントと共有すると弊害が出る可能性があります。
※スペース区切りで複数クラス名を指定することはできません。

addIcon

デフォルト：'true' | 'false'
'true'の場合、警告メッセージにアイコンを付けることができます。アイコンの指定はwarningIconで指定可能です。

warningIcon

デフォルト：'icon-warning-sign' | Bootstrapの任意のアイコンクラス名
警告メッセージにアイコンを指定することが可能です。addIconが'false'の場合は無視されます。
※ Bootstrap のページでアイコンクラス名の一覧が参照可能です。
アイコンの色を変更するためのクラスicon-white等は、半角スペースで区切って「'icon-exclamation-sign icon-white'」と指定することが可能です。

requiredMessage

デフォルト：'必須項目' | 任意の文字列
入力必須項目(valCheck="required")での警告メッセージ文を変更可能です。入力必須項目に何も入力しなかった場合に表示されます。

invalidMessage

デフォルト：'不正形式' | 任意の文字列
入力形式チェック項目(valCheck="zip|tel|email|url|passwd"とvalCheck="groupcheck")での警告メッセージ文を変更可能です。特定の項目の入力で形式がおかしな場合に表示されます。

inputTooShort

デフォルト：'入力不足' | 任意の文字列
入力数下限チェック項目(valCheck="passwd|groupcheck")での警告メッセージ文を変更可能です。パスワード文字数やチェック選択数が規定に足りない場合に表示されます。

inputTooLong

デフォルト：'入力超過' | 任意の文字列
入力数上限チェック項目(valCheck="passwd|groupcheck")での警告メッセージ文を変更可能です。パスワード文字数やチェック選択数が規定を超えた場合に表示されます。

$('#sampleForm').bootstrapFormValidation({
	'checkRealtime'   : 'false',
	'alertMsgClass'   : 'formAlert',
	'addIcon'         : 'true',
	'warningIcon'     : 'icon-exclamation-sign icon-white',
	'requiredMessage' : '入力必須の項目です',
	'invalidMessage'  : '電話番号の入力が間違っています',
	'inputTooShort'   : 'パスワードの文字数が足りません',
	'inputTooLong'    : 'パスワードの文字数が多すぎです'
});

初期処理
↓　　

対象フォーム.bootstrapFormValidation();が実行されたタイミングで、各種エラーメッセージや、チェック処理が対象フォームに付与されます。

対象項目入力後
↓　　

チェック対象の項目がフォーカスを失った時点で、その項目に対する単独のチェックやサニタイズ等の処理を実行します。
チェック結果が即時エラーメッセージとして表示されます。

サブミット時
↓　　

valCheck="submit"を持ったボタンを押した場合、その対象フォーム内の項目に対し上から順に、チェックやサニタイズ等の処理を実行します。
各項目毎にチェック結果がエラーメッセージとして表示されます。

サブミット処理
(全チェック後の正常処理)

Javascriptの場合： (valCheck="submit"を持ったボタンにonclick="XXX"がある場合)
全チェックが完了後、エラーが無い場合、続いてonclick="XXX"処理を実行します。

※ HTML上に書かれたonclick="XXX"属性は、HTML上からは消えます。(処理は実行されます。)

CGIの場合： (対象フォームにaction="XXX"がある場合)
全チェックが完了後、エラーが無い場合、続いてaction="XXX"処理を実行します。

JavascriptとCGIの両方の設定がある場合：
全チェックが完了後、エラーが無い場合、続いてonclick="XXX"処理を実行します。

※ 本スクリプト内ではformをsubmitしませんので、XXX処理側でsubmitしてください。

入力必須項目

対象のエレメントにvalCheck="required"を付加してください。入力が無い場合に警告メッセージを表示します。
valCheck="required"は、下記他のオプションと併用ができます。例えば、valCheck="required text"valCheck="required passwd_4-10"など。

テキスト項目

対象のエレメントにvalCheck="text"を付加してください。
名前や住所などテキスト項目に対して、全角英数文字を半角に、カタカナの後のハイフンは「ー(長音文字)」にそれ以外は「-(半角)」に置き換えます。

// 全角英数文字を半角に置き換える
ＡＢｃ１２３                                         -->   ABc123
あＡいBうエ１尾                                      -->   あAいBうエ1尾

// カタカナの後のハイフンは「ー(長音文字)」にそれ以外は「-(半角)」に置き換えられる
カレーラ-－ー―‐－メン                              -->   カレーラーメン
新宿区新宿１－－２－３ラ-ーメンビルＡー３０３号室    -->    新宿区新宿1-2-3ラーメンビルA-303号室

// 文字列の先頭/末尾のスペース(半角/全角両方)は削除、連続したスペース(半角/全角両方)は「スペース(全角)」1つに置き換えられる
「　ＡＢＣ  123　 あいう」                           -->    「ABC　123　あいう」

数値項目

対象のエレメントにvalCheck="number"を付加してください。
数量や価格などの数値項目に対して、全角英数文字を半角に、数字以外が含まれていた場合は、入力データを消去します。

// 全角数文字を半角に置き換える
１２３       -->  123
1２3４5６    -->  123456

// 数値以外はデータ消去する
1-A.3        -->  データ消去(空欄にする)          // 入力必須項目の場合は、警告メッセージ表示

電話番号項目

対象のエレメントにvalCheck="tel"を付加してください。
すべて半角に変換し、携帯電話や固定電話など番号毎に「-(半角)」で区切りを入れます。桁数が合わない場合や数字とハイフン以外の文字が入っている場合に不正形式の警告メッセージを表示します。

// 全角数文字を半角に置き換える
// ハイフン類は全て「-(半角)」に置き換えられる
０１２０－ー１２３-４５６      -->   0120-123-456
０１２３－ＡＢＣ－ＡＢＣ       -->   0123-ABC-ABC    // 全て半角に変換されるが、エラー警告
03.1234+5６７８                -->   03.1234+5678    // 全て半角に変換されるが、エラー警告

// 050|070|080|090で始まる11桁は「3桁-4桁-4桁」に置き換えられる
// IP電話、携帯電話、PHS電話
05０１ー2３45-6７8             -->  050-1234-5678
040-1234-5678                  -->                  // 正しいフォーマットだが、番号が存在しないためエラー警告

// 0120|0800で始まる10桁は「4桁-3桁-3桁」に置き換えられる
// フリーダイアル
01-2034-5678                   -->  0120-345-678
08-00-123456                   -->  0800-123-456

// 03|06、0420|0429、04700|04709、0471で始まる10桁は「2桁-4桁-4桁」に置き換えられる
// 市外局番2ケタ+市内局番4桁+加入者番号4桁
031-2-345678                   -->  03-1234-5678    // 間違った区切りを正しく変換
0471234567                     -->  04-7123-4567    // 千葉、埼玉の一部で採用されいている「2桁-4桁-4桁」形式
0472234567                     -->  047-223-4567    // 上記に該当しないので「3桁-3桁-4桁」に変換

// 上記以外で入力時に「-(ハイフン)」等で区切られていない10桁の番号、区切りがおかしい番号は「3桁-3桁-4桁」に置き換えられる
//「4桁-2桁-4桁」の変換には対応しない
05-1234-5678                   -->  051-234-5678
0----123456789                 -->  012-345-6789
123ー4567890                   -->  123-4567890     // 0から始まらない番号は全てエラー警告

// 緊急番号(110/119)、3桁番号サービス(117/171/177)、その他コレクトコール等には対応しない

郵便番号項目

対象のエレメントにvalCheck="zip"を付加してください。
すべて半角に変換し、3桁 + 「-(半角)」 + 4桁 で区切りを入れます。桁数が合わない場合や数字とハイフン以外の文字が入っている場合に不正形式の警告メッセージを表示します。

メールアドレス項目

対象のエレメントにvalCheck="email"を付加してください。
メールアドレスの規格に基づき、アドレスが正しくない場合に警告メッセージを表示します。

URLアドレス項目

対象のエレメントにvalCheck="url"を付加してください。
インターネットアドレスの規格に基づき、アドレスが正しくない場合に警告メッセージを表示します。静的なhtmlアドレスだけでなく、「/(スラッシュ)」区切り、ページ内リンクハッシュ、phpやcgiの付加パラメータにも対応しています。

パスワード項目

対象のエレメントにvalCheck="passwd"を付加してください。
パスワードの強度(長さ)を指定したい場合は、passwdの後ろに「_(アンダーバー)」と数値を指定します。
例えば、6文字以上(上限なし)の場合valCheck="passwd_6-"、10文字以上20文字以下の場合valCheck="passwd_10-20"となります。

// 4文字以上10文字までのパスワードを許容、パスワード入力自体は非必須のためパスワード入力時のみ文字数チェック
<input type="password" name="passwd1" valCheck="passwd_4-10">

// 10文字までのパスワードを許容、パスワード入力自体は非必須のためパスワード入力時のみ文字数チェック
<input type="password" name="passwd2" valCheck="passwd_-10">

// 4文字以上10文字までのパスワードを許容、パスワード入力自体必須
<input type="password" name="passwd3" valCheck="required passwd_4-10">

// パスワード入力自体必須のため最低1文字以上の入力が必須 (実質 valCheck="required" と同じ動作)
<input type="password" name="passwd4" valCheck="required passwd">

セレクト項目

対象のエレメントにvalCheck="select"を付加してください。
プレースホルダの代わりに記載した<option>選択してください</option>などが動作に影響しないようにします。

ラジオボタン
チェックボックス項目

対象のエレメントにvalCheck="check"を付加してください。
ラジオボタンまたは、チェックボックスがチェックされていない場合に警告メッセージを表示します。

選択数指定可能
チェックボックス項目

対象のエレメントにvalCheck="groupcheck"を付加してください。
同名のチェックボックスの中で一つもチェックされていない場合に警告メッセージを表示します。
チェックの数を指定したい場合は、groupcheckの後ろに「_(アンダーバー)」と数値を指定します。
例えば、6つのチェックボックスの内、最低3つチェックが必要な場合valCheck="groupcheck_3-"を6つチェックボックス全てに設定します。

// 趣味を3つ選んで貰いたい場合 (3 <= x <= 3)
// 3つ未満を選択した際：選択不足の警告メッセージを表示
// 4つ以上を選択した際：選択超過の警告メッセージを表示
<div class="form-group">
	<label class="col-md-2 control-label" for="inputPassword">趣味</label>
	<div class="controls">
		<label><input type="checkbox" name="hobbies" value="reading" valCheck="required groupcheck_3-3"> 読書</label>
		<label><input type="checkbox" name="hobbies" value="driving" valCheck="required groupcheck_3-3"> ドライブ</label>
		<label><input type="checkbox" name="hobbies" value="movies" valCheck="required groupcheck_3-3"> 映画鑑賞</label>
		<label><input type="checkbox" name="hobbies" value="cycling" valCheck="required groupcheck_3-3"> サイクリング</label>
		<label><input type="checkbox" name="hobbies" value="travelling" valCheck="required groupcheck_3-3"> 旅行</label>
		<label><input type="checkbox" name="hobbies" value="ceramics" valCheck="required groupcheck_3-3"> 陶芸</label>
		<label><input type="checkbox" name="hobbies" value="yoga" valCheck="required groupcheck_3-3"> ヨガ</label>
	</div>
</div>
// requiredの指定がある場合で選択が0個の場合：入力必須の警告メッセージを表示
// requiredの指定がない場合で選択が0個の場合：選択不足の警告メッセージを表示

valCheck="required groupcheck_3-"   // 項目を3つ以上選んで貰いたい場合 (3 <= x)
valCheck="required groupcheck_-5"   // 項目を5つまで選んで貰いたい場合 (x <= 5)
valCheck="required groupcheck_3-5"  // 項目を3つ以上5つまで選んで貰いたい場合 (3 <= x <= 5)

ファイル選択項目
(追加：0.9.1)

対象のエレメントにvalCheck="file"を付加してください。
拡張子による選択可否を設定する場合は、スペース区切りで受け入れ可能な拡張子を記載します。

// ファイルの選択が必須の場合
<input type="file" id="your-resume" name="your-resume" valCheck="required file">

// ファイルの選択が必須且つ、選択した拡張子をチェックする場合
<input type="file" id="your-resume" name="your-resume" valCheck="required file pdf doc docx rtf">

// ファイルの選択が必須ではないが、選択した際は拡張子をチェックする場合
<input type="file" id="your-photo" name="your-photo" valCheck="file png jpeg jpg gif">

同セクション内複数フィールド
(追加：0.9.1)

親セクション(この場合は親

)に、クラス名multiElementsを付与してください。 同一セクション内に複数のチェック対象エレメントがある場合、全ての子エレメントが正常な場合のみ、そのセクションが正常判定されます。

住所

// 親エレメントに'multiElements'クラスを付与する
<div class="form-group multiElements">
	<label class="col-md-2 control-label">住所</label>
	<div class="controls">
		<input type="text" class="form-control col-md-2" name="address1" placeholder="都道府県" valCheck="required text">
		<input type="text" class="form-control col-md-4" name="address2" placeholder="市区町村" valCheck="required text">
		<input type="text" class="form-control col-md-4" name="address3" placeholder="丁目番地" valCheck="required text">
	</div>
</div>

サブミットボタン

対象のエレメントにvalCheck="submit"を付加してください。
フォームの送信前にフォーム内の各対象エレメントに対し、上記のチェックを行い、エラー警告が一つもない場合のみ、対象オブジェクト(ボタン)の本来の処理を継続します。 エラー警告がある場合は警告を表示後、return false;を返し、処理を中断します。

<a class="btn btn-lg" href="#" onClick="alert('test');" valCheck="submit"><i class="icon-envelope icon-white"></i> 送信</a>