Django - Ajax

Ajax 本質上是將多種技術整合在一起以減少頁面載入次數的技術組合。我們通常使用 Ajax 來簡化終端使用者體驗。在 Django 中使用 Ajax 可以透過直接使用 JQuery 或其他 Ajax 庫來完成。假設您想使用 JQuery，那麼您需要下載並在您的伺服器（透過 Apache 或其他伺服器）上提供該庫。然後在您的模板中使用它，就像您在開發任何基於 Ajax 的應用程式時一樣。

在 Django 中使用 Ajax 的另一種方法是使用 Django Ajax 框架。最常用的是 django-dajax，它是一個功能強大的工具，可以使用 Python 和幾乎沒有 JavaScript 原始碼來輕鬆快速地在 Web 應用程式中開發非同步呈現邏輯。它支援四個最流行的 Ajax 框架：Prototype、jQuery、Dojo 和 MooTools。

使用 Django-dajax

首先需要安裝 django-dajax。這可以透過使用 easy_install 或 pip 來完成：

$ pip install django_dajax
$ easy_install django_dajax

這將自動安裝 django-dajaxice，它是 django-dajax 所需的。然後我們需要配置 dajax 和 dajaxice。

在您的專案 settings.py 檔案中，在 INSTALLED_APPS 選項中新增 dajax 和 dajaxice：

INSTALLED_APPS += (
   'dajaxice',
   'dajax'
)

確保在同一個 settings.py 檔案中，您擁有以下內容：

TEMPLATE_LOADERS = (
   'django.template.loaders.filesystem.Loader',
   'django.template.loaders.app_directories.Loader',
   'django.template.loaders.eggs.Loader',
)

TEMPLATE_CONTEXT_PROCESSORS = (
   'django.contrib.auth.context_processors.auth',
   'django.core.context_processors.debug',
   'django.core.context_processors.i18n',
   'django.core.context_processors.media',
   'django.core.context_processors.static',
   'django.core.context_processors.request',
   'django.contrib.messages.context_processors.messages'
)

STATICFILES_FINDERS = (
   'django.contrib.staticfiles.finders.FileSystemFinder',
   'django.contrib.staticfiles.finders.AppDirectoriesFinder',
   'dajaxice.finders.DajaxiceFinder',
)

DAJAXICE_MEDIA_PREFIX = 'dajaxice'

現在轉到 myapp/url.py 檔案，並確保您有以下內容來設定 dajax URL 並載入 dajax 靜態 js 檔案：

from dajaxice.core import dajaxice_autodiscover, dajaxice_config
from django.contrib.staticfiles.urls import staticfiles_urlpatterns
from django.conf import settings

Then dajax urls:

urlpatterns += patterns('',
   url(r'^%s/' % settings.DAJAXICE_MEDIA_PREFIX, include('dajaxice.urls')),)
	
urlpatterns += staticfiles_urlpatterns()

讓我們建立一個基於我們的 Dreamreal 模型的簡單表單來儲存它，使用 Ajax（意味著無需重新整理）。

首先，我們需要在 myapp/form.py 中建立我們的 Dreamreal 表單。

class DreamrealForm(forms.Form):
   website = forms.CharField(max_length = 100)
   name = forms.CharField(max_length = 100)
   phonenumber = forms.CharField(max_length = 50)
   email = forms.CharField(max_length = 100)

然後我們需要在我們的應用程式中建立一個 ajax.py 檔案：myapp/ajax.py。這就是我們的邏輯所在，我們在這裡放置儲存表單並返回彈出視窗的功能：

from dajaxice.utils import deserialize_form
from myapp.form import DreamrealForm
from dajax.core import Dajax
from myapp.models import Dreamreal

@dajaxice_register
def send_form(request, form):
   dajax = Dajax()
   form = DreamrealForm(deserialize_form(form))
   
   if form.is_valid():
      dajax.remove_css_class('#my_form input', 'error')
      dr = Dreamreal()
      dr.website = form.cleaned_data.get('website')
      dr.name = form.cleaned_data.get('name')
      dr.phonenumber = form.cleaned_data.get('phonenumber')
      dr.save()
      
      dajax.alert("Dreamreal Entry %s was successfully saved." % 
         form.cleaned_data.get('name'))
   else:
      dajax.remove_css_class('#my_form input', 'error')
      for error in form.errors:
         dajax.add_css_class('#id_%s' % error, 'error')
			
   return dajax.json()

現在讓我們建立 dreamreal.html 模板，其中包含我們的表單：

<html>
   <head></head>
   <body>
   
      <form action = "" method = "post" id = "my_form" accept-charset = "utf-8">
         {{ form.as_p }}
         <p><input type = "button" value = "Send" onclick = "send_form();"></p>
      </form>
      
   </body>
</html>

在 myapp/views.py 中新增與模板對應的檢視：

def dreamreal(request):
   form = DreamrealForm()
   return render(request, 'dreamreal.html', locals())

在 myapp/urls.py 中新增相應的 URL：

url(r'^dreamreal/', 'dreamreal', name = 'dreamreal'),

現在讓我們在我們的模板中新增必要的程式碼以使 Ajax 工作：

在檔案頂部新增：

{% load static %}
{% load dajaxice_templatetags %}

並在我們的 dreamreal.html 模板的 <head> 部分新增：

在本例中，我們使用的是 JQuery 庫，因此新增：

<script src = "{% static '/static/jquery-1.11.3.min.js' %}" 
   type = "text/javascript" charset = "utf-8"></script>
<script src = "{% static '/static/dajax/jquery.dajax.core.js' %}"></script>

將在點選時呼叫的 Ajax 函式：

<script>

   function send_form(){
      Dajaxice.myapp.send_form(Dajax.process,{'form':$('#my_form').serialize(true)});
   }
</script>

請注意，您需要在您的靜態檔案目錄中包含“jquery-1.11.3.min.js”，以及 jquery.dajax.core.js。為了確保所有 dajax 靜態檔案都在您的靜態目錄下提供服務，請執行：

$python manage.py collectstatic

注意 - 有時 jquery.dajax.core.js 可能丟失，如果發生這種情況，只需下載原始碼並獲取該檔案並將其放在您的靜態資料夾中。

訪問 /myapp/dreamreal/ 後，您將看到以下螢幕：

提交後，您將看到以下螢幕：

列印頁面