Como usar a tag de inclusão do Django

O framework Django usa diferentes tipos de templates para apresentar os dados da aplicação. A interface de administração do Django usa a tag de template customizada. A aparência desses elementos da interface, como botões, campos, etc., são iguais para todas as páginas. O desenvolvedor Django pode definir a tag de template customizada e filtrar de acordo com o mecanismo de template e a nova tag de template pode ser usada usando o % custom_tag%. A tag de modelo que é usada para exibir dados ao renderizar outro modelo é chamada de tag de inclusão. A maneira de usar a tag de inclusão no modelo Django é mostrada neste tutorial.

Pré-requisitos:

Antes de praticar o script deste tutorial, você deve concluir as seguintes tarefas.

UMA. Instale o Django versão 3+ no Ubuntu 20+ (de preferência)
B. Crie um projeto Django
C. Execute o servidor Django para verificar se o servidor está funcionando corretamente ou não.

Configure um aplicativo Django:

UMA. Execute o seguinte comando para criar um aplicativo Django chamado includetagapp.

$ python3 manage.py startapp inclusãotagapp

B. Execute o seguinte comando para criar o usuário para acessar o banco de dados Django. Se você já criou o usuário antes, não precisa executar o comando.

$ python3 manage.py cria superusuário

C. Adicione o nome do aplicativo no INSTALLED_APP parte de definições.py Arquivo.

INSTALLED_APPS = [
…
'includetagapp'
]

D. Crie uma pasta chamada modelos dentro de includetagapp pasta e definir o modelos localização do aplicativo no MODELOS parte de definições.py Arquivo.

MODELOS = [

… .
'DIRS': ['/ home / fahmida / django_pro / inclusãotagapp / templates'],
… .
,
]

Implementar tag de inclusão no Django:

Crio templatetags pasta dentro do includetagapp pasta. Em seguida, crie um arquivo python chamado tag de inclusão.py com o seguinte script. O módulo do modelo é importado para o script para usar a tag de inclusão. Uma lista de números pares será gerada após ligar para o display_even_numbers () função deste script. A saída deste script será exibida no exibição.html arquivo que foi criado na próxima etapa deste tutorial.

tag de inclusão.py

# Módulo de modelo de importação
do modelo de importação django
# Crie um objeto de Biblioteca ()
register = template.Biblioteca()
# Defina o arquivo de modelo para a tag de inclusão
@registro.inclusão_tag ('display.html ')
# Função de declaração para descobrir os números pares dentro de um intervalo
def display_even_numbers (a, b):
# Declare uma lista vazia
numero = []
# Repita o loop para descobrir o número par entre a e b
para i no intervalo (a, b):
# Verifique se o número é par ou não
se i% 2 == 0:
# Adicione o número na lista se for par
número.anexar (i)
# Retorne a lista para o display.arquivo html
retornar "saída": número

Crie um arquivo HTML chamado exibição.html dentro de modelos pasta e adicione o seguinte script. Os valores da lista retornados pela tag de inclusão são lidos por um loop for no script.

exibição.html

<br>Tag de inclusão de teste<br>

Em seguida, crie outro arquivo HTML chamado incusiontag.html dentro de modelos pasta e adicione o seguinte script. Neste script, o conteúdo da tag de inclusão feita na parte anterior deste tutorial é carregado, e o display_even_number () função é chamada com dois valores de argumento, 10 e 20. Esta função criará uma lista de números pares entre 10 e 20 e retornará a lista para o exibição.html Arquivo.

tag de inclusão.html

<br>Exemplo de tag de inclusão Django<br>

Lista de números pares de 10 a 20

% load inclusãotag%
% display_even_numbers 10 20%

Modifique as visualizações.arquivo py com o seguinte script para carregar a tag de inclusão no arquivo de modelo necessário. Quando a função inclusãotag () deste script é chamada, ele exibirá o tag de inclusão.html arquivo que irá carregar a tag de inclusão e chamar o display_even_numbers () função.

Visualizações.py

# Módulo de importação de renderizações
de django.importação de atalhos renderização
"
Declare a função para renderizar a tag de inclusão.arquivo html
carregar tag de inclusão
"
def inclusãotag (solicitação):
retornar render (solicitação, "tag de inclusão.html ")

Modifique o urls.py arquivo do projeto Django e adicione o seguinte script. Depois de executar o servidor Django, se o caminho, inctag, será adicionado após o URL base, o includetag () a função será chamada a partir do arquivo de visualização. Esta função irá renderizar o tag de inclusão.html Arquivo. Este arquivo HTML irá carregar a tag de inclusão que chamará display_even_numbers () com argumentos. Esta função irá retornar uma lista de números pares com base nos valores dos argumentos e exibi-los no exibição.html Arquivo.

urls.py

# Caminho de importação
de django.caminho de importação de urls
# Importar visualização de inclusão de tag
da inclusãotagapp.visualizações importação tag de inclusão
# Defina o caminho para chamar a função de inclusão de tag da visualização
urlpatterns = [
caminho ('inctag', inclusãotag),
]

Agora, execute o seguinte comando para iniciar o servidor Django para verificar se o script acima está funcionando corretamente ou não.

$ python3 manage.py runserver

Execute o seguinte URL em qualquer navegador para verificar a saída deste aplicativo.

http: // localhost: 8000 / inctag

A seguinte saída aparecerá se os arquivos acima forem criados e funcionando corretamente. Existem 5 números pares entre 10 e 20, e estes foram exibidos na saída.

Conclusão:

Existem muitas funções no framework Django para criar diferentes tipos de tags personalizadas. Estes são simple_tag (), inclusão_tag () e ssignment_tag (). A função simple_tag () é usada para retornar string após o processamento dos dados. A função inclusão_tag () é usada para retornar um modelo após o processamento dos dados. A função assign_tag () é usada para definir uma variável após o processamento dos dados. A função inclusão_tag () foi mostrada neste tutorial que retornou um modelo renderizado após o processamento dos dados. Espero que este tutorial ajude o leitor a saber como usar a tag de inclusão no aplicativo Django.