Versions

Description

****************** About this project ****************** The goal of this project is to create a new way of writing Django template tags which is fully compatible with the current Django templating infrastructure. This new way should be easy, clean and require as little boilerplate code as possible while still staying as powerful as possible. Features -------- * Class based template tags. * Template tag argument parser. * Declarative way to define arguments. * Supports (theoretically infinite) parse-until blocks. * Extensible! ***************** For the impatient ***************** This is how a tag looks like using django-classy-tags:: from classytags.core import Tag, Options from classytags.arguments import Argument from django import template register = template.Library() class Hello(Tag): options = Options( Argument('name', required=False, default='world'), 'as', Argument('varname', required=False, no_resolve=True) ) def render_tag(self, context, name, varname): output = 'hello %s' % name if varname: context[varname] = output return '' return output register.tag(Hello) That's your standard *hello world* example. Which can be used like this: * ``{% hello %}``: Outputs ``hello world`` * ``{% hello "classytags" %}``: Outputs ``hello classytags`` * ``{% hello as myvar %}``: Outputs nothing but stores ``hello world`` into the template variable ``myvar``. * ``{% hello "my friend" as othervar %}``: Outputs nothing but stores ``hello my friend`` into the template variable ``othervar``.

Repository

git://github.com/ojii/django-classy-tags.git

Project Slug

django-classy-tags

Last Built

4 years, 1 month ago passed

Maintainers

Home Page

http://github.com/ojii/django-classy-tags

Badge

Tags

django, classytags, class-based-tags, template-tags

Short URLs

django-classy-tags.readthedocs.io
django-classy-tags.rtfd.io

Default Version

latest

'latest' Version

master