Native Anwendungen erstellen - HTML5-Apps fur iPhone und Android - page 282

<li class "smallfield"><span class "name">Suchfilter</span><input
name "suchfilter" placeholder "* Platzhalter" type "text"/></li>
<li class "smallfield"><span
class "name">Eintr&auml;ge/Seite</span><input name "maxContacts"
placeholder "20" type "tel"/></li>
<li class "smallfield"><span class "name">Startseite</span><input
name "startpage" placeholder "1" type "tel"/></li>
</ul>
<ul class "pageitem">
<li class "button">
<input type "button" value "Anzeigen" onClick "kontakteAnzeigen();
return false;">
</li>
</ul>
</fieldset>
</form>

<div id "footer">
</div>
</body>
</html>

Zuerst haben wir wieder ein iPhone-typisches Formular mit iWebKit angelegt, um dort
einige für die API optionale Parameter abzufragen. Falls der Benutzer im Formular keine
anderen Werte eingibt, werden die am Anfang des Codes definierten Werte benutzt:

var nameFilter "";
var pageSize 20;
var pageNumber 1;

Die JavaScript-API getAllContacts() , die wir später im Beispiel verwenden, gibt uns
nicht nur die Adressinformationen aus dem Adressbuch wieder, sondern die Ausgabe
lässt sich über diese drei Parameter auch anpassen:

Variable Bedeutung

Über die Variable nameFilter kann ein Suchbegriff übermittelt wer-
den, der die API veranlasst, nur Namen zurückzugeben, die mit dem
Suchbegriff übereinstimmen. Die Angabe eines Platzhalters am Ende
eines Namens mittels eines *-Zeichens ist ebenfalls möglich.

nameFilter

Ein Adressbuch kann ziemlich lang und komplex sein. Manche Benut-
zer haben Hunderte, wenn nicht sogar Tausende Adresseinträge auf
ihrem Telefon. Wenn Sie die API aufrufen, ist es sinnvoll, diese in ver-
schiedene Seiten zu unterteilen. Über pageSize legen Sie fest, wie
viele Einträge pro Seite zurückgegeben werden sollen.

pageSize

Mittels pageNumber können Sie angeben, welche Seite Sie aus dem
Adressbuch abfragen und von welcher Sie Adressdaten erhalten
möchten. Haben Sie beispielsweise ein Adressbuch mit 60 Einträgen
und pageSize 20 definiert, erhalten Sie bei der Angabe von
pageNumber 2 die Adressbucheinträge 21 bis 40 von der API.

pageNumber