localflavor アドオン

revision-up-to:	7127 (0.97pre SVN)

Python の「バッテリ入り (batteries included)」哲学に従って、 Django には様々な国や文化のための有用なコードが付属しています。こうしたコードは「localflavor アドオン」と呼ばれ、 django.contrib.localflavor パッケージに収められています。

localflavor パッケージは、各国、各文化圏のコードを、それぞれ ISO 3166 国別コードに従って名付けたサブパッケージにまとめています。

localflavor アドオンの大部分は、 newforms フレームワークから導出された、ローカライズされたフォームコンポーネントで占められています。例えば、 USStateField にはアメリカの州名略号を検証する方法が組み込まれていますし、 FISocialSecurityNumber は、フィンランドの社会保障番号の検証方法が組み込まれています。

ローカライズコンポーネントは、サブパッケージを import するだけで使えます。例えば、フランスの電話番号を入力するためのフィールドを生成したければ、以下のようにします:

from django import newforms as forms
from django.contrib.localflavor import fr

class MyForm(forms.Form):
    my_french_phone_no = fr.forms.FRPhoneNumberField()

localflavor でサポートされている国

localflavor がサポートしている国や文化圏は、以下の通りです:

アルゼンチン (Argentina)

オーストラリア (Australia)

ブラジル (Brazil)

カナダ (Canada)

チリ (Chile)

フィンランド (Finland)

フランス (France)

ドイツ (Germany)

オランダ (Holland)

アイスランド (Iceland)

インド (India)

イタリア (Italy)

日本 (Japan)

メキシコ (Mexico)

ノルウェー (Norway)

ペルー (Peru)

ポーランド (Poland)

スロバキア (Slovakia)

南アフリカ (South Africa)

スペイン (Spain)

スイス (Switzerland)

イギリス (United Kingdom)

アメリカ (United States of America)

localfravor パッケージ内には、 generic というサブパッケージもあります。このパッケージは、複数の国や文化で便利なコードをまとめています。現状では、このモジュールには、アメリカの標準をデフォルトとしない、 newforms に基づいた日付や時刻の入力フィールドが入っています。使い方を以下に示します:

from django import newforms as forms
from django.contrib.localflavor import generic

class MyForm(forms.Form):
    my_date_field = generic.forms.DateField()

XXX-XX-XXXX 形式であること

0 ばかりでできた桁グループがないこと

先頭の桁グループが 666 でないこと

広報に使われるブロック (987-65-4320 から 987-65-4329) の範囲内でないこと

広報で使われているために、明らかに無効であると知られている番号 (Woolworth 番号、または 1962 promotional number) でないこと