דוגמאות והדגמות
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
כל הדוגמאות שכלולות בערכת התיעוד של Embedded Viewer API מפורטות למטה לעיון מהיר. בנוסף, נכללות מספר הדגמות נוספות להמחשת מושגים מתקדמים.
דוגמאות מהמדריך למפתחים
דוגמאות בסיסיות אלה מופיעות במדריך למפתחים ומתייחסות לשימושים הנפוצים ביותר של Embedded Viewer API.
- ספר פשוט
הדוגמה "שלום, עולם" ל-API של צפייה מוטמעת. בדוגמה הזו מוסבר איך לטעון את ה-API ולצייר צופה עם ספר מסוים.
- שפת הספר
הדוגמה הזו מראה איך לשנות את שפת הממשק של הצופה, במקרה הזה לפורטוגזית (ברזיל).
- book-notfound
כאן תוכלו לראות איך להוסיף פונקציית קריאה חוזרת (callback) שנקראת כאשר הצופה לא מצליח לטעון את הספר שצוין. אפשר להיעזר בדוגמה הזו כדי לטפל במצבים כאלה באלגנטיות.
- book-הצלחה
כאן אפשר לראות איך להוסיף פונקציית קריאה חוזרת (callback) שמופעלת כשהצופה אתחל בהצלחה את הספר ומוכן לשינוי פרוגרמטי.
- אנימציה לספר
כדי להמחיש איך אפשר לשלוט בצופה באופן פרוגרמטי באמצעות JavaScript, מוצגת תצוגה מקדימה שמחזירה אוטומטית לדף הבא כל 3 שניות.
שליטה פרוגרמטית של הצופה
הצופה מאפשר לכם לבצע כמעט כל פעולה שהמשתמש יכול לבצע באמצעות אינטראקציה עם הצופה. הדוגמאות הבאות מראות איך זה יכול להיות שימושי.
שילוב עם Books API והקישורים הדינמיים
כשאתם מפתחים אפליקציות מתקדמות, כדאי לשלב את Embedded Viewer API עם Books API או עם התכונה קישורים דינמיים. לדוגמה, כדאי לדעת מראש אם תצוגה מקדימה מסוימת זמינה להטמעה (למשל, כדי לקבוע אם לתת למשתמש אפשרות לפתוח חלון תצוגה מקדימה באתר). לחלופין, אולי אתם לא יודעים מה המזהה של ספר מסוים ואתם רוצים קודם 'לחפש אותו' באמצעות Books API. הדוגמאות הבאות ממחישות איך לבצע את הפעולות האלה.
- book- dynamiclinks-zippy
כאן אנחנו בודקים קודם אם ספר מסוים זמין להטמעה. אם הוא זמין ורק אם הוא זמין, אנחנו מעבדים "קובץ zippy עם תצוגה מקדימה", שכאשר לוחצים עליו, התצוגה המקדימה של הספר מוצגת בתוך השורה.
- booksapi-titlesearch
הדוגמה הזו מאפשרת לפתוח מציג מוטמע פשוט על ידי הזנת שאילתת חיפוש לגבי ספר. תוצג באופן אוטומטי התוצאה הראשונה שמוטמעת בתגובה לשאילתה שהזנתם. הפקודה הזו משתמשת בפורמט הפלט ה-JSON של ה-Data API כדי לגשת לתוצאות החיפוש.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-06-28 (שעון UTC).
[null,null,["עדכון אחרון: 2024-06-28 (שעון UTC)."],[[["\u003cp\u003eThis documentation provides a comprehensive list of examples for Google Books Embedded Viewer API.\u003c/p\u003e\n"],["\u003cp\u003eExamples cover basic viewer setup, language settings, error handling, and programmatic control functionalities.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can learn to integrate the viewer with the Books API and Dynamic Links for advanced functionalities.\u003c/p\u003e\n"],["\u003cp\u003eSample code demonstrates interactions like zooming, navigation, and highlighting within the embedded viewer.\u003c/p\u003e\n"],["\u003cp\u003eUse cases include creating book previews, searching for books, and handling embedding availability.\u003c/p\u003e\n"]]],[],null,["# Examples and Demos\n\nAll of the examples contained within the Embedded Viewer API documentation set are listed below for quick reference. In addition, a number of additional demos are included to illustrate advanced concepts.\n\nExamples from the Developer's Guide\n-----------------------------------\n\nThese basic examples appear in the [Developer's Guide](/books/docs/viewer/developers_guide) and cover the most common uses of the Embedded Viewer API.\n\n- [book-simple](/books/docs/viewer/examples/book-simple) \n The \"Hello, World\" example of the Embedded Viewer API, this example indicates how to load the API and draw a viewer with a particular book.\n- [book-language](/books/docs/viewer/examples/book-language) \n This example shows how to change the viewer's interface language, in this case to Brazilian Portuguese.\n- [book-notfound](/books/docs/viewer/examples/book-notfound) \n This shows how to add a callback function which is called when the viewer could not load the specified book. You can build on this example to gracefully handle such conditions.\n- [book-success](/books/docs/viewer/examples/book-success) \n This shows how to add a callback function which is called when the viewer has successfully initialized with a book and is ready to be manipulated programatically.\n- [book-animate](/books/docs/viewer/examples/book-animate) \n To illustrate how the viewer can be controlled programmatically using JavaScript, a preview is shown which automatically flips to the next page every 3 seconds.\n\nProgrammatic control of the viewer\n----------------------------------\n\nThe viewer allows you to do with code almost anything the user can do by interacting with the the viewer. The examples below show how this might be useful.\n\n- [book-interactions-controls](/books/docs/viewer/examples/book-interactions-controls) \n This working example enumerates all the interaction methods supported by the viewer, including zoom, nextPage, goToPage, and highlighting functions.\n- [book-interactions-openatpage](/books/docs/viewer/examples/book-interactions-openatpage) \n Shows how to automatically open a book viewer on a particular page, using callbacks and the goToPage function.\n\nCombining with the Books API and Dynamic Links\n----------------------------------------------\n\nWhen building advanced applications, you may find it useful to combine\nthe Embedded Viewer API with either the [Books API](/books/docs/v1/getting_started) or the\n[Dynamic Links](/books/docs/dynamic-links)\nfeature. For example, it may be useful to know in advance whether a particular\npreview will be available for embedding (e.g., to determine whether to give the\nuser the option to open a preview window on your site). Or, you may not know the\nidentifier for a particular book, and want to first \"look it up\" using the Books\nAPI. The examples below indicate how to perform these operations.\n\n- [book-dynamiclinks-zippy](/books/docs/viewer/examples/book-dynamiclinks-zippy) \n Here we check whether a book is available for embedding first. If and only if it is available, we render a \"preview zippy,\" which, when clicked, shows the book preview inline.\n- [booksapi-titlesearch](/books/docs/viewer/examples/booksapi-titlesearch) \n This example allows you open an embedded viewer by simply entering a search query for a book. It will automatically show the first embeddable result for the query you enter. This uses the JSON output format of the Data API to access the search results."]]
