ajax views

ajax 視圖

一個簡單的 Django 應用程序，可透過 JavaScript 輕鬆使用 AJAX 視圖。

相容性

• django >= 3.2
• python >= 3.9

特徵

• 能夠將 AJAX URL 公開給 JavaScript
• 支援的基於函數和基於類別的視圖
• 一種 URL 模式統治他們所有人對於所有 AJAX 視圖
• Jinja2 支持

安裝

透過 Pip 安裝套件：

 pip install ajax-views

將其新增至您的INSTALLED_APPS清單：

 INSTALLED_APPS = (
    # ...
    "ajax_views" ,
    # ...
)

將ajax_views.urls加入到您的 URLconf：

 from django . urls import include , path

urlpatterns = [
    path ( "ajax/" , include ( "ajax_views.urls" )),
]

用法

@ajax_view(“名稱”)

使用此裝飾器來註冊您的視圖（基於函數或基於類別）。

 from ajax_views . decorators import ajax_view

@ ajax_view ( "myapp.form" )
def form_view ( request ):
    ...

@ ajax_view ( "myapp.form_cbv" )
class AjaxFormView ( FormView ):
    ...

注意：指定的名稱必須是唯一的。

您可以將ajax_view與其他裝飾器結合使用：

 @ csrf_exempt
@ require_POST
@ ajax_view ( "myapp.contact_form" )
def csrf_exempt_view ( request ):
    # ... 

{% ajax_views_json %}

用於將註冊 URL 輸出為 JSON 的範本標籤。

 {% load ajax_views %}

<script>
    window.ajax_views = {% ajax_views_json %};
</script>

現在您可以使用聲明的物件來引用對應的 url，如下所示：

 $ . ajax ( {
    url : window . ajax_views . myapp . form ,
    ...
} ) ; 

{% ajax_url '名稱' %}

此標籤用於在範本文件中新增 AJAX URL：

 {% load ajax_views %}

<form action="{% ajax_url 'myapp.form' %}" method="post">
    ...
</form>

多個名字

同一視圖可以有多個名稱：

 from ajax_views . decorators import ajax_view

@ ajax_view ([ "myapp.form" , "myapp.fallback" ])
def example_view ( request ):
    ...

Jinja2 支持

啟用 Jinja2 擴展

 TEMPLATES = [
    {
        "BACKEND" : "django.template.backends.jinja2.Jinja2" ,
        "OPTIONS" : {
            "extensions" : [
                # ...
                "ajax_views.templatetags.ajax_views.AjaxViewsExtension" ,
            ]
        }
    }
]

注意：如果您使用 django-jinja，則不需要執行此操作。

用法與Django類似，只不過ajax_url是一個全域函數：

< form action = " {{ ajax_url('myapp.form') }} " method = " post " >
    ...
</ form >