0Pricing
Django Academy · Aula

ImageField e disponibilização de uploads

Lide com imagens e vincule à mídia no desenvolvimento

ImageField e disponibilização de uploads é uma aula grátis de Django Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Django Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Django Academy inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

Why ImageField

For pictures, use ImageField instead of FileField. It works the same but adds image-specific checks and helpers on top.

avatar = models.ImageField(upload_to='avatars/')

Pillow Is Required

ImageField depends on the Pillow library to read images. Install it first or migrations will refuse to run. 🖼️

pip install Pillow

Validation Built In

ImageField verifies an upload is a real image. A renamed .txt file gets rejected during form validation automatically.

Width and Height

Set width_field and height_field and Django records each image's dimensions into those columns on save.

photo = models.ImageField(
    upload_to='pics/',
    height_field='h', width_field='w')

Display the Image

In a template, point an img tag at the field's .url to render the stored picture for the user.

<img src="{{ profile.avatar.url }}" alt="avatar">

Guard the URL

Calling .url on an empty field raises an error. Wrap it in an if check so missing images do not crash your page.

{% if profile.avatar %}
  <img src="{{ profile.avatar.url }}">
{% endif %}

Provide a Default

Give the field a default image path so users without an upload still see a placeholder avatar.

models.ImageField(default='avatars/blank.png')

Serving in Dev

Django will not serve media on its own. In development, add a route from MEDIA_URL to MEDIA_ROOT in your project urls.

urlpatterns += static(
    settings.MEDIA_URL,
    document_root=settings.MEDIA_ROOT)

Only When DEBUG

That media helper is for development only. In production a real web server serves uploads, so guard the route with a DEBUG check.

if settings.DEBUG:
    urlpatterns += static(...)

Production Serving

In production let Nginx or a storage service like S3 serve media directly. Routing every image through Django would be slow.

Thumbnails Later

Need resized versions? Libraries like django-imagekit generate thumbnails on top of ImageField when you are ready.

Quick Check

Let us check what ImageField needs to function.

Recap

You learned that ImageField needs Pillow, validates real images, exposes .url for display, and that production should serve media outside Django. 🎉

Perguntas Frequentes

A aula “ImageField e disponibilização de uploads” é grátis?

Sim — o texto completo de “ImageField e disponibilização de uploads” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Django Academy, atualize para CoddyKit PRO. O curso de Django Academy inclui 4 aulas no total.

O que vou aprender em “ImageField e disponibilização de uploads”?

Lide com imagens e vincule à mídia no desenvolvimento Você pratica Django Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Django Academy?

Nenhuma experiência prévia é necessária. Django Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “ImageField e disponibilização de uploads”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Django Academy?

Sim. Cada aula de Django Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. STATICFILES e a tag static
  2. collectstatic para produção
  3. MEDIA_ROOT e uploads de arquivos
  4. ImageField e disponibilização de uploads
← Voltar para Django Academy