כל הדוגמאות שכלולות בערכת התיעוד של Embedded Viewer API מפורטות למטה לעיון מהיר. בנוסף, נכללות מספר הדגמות נוספות להמחשת מושגים מתקדמים.
דוגמאות מהמדריך למפתחים
דוגמאות בסיסיות אלה מופיעות במדריך למפתחים ומתייחסות לשימושים הנפוצים ביותר של Embedded Viewer API.
- ספר פשוט
הדוגמה "שלום, עולם" ל-API של צפייה מוטמעת. בדוגמה הזו מוסבר איך לטעון את ה-API ולצייר צופה עם ספר מסוים. - שפת הספר
הדוגמה הזו מראה איך לשנות את שפת הממשק של הצופה, במקרה הזה לפורטוגזית (ברזיל). - book-notfound
כאן תוכלו לראות איך להוסיף פונקציית קריאה חוזרת (callback) שנקראת כאשר הצופה לא מצליח לטעון את הספר שצוין. אפשר להיעזר בדוגמה הזו כדי לטפל במצבים כאלה באלגנטיות. - book-הצלחה
כאן אפשר לראות איך להוסיף פונקציית קריאה חוזרת (callback) שמופעלת כשהצופה אתחל בהצלחה את הספר ומוכן לשינוי פרוגרמטי. - אנימציה לספר
כדי להמחיש איך אפשר לשלוט בצופה באופן פרוגרמטי באמצעות JavaScript, מוצגת תצוגה מקדימה שמחזירה אוטומטית לדף הבא כל 3 שניות.
שליטה פרוגרמטית של הצופה
הצופה מאפשר לכם לבצע כמעט כל פעולה שהמשתמש יכול לבצע באמצעות אינטראקציה עם הצופה. הדוגמאות הבאות מראות איך זה יכול להיות שימושי.
- book-interactions-controls
הדוגמה בעבודה הזו מפרטת את כל שיטות האינטראקציה שנתמכות על ידי הצופה, כולל פונקציות זום, nextPage, goToPage והדגשה. - book-interactions-openatpage
מדריך לפתיחה אוטומטית של מציג הספר בדף מסוים באמצעות קריאות חוזרות (callback) והפונקציה goToPage.
שילוב עם Books API והקישורים הדינמיים
כשאתם מפתחים אפליקציות מתקדמות, כדאי לשלב את Embedded Viewer API עם Books API או עם התכונה קישורים דינמיים. לדוגמה, כדאי לדעת מראש אם תצוגה מקדימה מסוימת זמינה להטמעה (למשל, כדי לקבוע אם לתת למשתמש אפשרות לפתוח חלון תצוגה מקדימה באתר). לחלופין, אולי אתם לא יודעים מה המזהה של ספר מסוים ואתם רוצים קודם 'לחפש אותו' באמצעות Books API. הדוגמאות הבאות ממחישות איך לבצע את הפעולות האלה.
- book- dynamiclinks-zippy
כאן אנחנו בודקים קודם אם ספר מסוים זמין להטמעה. אם הוא זמין ורק אם הוא זמין, אנחנו מעבדים "קובץ zippy עם תצוגה מקדימה", שכאשר לוחצים עליו, התצוגה המקדימה של הספר מוצגת בתוך השורה. - booksapi-titlesearch
הדוגמה הזו מאפשרת לפתוח מציג מוטמע פשוט על ידי הזנת שאילתת חיפוש לגבי ספר. תוצג באופן אוטומטי התוצאה הראשונה שמוטמעת בתגובה לשאילתה שהזנתם. הפקודה הזו משתמשת בפורמט הפלט ה-JSON של ה-Data API כדי לגשת לתוצאות החיפוש.