ディレクトリ
まず、多くの-な方法を作成するには、3つの方法は、
(A)自動
- ORMは自動的に3番目のテーブルを作成し、いない第3の動作テーブルの上に、4つの方法を構築しました(追加、削除、セット、クリア)
- 悪いスケーラビリティ、3番目の表は、フィールドを拡張または変更することはできません
from django.db import models
class Book(models.Model):
title = models.CharField(max_length=32)
# 多对多关系字段
authors = models.ManyToManyField(to='Authors')
class Authors(models.Model):
name = models.CharField(max_length=32)
(B)の純粋なラインと手(ベーシック必要)
- すべての3番目のテーブルのフィールドとフィールド名の数は、独自に定義することができます
- ORMは、もはやクロステーブルのクエリをサポートしてされて4つの組み込み方法(追加、設定、削除、クリア)
from django.db import models
class Book(models.Model):
title = models.CharField(max_length=32)
class Authors(models.Model):
name = models.CharField(max_length=32)
class Book2Authors(models.Model):
book = models.ForeignKey(to='Book')
author = models.ForeignKey(to='Authors')
# 扩展字段
create_time = models.DateField(auto_now_add=True)
(C)半自動(推奨)
- 経由:カスタム指定された第三のリレーショナルテーブル
- through_fields:(フィールドの前に配置されているテーブルが作成される順序とは、表、)第3のテーブルのカスタムフィールドのセットの指定されたフォームに関連付けられた要素
- あなたは、必要に応じて、テーブルの列を変更し、第三に追加することができます
- クロステーブルのクエリのORMサポートは、組み込み方法(追加、設定、削除、クリア)4でサポートされていません
from django.db import models
class Book(models.Model):
title = models.CharField(max_length=32)
# 多对多关系字段
authors = models.ManyToManyField(to='Authors',through='Book2Authors',through_fields=('book','authors'))
class Authors(models.Model):
name = models.CharField(max_length=32)
# books = models.ManyToManyField(to='Book',through='Book2Authors',through_fields=('authors','book'))
class Book2Authors(models.Model):
book = models.ForeignKey(to='Book')
authors = models.ForeignKey(to='Authors')
二、フォームコンポーネント
輸入fromsする必要があります。from django import forms
(B)検査データ
(1)内蔵で使用されるフィールドとパラメータ
あるフィールド継承するすべてのフィールドのデフォルトは、パラメータのフィールドを使用することができます
- フィールド
- 必要=真:空を許可するかどうか
- ラベル:ラベル表示のコンテンツラベル
- 初期:初期値
- エラー・メッセージ・フォーマット{「パラメータ名」:「エラー」}設定error_messages ,:、など
{‘required’:‘为空时显示的错误信息内容’}
- ウィジェット:HTMLプラグイン
- バリ:カスタム検証ルール、タプルを入れ、RegexValidatorと組み合わせます
- CharFieldです
- MAX_LENGTH:最大長
- MIN_LENGTH:最小の長さ
- ストリップ:削除空白にするかどうか
- ウィジェット:設定タブ型パラメータおよびプロパティを追加し、デフォルトテキスト、 `
* TextInput(字典):设置标签type参数为text,同时可以添加自定义属性或样式,如:
ウィジェット= forms.widgets.TextInput({「クラス」:「コントロールフォームC1-C2」、「ユーザ名」:「ジェイソン」})* PasswordInput():设置标签type参数为password,如:
ウィジェット= forms.widgetsを.PasswordInput() `
- ChoiceField /なMultipleChoiceField
- 選択肢:選択肢=((0、 '上海')、(1、 '北京'))などの選択パラメータ
- 必須:必須
- ウィジェット:プラグインのデフォルト設定を選択します
- RadioSelect():ラジオのラベル型パラメータ
- 選択():ドロップダウンボックスのラベルを選択
- CheckboxInput():パスワードを記憶するかどうか
- selectMultiple():ドロップダウンボックスのラベルの複数の選択肢を選択
- CheckboxSelectMultiple:ラベルタイプパラメータのチェックボックス
EmailField
これは、メールボックス形式でなければなりません
from django import forms
class MyForm(forms.Form):
# username字段 最少三位 最多八位
username = forms.CharField(max_length=8,min_length=3)
# password字段 最少三位 最多八位
password = forms.CharField(max_length=8,min_length=3)
# email字段 必须是邮箱格式
email = forms.EmailField()
(2)内蔵バリ
- チェックバリデータによって設定されたパラメータ点、リスト形式は、複数のを置くことができます
- RegexValidator(条件を満たさない場合、正規表現文字列を出力)
from django.core.validators import RegexValidator
class MyForm(Form):
user = fields.CharField(
validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],
)
(3)HOOK方法
ローカルフック関数
- 単一のフィールドを確認してください
- Clean_は、Formクラス()メソッドでフィールド名を定義し
- cleaned_data:最初の二つは、データが記憶されている辞書穿刺を満たすように選択されています
- ValidationErrorを(エラーメッセージ)を指示し、エラーをスローすることにより、我々は内部ソースをキャプチャするために例外を作りました
- add_errorでエラーを追加します(フィールド名、エラーメッセージ)メソッド
from django.core.exceptions import ValidationError class LoginForm(forms.Form): username = forms.CharField( min_length=8, label="用户名", initial="张三", error_messages={ "required": "不能为空", "invalid": "格式错误", "min_length": "用户名最短8位" }, widget=forms.widgets.TextInput(attrs={"class": "form-control"}) ) ... # 定义局部钩子,用来校验username字段 def clean_username(self): username = self.cleaned_data.get('username') if '666' in username: # 给username所对应的框展示错误信息 # self.add_error('username','光喊666是不行的') raise ValidationError('到底对不对啊') # 将username数据返回 return username
グローバルフック関数
- チェックサムフィールドの複数
- クラス形式で定義クリーン()メソッド
class LoginForm(forms.Form):
...
password = forms.CharField(
min_length=6,
label="密码",
widget=forms.widgets.PasswordInput(attrs={'class': 'form-control'}, render_value=True)
)
re_password = forms.CharField(
min_length=6,
label="确认密码",
widget=forms.widgets.PasswordInput(attrs={'class': 'form-control'}, render_value=True)
)
...
# 定义全局的钩子,用来校验密码和确认密码字段是否相同
def clean(self):
password = self.cleaned_data.get("password")
confirm_password = self.cleaned_data.get("confirm_password")
if not password == confirm_password:
self.add_error('confirm_password','两次密码不一致')
# 将全局的数据返回
return self.cleaned_data
(B)タグをレンダリング
(1)バックエンド
- 保存された後続のエラーステータス情報を容易にするために、同じオブジェクト名、および情報提示を形成するために、POSTリクエストの前と後
- IS_VALID:、一致条件のチェックを満たしているブール値を返します。
# views.py
def index(request):
# 渲染标签 第一步 需要生成一个空的forms类的对象
form_obj = MyForm()
# 如何校验前端用户传入的数据
if request.method == 'POST':
# 获取用户的数据 request.POST中 forms组件校验数据
form_obj = MyForm(request.POST) # 改变量名一定要跟上面的form_obj变量名一直
if form_obj.is_valid(): # 研究forms组件入口就是is_valid()
print(form_obj.cleaned_data)
return HttpResponse('数据全部OK')
# 直接将生成的对象 传递给前端页面
return render(request,'index.html',locals())
(2)先端
フォームは送信ボタンをレンダリングしていない、過去にユーザーが入力したコンポーネントのラベルをレンダリングします
実施例1(ビルトイン方式)
1つの実施形態のパッケージには、あまりにも高い、貧しいスケーラビリティ、お勧めできません
- as_p:pタグとして
- as_ul:タグのリスト
- as_table:表ヘッダタグ、横効果の行として
{{ form_obj.as_p }} <!--自动渲染所有input框 --> {{ form_obj.as_ul }} {{ form_obj.as_table }}
モード2(label属性)
プロジェクト内の2ごちゃ混ぜにあまりにも多くの入力は、推奨されません
{{ form_obj.username.label }}{{ form_obj.username }} {{ form_obj.username.label }}{{ form_obj.password }} {{ form_obj.username.label }}{{ form_obj.email }}
モード3(ループ用)
勧告
{% for form in form_obj %} <p>{{ form.label }}{{ form }}</p> <!--form 等价于你方式2中的对象点字段名--> {% endfor %}
(C)は、本情報
- 同じにオブジェクト名やPOSTリクエストの後にフォームFormオブジェクトを空にする
- エラー:エラーメッセージ、リストに戻ります
<form action="" method="post" novalidate>
{% for forms in form_obj %}
<p>
{{ forms.label }}{{ forms }}
<span>{{ forms.errors.0 }}</span>
</p> <!--form 等价于你方式2中的对象点字段名-->
{% endfor %}
<input type="submit">
</form>
三、フォームテンプレートコンポーネント
(A)初期
初期値、初期値入力ボックスの内側。
class LoginForm(forms.Form):
username = forms.CharField(
min_length=8,
label="用户名",
initial="张三" # 设置默认值
)
pwd = forms.CharField(min_length=6, label="密码")
(二)error_messages
エラーメッセージを書き換えます。
class LoginForm(forms.Form):
username = forms.CharField(
min_length=8,
label="用户名",
initial="张三",
error_messages={
"required": "不能为空",
"invalid": "格式错误",
"min_length": "用户名最短8位"
}
)
pwd = forms.CharField(min_length=6, label="密码")
(C)パスワード
class LoginForm(forms.Form):
...
pwd = forms.CharField(
min_length=6,
label="密码",
widget=forms.widgets.PasswordInput(attrs={'class': 'c1'}, render_value=True)
)
(D)radioSelect
値は、単一の無線の文字列です。
class LoginForm(forms.Form):
username = forms.CharField(
min_length=8,
label="用户名",
initial="张三",
error_messages={
"required": "不能为空",
"invalid": "格式错误",
"min_length": "用户名最短8位"
}
)
pwd = forms.CharField(min_length=6, label="密码")
gender = forms.fields.ChoiceField(
choices=((1, "男"), (2, "女"), (3, "保密")),
label="性别",
initial=3,
widget=forms.widgets.RadioSelect()
)
(E)ラジオを選択
class LoginForm(forms.Form):
...
hobby = forms.ChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
label="爱好",
initial=3,
widget=forms.widgets.Select()
)
(F)複数の選択肢を選択
class LoginForm(forms.Form):
...
hobby = forms.MultipleChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
label="爱好",
initial=[1, 3],
widget=forms.widgets.SelectMultiple()
)
(VII)無線チェックボックス
class LoginForm(forms.Form):
...
keep = forms.ChoiceField(
label="是否记住密码",
initial="checked",
widget=forms.widgets.CheckboxInput()
)
(H)複数選択チェックボックス
class LoginForm(forms.Form):
...
hobby = forms.MultipleChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
label="爱好",
initial=[1, 3],
widget=forms.widgets.CheckboxSelectMultiple()
IV、付録
Field
required=True, 是否允许为空
widget=None, HTML插件
label=None, 用于生成Label标签或显示内容
initial=None, 初始值
help_text='', 帮助信息(在标签旁边显示)
error_messages=None, 错误信息 {'required': '不能为空', 'invalid': '格式错误'}
validators=[], 自定义验证规则
localize=False, 是否支持本地化
disabled=False, 是否可以编辑
label_suffix=None Label内容后缀
CharField(Field)
max_length=None, 最大长度
min_length=None, 最小长度
strip=True 是否移除用户输入空白
IntegerField(Field)
max_value=None, 最大值
min_value=None, 最小值
FloatField(IntegerField)
...
DecimalField(IntegerField)
max_value=None, 最大值
min_value=None, 最小值
max_digits=None, 总长度
decimal_places=None, 小数位长度
BaseTemporalField(Field)
input_formats=None 时间格式化
DateField(BaseTemporalField) 格式:2015-09-01
TimeField(BaseTemporalField) 格式:11:12
DateTimeField(BaseTemporalField)格式:2015-09-01 11:12
DurationField(Field) 时间间隔:%d %H:%M:%S.%f
...
RegexField(CharField)
regex, 自定制正则表达式
max_length=None, 最大长度
min_length=None, 最小长度
error_message=None, 忽略,错误信息使用 error_messages={'invalid': '...'}
EmailField(CharField)
...
FileField(Field)
allow_empty_file=False 是否允许空文件
ImageField(FileField)
...
注:需要PIL模块,pip3 install Pillow
以上两个字典使用时,需要注意两点:
- form表单中 enctype="multipart/form-data"
- view函数中 obj = MyForm(request.POST, request.FILES)
URLField(Field)
...
BooleanField(Field)
...
NullBooleanField(BooleanField)
...
ChoiceField(Field)
...
choices=(), 选项,如:choices = ((0,'上海'),(1,'北京'),)
required=True, 是否必填
widget=None, 插件,默认select插件
label=None, Label内容
initial=None, 初始值
help_text='', 帮助提示
ModelChoiceField(ChoiceField)
... django.forms.models.ModelChoiceField
queryset, # 查询数据库中的数据
empty_label="---------", # 默认空显示内容
to_field_name=None, # HTML中value的值对应的字段
limit_choices_to=None # ModelForm中对queryset二次筛选
ModelMultipleChoiceField(ModelChoiceField)
... django.forms.models.ModelMultipleChoiceField
TypedChoiceField(ChoiceField)
coerce = lambda val: val 对选中的值进行一次转换
empty_value= '' 空值的默认值
MultipleChoiceField(ChoiceField)
...
TypedMultipleChoiceField(MultipleChoiceField)
coerce = lambda val: val 对选中的每一个值进行一次转换
empty_value= '' 空值的默认值
ComboField(Field)
fields=() 使用多个验证,如下:即验证最大长度20,又验证邮箱格式
fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),])
MultiValueField(Field)
PS: 抽象类,子类中可以实现聚合多个字典去匹配一个值,要配合MultiWidget使用
SplitDateTimeField(MultiValueField)
input_date_formats=None, 格式列表:['%Y--%m--%d', '%m%d/%Y', '%m/%d/%y']
input_time_formats=None 格式列表:['%H:%M:%S', '%H:%M:%S.%f', '%H:%M']
FilePathField(ChoiceField) 文件选项,目录下文件显示在页面中
path, 文件夹路径
match=None, 正则匹配
recursive=False, 递归下面的文件夹
allow_files=True, 允许文件
allow_folders=False, 允许文件夹
required=True,
widget=None,
label=None,
initial=None,
help_text=''
GenericIPAddressField
protocol='both', both,ipv4,ipv6支持的IP格式
unpack_ipv4=False 解析ipv4地址,如果是::ffff:192.0.2.1时候,可解析为192.0.2.1, PS:protocol必须为both才能启用
SlugField(CharField) 数字,字母,下划线,减号(连字符)
...
UUIDField(CharField) uuid类型
Django Form内置字段