@seanox/aspect-js/manual/de/events.md

full stack JavaScript framework for SPAs incl. reactivity rendering, mvc / mvvm, models, expression language, datasource, virtual paths, unit test and some more

[Erweiterung](extension.md) | [Inhalt](README.md#ereignisse) | [Test](test.md)
- - -

# Ereignisse

Seanox aspect-js stellt verschiedene Ereignisse bereit, die u.a. zur
Implementierung von Erweiterungen sowie als Benachrichtigung der Anwendung
über bestimmte Betriebszustände des Frameworks und der
Laufzeitumgebung genutzt werden können.


## Inhalt

* [Rendering](#rendering)
  * [Composite.EVENT_RENDER_START](#compositeevent_render_start)
  * [Composite.EVENT_RENDER_NEXT](#compositeevent_render_next)
  * [Composite.EVENT_RENDER_END](#compositeevent_render_end)
* [View-Model-Binding](#view-model-binding)
  * [Composite.EVENT_MOUNT_START](#compositeevent_mount_start)
  * [Composite.EVENT_MOUNT_NEXT](#compositeevent_mount_next)
  * [Composite.EVENT_MOUNT_END](#compositeevent_mount_end)
* [HTTP](#http)
  * [Composite.EVENT_HTTP_START](#compositeevent_http_start)
  * [Composite.EVENT_HTTP_PROGRESS](#compositeevent_http_progress)
  * [Composite.EVENT_HTTP_RECEIVE](#compositeevent_http_receive)
  * [Composite.EVENT_HTTP_LOAD](#compositeevent_http_load)
  * [Composite.EVENT_HTTP_ABORT](#compositeevent_http_abort)
  * [Composite.EVENT_HTTP_TIMEOUT](#compositeevent_http_timeout)
  * [Composite.EVENT_HTTP_ERROR](#compositeevent_http_error)
  * [Composite.EVENT_HTTP_END](#compositeevent_http_end)
* [Error](#error)
  * [Composite.EVENT_ERROR](#compositeevent_error)


# Rendering

Die nachfolgenden Ereignisse treten während dem Rendering auf. Der
Callback-Methode wird dazu der aktuelle Selector übergeben. Die Methode
kann dann den Selector, wie auch das korrespondierende Element beeinflussen,
nicht aber das Rendering.

```javascript
Composite.listen(Composite.EVENT_RENDER_***, function(event, selector) {
    ...
});
```


## Composite.EVENT_RENDER_START

Das Ereignis tritt mit dem Start des Renderings auf. Die Verarbeitung selbst
beginnt erst nach dem Ereignis.


## Composite.EVENT_RENDER_NEXT

Das Ereignis tritt bei rekursiver Iteration beim Rendering auf, wenn
während eines Renderzyklus, das Rendering eines weiteren Elements startet.
Die Verarbeitung selbst beginnt erst nach dem Ereignis.


## Composite.EVENT_RENDER_END

Das Ereignis tritt mit dem finalen Ende des Renderings auf. Die Verarbeitung
selbst endet vor dem Ereignis.


# View-Model-Binding

Die nachfolgenden Ereignisse treten während dem View-Model-Binding auf. Der
Callback-Methode wird dazu der aktuelle Selector übergeben. Die Methode
kann den Selector wie auch das korrespondierende Element beeinflussen, nicht
aber das View-Model-Binding.

```javascript
Composite.listen(Composite.EVENT_MOUNT_***, function(event, selector) {
    ...
});
```


## Composite.EVENT_MOUNT_START

Das Ereignis tritt mit dem Start vom View-Model-Binding auf. Die Verarbeitung
selbst beginnt erst nach dem Ereignis.


## Composite.EVENT_MOUNT_NEXT

Das Ereignis tritt bei rekursiver Iteration beim View-Model-Binding auf, wenn
während eines Renderzyklus, das View-Model-Binding eines weiteren Elements
startet. Die Verarbeitung selbst beginnt erst nach dem Ereignis.


## Composite.EVENT_MOUNT_END

Das Ereignis tritt mit dem finalen Ende vom View-Model-Binding auf. Die
Verarbeitung selbst endet vor dem Ereignis.


# HTTP

Das Composite-API unterstützt ein anwendungsweites Event-Management
für den XMLHttpRequest zur Implementierung Request-bezogener
Anwendungslogik, z.B. für Logging oder Spinner. 

```javascript
Composite.listen(Composite.EVENT_HTTP_***, function(event, XMLHttpRequest) {
    ...
});
```


## Composite.EVENT_HTTP_START

Entspricht dem XMLHttpRequest-Event: `loadstart` und wird ausgelöst, wenn
eine Anforderung zum Laden von Daten gestartet wurde.


## Composite.EVENT_HTTP_PROGRESS

Entspricht dem XMLHttpRequest-Event: `progress`. Das Fortschrittsereignis wird
periodisch ausgelöst, wenn eine Anforderung weitere Daten empfängt.


## Composite.EVENT_HTTP_RECEIVE

Entspricht dem XMLHttpRequest-Event: `readystatechange` und wird ausgelöst,
wenn sich der Status vom Request/Response ändert.


## Composite.EVENT_HTTP_LOAD

Entspricht dem XMLHttpRequest-Event: `load` und wird ausgelöst, wenn eine
Ressource geladen wurde.


## Composite.EVENT_HTTP_ABORT

Entspricht dem XMLHttpRequest-Event: `abort` und wird ausgelöst, wenn das
Laden einer Ressource abgebrochen wurde.


## Composite.EVENT_HTTP_TIMEOUT

Entspricht dem XMLHttpRequest-Event: `timeout` und wird ausgelöst, wenn das
Laden einer Ressource wegen Überschreitung der maximalen Ladezeit
abgebrochen wurde.


## Composite.EVENT_HTTP_ERROR

Entspricht dem XMLHttpRequest-Event: `error` und wird ausgelöst, wenn ein
Fehler aufgetreten ist.


## Composite.EVENT_HTTP_END

Entspricht dem XMLHttpRequest-Event: `loadend` und wird ausgelöst, wenn der
Request abgeschlossen ist, unabhängig von evtl. Fehlern oder erfolgreichem
Verlauf.


# Error

Das Composite-API unterstützt ein anwendungsweites Event-Management
für Laufzeitfehler zur Implementierung Ereignis-bezogener Anwendungslogik,
z.B. für Logging oder Fehlerausgaben. 

```javascript
Composite.listen(Composite.EVENT_ERROR, function(event, Error) {
    ...
});
```


## Composite.EVENT_ERROR

Das Fehlerereignis wird bei unbehandelten Laufzeitfehlern ausgelöst.
Syntaktische Fehler die eine generelle Ausführung von JavaScript
verhindern, können das Fehlerereignis nicht auslösen.


- - -
[Erweiterung](extension.md) | [Inhalt](README.md#ereignisse) | [Test](test.md)