DecimalField – Django Forms
Last Updated :
13 Feb, 2020
DecimalField in Django Forms is a decimal field, for input of decimal numbers. The default widget for this input is NumberInput. It normalizes to a Python decimal. It uses MaxLengthValidator and MinLengthValidator if max_length and min_length are provided. Otherwise, all inputs are valid.
DecimalField has following optional arguments:
- max_length and min_length :- If provided, these arguments ensure that the string is at most or at least the given length.
- decimal_places :- The maximum number of decimal places permitted.
-
empty_value :- The value to use to represent “empty”. Defaults to an empty string.
Syntax
field_name = forms.DecimalField(**options)
Django form DecimalField Explanation
Illustration of DecimalField using an Example. Consider a project named geeksforgeeks having an app named geeks.
Refer to the following articles to check how to create a project and an app in Django.
Enter the following code into forms.py file of geeks app.
from django import forms
class GeeksForm(forms.Form):
geeks_field = forms.DecimalField(max_length = 200)
|
Add the geeks app to INSTALLED_APPS
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'geeks',
]
|
Now to render this form into a view we need a view and a URL mapped to that URL. Let’s create a view first in views.py of geeks app,
from django.shortcuts import render
from .forms import GeeksForm
def home_view(request):
context = {}
context['form'] = GeeksForm()
return render( request, "home.html", context)
|
Here we are importing that particular form from forms.py and creating an object of it in the view so that it can be rendered in a template.
Now, to initiate a Django form you need to create home.html where one would be designing the stuff as they like. Let’s create a form in home.html.
<form method = "GET">
{{ form }}
<input type = "submit" value = "Submit">
</form>
|
Finally, a URL to map to this view in urls.py
from django.urls import path
from .views import home_view
urlpatterns = [
path('', home_view ),
]
|
Let’s run the server and check what has actually happened, Run
Python manage.py runserver
Thus, an geeks_field DecimalField is created by replacing “_” with ” “. It is a field to input of decimal numbers.
How to use DecimalField ?
DecimalField is used for input of decimal numbers in the database. One can input percentage marks, Marks, etc. Till now we have discussed how to implement DecimalField but how to use it in the view for performing the logical part. To perform some logic we would need to get the value entered into the field into a python string instance.
In views.py,
from django.shortcuts import render
from .forms import GeeksForm
def home_view(request):
context ={}
form = GeeksForm()
context['form']= form
if request.GET:
temp = request.GET['geeks_field']
print(temp)
return render(request, "home.html", context)
|
Now let’s try entering some other data into the field.
You can clearly see it is asking for entering a valid Number. Let’s try entering decimal data now.
Now this data can be fetched using corresponding request dictionary. If method is GET, data would be available in request.GET and if post, request.POST correspondingly. In above example we have the value in temp which we can use for any purpose. You can check that data is converted to a python decimal instance in geeks_field.
Core Field Arguments
Core Field arguments are the arguments given to each field for applying some constraint or imparting a particular characteristic to a particular Field. For example, adding an argument required = False to DecimalField will enable it to be left blank by the user. Each Field class constructor takes at least these arguments. Some Field classes take additional, field-specific arguments, but the following should always be accepted:
| Field Options |
Description |
| required |
By default, each Field class assumes the value is required, so to make it not required you need to set required=False |
| label |
The label argument lets you specify the “human-friendly” label for this field. This is used when the Field is displayed in a Form. |
| label_suffix |
The label_suffix argument lets you override the form’s label_suffix on a per-field basis. |
| widget |
The widget argument lets you specify a Widget class to use when rendering this Field. See Widgets for more information. |
| help_text |
The help_text argument lets you specify descriptive text for this Field. If you provide help_text, it will be displayed next to the Field when the Field is rendered by one of the convenience Form methods.
|
| error_messages |
The error_messages argument lets you override the default messages that the field will raise. Pass in a dictionary with keys matching the error messages you want to override. |
| validators |
The validators argument lets you provide a list of validation functions for this field.
|
| localize |
The localize argument enables the localization of form data input, as well as the rendered output. |
| disabled. |
The disabled boolean argument, when set to True, disables a form field using the disabled HTML attribute so that it won’t be editable by users.
|
Similar Reads
DecimalField - Django Models
DecimalField is a field which stores a fixed-precision decimal number, represented in Python by a Decimal instance. It validates the input using DecimalValidator. Syntax field_name = models.DecimalField(max_digits=None, decimal_places=None, **options) DecimalField has the following required argument
4 min read
DateTimeField - Django Forms
DateTimeField in Django Forms is a date field, for taking input of date and time from user. The default widget for this input is DateTimeInput. It Normalizes to: A Python datetime.datetime object. It validates that the given value is either a datetime.datetime, datetime.date or string formatted in a
5 min read
CharField - Django Forms
CharField in Django Forms is a string field, for small- to large-sized strings. It is used for taking text inputs from the user. The default widget for this input is TextInput. It uses MaxLengthValidator and MinLengthValidator if max_length and min_length are provided. Otherwise, all inputs are vali
5 min read
DateField - Django Forms
DateField in Django Forms is a date field, for taking input of dates from user. The default widget for this input is DateInput. It Normalizes to: A Python datetime.date object. It validates that the given value is either a datetime.date, datetime.datetime or string formatted in a particular date for
5 min read
ChoiceField - Django Forms
ChoiceField in Django Forms is a string field, for selecting a particular choice out of a list of available choices. It is used to implement State, Countries etc. like fields for which information is already defined and user has to choose one. It is used for taking text inputs from the user. The def
5 min read
BooleanField - Django Forms
BooleanField in Django Forms is a checkbox field which stores either True or False. It is used for taking boolean inputs from the user. The default widget for this input is CheckboxInput. It normalizes to: A Python True or False value. Syntax field_name = forms.BooleanField(**options) Django form Bo
5 min read
CharField - Django Models
CharField is a string field, for small- to large-sized strings. It is like a string field in C/C++. CharField is generally used for storing small strings like first name, last name, etc. To store larger text TextField is used. The default form widget for this field is TextInput. CharField has one ex
4 min read
DateField - Django Models
DateField is a field that stores date, represented in Python by a datetime.date instance. As the name suggests, this field is used to store an object of date created in python. The default form widget for this field is a TextInput. The admin can add a JavaScript calendar and a shortcut for “Today†e
5 min read
BinaryField - Django Models
BinaryField is a special field to store raw binary data. It can be assigned bytes, bytearray, or memoryview. By default, BinaryField sets editable to False, that is it can’t be included in a ModelForm. Since BinaryField stores raw data or in other terms a python object, it can not be manually entere
4 min read
EmailField - Django Forms
EmailField in Django Forms is a string field, for input of Emails. It is used for taking text inputs from the user. The default widget for this input is EmailInput. It uses MaxLengthValidator and MinLengthValidator if max_length and min_length are provided. Otherwise, all inputs are valid. EmailFiel
5 min read