Jump To …

alert.coffee

Copyright 2012-2013 The Apache Software Foundation

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http:#www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

t5/core/alert

Support for the core/Alerts components.

define ["./dom", "./console", "./messages", "./ajax", "underscore", "./bootstrap"],
  (dom, console, messages, ajax, _, {glyph}) ->

    severityToClass =
      info: "alert-info"
      success: "alert-success"
      warn: "alert-warning"
      error: "alert-danger"

    getURL = (container) -> container.attr "data-dismiss-url"

    removeAlert = (container, alert) ->
      alert.remove()

      if container.find(".alert").length is 0
        container.update null

    dismissAll = (container) ->

      alerts = container.find "[data-alert-id]"

      if alerts.length is 0
        container.update null
        return

      ajax (getURL container),
        success: -> container.update null

    dismissOne = (container, button) ->

      alert = button.parent()

      id = alert.attr "data-alert-id"

      unless id
        removeAlert container, alert
        return

      ajax (getURL container),
        data: { id }
        success: -> removeAlert container, alert

    setupUI = (outer) ->

      outer.update """
        <div data-container-type="inner"></div>
      """

      if (outer.attr "data-show-dismiss-all") is "true"
        outer.append """
         <div class="pull-right">
            <button class="btn btn-xs btn-default" data-action="dismiss-all">
              #{glyph "remove"}
              #{messages "core-dismiss-label"}
            </button>
          </div>
         """

      outer.on "click", "[data-action=dismiss-all]", ->
        dismissAll outer
        return false

      outer.on "click", "button.close", ->
        dismissOne outer, this
        return false

    findInnerContainer = ->
      outer = dom.body.findFirst "[data-container-type=alerts]"

      unless outer
        console.error "Unable to locate alert container element to present an alert."
        return null

Set up the inner content when needed

      unless outer.element.firstChild
        setupUI outer

      return outer?.findFirst "[data-container-type=inner]"

The data for the alert has a number of keys to control its behavior:

  • severity - used to determine the CSS class, may be "warn", "error", or "info" (the default)
  • message - message to display to as te alert's body
  • markup - if true, then the message contains markup that should not be HTML escaped
    alert = (data) ->

      container = findInnerContainer()

      return unless container

Map from severity name to a CSS class; using alert-info if no severity, or unknown severity

      className = severityToClass[data.severity] or "alert-info"

      content = if data.markup then data.message else _.escape data.message

Note that data-dismiss=alert is purposely excluded - we want to handle closes w/ notifications to the server if not transient - we don't want to rely on bootstrap.js, as that will drag jQuery into the application Also, the tag makes it easier to pull out just the content when doing tests, but we only add this add if the alert doesn't have a message that contains markup (TAP5-1863)

      element = dom.create "div",
        "data-alert-id": data.id
        class: "alert alert-dismissable " + className
        if data.markup
          """
            <button type="button" class="close">&times;</button>
            #{content}
            """
        else
          """
            <button type="button" class="close">&times;</button>
            <span>#{content}</span>
            """

      container.append element

      if data['transient']
        outerContainer = container.findParent '[data-container-type=alerts]'
        _.delay removeAlert, exports.TRANSIENT_DURATION, outerContainer, element

    alert.TRANSIENT_DURATION = 5000

Export the alert function

    exports = alert