logo
  • Proces
  • Case studies
  • Blog
  • O nas
Napisz do nas
  1. Strona główna

  2. /

    Blog

  3. /

    Customowe template tags w Django

Customowe template tags w Django

fullstack

2 minuty czytania

Tomasz Kozon

13 lip 2023

djangohtml5python

Template tags to świetne narzędzie pozwalające na manipulację danymi z poziomu template'ów w aplikacjach opartych o framework Django. Dużo z nich jest już wbudowanych we framework i gotowych do użytku, jednak czasem potrzebna jest customowa funkcjonalność.

Spis treści

Plusy i minusy - dobre praktyki

Po co nam customowe template tagi?

Deklaracja

Typy tagów

Podsumowanie

komputer, template tags w Django

Powiązane case studies

SAO Life - aplikacja lojalnościowa dla klientów marki premium

Mobile development, Web development

Kwant - e-commerce dla ogólnopolskiej sieci hurtowni

Web development, E-commerce, Body leasing

Pokaż wszystkie case study

Umów się na bezpłatną konsultację

Twoje dane przetwarzamy zgodnie z naszą polityką prywatności.

Plusy i minusy - dobre praktyki

Podstawowe template tagi dostępne w Django to np. autoescape, który przeciwdziała traktowaniu wartości typu string jako elementów HTML, czy comment, który sprawia, że napisana część template'u jest ignorowana.  Mamy też takie funkcje jak lower, safe, if, for. Pierwsze co rzuca się w oczy to prostota tych funkcjonalności. I właśnie na to powinniśmy uważać. Zamysł template tagów zawiera w sobie prostotę działania - template nie powinien zawierać zbyt skomplikowanej logiki - za dostarczenie odpowiedniego kontekstu odpowiedzialny jest widok sam w sobie, template jest jedynie warstwą wizualną.

 

Czy szukasz wykonawcy projektów IT ?
logo
Sprawdź case studies

Po co nam customowe template tagi?

To akurat bardzo proste. Załóżmy że chcemy dokonać konkatenacji dwóch wartości w sposób, który będzie godny zaufania. Django posiada tag pod nazwą add, jednak używanie go w ten sposób jest ryzykowne, ponieważ framework NAJPIERW spróbuje potraktować wartości jako liczby (cast na int), a dopiero PÓŹNIEJ jako stringi. 

 

Deklaracja

Tagi definiujemy jako pythonowe funkcje z argumentami zależnymi od typu tagu. Rejestrujemy je odpowiednim dekoratorem zaimportowanym z Django, a następnie definiujemy co mają zwracać. Wszystko zachodzi w pliku o dowolnej nazwie zawartym w folderze templatetags naszej aplikacji. Generyczny przykład wygląda tak:

 

from django import template

register = template.Library()

@register.<typ tagu>(<...opcje>)
def <nazwa tagu>(<...argumenty>):
    <...operacje>
    return <zwracana wartosc>

 

Typy tagów

Mamy kilka typów tagów: filtry, simple tagi i inclusion tagi. Każdy z nich służy do czegoś innego.  Filtry służą do dokonywania operacji na wartościach, definiujemy je tak:

 

@register.filter
def example_filter(value):
	return f"{value} with filter applied"

 

Ten tag zwraca wartość z dopiskiem "with filter applied". Oczywiście tylko od nas zależy co taka funkcja zwróci. Wewnątrz template'u składnia będzie taka:

 

{% load <nazwa pliku z naszym tagiem> %}
{{ some_value|example_filter }}

 

Mamy też simple tag, który dokonuje operacji na wielu przekazanych wartościach i zwraca wynik, wygląda to tak:

 

@register.simple_tag(takes_context=<bool>)
def example_simple_tag(*args):
	return sum(args)

 

Opcja takes_context umożliwia przekazanie kontekstu template'u jako pierwszy argument. W tym przykładzie tag przyjmuje nieograniczoną ilość argumentów nienazwanych i zwraca ich sumę. Przykład użycia:

 

{% load <nazwa pliku z tagiem> %}
{% example_simple_tag 46 11 5 39 %}

 

Następnym typem tagu jest inclusion tag. Służy on do injectowania sub-template'ów z plików, przekazując im różne dane. Służy on do zbudowania struktury modułowej naszych widoków, aby uniknąć powtarzania kodu, w myśl zasady DRY.  Tworzymy go tak:

 

@register.inclusion_tag("<nazwa pliku>.html")
def example_inclusion_tag(data):
	return {
		"some_data": data
	}

 

W tym przypadku przyjmujemy jeden argument i przekazujemy go templateo'wi z podanego pliku w kontekście pod nazwą "some_data". Skutkiem tego w naszym template <nazwa pliku>.html jesteśmy w stanie dostać się do podanej wartości używając {{ some_data }}. Użycie tego tagu wygląda w ten sposób:

 

{% load <nazwa pliku z tagiem> %}
{% example_inclusion_tag data=5 %}

 

Podsumowanie

To są podstawy podstaw customowych template tagów w Django. Zawsze warto zajrzeć do dokumentacji frameworka aby uzyskać więcej informacji. Template tagi to świetne narzędzia, dające dużą wygodę developerom piszącym template'y.

Nasza oferta

Web development

Dowiedz się więcej

Mobile development

Dowiedz się więcej

E-commerce

Dowiedz się więcej

Projektowanie UX/UI

Dowiedz się więcej

Outsourcing

Dowiedz się więcej

SEO

Dowiedz się więcej

Powiązane artykuły

Czym jest BMS? Podstawy systemów zarządzania budynkami

15 lip 2025

Systemy zarządzania budynkami (BMS) stają się nieodzownym elementem nowoczesnej infrastruktury, umożliwiając inteligentne sterowanie instalacjami technicznymi w obiektach komercyjnych, przemysłowych i mieszkalnych. Dzięki BMS możliwe jest centralne monitorowanie, automatyzacja i optymalizacja działania takich systemów jak ogrzewanie, wentylacja, oświetlenie czy bezpieczeństwo. Rozwiązania te nie tylko zwiększają komfort i bezpieczeństwo użytkowników, ale także pozwalają na znaczną redukcję kosztów operacyjnych i zużycia energii.

Tomasz Kozon
#embedded
related-article-image-dom, BMS (Building Management System)

Browserling – testowanie stron internetowych w każdej przeglądarce

13 lip 2025

Tworzenie stron internetowych to dopiero połowa sukcesu – równie ważne jest ich poprawne działanie w różnych przeglądarkach i systemach. Różnice w silnikach renderujących sprawiają, że ten sam kod może wyglądać i działać inaczej w Chrome, Safari czy Internet Explorerze. Dlatego testy cross-browser to niezbędny etap w procesie tworzenia nowoczesnych witryn. Jednym z narzędzi, które znacząco ułatwia to zadanie, jest Browserling – prosta, ale bardzo skuteczna platforma do testowania online.

Tomasz Kozon
#testing

Apache MXNet: Dlaczego warto poznać to narzędzie do głębokiego uczenia?

8 lip 2025

Apache MXNet jest dynamicznym, wydajnym i łatwym w użyciu narzędziem do głębokiego uczenia, które umożliwia precyzyjne tworzenie, szkolenie i wyznaczanie modeli uczenia maszynowego. Oferta wszechstronnych funkcji i elastyczności MXNet przekłada się na dostosowanie do różnych scenariuszy. Warto poznać ten potężny tool AI.

Tomasz Kozon
#ai

ButterCMS: Czym jest i dlaczego warto z niego skorzystać?

6 lip 2025

ButterCMS to nowoczesny headless CMS, który pozwala tworzyć i zarządzać treściami w sposób szybki, elastyczny i niezależny od warstwy front-endowej. Dzięki temu programiści mogą budować aplikacje i strony internetowe w dowolnych technologiach, a marketerzy zyskują wygodne narzędzie do publikacji treści. System świetnie sprawdza się zarówno w małych projektach, jak i w dużych serwisach wymagających skalowalności i integracji z innymi rozwiązaniami.

Tomasz Kozon
#fullstack

Light Table – lekki, interaktywny edytor kodu

8 cze 2025

Coś, co wywołuje furorę w świecie IT, to Light Table - lekki i interaktywny edytor kodu zyskujący coraz większą popularność. Jego nowatorskie podejście do programowania, które łączy prostotę i interaktywność, zrewolucjonizowało sposób, w jaki myślimy o tworzeniu kodu. Zapraszam do przeczytania reszty artykułu, aby dowiedzieć się więcej o tym, dlaczego Light Table jest nazywany przyszłością programowania.

Tomasz Kozon
#fullstack

Neovim - edytor kodu. Dlaczego warto mu szansę?

22 maj 2025

Neovim to rewolucja wśród edytorów kodu, łącząca sprawdzone rozwiązania z nowoczesnymi technologiami. Daje nam komfort pracy znanego z Vim dostosowany do wymagań XXI wieku. Czy Neovim to naprawdę next-level kodowania? Pozwól, że Ci to wyjaśniamy i przekonaj się sam, dlaczego warto dać mu szansę.

Tomasz Kozon
#fullstack

Appwrite: wielofunkcyjna platforma do tworzenia aplikacji Backend-as-a-Service

9 maj 2025

Przygoda z tworzeniem aplikacji nigdy nie była prostsza, dzięki Appwrite - nowoczesnej, wielofunkcyjnej platformie Backend-as-a-Service. Co sprawia, że Appwrite wyróżnia się na tle innych rozwiązań typu BaaS? Czy dostosowana do potrzeb developerów funkcjonalność to klucz do sukcesu? Sprawdźmy.

Tomasz Kozon
#back-end

Zobacz wszystkie artykuły powiązane z #fullstack

Boring Owl Logo

Napisz do nas

Zadzwoń

+48 509 280 539

Oferta

  • Web Development

  • Mobile Development

  • UI/UX Design

  • E-commerce

  • Outsourcing

  • SEO

Menu

  • O nas

  • Case studies

  • FAQ

  • Blog

  • Kariera

  • Kontakt

Software House

  • Software House Warszawa

  • Software House Katowice

  • Software House Lublin

  • Software House Kraków

  • Software House Wrocław

  • Software House Łódź

 

  • Software House Poznań

  • Software House Gdańsk

  • Software House Białystok

  • Software House Gliwice

  • Software House Trójmiasto

Agencje SEO

  • Agencja SEO Warszawa

  • Agencja SEO Kraków

  • Agencja SEO Wrocław

  • Agencja SEO Poznań

  • Agencja SEO Gdańsk

  • Agencja SEO Toruń

© 2025 – Boring Owl – Software House Warszawa

  • adobexd logo
    adobexd
  • algolia logo
    algolia
  • amazon-s3 logo
    amazon-s3
  • android logo
    android
  • angular logo
    angular
  • api logo
    api
  • apscheduler logo
    apscheduler
  • argocd logo
    argocd
  • astro logo
    astro
  • aws-amplify logo
    aws-amplify
  • aws-cloudfront logo
    aws-cloudfront
  • aws-lambda logo
    aws-lambda
  • axios logo
    axios
  • azure logo
    azure
  • bash logo
    bash
  • bootstrap logo
    bootstrap
  • bulma logo
    bulma
  • cakephp logo
    cakephp
  • celery logo
    celery
  • chartjs logo
    chartjs
  • clojure logo
    clojure
  • cloudflare logo
    cloudflare
  • cloudinary logo
    cloudinary
  • cms logo
    cms
  • cobol logo
    cobol
  • contentful logo
    contentful
  • coolify logo
    coolify
  • cpython logo
    cpython
  • css3 logo
    css3
  • django logo
    django
  • django-rest logo
    django-rest
  • docker logo
    docker
  • drupal logo
    drupal
  • dynamodb logo
    dynamodb
  • elasticsearch logo
    elasticsearch
  • electron logo
    electron
  • expo-io logo
    expo-io
  • express-js logo
    express-js
  • fakerjs logo
    fakerjs
  • fastapi logo
    fastapi
  • fastify logo
    fastify
  • figma logo
    figma
  • firebase logo
    firebase
  • flask logo
    flask
  • flutter logo
    flutter
  • gatsbyjs logo
    gatsbyjs
  • ghost-cms logo
    ghost-cms
  • google-cloud logo
    google-cloud
  • graphcms logo
    graphcms
  • graphql logo
    graphql
  • groovy logo
    groovy
  • gtm logo
    gtm
  • gulpjs logo
    gulpjs
  • hasura logo
    hasura
  • headless-cms logo
    headless-cms
  • heroku logo
    heroku
  • html5 logo
    html5
  • httpie logo
    httpie
  • i18next logo
    i18next
  • immutablejs logo
    immutablejs
  • imoje logo
    imoje
  • ios logo
    ios
  • java logo
    java
  • javascript logo
    javascript
  • jekyll logo
    jekyll
  • jekyll-admin logo
    jekyll-admin
  • jenkins logo
    jenkins
  • jquery logo
    jquery
  • json logo
    json
  • keras logo
    keras
  • keystone5 logo
    keystone5
  • kotlin logo
    kotlin
  • kubernetes logo
    kubernetes
  • laravel logo
    laravel
  • lodash logo
    lodash
  • magento logo
    magento
  • mailchimp logo
    mailchimp
  • material-ui logo
    material-ui
  • matlab logo
    matlab
  • maven logo
    maven
  • miro logo
    miro
  • mockup logo
    mockup
  • momentjs logo
    momentjs
  • mongodb logo
    mongodb
  • mysql logo
    mysql
  • nestjs logo
    nestjs
  • net logo
    net
  • netlify logo
    netlify
  • next-js logo
    next-js
  • nodejs logo
    nodejs
  • npm logo
    npm
  • nuxtjs logo
    nuxtjs
  • oracle logo
    oracle
  • pandas logo
    pandas
  • php logo
    php
  • postgresql logo
    postgresql
  • postman logo
    postman
  • prestashop logo
    prestashop
  • prettier logo
    prettier
  • prisma logo
    prisma
  • prismic logo
    prismic
  • prose logo
    prose
  • pwa logo
    pwa
  • python logo
    python
  • python-scheduler logo
    python-scheduler
  • rabbitmq logo
    rabbitmq
  • react-flow logo
    react-flow
  • react-hook-form logo
    react-hook-form
  • react-js logo
    react-js
  • react-native logo
    react-native
  • react-query logo
    react-query
  • react-static logo
    react-static
  • redis logo
    redis
  • redux logo
    redux
  • redux-persist logo
    redux-persist
  • redux-saga logo
    redux-saga
  • redux-thunk logo
    redux-thunk
  • relume logo
    relume
  • restful logo
    restful
  • ruby-on-rails logo
    ruby-on-rails
  • rust logo
    rust
  • rxjs logo
    rxjs
  • saleor logo
    saleor
  • sanity logo
    sanity
  • scala logo
    scala
  • scikit-learn logo
    scikit-learn
  • scrapy logo
    scrapy
  • scrum logo
    scrum
  • selenium logo
    selenium
  • sentry logo
    sentry
  • shodan logo
    shodan
  • shopify logo
    shopify
  • slack logo
    slack
  • sms-api logo
    sms-api
  • socket-io logo
    socket-io
  • solidity logo
    solidity
  • spring logo
    spring
  • sql logo
    sql
  • sql-alchemy logo
    sql-alchemy
  • storyblok logo
    storyblok
  • storybook logo
    storybook
  • strapi logo
    strapi
  • stripe logo
    stripe
  • structured-data logo
    structured-data
  • struts logo
    struts
  • styled-components logo
    styled-components
  • supabase logo
    supabase
  • svelte logo
    svelte
  • swagger logo
    swagger
  • swift logo
    swift
  • symfony logo
    symfony
  • tailwind-css logo
    tailwind-css
  • tensorflow logo
    tensorflow
  • terraform logo
    terraform
  • threejs logo
    threejs
  • twig logo
    twig
  • typescript logo
    typescript
  • vercel logo
    vercel
  • vue-js logo
    vue-js
  • webflow logo
    webflow
  • webpack logo
    webpack
  • websocket logo
    websocket
  • woocommerce logo
    woocommerce
  • wordpress logo
    wordpress
  • yarn logo
    yarn
  • yii logo
    yii
  • zend logo
    zend
  • zeplin logo
    zeplin
  • zustand logo
    zustand