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 >