DOM Helper¶

dom_id¶

dom_id is a helper method that returns a unique DOM ID based on the object’s class name and ID

{% load turbo_helper %}

{% dom_id instance %}               ->  task_1
{% dom_id instance 'detail' %}      ->  detail_task_1
{% dom_id Task %}                   ->  new_task

  1. dom_id first argument can be string, instance or Model class

  2. dom_id second argument is optional string that will be used as prefix.

  3. The dom_id can help make the id generation behavior consistent across the project, and save our time to update it in turbo-stream or turbo-frame element.

  4. You can also use it in your Django view code.

Use in Django view

from turbo_helper import dom_id

target = dom_id(instance, "detail_container")

class_names¶

Inspired by JS classnames and Rails class_names

class_names can help conditionally render css classes

<div class="{% class_names test1=True 'test2' ring-slate-900/5=True already-sign-in=request.user.is_authenticated %}"></div>

'<div class="test1 test2 ring-slate-900/5 dark:bg-slate-800 %}"></div>'

It can also work well with TailwindCSS’s some special css char such as / and :