Intersult: JSF-JQuery

This page (revision-8) was last changed on 04-Sep-2019 06:58 by Dieter Käppel

This page was created on 14-Sep-2016 14:10 by Dieter Käppel

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Page revision history

Version	Date Modified	Size	Author	Changes ...
8	04-Sep-2019 06:58	9 KB	Dieter Käppel	to previous
7	04-Sep-2019 06:58	8 KB	Dieter Käppel	to previous \| to last
6	15-Sep-2016 19:47	8 KB	Dieter Käppel	to previous \| to last
5	14-Sep-2016 14:39	8 KB	Dieter Käppel	to previous \| to last
4	14-Sep-2016 14:37	7 KB	Dieter Käppel	to previous \| to last
3	14-Sep-2016 14:30	6 KB	Dieter Käppel	to previous \| to last
2	14-Sep-2016 14:25	5 KB	Dieter Käppel	to previous \| to last
1	14-Sep-2016 14:10	2 KB	Dieter Käppel	to last

Page References

Incoming links	Outgoing links
JSF-JQuery JSF Activate JS JSF-JQuery JSF-JQuery 2	JSF-JQuery JSF Java Javascript

Version management

Difference between version and

At line 1 changed one line

Diese [JSF]-Erweiterung ermöglicht es, einfache [Javascript] und [JQuery|https://de.wikipedia.org/wiki/JQuery] Komponenten JSF-Konform zu implementieren. [JSF-JQuery] enthält zwar einige fertig einsatzfähige Komponenten, versteht sich allerdings vorwiegend als [API|https://de.wikipedia.org/wiki/Programmierschnittstelle] zum Implementieren eigener Komponenten.

At line 23 changed one line

!!AJAX Tag

!!JQuery-AJAX

At line 36 removed 77 lines

!!Function Tag

Der Function-Tag <j:function> ist eine Erweiterung des Tags <f:param> und Implementiert dadurch UIParam. Er kann an jeder Stelle anstatt <f:param> verwendet werden, sinnvoll ist es jedoch hauptsächlich zusammen mit den Options von [JSF-JQuery].

Ein Beispiel:

{{{

<j:function name="hello" arguments="name">

alert('Hello ' + name);

</j:function>

}}}

Im JSON-Array erscheint folgendes:

{{{

{

[...]

"hello": function(name) {

alert('Hello ' + name);

[...]

}

}}}

__Hinweis:__ Der Wert des JSON-Elements "hello" enthält keine Anführungsstriche. Auf Javascript-Seite wird dadurch direkt ein Javascript-Code erzeugt, der nachher ausgeführt werden kann.

!!Autocomplete Tag

Der Autocomplete-Tag <j:autocomplete> ist dem Primefaces-Tag <p:autocomplete> nachempfunden und verwendet dieselben Styles, sodass er sich optisch nicht unterscheidet. Das Laden der Complete-Liste erfolgt allerdings über JQuery-AJAX:

{{{

<j:autocomplete id="autocomplete" complete="#{jqueryController.complete}">

<p:inputText id="input" value="#{jqueryController.value}" autocomplete="off"/>

</j:autocomplete>

}}}

Bei der Implementierung wurde bewusst darauf verzichtet, den kompletten Input-Text-Tag ebenfalls zu implementieren, da es dafür bereits umfangreiche Tags gibt. Er wird daher als Child-Element eingefügt, wie im Beispiel zu sehen ist.

Der Tag <j:autocomplete> unterstützt den Parameter "cellRenderer", mit dem eine Javascript-Function übergeben werden kann, um das standardmäßige Cell-Rendering zu ersetzen. Hier eine Beispiel, wie die Option eingesetzt werden kann:

{{{

<j:function name="cellRenderer" arguments="$row, key, value">

if (key == "styleClass") {

$row.addClass(value);

} else {

var $cell = $("<td/>");

$cell.attr("title", value);

$cell.html(value);

if (key == "label") {

$cell.css("background-color", "black");

$cell.css("color", "yellow");

}

$row.append($cell);

}

</j:function>

}}}

!!JSON Parameter

Mit dem Parameter-Set <j:json>, <j:element>, <j:array> und <j:raw> kann ein JSON-Parameter erzeugt werden. Die Tags können an allen Stellen verwendet werden, die UIParameter akzeptieren (also <f:param>). Wie etwa <h:link> im folgenden Beispiel zeigt:

{{{

<h:link value="#{transaction.signal.symbol}" outcome="/chart.xhtml">

<j:json name="analyzer">

<j:array name="generators">

<j:element>

<j:element name="type" value="stockDataMongoGenerator"/>

<j:element name="name" value="#{transaction.signal.symbol}"/>

<j:element name="symbol" value="#{transaction.signal.symbol}"/>

<j:element name="count" value="#{simulatorController.ticks}"/>

</j:element>

<j:element>

<j:element name="type" value="indicatorGenerator"/>

<j:raw name="indicator" value="#{simulatorController.json}"/>

</j:element>

</j:array>

</j:json>

</h:link>

}}}

At line 158 removed 26 lines

!!Options

Die Options API erleichtert das Generieren von JSON-Options für die eigene Komponente. JQueryComponent enthält eine Methode getOptions(), mit der ein fertiges JSON-Objekt bezogen werden kann. Die Options können dabei aus unterschiedlichen Quellen stammen:

* __Attribute:__ getOptions hat das Parameter-Array Object... properties, mit der eine beliebige Anzahl von Properties der eigenen Komponente spezifiziert werden kann, die in die Options mit aufgenommen werden. Aus XHTML-Sicht sind dies Attribute. Also beispielsweise getOptions(PropertyKeys.valueProperty), um das Property "valueProperty" in die Options zu übertragen.

* __Parameter-Tags:__ Mit dem UIParam-Tag <f:param> können ebenfalls Options hinzugefügt werden. Zusätzlich bringt [JSF-JQuery] die Erweiterung <j:function> mit, der die Übergabe von Javascript-Code in die Options ermöglicht.

!!Komponenten und Scripte

Die Basisklasse JQueryComponent enthält bewusst noch keine Annotation mit ResourceDependencies, sodass man frei in der Wahl der Bibliotheken ist. Insbesondere, ob man Primefaces-JQuery oder eine eigene JQuery bzw. ganz andere Javascript-Bibliothek verwenden möchte.

Hat man Primefaces im Projekt, werden die meisten Komponenten so aussehen:

{{{

@FacesComponent(namespace = JQueryComponent.NAMESPACE, createTag = true)

@ResourceDependencies({

@ResourceDependency(name = "jquery/jquery.js", library = "primefaces"),

@ResourceDependency(name = "jsf-jquery.js", library = "jquery-js")

})

public class Test extends JQueryComponent {

[...]

}

}}}

Damit stellt [JSF] automatisch sicher, dass sich die benötigten Scripte auf der Web-Seite befinden und lädt diese gegebenenfalls nach.

Die Annotation FacesComponent kann dazu verwendet werden, um den Tag direkt zu erzeugen, ohne eine taglib.xml zusätzlich anlegen zu müssen.

This page (revision-8) was last changed on 04-Sep-2019 06:58 by Dieter Käppel Top

Übersicht
Startseite
Das Unternehmen
Produkte
Consulting
Referenzen

Jobmarkt
Jobangebote
Profile

Hilfe
Suche
Seitenindex
Letzte Änderungen
Sichere Verbindung

Systeme
Tickets
Jenkins
Nexus
SVN
Email Client

4050 Aufrufe

referenziert von
JSF Activate JS
JSF-JQuery
JSF-JQuery 2