django-reverse-js 0.1.2

Django URL handling in JavaScript

Django Reverse JS

JavaScript url handling for Django that doesn’t hurt.

Original idea from django-js-reverse.

Django Reverse JS is a small django app that makes url handling of named urls in JavaScript easy and confortable for django's users.

For example you can retrieve a named url:

path('/betterliving/<str:category_slug>/<int:entry_pk>/', 'get_house', name='betterliving_get_house')

in JavaScript it can be resolved like:

Urls.betterlivingGetHouse('house', 12)
// '/betterliving/house/12/'

Installation

Install using pip

pip install django-reverse-js

… or clone the project from github.

git clone https://github.com/sevdog/django-reverse-js.git

Add 'django_reverse_js' to your INSTALLED_APPS setting.

INSTALLED_APPS = (
    ...
    'django_js_reverse',
)

Usage

As a static file

First generate static file with createstatic_reversejs command

django-admin createstatic_reversejs

NOTE: If you change some urls or add an app and want to update the reverse.js file by running again the command.

After this add the file to your template

<script src="{% static 'django_reverse_js/js/reverse.js' %}"></script>

As view

Include view in your URLCONF (you may also cache this is needed):

urlpatterns = [
    ...,
    path('reverse.js', 'django_reverse_js.views.urls_js', name='reverse_js'),
]

Then include JavaScript in your template

<script src="{% url 'reverse_js' %}" type="text/javascript"></script>

As template tag

You can place the reverse_js JavaScript inline into your templates, however use of inline JavaScript is not recommended, because it may cause problems with Content Security Policy. See django-csp for further readings.

{% load reversejs %}

<script type="text/javascript" charset="utf-8">
    {% reverse_js %}
</script>

---

Use the resolver in JavaScript

If your url names are valid JavaScript identifiers you can access them by the dot notation:

Urls.betterlivingGetHouse('house', 12)

If the named url contains invalid identifiers use the square-bracket notation instead:

NOTE: ATM namespaced urls must be accessd in this way

Urls['betterliving-get-house']('house', 12)
Urls['namespace:betterliving-get-house']('house', 12)

You can also pass javascript objects to match keyword aguments like the examples bellow:

Urls['betterliving-get-house']({ category_slug: 'house', entry_pk: 12 })
Urls['namespace:betterliving-get-house']({ category_slug: 'house', entry_pk: 12 })

Settings

• REVERSEJS_VAR_NAME: name given to JavaScript variable used to access django urls; default Urls.

• REVERSEJS_GLOBAL_OBJECT_NAME: global JavaScript object to which bound resolver variable; default window.

• REVERSEJS_EXCLUDE_NAMESPACES: list of url namespaces to be excluded from JavaScript resolver; default [] (aka: all namespaces allowed).

• REVERSEJS_INCLUDE_ONLY_NAMESPACES: list of url namespaces to be included in JavaScript resolver; default [] (aka: all namespaces allowed).

  • use '' (empty string) to allow only url without a namespace
  • use 'foo\0' (namespace name terminated with null-char) to include only urls from 'foo' namespace and prevent any inner namespace to be extracted (ie: 'foo:bar')

• REVERSEJS_SCRIPT_PREFIX: path of application (when served behing a reverse-proxy), needed to return full-urls; default None.

• REVERSEJS_OUTPUT_PATH: path where to place file created by createstatic_reversejs command, if not provided STATIC_ROOT is used; defatul None.

• REVERSEJS_MINIFY: flag which indicates if the minified version of JS script should be used; default False.

NOTE: at the moment only one between REVERSEJS_INCLUDE_ONLY_NAMESPACES and REVERSEJS_EXCLUDE_NAMESPACES may be used.