Exemples et démonstrations
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Tous les exemples contenus dans la documentation de l'API Embedded Viewer sont listés ci-dessous pour une consultation rapide. D'autres démonstrations sont également fournies pour illustrer les concepts avancés.
Exemples du guide du développeur
Ces exemples de base figurent dans le Guide du développeur et couvrent les utilisations les plus courantes de l'API Embedded Viewer.
- book-simple
Dans l'exemple "Hello, World" de l'API Embedded Viewer, cet exemple indique comment charger l'API et dessiner une visionneuse avec un livre particulier.
- book-language
Cet exemple montre comment modifier la langue de l'interface de l'utilisateur, en l'occurrence le portugais brésilien.
- book-notfound
Ceci montre comment ajouter une fonction de rappel qui est appelée lorsque le lecteur n'a pas pu charger le livre spécifié. Vous pouvez vous appuyer sur cet exemple pour gérer correctement ces conditions.
- book-success
Cet exemple montre comment ajouter une fonction de rappel qui est appelée lorsque l'utilisateur a correctement initialisé un livre et est prêt à être manipulé par programmation.
- book-animate
Pour illustrer la façon dont le lecteur peut être contrôlé de manière programmatique à l'aide de JavaScript, un aperçu s'affiche. Il passe automatiquement à la page suivante toutes les trois secondes.
Contrôle programmatique du lecteur
La visionneuse vous permet d'effectuer avec du code presque tout ce que l'utilisateur peut faire en interagissant avec lui. Les exemples ci-dessous illustrent l'utilité de cette fonctionnalité.
- book-interactions-controls
Cet exemple pratique énumère toutes les méthodes d'interaction compatibles avec l'utilisateur, y compris les fonctions de zoom, nextPage, goToPage et de mise en surbrillance.
- book-interactions-openatpage
Indique comment ouvrir automatiquement une visionneuse de livres sur une page spécifique à l'aide de rappels et de la fonction goToPage.
Combiner avec l'API Books et Dynamic Links
Pour créer des applications avancées, il peut être utile de combiner l'API Embedded Viewer avec l'API Livres ou la fonctionnalité Dynamic Links. Par exemple, il peut être utile de savoir à l'avance si un aperçu spécifique peut être intégré (par exemple, pour déterminer s'il doit permettre à l'utilisateur d'ouvrir une fenêtre d'aperçu sur votre site). Il est également possible que vous ne connaissiez pas l'identifiant d'un livre particulier et que vous souhaitiez d'abord le rechercher à l'aide de l'API Books. Les exemples ci-dessous indiquent comment effectuer ces opérations.
- book- dynamiclinks-zippy
À cette étape, nous vérifions si un livre peut d'abord être intégré. Si, et seulement si, il est disponible, nous affichons un "zippy de l'aperçu". Lorsque l'utilisateur clique dessus, il affiche l'aperçu du livre de façon intégrée.
- booksapi-titlesearch
Cet exemple vous permet d'ouvrir une visionneuse intégrée en saisissant simplement une requête de recherche pour un livre. Il affichera automatiquement le premier résultat intégrable pour la requête que vous saisissez. Cette méthode utilise le format de sortie JSON de l'API Data pour accéder aux résultats de recherche.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/06/28 (UTC).
[null,null,["Dernière mise à jour le 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."]]
