ajax views

visualizações ajax

Um aplicativo Django simples para usar facilmente visualizações AJAX com JavaScript.

Compatibilidade

• django >= 3.2
• python >= 3.9

Características

• Capacidade de expor seus URLs AJAX a JavaScript
• Visualizações baseadas em funções e classes suportadas
• Um padrão de URL para governar todos eles para todas as visualizações AJAX
• Suporte Jinja2

Instalação

Instale o pacote via Pip:

 pip install ajax-views

Adicione-o à sua lista INSTALLED_APPS :

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

Adicione ajax_views.urls ao seu URLconf:

 from django . urls import include , path

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

Uso

@ajax_view("nome")

Use este decorador para registrar suas visualizações (baseadas em função ou baseadas em classe).

 from ajax_views . decorators import ajax_view

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

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

NOTA : O nome especificado deve ser exclusivo.

Você pode combinar ajax_view com outros decoradores:

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

{% ajax_views_json %}

Tag de modelo para gerar URLs registrados como JSON.

 {% load ajax_views %}

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

Agora você pode usar o objeto declarado para se referir aos URLs correspondentes como este:

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

{% ajax_url 'nome' %}

Esta tag é usada para adicionar URLs AJAX nos arquivos de modelo:

 {% load ajax_views %}

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

Vários nomes

Você pode ter vários nomes para a mesma visualização:

 from ajax_views . decorators import ajax_view

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

Suporte Jinja2

Habilitar extensão Jinja2

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

NOTA : Se você estiver usando Django-jinja, não precisa fazer isso.

O uso é semelhante ao Django, exceto que ajax_url é uma função global:

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