Référence
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API Embedded Viewer contient une classe: DefaultViewer. Pour découvrir comment utiliser l'API, consultez le guide du développeur.
Résumé sur le constructeur
google.books.DefaultViewer(div, opt_options)
- Lecteur intégré pour un volume dans la recherche sur Google Livres.
Résumé de la méthode
string
getPageNumber()
- Renvoie le numéro de la page actuellement visible dans le viewport.
string
getPageId()
- Renvoie un identifiant unique pour la page actuellement visible dans la fenêtre d'affichage.
boolean
goToPage(pageNumber)
- Renvoie "true" si la page existe et a été affichée.
boolean
goToPageId(pageId)
- Renvoie "true" si la page existe et a été affichée.
boolean
isLoaded()
- Indique si la visionneuse a bien été initialisée avec le livre donné.
highlight(opt_string)
- Met en surbrillance un terme dans la fenêtre d'affichage.
load(identifiers, opt_notFoundCallback, opt_successCallback)
- Charge un livre dans la fenêtre d'affichage.
nextPage()
- Passe à la page suivante du livre.
previousPage()
- Affiche la page précédente du livre.
resize()
- Redimensionne le lecteur pour qu'il s'adapte à la taille de son élément div de conteneur.
zoomIn()
- Fait un zoom sur la visionneuse.
zoomOut()
- Fait un zoom arrière dans la visionneuse.
Détails sur le constructeur
google.books.DefaultViewer
google.books.DefaultViewer(div, opt_options)
Lecteur intégré d'un volume dans la recherche de livres Google
Paramètres
Element div:div dans lequel dessiner le viewport.
Object opt_options : mappage clé-valeur des options à transmettre au spectateur.
Détails sur la méthode
getPageNumber
string getPageNumber()
Renvoie le numéro de la page actuellement visible dans le viewport.
getPageId
string getPageId()
Renvoie un identifiant unique pour la page actuellement visible dans le viewport.
goToPage
boolean goToPage(pageNumber)
Renvoie "true" si la page existe et a été consultée.
Paramètres :
string, number pageNumber : numéro de la page vers laquelle les internautes doivent accéder.
goToPageId
boolean goToPageId(pageId)
Renvoie "true" si la page existe et a été consultée.
Paramètres
string pageId :identifiant unique de la page à laquelle accéder.
isLoaded
boolean isLoaded()
Renvoie la valeur "true" si l'affichage du livre a bien été initialisé à l'aide de load.
sélection
highlight(opt_string)
Met en surbrillance un terme dans la fenêtre d'affichage.
Paramètres
string opt_string :chaîne à mettre en surbrillance. Désactive la mise en surbrillance si null ou undefined.
auto-infligée
load(identifiers, opt_notFoundCallback, opt_successCallback)
Charge un livre dans la fenêtre d'affichage.
Paramètres
string, Array of strings identifiers :URL d'aperçu ou identifiant de livre tel qu'un ISBN, un OCLC, etc. Consultez le format de requête des liens dynamiques. Pour spécifier plusieurs identifiants alternatifs pour le livre (par exemple, les ISBN en version reliée et en version souple), transmettez un Array de ces chaînes d'identifiants. Le lecteur chargera le premier livre intégré dans le tableau.
Function opt_notFoundCallback : si identifier est un identifiant de livre, ce rappel sera appelé si le livre n'a pas été trouvé. Si null est transmis ou si ce paramètre est omis, aucune fonction n'est appelée en cas d'échec.
Function opt_successCallback : ce rappel sera exécuté si et quand l'instance du lecteur est créée avec un livre particulier et prête à recevoir des appels de fonction tels que nextPage.
nextPage
nextPage()
Permet d'accéder à la page suivante du livre.
previousPage
previousPage()
Accède à la page précédente du livre.
resize
resize()
Redimensionne le lecteur pour qu'il s'adapte à la taille de son div de conteneur.
zoomIn
zoomIn()
Effectue un zoom avant dans le lecteur.
zoomOut
zoomOut()
Effectue un zoom arrière dans la visionneuse.
Haut de page
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/11/08 (UTC).
[null,null,["Dernière mise à jour le 2024/11/08 (UTC)."],[[["\u003cp\u003eThe Embedded Viewer API allows you to embed a Google Book into your webpage using the \u003ccode\u003egoogle.books.DefaultViewer\u003c/code\u003e class.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods for navigation such as \u003ccode\u003enextPage\u003c/code\u003e, \u003ccode\u003epreviousPage\u003c/code\u003e, \u003ccode\u003egoToPage\u003c/code\u003e, and \u003ccode\u003egoToPageId\u003c/code\u003e, as well as zooming and highlighting functionalities.\u003c/p\u003e\n"],["\u003cp\u003eYou can load a book using identifiers like ISBN or OCLC with the \u003ccode\u003eload\u003c/code\u003e method and handle loading success or failure with callbacks.\u003c/p\u003e\n"],["\u003cp\u003eThe viewer can be resized dynamically with \u003ccode\u003eresize\u003c/code\u003e and provides methods to retrieve current page information like \u003ccode\u003egetPageNumber\u003c/code\u003e and \u003ccode\u003egetPageId\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Reference\n\nThe Embedded Viewer API contains one class: DefaultViewer. For an introduction to using the API, see the [Developer's Guide](/books/docs/viewer/developers_guide).\n\nConstructor summary\n-------------------\n\n`\n`**[google.books.DefaultViewer](#google.books.DefaultViewer)**`(div, opt_options)\n`\n: An embedded viewer for a volume in Google Book Search.\n\nMethod summary\n--------------\n\n`string\n`**[getPageNumber](#google.books.DefaultViewer.getPageNumber)**`() `\n: Returns the page number of the page that's currently visible in\n the viewport.\n\n`string\n`**[getPageId](#google.books.DefaultViewer.getPageId)**`() `\n: Returns a unique identifier for the page that's currently visible in the\n viewport.\n\n`boolean\n`**[goToPage](#google.books.DefaultViewer.goToPage)**`(pageNumber) `\n: Returns true if the page exists and was turned to.\n\n`boolean\n`**[goToPageId](#google.books.DefaultViewer.goToPageId)**`(pageId) `\n: Returns true if the page exists and was turned to.\n\n`boolean\n`**[isLoaded](#google.books.DefaultViewer.isLoaded)()**\n: Indicates whether the viewer has been successfully initialized with the given book.\n\n`\n`**[highlight](#google.books.DefaultViewer.highlight)**`(opt_string) `\n: Highlights a term in the viewport.\n\n`\n`**[load](#google.books.DefaultViewer.load)**`(identifiers, opt_notFoundCallback, opt_successCallback) `\n: Loads a book in the viewport.\n\n`\n`**[nextPage](#google.books.DefaultViewer.nextPage)**`() `\n: Goes to the next page in the book.\n\n`\n`**[previousPage](#google.books.DefaultViewer.previousPage)**`() `\n: Goes to the previous page in the book.\n\n`\n`**[resize](#google.books.DefaultViewer.resize)**`() `\n: Resizes the viewer to conform to size of its container div.\n\n`\n`**[zoomIn](#google.books.DefaultViewer.zoomIn)**`() `\n: Zooms into the viewer.\n\n`\n`**[zoomOut](#google.books.DefaultViewer.zoomOut)**`() `\n: Zooms out of the viewer.\n\nConstructor detail\n------------------\n\n### google.books.DefaultViewer\n\n```\ngoogle.books.DefaultViewer(div, opt_options)\n```\n\nAn embedded viewer for a volume in Google Book Search.\n\n\u003c!-- --\u003e\n\n**Parameters:** *Element*` div` - Div to draw the viewport in.\n\u003c!-- --\u003e\n\n*Object*` opt_options` - Key-value map of options to pass along to the viewer.\n\nMethod detail\n-------------\n\n### getPageNumber\n\n```\nstring getPageNumber()\n```\n\nReturns the page number of the page that's currently visible in the viewport.\n\n\u003c!-- --\u003e\n\n**Returns:** *string*` `\n\n### getPageId\n\n```\nstring getPageId()\n```\n\nReturns a unique identifier for the page that's currently visible in the viewport.\n\n\u003c!-- --\u003e\n\n**Returns:** *string*` `\n\n### goToPage\n\n```\nboolean goToPage(pageNumber)\n```\n\nReturns true if the page exists and was turned to.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string, number*` pageNumber ` - The page number of the page to turn to.\n\n\u003c!-- --\u003e\n\n**Returns:** *boolean*` `\n\n### goToPageId\n\n```\nboolean goToPageId(pageId)\n```\n\nReturns true if the page exists and was turned to.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string*` pageId ` - The unique identifier of the page to turn to.\n\n\u003c!-- --\u003e\n\n**Returns:** *boolean*` `\n\n### isLoaded\n\n```\nboolean isLoaded()\n```\n\nReturns true if the viewer has been successfully initialized with the given book using `load`.\n\n\u003c!-- --\u003e\n\n**Returns:** *boolean*` `\n\n### highlight\n\n```\nhighlight(opt_string)\n```\n\nHighlights a term in the viewport.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string*` opt_string ` - A string to highlight. Turns off highlighting if `null` or `undefined`.\n\n### load\n\n```\nload(identifiers, opt_notFoundCallback, opt_successCallback)\n```\n\nLoads a book in the viewport.\n\n\u003c!-- --\u003e\n\n**Parameters:** *string* `, `*Array of strings*` identifiers ` - A preview URL or book identifier such as an ISBN, OCLC, etc. See [Dynamic Links request format](/books/docs/dynamic-links#requestFormat). To specify several alternative identifiers for the book (e.g., the hardcover and softcover ISBNs), pass an `Array` of these identifier strings; the viewer will the viewer will load the first embeddable book in the array.\n\u003c!-- --\u003e\n\n*Function*` opt_notFoundCallback ` - If `identifier` is a book identifier, this callback will be called if the book was not found. If `null` passed or this parameter is omitted, no function will be called on failure.\n\u003c!-- --\u003e\n\n*Function*` opt_successCallback ` - This callback will be executed if and when the viewer is successfully instantiated with a particular book, and ready to receive function calls such as `nextPage`.\n\n### nextPage\n\n```\nnextPage()\n```\n\nGoes to the next page in the book.\n\n### previousPage\n\n```\npreviousPage()\n```\n\nGoes to the previous page in the book.\n\n### resize\n\n```\nresize()\n```\n\nResizes the viewer to conform to size of its container div.\n\n### zoomIn\n\n```\nzoomIn()\n```\n\nZooms into the viewer.\n\n### zoomOut\n\n```\nzoomOut()\n```\n\nZooms out of the viewer.\n\n[Back to top](#top)"]]
