在 Django 模板中为 django-widget-tweaks 的 {% render_field %} 动态注入含连字符（如 hx-vals）和内嵌 JSON（如 {"country": this.value}）的 HTML 属性时，直接书写会导致模板解析错误；本文提供无需上下文预传、纯模板侧解决的标准化方案。
在 django 模板中为 `django-widget-tweaks` 的 `{% render_field %}` 动态注入含连字符（如 `hx-vals`）和内嵌 json（如 `{"country": this.value}`）的 html 属性时，直接书写会导致模板解析错误；本文提供无需上下文预传、纯模板侧解决的标准化方案。
Django 模板引擎在解析 {% render_field field hx-vals='{"country": this.value}' %} 时，会将花括号 {} 视为变量语法分隔符（如 {{ variable }}），导致解析失败——这不是“转义”问题，而是模板语法层级冲突：Django 不允许在标签参数中直接嵌入未受控的 JSON 字面量或含 - 的属性名作为键值对。
✅ 正确解法是 分离结构与数据，利用 Django 内置过滤器组合构造合法属性值：
1. 使用 json_script + 前端 JS（推荐，语义清晰、安全可靠）
<!-- 在模板中 -->
{% render_field field
hx-get="{% url 'subdivisions' 'placeholder' %}"
hx-trigger="change"
hx-target="#id_principal_subdivision"
hx-swap="outerHTML"
hx-include="#id_country"
%}
<!-- 配合一个不可见的 JSON 数据块 -->
{{ form.country.value|json_script:"hx-vals-data" }}
<script>
document.addEventListener('htmx:configRequest', function(evt) {
const countryVal = document.getElementById('id_country').value;
const dataEl = document.getElementById('hx-vals-data');
const baseData = dataEl ? JSON.parse(dataEl.textContent) : {};
evt.detail.headers['HX-Vals'] = JSON.stringify({
...baseData,
country: countryVal
});
});
</script>
✅ 优势：完全规避模板解析限制；支持动态
this.value；JSON 自动转义防 XSS；符合 HTMX 最佳实践。
2. 纯模板方案：用 add / stringformat 构造 JSON 字符串（适用于静态/简单场景）
{% with hx_vals='"country": "'|add:form.country.value|add:'"' %}
{% render_field field
hx-vals='{'|add:hx_vals|add:'}'
hx-get="/api/subdivisions/"
hx-trigger="change"
%}
{% endwith %}
⚠️ 注意：此方式不推荐用于用户输入内容（存在 JSON 注入风险），仅适用于可信字段（如枚举 ID）。若需处理任意字符串，请改用 json_script 方案。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
3. 关于 URL 中占位符的优化写法
原答案中用 cut+add 处理 URL 是冗余且易错的。应直接使用 url 模板标签的命名参数：
<!-- ✅ 清晰、安全、可读 -->
{% url 'subdivisions' country="PLACEHOLDER" as base_url %}
{% with base_url|add:"?country="|add:form.country.value as hx_get_url %}
{% render_field field hx-get=hx_get_url hx-trigger="change" %}
{% endwith %}
或更简洁地（Django 4.1+ 支持 url 标签内联表达式）：
{% render_field field
hx-get="{% url 'subdivisions' country=form.country.value %}"
hx-trigger="change"
%}
总结
- ❌ 避免在
{% render_field %}参数中硬编码含{}或-的 JSON 字符串； - ✅ 优先采用
json_script+ JavaScript 动态注入，兼顾安全性与灵活性； - ✅ 模板内构造 JSON 仅限高度可控场景，并确保值已通过
escapejs过滤（如{{ value|escapejs }}）； - ✅ URL 构造始终使用
{% url %}标签，而非字符串拼接。
这样既保持视图逻辑纯净，又让模板具备现代前端交互能力，真正实现 HTMX 与 Django 的无缝协同。
