js客户端消息插件,支持djangocontrib.messages应用程序
django-messages-ui的Python项目详细描述
jquery django消息ui
js客户端消息插件,支持django contrib.messages应用程序
入门
django消息ui可以用作添加和 删除客户端消息,或作为django附加组件以附加支持 django contrib.messages应用程序。应该在消息列表中调用它 元素,并接受消息选择器、临时消息(即 单击或按键后消失),然后关闭链接。信息本身 应该使用css样式。
消息可以通过 handlebars.js 、 icanhaz.js 或任何 创建预编译可调用模板fn的其他模板引擎。如果 作为django插件,有一个python中间件可以自动添加 从请求到ajax json响应的消息。
依赖关系
- jquery 库
- jquery-dotimeout 插件
- (可选)把手.runtime.js1.0.0
- (可选)icanhaz js.js icanhaz.js
- (可选)django icanhaz django icanhaz 0.2.0+
作为独立jquery插件安装
如果作为独立的jquery插件使用,请下载生产版本 开发版本,以及 handlebars.js预编译模板 或 icanhaz.js模板
链接js:
<script src="dist/django-messages-ui.min.js"></script>
如果需要,还包括预编译的js模板
<script src="messages_ui/static/messages_ui/message.js"></script>
要重写默认的js模板,请传递您自己的预编译模板函数 作为选项 模板
如果使用icanhaz js.js icanhaz.js ,请包装icanhaz.js模板(或您自己的自定义 模板,如果您不想使用默认模板)在脚本中 id="message" type="text/html">; 标记并将其包含在HTML中,或者导入它 在js中使用铃声)<。然后通过 预编译模板: 模板:ich.message
使用django安装
如果与django一起使用,只需安装django消息ui(或 从pypi下载tarball,解压并运行python setup.py 安装)。在Django项目设置中,向 已安装的应用程序设置。
链接js:
<script src="{% static 'messages_ui/django-messages-ui.js' %}"></script>
如果需要,还包括预编译的js模板:
<script src="{% static 'messages_ui/message.js' %}"></script>
如果使用icanhaz js.js在客户端插入消息,请使用此模板 相反,并传入预编译的模板: 模板:ich.message :
{% include "messages_ui/_messages_ich.html" %}
要重写默认的js模板,请传递您自己的预编译模板函数 作为选项 模板
ajax
要启用对来自ajax请求的消息的自动处理,请添加 "消息ui.middleware.ajaxMessagesMiddleware" 发送到 中间件类 设置(直接在 django.contrib.messages.middleware.messagemiddleware ,并传递 handleajax:true 到插件初始化。
< div >警告
ajaxMessagesMiddleware 将所有HTML AJAX响应转换为JSON 使用 消息 键和嵌入在 HTML中的HTML的响应 关键。如果您的站点使用html-ajax响应,这可能需要 更新站点中的其他ajax处理代码。为了避免这个 特定响应,将该响应上的属性设置为 真的 在它通过AjaxMessagesMiddleware之前
类似地, handleajax:true 全局设置所需的默认值 ajax请求的数据类型 "json"