{"id":573237,"date":"2025-06-05T03:49:07","date_gmt":"2025-06-05T02:49:07","guid":{"rendered":"https:\/\/blog.jetbrains.com\/?post_type=pycharm&p=573237"},"modified":"2025-06-05T03:49:16","modified_gmt":"2025-06-05T02:49:16","slug":"introducao-as-visualizacoes-do-django","status":"publish","type":"pycharm","link":"https:\/\/blog.jetbrains.com\/pt-br\/pycharm\/2025\/06\/introducao-as-visualizacoes-do-django\/","title":{"rendered":"Introdu\u00e7\u00e3o \u00e0s visualiza\u00e7\u00f5es do Django"},"content":{"rendered":"
\"\"<\/figure>\n

Visualiza\u00e7\u00f5es s\u00e3o centrais no padr\u00e3o de arquitetura do Django e \u00e9 essencial que qualquer desenvolvedor que trabalhe com esse framework tenha um s\u00f3lido dom\u00ednio de como trabalhar com elas. Se voc\u00ea for novato no desenvolvimento de aplicativos de Web com o Django ou simplesmente precisar recapitular as visualiza\u00e7\u00f5es, temos o que voc\u00ea precisa.\u00a0<\/p>\n

Compreender melhor as visualiza\u00e7\u00f5es ajudar\u00e1 voc\u00ea a progredir mais rapidamente no seu projeto com o Django. Quer voc\u00ea esteja trabalhando em um back-end de API ou em fluxos de interface de usu\u00e1rio na Web, \u00e9 crucial saber como usar as visualiza\u00e7\u00f5es.<\/p>\n

Continue lendo para descobrir o que s\u00e3o as visualiza\u00e7\u00f5es do Django, quais s\u00e3o os seus diferentes tipos e as melhores pr\u00e1ticas para se trabalhar com elas, e ver exemplos de casos de uso.<\/p>\n

O que s\u00e3o as visualiza\u00e7\u00f5es do Django?<\/h2>\n

As visualiza\u00e7\u00f5es s\u00e3o um componente central do padr\u00e3o de arquitetura MTV (“model-template-view”, “modelo-template-visualiza\u00e7\u00e3o”) do Django. Essencialmente, elas funcionam como intermedi\u00e1rias entre modelos<\/a> e templates<\/a>, processando as solicita\u00e7\u00f5es dos usu\u00e1rios e retornando respostas.<\/p>\n

Talvez voc\u00ea j\u00e1 tenha encontrado visualiza\u00e7\u00f5es no padr\u00e3o MVC (modelo-visualiza\u00e7\u00e3o-controlador). Por\u00e9m, essas visualiza\u00e7\u00f5es s\u00e3o ligeiramente diferentes das visualiza\u00e7\u00f5es do Django<\/a> e n\u00e3o t\u00eam uma correspond\u00eancia exata. As visualiza\u00e7\u00f5es do Django s\u00e3o essencialmente controladores no MVC, enquanto as templates do Django correspondem grosseiramente \u00e0s visualiza\u00e7\u00f5es do MVC. Isso torna vital compreender as nuances das visualiza\u00e7\u00f5es do Django, mesmo que voc\u00ea j\u00e1 esteja familiarizado com as visualiza\u00e7\u00f5es no contexto do MVC.<\/p>\n

No Django, as visualiza\u00e7\u00f5es s\u00e3o parte da interface de usu\u00e1rio e lidam com a l\u00f3gica e o processamento dos dados de solicita\u00e7\u00f5es de Web enviadas aos seus aplicativos e sites que usam o Django. Elas renderizam as suas templates no que o usu\u00e1rio v\u00ea quando visualiza a sua p\u00e1gina da Web. Cada visualiza\u00e7\u00e3o baseada em uma fun\u00e7\u00e3o ou classe recebe uma solicita\u00e7\u00e3o de um usu\u00e1rio, busca o dado em seus modelos, aplica a l\u00f3gica de neg\u00f3cios ou o processamento de dados e depois prepara e retorna uma resposta a uma template por HTTP.<\/p>\n

Essa resposta pode ser qualquer coisa que um navegador de Web possa mostrar e tipicamente \u00e9 uma p\u00e1gina em HTML. Por\u00e9m, as visualiza\u00e7\u00f5es do Django tamb\u00e9m podem retornar imagens, documentos em XML, redirecionamentos, p\u00e1ginas de erro e muito mais.<\/p>\n

Renderiza\u00e7\u00e3o e passagem de dados para templates<\/h2>\n

O Django fornece o atalho render()<\/code> para simplificar a renderiza\u00e7\u00e3o de templates de dentro das visualiza\u00e7\u00f5es. Esse atalho ajuda a evitar o c\u00f3digo repetitivo para carregar a template e criar a resposta manualmente.<\/p>\n

O PyCharm oferece complementa\u00e7\u00e3o inteligente do c\u00f3digo, que automaticamente sugere a fun\u00e7\u00e3o render()<\/code> de django.shortcuts<\/code> quando voc\u00ea come\u00e7a a digit\u00e1-la nas suas visualiza\u00e7\u00f5es. Ele tamb\u00e9m reconhece nomes de templates e fornece complementa\u00e7\u00e3o autom\u00e1tica em caminhos de templates, ajudando voc\u00ea a evitar erros de digita\u00e7\u00e3o e outros.<\/p>\n

O usu\u00e1rio fornece a solicita\u00e7\u00e3o, o nome da template e um dicion\u00e1rio de contexto, que alimentam a template com dados. Depois que os dados necess\u00e1rios forem obtidos, a visualiza\u00e7\u00e3o os passa para a template, onde eles podem ser renderizados e apresentados ao usu\u00e1rio.<\/p>\n

from django.shortcuts import render\n\ndef my_view(request):\n    # Some business logic to obtain data\n    data_to_pass = {'variable1': 'value1', 'variable2': 'value2'}\n\n    # Pass the data to the template\n    return render(request, 'my_template.html', context=data_to_pass)<\/pre>\n
Neste exemplo, data_to_pass<\/code> \u00e9 um dicion\u00e1rio que cont\u00e9m os dados que voc\u00ea deseja enviar para a template. Em seguida, a fun\u00e7\u00e3o render<\/code> \u00e9 usada para renderizar a template (my_template.html<\/code>) com os dados de contexto fornecidos.<\/p>\n
Agora voc\u00ea pode acessar e mostrar os dados na sua template (my_template.html<\/code>).<\/p>\n
\n\n    <\/pre>\n
{{ variable1 }}<\/h1>\n
{{ variable2 }}<\/p>\n
\n<\/pre>\n
Na template, voc\u00ea pode usar chaves duplas ({{ }}<\/code>) para indicar vari\u00e1veis de template, que ser\u00e3o substitu\u00eddas pelos valores dos dados de contexto passados pela visualiza\u00e7\u00e3o.<\/p>\n
O PyCharm<\/a> oferece complementa\u00e7\u00e3o e realce de sintaxe para tags, vari\u00e1veis e loops de templates do Django. Tamb\u00e9m oferece linting dentro do editor para erros comuns. Isso permite que voc\u00ea se concentre em criar as visualiza\u00e7\u00f5es e lidar com a l\u00f3gica, em vez de gastar tempo preenchendo manualmente os elementos da template ou depurando erros comuns.<\/p>\n
\"Complementa\u00e7\u00e3o<\/figure>\n
\n
Comece a usar o PyCharm Pro gratuitamente<\/a><\/div>\n<\/div>\n
Visualiza\u00e7\u00f5es baseadas em fun\u00e7\u00f5es<\/h2>\n
O Django tem dois tipos de visualiza\u00e7\u00f5es: baseadas em fun\u00e7\u00f5es e em classes.<\/p>\n
As visualiza\u00e7\u00f5es baseadas em fun\u00e7\u00f5es s\u00e3o criadas usando fun\u00e7\u00f5es simples em Python e geralmente se dividem em quatro categorias b\u00e1sicas: cria\u00e7\u00e3o, leitura (“read”), atualiza\u00e7\u00e3o (“update”) e exclus\u00e3o (“delete”) \u2014 CRUD. Esta \u00e9 a base de qualquer framework no desenvolvimento. Essas fun\u00e7\u00f5es recebem uma solicita\u00e7\u00e3o por HTTP e retornam uma resposta pelo mesmo protocolo.<\/p>\n
from django.http import HttpResponse\n\ndef my_view(request):\n\n    # View logic goes here\n    context = {\"message\": \"Hello world\"}\n\n    return HttpResponse(render(request, \"mytemplate.html\", context))<\/pre>\n
Este trecho de c\u00f3digo lida com a l\u00f3gica da visualiza\u00e7\u00e3o, prepara um dicion\u00e1rio de contexto para passar os dados a uma template renderizada e retorna o c\u00f3digo em HTML final da template em um objeto de resposta.<\/p>\n
Visualiza\u00e7\u00f5es baseadas em fun\u00e7\u00f5es s\u00e3o simples e diretas. A l\u00f3gica fica contida em uma \u00fanica fun\u00e7\u00e3o em Python, em vez de espalhada pelos m\u00e9todos de uma classe, tornando essas visualiza\u00e7\u00f5es as mais adequadas para casos de usos com muito pouco processamento.<\/p>\n
O PyCharm permite que voc\u00ea gere automaticamente a estrutura def my_view(request)<\/code> usando templates din\u00e2micas<\/a>. Essas templates s\u00e3o trechos predefinidos de c\u00f3digo que podem ser expandidos para c\u00f3digo reutiliz\u00e1vel. Esse recurso poupa tempo e garante uma estrutura consistente \u00e0s suas defini\u00e7\u00f5es de visualiza\u00e7\u00f5es.<\/p>\n
Para invocar templates din\u00e2micas, basta pressionar \u2318J<\/em>, digitar Listview<\/code> e pressionar a tecla TAB.\u00a0<\/p>\n
Visualiza\u00e7\u00f5es baseadas em classes<\/h2>\n
O Django introduziu as visualiza\u00e7\u00f5es baseadas em classes, para que os usu\u00e1rios n\u00e3o precisem escrever o mesmo c\u00f3digo repetidas vezes. Elas n\u00e3o substituem as visualiza\u00e7\u00f5es baseadas em fun\u00e7\u00f5es, mas t\u00eam certas aplica\u00e7\u00f5es e vantagens, especialmente em casos que requerem uma l\u00f3gica complexa.<\/p>\n
As visualiza\u00e7\u00f5es baseadas em classes do Django fornecem classes-pais reutiliz\u00e1veis que implementam diversos padr\u00f5es e recursos tipicamente necess\u00e1rios para visualiza\u00e7\u00f5es de aplicativos de Web. Voc\u00ea pode obter as suas visualiza\u00e7\u00f5es dessas classes-pais para reduzir o c\u00f3digo repetitivo.\u00a0<\/p>\n
As visualiza\u00e7\u00f5es baseadas em classes oferecem classes-pais gen\u00e9ricas, como:<\/p>\n