المرجع
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحتوي Embedded Viewer API على فئة واحدة: DefaultViewer. للحصول على مقدّمة عن استخدام واجهة برمجة التطبيقات، يُرجى الاطّلاع على دليل المطوّر.
ملخّص المنشئ
google.books.DefaultViewer(div, opt_options)
- عارض مضمّن لمجلد في "بحث الكتب من Google"
ملخّص الطريقة
string
getPageNumber()
- تعرض هذه السمة رقم الصفحة التي تظهر حاليًا في
مساحة العرض.
string
getPageId()
- تعرض هذه الدالة معرّفًا فريدًا للصفحة التي تظهر حاليًا في
إطار العرض.
boolean
goToPage(pageNumber)
- عرض القيمة "صحيح" إذا كانت الصفحة موجودة وتم استخدامها.
boolean
goToPageId(pageId)
- عرض القيمة "صحيح" إذا كانت الصفحة موجودة وتم استخدامها.
boolean
isLoaded()
- تشير إلى ما إذا كان قد تم إعداد العارض بنجاح مع الكتاب المحدّد.
highlight(opt_string)
- تمييز عبارة في إطار العرض
load(identifiers, opt_notFoundCallback, opt_successCallback)
- تحميل كتاب في إطار العرض
nextPage()
- الانتقال إلى الصفحة التالية في الكتاب
previousPage()
- الانتقال إلى الصفحة السابقة في الكتاب
resize()
- تغيير حجم المشغّل ليتوافق مع حجم div للحاوية
zoomIn()
- تكبير الشاشة
zoomOut()
- تصغير العارض
تفاصيل الجهة المصنِّعة
google.books.DefaultViewer
google.books.DefaultViewer(div, opt_options)
مشغّل مضمّن لمجلد في "بحث الكتب من Google"
المَعلمات:
Element div - Div لرسم إطار العرض.
Object opt_options - خريطة مفاتيح وقيم للخيارات التي يجب تمريرها إلى
المشاهد.
تفاصيل الطريقة
getPageNumber
string getPageNumber()
تعرض رقم صفحة الصفحة التي تظهر حاليًا في
إطار العرض.
getPageId
string getPageId()
تعرض هذه السمة معرّفًا فريدًا للصفحة التي تظهر حاليًا في
إطار العرض.
goToPage
boolean goToPage(pageNumber)
تعرض هذه الدالة القيمة "صحيح" إذا كانت الصفحة متوفّرة وتمّ الانتقال إليها.
المَعلمات:
string, number pageNumber - رقم الصفحة التي تريد الانتقال إليها.
goToPageId
boolean goToPageId(pageId)
تعرض هذه الدالة القيمة "صحيح" إذا كانت الصفحة متوفّرة وتمّ الانتقال إليها.
المَعلمات:
string pageId : المعرّف الفريد للصفحة التي تريد الانتقال إليها.
isLoaded
boolean isLoaded()
يتم عرض قيمة صحيحة إذا تم إعداد المشاهد بنجاح باستخدام الكتاب المحدّد باستخدام load.
مختارات
highlight(opt_string)
يُبرز هذا الرمز عبارة في إطار العرض.
المَعلمات:
string opt_string - سلسلة يتم تمييزها. إيقاف ميزة التمييز في حال استخدام
null أو undefined
حمولة
load(identifiers, opt_notFoundCallback, opt_successCallback)
لتحميل كتاب في إطار العرض
المَعلمات:
string, Array of strings identifiers - عنوان URL لمعاينة الكتاب أو معرّف الكتاب، مثل رقم ISBN أو
OCLC أو غير ذلك. يُرجى الاطّلاع على تنسيق طلب الروابط الديناميكية. لتحديد عدة معرّفات بديلة للكتاب (مثل أرقام ISBN للغلاف الصلب والغلاف الورقي)، يمكنك تمرير Array من سلاسل المعرّفات هذه، وسيحمّل المشاهد أول كتاب قابل للتضمين في الصفيف.
Function opt_notFoundCallback - إذا كان identifier هو معرّف
كتاب، سيتمّ استدعاء هذا المرجع في حال عدم العثور على الكتاب. في حال تم تمرير null أو تم حذف هذه المَعلمة، لن يتم استدعاء أي دالة في حال حدوث خطأ.
Function opt_successCallback - سيتم تنفيذ عملية الاستدعاء هذه
إذا تم إنشاء مثيل المُشاهد بنجاح باستخدام كتاب محدّد وكان جاهزًا
لتلقّي استدعاءات الدوال، مثل nextPage.
nextPage
nextPage()
للانتقال إلى الصفحة التالية في الكتاب
previousPage
previousPage()
للانتقال إلى الصفحة السابقة في الكتاب
تغيير الحجم
resize()
يُعيد هذا العنصر ضبط حجم المشغّل ليتوافق مع حجم div الحاوية.
zoomIn
zoomIn()
zoomOut
zoomOut()
الرجوع إلى الأعلى
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)"]]
