Zum Hauptinhalt springen

API Übersicht

Kanban Konstruktor

new kanban.Kanban("#root", {
// Konfigurationsparameter
});

Parameter:

  • der HTML-Container (die ID des Containers)
  • ein Objekt mit Konfigurationsparametern (Details hier)

Toolbar Konstruktor

new kanban.Toolbar("#toolbar", {
// Konfigurationsparameter
});

Parameter:

  • der HTML-Container (die ID des Containers)
  • ein Objekt mit Konfigurationseinstellungen (Details hier)

Kanban Methoden

NameBeschreibung
addCard()Fügt eine neue Karte in das Kanban-Board ein
addColumn()Fügt dem Kanban-Board eine neue Spalte hinzu
addComment()Fügt einen neuen Kommentar in die angegebene Karte mittels ihrer ID ein.
addLink()Fügt ein neues Link-Element in das Kanban-Board ein.
addRow()Fügt dem Kanban-Board eine neue Zeile hinzu
deleteCard()Löscht eine bestimmte Karte aus dem Kanban-Datenspeicher.
deleteColumn()Löscht eine angegebene Spalte aus dem Kanban-Datenspeicher.
deleteComment()Entfernt einen Kommentar von einer Karte anhand seiner ID
deleteLink()Löscht den angegebenen Link aus dem Kanban-Datenspeicher.
deleteRow()Löscht die angegebene Zeile aus dem Kanban-Datenspeicher.
destructor()Löscht alle HTML-Elemente des Kanban-Boards und entfernt alle zugehörigen Ereignishandler.
duplicateCard()Erstellt eine Kopie einer Karte basierend auf der angegebenen ID
getAreaCards()Ruft ein Array mit Datenobjekten aller Karten in der angegebenen Spalte (und Zeile) ab.
getCard()Ruft das Datenobjekt einer Karte anhand ihrer angegebenen ID ab
getSelection()Gibt ein Array mit der ID bzw. den IDs der ausgewählten Karte(n) zurück
moveCard()Verschiebt eine Karte in eine angegebene Spalte (und Zeile).
moveColumn()Verschiebt eine Spalte an eine neue Position innerhalb des Boards.
moveRow()Verschiebt eine Zeile an eine neue Position innerhalb des Boards.
parse()Lädt Daten in das Kanban-Board
redo()Führt die Aktion erneut aus, die durch die undo Methode rückgängig gemacht wurde
scroll()Bewegt die Kanban-Ansicht zu einem bestimmten Element
selectCard()Markiert eine Karte basierend auf der angegebenen ID.
serialize()Wandelt die Kanban-Daten in ein JSON-Format um.
setConfig()Aktualisiert das Kanban mit neuen Konfigurationseinstellungen
setEdit()Schaltet den Kanban-Karten-Editor ein oder aus
setLocale()Setzt eine neue Lokalisierung für die Kanban-Komponente
setSearch()Findet Karten basierend auf den angegebenen Suchkriterien
setSort()Sortiert Karten basierend auf den angegebenen Kriterien
setTheme()Wendet dynamisch ein neues Theme auf das Kanban-Board an (initialisiert es neu).
undo()Macht die letzte Operation im Kanban rückgängig
unselectCard()Hebt die Auswahl der Karte(n) auf, die durch ihre ID identifiziert werden.
updateCard()Aktualisiert die Daten einer Karte anhand ihrer ID
updateColumn()Ändert die Daten einer Spalte anhand ihrer ID
updateComment()Ändern Sie einen Kommentar einer Karte, indem Sie dessen ID angeben
updateRow()Ändert die Daten einer Zeile basierend auf ihrer ID.

Kanban interne API

Event Bus Methoden

NameBeschreibung
api.exec()Diese Methode ermöglicht es Ihnen, interne Ereignisse innerhalb des Kanban-Boards auszulösen.
api.intercept()Ermöglicht das Abfangen und Blockieren interner Ereignisse, bevor sie eintreten.
api.on()Ermöglicht das Anhängen eines Handlers an interne Ereignisse
api.setNext()Ermöglicht das Einfügen einer bestimmten Aktion in die Event Bus-Sequenz.

Export Methoden

NameBeschreibung
export.json()Speichert die Kanban-Daten als JSON-Datei

State Methoden

NameBeschreibung
api.getReactiveState()Ruft ein Objekt mit den reaktiven Eigenschaften des Kanban-Boards ab.
api.getState()Ruft ein Objekt ab, das die Eigenschaften des StateStore des Kanban enthält.
api.getStores()Ruft ein Objekt mit den DataStore-Eigenschaften des Kanban ab.

Kanban Events

NameBeschreibung
add-cardWird ausgelöst, wenn eine neue Karte hinzugefügt wird
add-columnWird ausgelöst, wenn eine neue Spalte hinzugefügt wird
add-commentWird ausgelöst, wenn ein neuer Kommentar hinzugefügt wird
add-linkWird ausgelöst, wenn ein neuer Link hinzugefügt wird
add-rowWird ausgelöst, sobald eine neue Zeile hinzugefügt wird
add-voteWird ausgelöst, sobald ein Benutzer eine neue Stimme hinzufügt
delete-cardWird ausgelöst, wenn eine Karte entfernt wird
delete-columnWird ausgelöst, wenn eine Spalte entfernt wird
delete-commentWird ausgelöst, wenn ein Kommentar zu einer Karte gelöscht wird
delete-linkWird ausgelöst, wenn ein Link gelöscht wird
delete-rowWird ausgelöst, wenn eine Zeile entfernt wird
delete-voteWird ausgelöst, wenn ein Benutzer eine Stimme von einer Karte entfernt
drag-cardDieses Event wird ausgelöst, sobald eine Karte per Drag-and-Drop verschoben wird.
duplicate-cardWird ausgelöst, wenn eine Karte dupliziert wird
end-drag-cardWird ausgelöst, wenn eine Karten-Zieh-Aktion beendet wird
move-cardWird ausgelöst, wenn eine Karte verschoben wird
move-columnWird ausgelöst, wenn eine Spalte verschoben wird
move-rowWird ausgelöst, wenn eine Zeile verschoben wird
scrollWird ausgelöst, wenn zu bestimmten Elementen gescrollt wird
select-cardWird ausgelöst, wenn eine Karte ausgewählt wird
set-editWird ausgelöst, wenn der Editor umgeschaltet wird
set-searchWird ausgelöst, wenn eine Kartensuche ausgeführt wird
set-sortWird ausgelöst, sobald Karten sortiert werden.
start-drag-cardWird ausgelöst, wenn mit dem Ziehen einer Karte begonnen wird
unselect-cardWird ausgelöst, wenn eine Karte abgewählt wird
update-cardWird ausgelöst, wenn Kartendaten aktualisiert werden
update-columnWird ausgelöst, sobald Spaltendaten aktualisiert werden.
update-commentWird ausgelöst, wenn ein Kommentar aktualisiert wird
update-rowWird ausgelöst, wenn die Daten einer Zeile aktualisiert werden

Kanban Eigenschaften

NameBeschreibung
cardHeightOptional. Definiert die Höhe der Karten.
kartenOptional. Ein Array von Objekten, die die Kartendaten enthalten
cardShapeOptional. Einstellungsobjekt, das steuert, wie Karten dargestellt werden.
cardTemplateOptional. Erzeugt und wendet eine benutzerdefinierte HTML-Vorlage für die Karte an.
columnKeyOptional. Gibt an, zu welcher Spalte eine Karte gehört.
SpaltenOptional. Ein Array von Objekten, die die Spaltendaten enthalten
columnShapeOptional. Einstellungsobjekt zur individuellen Anpassung des Aussehens der Spalten
currentUserOptional. Repräsentiert die ID des aktuellen Benutzers
editorOptional. Enthält Einstellungen zur Anpassung des Kanban-Editors
editorAutoSaveVeraltet! Optional. Aktiviert/deaktiviert den Autosave-Modus
editorShapeOptional. Ein Array von Objekten, die die Einstellungen zur Steuerung des Aussehens und Verhaltens des Kanban-Editors definieren.
historyOptional. Steuert, ob die Historie der Änderungen verfolgt wird
linksOptional. Dies ist ein Array von Objekten, das die Links-Daten enthält.
localeOptional. Ein Objekt, das eine benutzerdefinierte Locale für Kanban definiert.
readonlyOptional. Steuert, ob das Bearbeiten, Hinzufügen, Auswählen und Ziehen von Karten aktiviert oder deaktiviert ist.
renderTypeOptional. Gibt an, wie die Karten dargestellt werden.
rowKeyOptional. Legt fest, wie eine Karte einer Reihe zugewiesen wird.
rowsOptional. Ein Array von Objekten, das die Daten der Zeilen (Swimlanes) enthält.
rowShapeOptional. Ein Objekt mit Einstellungen zur Anpassung des Erscheinungsbilds von Zeilen
scrollTypeOptional. Gibt an, wie das Scrollen funktioniert.
themeOptional. Definiert ein Theme, das auf das Kanban-Board angewendet wird

Toolbar Methoden

NameBeschreibung
destructor()Räumt auf, indem alle Toolbar-HTML-Elemente entfernt und alle zugehörigen Ereignisse abgehängt werden.
setConfig()Aktualisiert die Toolbar mit neuen Konfigurationseinstellungen
setLocale()Aktualisiert die Toolbar von Kanban mit einer neuen Spracheinstellung

Toolbar Eigenschaften

NameBeschreibung
apiErforderlich. Ein Objekt, das die interne API von Kanban repräsentiert
itemsOptional. Ein Array, das die auf der Kanban Toolbar angeordneten Steuerelemente enthält.
localeOptional. Ein Objekt, das eine benutzerdefinierte Locale für die Toolbar definiert.
themeOptional. Gibt das auf die Toolbar angewendete Theme an.

Allgemeine Einstellungen

NameBeschreibung
$metaEin Objekt mit zusätzlichen Einstellungen zur Anpassung von Kanban-Methoden und -Ereignissen

RestDataProvider API

RestDataProvider Methoden

NameBeschreibung
getCards()Ruft ein Promise mit den Kartendaten ab
getColumns()Ruft ein Promise mit den Spalten-Daten ab
getLinks()Ruft ein Promise mit den Link-Daten ab
getRows()Ruft ein Promise mit den Zeilendaten ab
getUsers()Ruft ein Promise mit den Benutzerdaten ab
send()Diese Methode übernimmt das Senden der erforderlichen HTTP-Anfragen an den Server und liefert ein Promise zurück, das je nach Anfragetyp Daten enthalten kann.

RestDataProvider Routen

NameBeschreibung
GET /cardsRuft Informationen zu allen Karten ab und gibt ein JSON-Objekt mit einem Array von Kartenobjekten zurück.
GET /columnsRuft Informationen über alle Spalten ab und gibt ein JSON-Objekt mit einem Array von Spaltendaten zurück.
GET /linksRuft Informationen über alle Links ab und gibt ein JSON-Objekt zurück, das ein Array von Link-Objekten enthält.
GET /rowsRuft Daten für alle Zeilen ab und gibt ein JSON-Objekt zurück, das ein Array von Zeilen- (Swimlane-) Datenobjekten enthält.
GET /usersRuft Daten für alle Benutzer ab und gibt ein JSON-Objekt zurück, das ein Array von Benutzerobjekten enthält.
GET /uploadsRuft die angegebene Binärdatei vom Server ab
POST /cardsFügt eine neue Karte hinzu und antwortet mit einem JSON-Objekt, das die ID der Karte enthält.
POST /cards/{cardId}/commentsFügt der angegebenen Karte einen oder mehrere neue Kommentare hinzu und gibt ein JSON-Objekt mit der ID des neu hinzugefügten Kommentars zurück.
POST /cards/{cardId}/voteFügt der Karte eine neue Stimme hinzu und gibt ein JSON-Objekt mit der ID des abstimmenden Benutzers zurück.
POST /columnsFügt eine neue Spalte hinzu und gibt ein JSON-Objekt mit der Spalten-ID zurück.
POST /linksFügt einen neuen Link hinzu und gibt ein JSON-Objekt mit der neuen Link-ID zurück
POST /rowsFügt eine neue Zeile hinzu und antwortet mit einem JSON-Objekt, das die ID der Zeile enthält.
POST /uploadsLädt eine Binärdatei auf den Server hoch und gibt ein JSON-Objekt mit der Datei-ID, dem Namen und der URL zurück
PUT /cardsAktualisiert die Daten einer angegebenen Karte und gibt ein leeres JSON-Objekt zurück.
PUT /cards/{id}/moveVerschiebt Karten an eine bestimmte Position
PUT /cards/{cardId}/comments/{cardId}Dieser Endpunkt aktualisiert einen bestehenden Kommentar innerhalb einer Karte und gibt ein JSON-Objekt mit der ID des aktualisierten Kommentars zurück.
PUT /columnsAktualisiert die Details einer bestimmten Spalte und gibt ein leeres JSON-Objekt zurück.
PUT /columns/{id}/moveÄndert die Position einer Spalte, indem sie an eine bestimmte Stelle verschoben wird.
PUT /rowsAktualisiert die Daten für eine bestimmte Zeile (Swimlane) und gibt ein leeres JSON-Objekt zurück.
PUT /rows/{id}/moveÄndert die Position einer Zeile, indem sie an eine bestimmte Stelle verschoben wird.
DELETE /cardsEntfernt Daten von einer Karte
DELETE /cards/{cardId}/comments/{cardId}Löscht einen Kommentar von einer Karte
DELETE /cards/{cardId}/voteEntfernt eine Stimme von einer Karte und gibt ein JSON-Objekt mit der Benutzer-ID zurück, die die Stimme entfernt hat.
DELETE /columnsEntfernt die Daten einer Spalte
DELETE /linksEntfernt einen Link-Eintrag
DELETE /rowsEntfernt eine Zeile (Swimlane) aus den Daten.