django-messages-ui

JS and HTML to support the Django contrib.messages app
Download

django-messages-ui Ranking & Summary

Advertisement

  • Rating:
  • License:
  • BSD License
  • Publisher Name:
  • Jonny Gerig Meyer
  • Publisher web site:
  • https://github.com/jgerigmeyer/

django-messages-ui Tags


django-messages-ui Description

JS and HTML to support the Django contrib.messages app django-messages-ui is a Django app that adds JS and HTML to support the Django contrib.messages app. It should be called on the message list element, and accepts options for message selectors, transient messages (that disappear on click or key-press), and close-links.Messages can be dynamically added via ICanHaz.js, and there's a Python middleware to automatically add messages from the request into Ajax JSON responses.Installation:In your Django project settings, add "messages_ui" to your INSTALLED_APPS.Usage:Linking the JS:< script src="{{ STATIC_URL }}messages_ui/jquery.messages-ui.js" >< /script >Including the default HTML Template:{% include "messages_ui/_messages.html" %}Calling the plugin:$('#messages').messages();Calling the plugin with a variety of options explicitly configured to their default values:$('#messages').messages({ message: '.message', // Selector for individual messages closeLink: '.close', // Selector for link to close message transientMessage: '.success', // Selector for transient messages transientDelay: 500, // Transient message fade delay (ms) transientFadeSpeed: 3000, // Transient message fade speed (ms) handleAjax: false // Enable automatic AJAX handling});Adding a message in JS (requires ICanHaz.js):$(ich.message({message: "Sample Message", tags: "info"}).appendTo( $('#messages'));To override the default JS template, add a message.html file to a directory listed in your ICANHAZ_DIRS setting (a django-icanhaz setting).AjaxTo enable automatic handling of messages from Ajax requests, add "messages_ui.middleware.AjaxMessagesMiddleware" to your MIDDLEWARE_CLASSES setting (directly after django.contrib.messages.middleware.MessageMiddleware), and pass handleAjax: true to the plugin initialization. Requirements: · Python · jQuery · jQuery doTimeout plugin · django-icanhaz · ICanHaz.js (optional) · Django What's New in This Release: · JS cleanup; added JSLint options.


django-messages-ui Related Software