maskFormat オプション

デフォルト値: ""

実行時に使用する入力マスクを決定します。

シンタックス

Javascript (Usage)
$(function () { //値を取得する var returnsValue; //タイプ： string returnsValue = $(".selector").wijinputmask("option", "maskFormat"); //値を設定します var newValue; //タイプ： string $(".selector").wijinputmask("option", "maskFormat", newValue); });

Javascript (Usage)

$(function () {
    
    //値を取得する
    var returnsValue; //タイプ： string
    returnsValue = $(".selector").wijinputmask("option", "maskFormat");
    
    //値を設定します
    var newValue; //タイプ： string
    $(".selector").wijinputmask("option", "maskFormat", newValue);
        
});

Javascript (Specification)
var maskFormat : string;

使用例

These examples show two ways to use RegEx values for the maskFormat option.

Javascript

$(".selector").wijinputmask({
    maskFormat: /\D{3}-\D{4}/
});

$(".selector").wijinputmask({
    maskFormat: new RegExp("\\D{3}-\\D{4}")
});

This example shows how to use the equivalent of [a-zA-Z] regular expressions in the maskFormat option.

Javascript

$("#masktext").wijinputmask({
    maskFormat:/[A-Z,a-z]*/,
    hidePromptOnLeave: true
});

解説

プロパティ値を表す文字列には、1つまたは複数のマスク要素を含めることができます。次の表は、有効なマスク要素を示します。

マスク要素	説明
0	数字（必須）。この要素は、0～9の任意の1桁の数値を受け入れます。
9	数字またはスペース（オプション）
#	数字またはスペース（オプション）。正（+）および負（-）の記号も有効です。
L	英字（必須）。ASCII文字a-zおよびA-Zだけに入力値を制限します。有効な文字は、UnicodeCategoryの以下のカテゴリに属するメンバとなります。UppercaseLetter、LowercaseLetter、TitlecaseLetter、ModifierLetter、およびOtherLetter。
?	英字（オプション）。ASCII文字a-zおよびA-Zだけに入力値を制限します。このマスク要素は、正規表現の[a-zA-Z]?と等価です。
&	文字（必須）
C	文字（オプション）。制御文字以外の任意の文字です。
A	英数字（オプション）
a	英数字（オプション）
.	小数点プレースホルダ。実際の表示に使用される文字は、cultureオプションに適した小数点プレースホルダとなります。
,	3桁区切りプレースホルダ。実際の表示に使用される文字は、cultureオプションに適した3桁区切りプレースホルダとなります。
:	時刻の区切り記号。実際の表示に使用される文字は、cultureオプションに適した時刻プレースホルダとなります。
/	日付の区切り記号。実際の表示に使用される文字は、cultureオプションに適した日付プレースホルダとなります。
$	通貨記号。実際の表示に使用される文字は、cultureオプションに適した通貨記号となります。
	シフトダウン。後続のすべての文字を小文字に変換します。
>	シフトアップ。後続のすべての文字を大文字に変換します。
\|	直前のシフトアップまたはシフトダウンを無効にします。
H	すべての半角文字
K	半角カタカナ
	全角の数字
	全角カタカナ
	ヒラガナ
	すべての全角文字
\\	エスケープ。マスク文字をエスケープし、リテラルとして扱われるようにします。バックラッシュのエスケープシーケンスは「\\\\」となります。
その他すべての文字はリテラル	マスク以外のすべての要素は、wijinputmask内にそのまま表示されます。実行時に、リテラルはマスク内の静的な位置を常に占有します。ユーザーが移動または削除することはできません。

次の表は、マスクの例を示します。

マスクの例	説明
00/00/0000	国際標準の日付形式による日付（日、月を表す数字、年）。「/」は論理的な日付区切り記号であり、ユーザーに対しては、アプリケーションの現在のカルチャに適した日付区切り記号として表示されます。
00->L	米国形式の日付（日、月の省略名、年）。3文字の月の省略名が、先頭を大文字、後続の2文字を小文字として表示されます。
(999)-000-0000	米国の電話番号。エリアコードはオプションです。オプション文字を入力しない場合、ユーザーはスペースを入力するか、またはマスク内の該当位置（最初の0の位置）にマウスポインタを直接移動します。次に、例を示します。 $(".selector").wijinputmask({ maskFormat: "(999)-000-0000 " });
$999,999.00	0～999999の範囲の通貨値。通貨記号、桁区切り記号、および小数点記号は、実行時に、カルチャに適したそれぞれの記号に置換されます。

RegEx

maskFormat値は、正規表現の形で指定することもできます。次に、例を示します。

\D{3}-\D{4} yields a Zip Code like this: (012-3456)

\D{2,4}-\D{2,4}-\D{4}/は、次のような電話番号: ( 012-345-6789)

\D{2,4}-\D{2,4}-\D{4}は、次のような電話番号: ( 012-345-6789)

Note Box

重要: 以下のRegExキーワードだけがサポートされます。

キーワード	説明
\A	任意の大文字アルファベットに一致します。[A-Z] と同じです。
\a	任意の小文字アルファベットに一致します。[a-z] と同じです。
\D	任意の 10 進数字に一致します。[0-9] と同じです。
\W	単語に使用される任意の文字に一致します。[a-zA-Z_0-9] と同じです。
\K	半角カタカナに一致します。
\H	すべての半角文字に一致します。
\Ａ	任意の全角大文字アルファベットに一致します。[Ａ-Ｚ] と同じです。
\ａ	任意の全角小文字アルファベットに一致します。[ａ-ｚ] と同じです。
\Ｄ	任意の全角 10 進数字に一致します。[０-９] と同じです。
\Ｗ	単語に使用される任意の全角文字に一致します。[ａ-ｚＡ-Ｚ＿０-９] と同じです。
\Ｋ	全角カタカナ。
\Ｊ	ひらがな。
\Ｚ	すべての全角文字。
[]	文字を組み合わせたサブセットの定義に使用します。
[^]	除外するサブセットの表記に使用します。
-	連続する文字範囲の定義に使用します。
{}	パターンを指定します。
*	{0,}の短縮表現。
+	{1,}の短縮表現。
?	{0,1}の短縮表現。

RegEx

関連トピック

参照