Bootbox.js: Dialogboxen per Bootstrap erstellen

Mit Twitters Bootstrap können die unterschiedlichsten Interface-Elemente für Webanwendungen erstellt werden. Buttons, Navigationen, Fortschrittsbalken – mit einer Mischung aus Stylesheets und JavaScript sind diese schnell eingerichtet und fertig gestaltet. Mit Bootbox.js, das auf Bootstrap aufbaut, erzeugt man passende Dialogboxen im Bootstrap-Stil.

Zwar lassen sich Dialogboxen auch ohne Bootbox.js erstellen, aber mit Boobox.js ist dies mit deutlich geringerem Aufwand verbunden. Wenige Zeilen JavaScript reichen aus.

Boots are made for walking… (Bildquelle: CFalk / pixelio.de)

Dialogboxen schnell gemacht

Will man eine Dialogbox nur mit Bootstrap realisieren, muss zunächst per HTML die Box inklusive Text und Button ausgezeichnet werden. Anschließend sind einige Zeilen JavaScript notwendig, um den HTML-Elementen die entsprechenden Funktionen zuweisen zu können. Mit Bootbox.js reicht eine einzige Zeile JavaScript aus, um eine fertige Dialogbox zu erhalten:

<script type="text/javascript>
  bootbox.alert("Dies ist eine einfache Dialogbox mit OK-Button.");
</script>

Einfacher Alert-Dialog

Damit Bootbox.js funktioniert, müssen einige JavaScript-Dateien im Header eingebunden werden. Neben der Bootbox.js müssen jQuery sowie das Modal-Plugin von Bootstrap eingebunden werden. Außerdem ist für das Aussehen der Boxen die Bootstrap-Stylesheet-Datei erforderlich:

<link rel="stylesheet" type="text/css" href="http://twitter.github.com/bootstrap/assets/css/bootstrap.css" />
<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script type="text/javascript" src="http://twitter.github.com/bootstrap/assets/js/bootstrap-modal.js"></script>

<script type="text/javascript" src="bootbox.js"></script>

Anschließend können Dialogboxen im Body des Dokumentes aufgerufen werden. Der einfache Alert-Dialog lässt sich auch mit einem individuell beschrifteten Button versehen:

<script type="text/javascript>
  bootbox.alert("Dies ist eine einfache Dialogbox mit individuellem Button.", "Bestätigen");
</script>

Verschiedene Dialogboxen möglich

Neben einfachen Alert-Dialogen können auch Boxen mit Confirm-Dialog erstellt werden, die zum Bestätigen oder Abbrechen einer Aktion auffordern. Für beide Buttons lassen sich Funktionen übergeben, die eine entsprechende Aktion ausführen:

<script type="text/javascript>
bootbox.confirm("Seitentitel ändern?", function(result) {
  if (result) {
    document.title = "Neuer Seitentitel";
  }
});
</script>

Auch hierbei kann die Beschriftung der beiden Buttons angepasst werden:

<script type="text/javascript>
bootbox.confirm("Seitentitel ändern?", "Nein", "Ja", function(result) {
  if (result) {
    document.title = "Neuer Seitentitel";
  }
});
</script>

Jenseits der Standardmöglichkeiten sind ganz individuelle Boxen mit beliebig vielen Buttons und Aktionen denkbar. Insgesamt gibt es vier unterschiedliche Klassen von Button: „primary“ für einfache Bestätigungsbuttons (standardmäßig blau), „success“ für positive bestätigende Aktionen (grün), „danger“ für ablehnende Aktionen (rot) sowie ein einfacher Button ohne besondere Hervorhebung.

Jedem Button lässt sich eine Klasse, eine Beschriftung sowie eine Funktion zuweisen:

<script>
bootbox.dialog("Ich möchte …", [
  {
    "label" : "Dr. Web besuchen",
    "class" : "btn-success",
    "callback": function() {
      location.href = "http://www.drweb.de/";
    }
  }, {
    "label" : "Google besuchen",
    "class" : "btn-danger",
    "callback": function() {
      location.href = "http://www.google.de/";
    }
  }, {
    "label" : "Abbrechen"
  }
]);
</script>

Individuelle Dialogbox

Wer das Layout der Dialogboxen anpassen möchte, sollte sich mit der „bootstrap.css“ auseinandersetzen. Dort ist das Layout für alle per Bootstrap erzeugten Interface-Elemente, inklusive der mit Bootbox.js erstellten Dialogboxen enthalten.

(dpe)