כל הדוגמאות שנכללות בקבוצת התיעוד של ממשק ה-API של רכיב מוטמע מוטמע מפורטות בהמשך. בנוסף, כמה הדגמות נוספות כלולות כדי להמחיש מושגים מתקדמים.
דוגמאות מתוך המדריך למפתחים
הדוגמאות הבסיסיות האלו מופיעות במדריך למפתחים, ועוסקות בשימושים הנפוצים ביותר ב-מוטמע ממשק צפייה.
- book-Simple
הדוגמה "Hello, World" של מוטמע ממשק API, דוגמה זו מציינת כיצד לטעון את ממשק ה-API ולצייר צופה עם ספר ספציפי. - book-language
דוגמה זו מראה איך לשנות את שפת הממשק של הצופה, במקרה הזה לפורטוגזית ברזילאית. - book-notFound
כך ניתן להוסיף פונקציית קריאה חוזרת שנקראת כאשר הצופה לא הצליח לטעון את הספר שצוין. אתם יכולים לבסס על הדוגמה הזו כדי לטפל במצבים כאלה בחינניות. - book-success
כך ניתן להוסיף פונקציית קריאה חוזרת (callback) שנקראת כשהצופה מתחיל לעבוד עם ספר ומוכן לשינוי פרוגרמטי. - אנימציית הספר
כדי להדגים איך אפשר לשלוט בצופה באופן פרוגרמטי באמצעות JavaScript, מוצגת תצוגה מקדימה שתעבור באופן אוטומטי לדף הבא כל 3 שניות.
שליטה פרוגרמטית בצופה
הצופה יכול לבצע עם הקוד כמעט כל דבר שהמשתמש יכול לעשות בו באמצעות אינטראקציה עם הצופה. הדוגמאות הבאות ממחישות כיצד זה יכול להיות שימושי.
- book-interactions-controls
הדוגמה הפעילה מסכמת את כל שיטות האינטראקציה שהצופה תומך בהן, כולל פונקציות zoom , nextPage , goToPage ופונקציות הדגשה. - book-interactions-openatpage
כך אפשר לפתוח אוטומטית מציג ספרים בדף מסוים, באמצעות התקשרות חזרה ופונקציית goToPage.
שילוב של Books API ו-Dynamic Links
כשאתם בונים אפליקציות מתקדמות, כדאי לשלב את ה-API הצופה המוטמע ב-Books API או בתכונה קישורים דינמיים. לדוגמה, כדאי לדעת מראש אם תצוגה מקדימה מסוימת תהיה זמינה להטמעה (למשל, כדי לקבוע אם לתת למשתמש אפשרות לפתוח חלון תצוגה מקדימה באתר). או שאולי לא ידוע לכם מהו המזהה של ספר מסוים, וברצונכם תחילה "לחפש אותו" באמצעות Books API. הדוגמאות הבאות מראות כיצד לבצע פעולות אלה.
- book-Dynamiclinks-zippy
כאן אנחנו בודקים אם הספר זמין להטמעה תחילה. אם ורק אם הוא זמין, אנחנו מעבדים "תצוגה מקדימה של zippy", שלחיצה עליה מציגה את התצוגה המקדימה של הספר בתוך השורה. - booksapi-titlesearch
הדוגמה הזו מאפשרת לפתוח צופה מוטמע על ידי הזנת שאילתת חיפוש עבור ספר. הוא יציג באופן אוטומטי את התוצאה הראשונה המוטמעת עבור השאילתה שהזנת. זה משתמש בפורמט פלט JSON של Data API כדי לגשת לתוצאות החיפוש.