A token field for Django
JavaScript Python Shell
Switch branches/tags
Nothing to show
Latest commit cd8098c Sep 24, 2011 @bradleyayers bradleyayers Input now displays outline when selected.
Variable tokens now lose focus when clicking outside.
Refactored token objects.
Permalink
Failed to load latest commit information.
django_tokenfield Input now displays outline when selected. Sep 23, 2011
docs Started adding some docs. Sep 22, 2011
example Started adding some docs. Sep 22, 2011
tests
.gitignore
LICENSE initial commit Sep 13, 2011
MANIFEST.in initial commit Sep 13, 2011
README.rst
setup.py Bumped to v0.1.0 Sep 16, 2011

README.rst

django-tokenfield - A token based form field+widget for Django

django-tokenfield provides a token based form field for Django. Its interface is very similar to the message recipient input on Facebook or iOS. It behaves as a normal text field but allows custom placeholders to be inserted at any position.

It allows normal string data that may contain predefined placeholder tokens.

One use-case is when you want to collect a "destination filename" for a set of records

It's original use was in a tool that allowed database records to be dumped to individual files.

Its features include:

Dependencies

  • knockout.js
  • jQuery

Using the field is as simple as:

from django_tokenfield import TokenField

class ArticleTemplate(forms.Form):
    title = TokenField()

import django_tables2 as tables

class SimpleTable(tables.Table):
    class Meta:
        model = Simple

This would then be used in a view:

def simple_list(request):
    queryset = Simple.objects.all()
    table = SimpleTable(queryset)
    return render_to_response("simple_list.html", {"table": table},
                              context_instance=RequestContext(request))

And finally in the template:

{% load django_tables2 %}
{% render_table table %}

This example shows one of the simplest cases, but django-tables2 can do a lot more! Check out the documentation for more details.

Building the documentation

If you want to build the docs from within a virtualenv, use:

make html SPHINXBUILD="python $(which sphinx-build)"