حزمة أدوات Places UI Kit: هي مكتبة جاهزة للاستخدام تتيح للمطوّرين إمكانية التخصيص والتحكّم. ننصحك بتجربتها ومشاركة ملاحظاتك حول تجربتك مع حزمة واجهة المستخدم.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

Info Window

فئة InfoWindow

class google.maps.InfoWindow extends MVCObject
library "maps", "streetView"

هي تراكب يشبه الفقاعة وغالبًا ما يكون متصلاً بعلامة.

const {InfoWindow} = await google.maps.importLibrary("maps");

أو

const {InfoWindow} = await google.maps.importLibrary("streetView");

الشركة المصنِّعة
`InfoWindow`	`InfoWindow([opts])` المَعلمات: `opts: InfoWindowOptions optional` تنشئ هذه الدالة نافذة معلومات بالخيارات المحدّدة. يمكن وضع InfoWindow على خريطة في موضع معيّن أو فوق علامة، استنادًا إلى ما تم تحديده في الخيارات. ما لم يتم إيقاف التحريك التلقائي، ستعمل نافذة InfoWindow على تحريك الخريطة لتصبح مرئية عند فتحها. بعد إنشاء InfoWindow، يجب استدعاء open لعرضها على الخريطة. يمكن للمستخدم النقر على زر الإغلاق في InfoWindow لإزالته من الخريطة، أو يمكن للمطوّر استدعاء close()‎ للحصول على التأثير نفسه.

الشركة المصنِّعة

InfoWindow

InfoWindow([opts])

المَعلمات:

opts: InfoWindowOptions optional

تنشئ هذه الدالة نافذة معلومات بالخيارات المحدّدة. يمكن وضع InfoWindow على خريطة في موضع معيّن أو فوق علامة، استنادًا إلى ما تم تحديده في الخيارات. ما لم يتم إيقاف التحريك التلقائي، ستعمل نافذة InfoWindow على تحريك الخريطة لتصبح مرئية عند فتحها. بعد إنشاء InfoWindow، يجب استدعاء open لعرضها على الخريطة. يمكن للمستخدم النقر على زر الإغلاق في InfoWindow لإزالته من الخريطة، أو يمكن للمطوّر استدعاء close()‎ للحصول على التأثير نفسه.

الخصائص
`isOpen` readonly	النوع: `boolean` يتحقّق هذا الإجراء مما إذا كانت InfoWindow مفتوحة.

الطُرق
`close`	`close()` المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: لا شيء لإغلاق InfoWindow هذه من خلال إزالتها من بنية DOM
`focus`	`focus()` المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: لا شيء يضبط التركيز على `InfoWindow`. يمكنك استخدام هذه الطريقة مع حدث `visible` للتأكّد من أنّ `InfoWindow` مرئي قبل التركيز عليه. لا يمكن التركيز على `InfoWindow` غير مرئي.
`getContent`	`getContent()` المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: `string\|Element\|Text\|null\|undefined` محتوى InfoWindow هذا. القيمة نفسها التي تم ضبطها سابقًا كمحتوى.
`getHeaderContent`	`getHeaderContent()` المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: `string\|Element\|Text\|null\|undefined` محتوى العنوان في InfoWindow. يمكنك الاطّلاع على `InfoWindowOptions.headerContent`.
`getHeaderDisabled`	`getHeaderDisabled()` المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: `boolean\|undefined` ما إذا كان صف العنوان بأكمله غير مفعَّل أم لا. يمكنك الاطّلاع على `InfoWindowOptions.headerDisabled`.
`getPosition`	`getPosition()` المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: `LatLng\|null\|undefined` موضع LatLng الخاص بنافذة المعلومات هذه.
`getZIndex`	`getZIndex()` المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: `number` قيمة zIndex الخاصة بنافذة InfoWindow هذه.
`open`	`open([options, anchor])` المَعلمات: ‫`options: InfoWindowOpenOptions\|Map\|StreetViewPanorama optional` إما عنصر InfoWindowOpenOptions (يُنصح به) أو الخريطة\|البانوراما التي سيتم عرض InfoWindow عليها. `anchor: MVCObject\|AdvancedMarkerElement optional` تمثّل هذه السمة نقطة الارتكاز التي سيتم وضع InfoWindow عليها. إذا كانت نقطة الارتساء غير فارغة، سيتم وضع InfoWindow في أعلى وسط نقطة الارتساء. سيتم عرض InfoWindow على الخريطة أو الصورة البانورامية نفسها مثل نقطة الارتساء (عند توفّرها). القيمة المعروضة: لا شيء يفتح InfoWindow هذا على الخريطة المحدّدة. يمكن ربط InfoWindow بمرساة اختياريًا. في واجهة برمجة التطبيقات الأساسية، يكون الارتساء الوحيد هو فئة Marker. ومع ذلك، يمكن أن يكون الارتساء أي MVCObject يعرض سمة LatLng `position` وسمة Point `anchorPoint` اختياريًا لحساب `pixelOffset` (راجِع InfoWindowOptions). تمثّل السمة `anchorPoint` الإزاحة من موضع علامة الارتساء إلى طرف InfoWindow. ننصحك باستخدام واجهة `InfoWindowOpenOptions` كوسيطة واحدة لهذه الطريقة. لمنع تغيير تركيز المتصفّح عند الفتح، اضبط السياسة `InfoWindowOpenOptions.shouldFocus` على `false`.
`setContent`	`setContent([content])` المَعلمات: `content: string\|Element\|Text optional` المحتوى الذي سيتم عرضه في InfoWindow. القيمة المعروضة: لا شيء
`setHeaderContent`	`setHeaderContent([headerContent])` المَعلمات: ‫`headerContent: string\|Element\|Text optional` يمثّل هذا المَعلمة محتوى العنوان الذي سيتم عرضه في InfoWindow. يمكنك الاطّلاع على `InfoWindowOptions.headerContent`. القيمة المعروضة: لا شيء
`setHeaderDisabled`	`setHeaderDisabled([headerDisabled])` المَعلمات: `headerDisabled: boolean optional` تحدّد ما إذا كان سيتم إيقاف صف العنوان بالكامل. يمكنك الاطّلاع على `InfoWindowOptions.headerDisabled`. القيمة المعروضة: لا شيء
`setOptions`	`setOptions([options])` المَعلمات: `options: InfoWindowOptions optional` القيمة المعروضة: لا شيء
`setPosition`	`setPosition([position])` المَعلمات: `position: LatLng\|LatLngLiteral optional` موضع LatLng الذي سيتم عرض InfoWindow فيه. القيمة المعروضة: لا شيء
`setZIndex`	`setZIndex(zIndex)` المَعلمات: `zIndex: number` يمثّل هذا المعامل فهرس z لـ InfoWindow. سيتم عرض InfoWindow بقيمة z-index أكبر أمام جميع InfoWindows الأخرى بقيمة z-index أقل. القيمة المعروضة: لا شيء
القيم المكتسَبة: `addListener`، `bindTo`، `get`، `notify`، `set`، `setValues`، `unbind`، `unbindAll`

الفعاليات
`close`	`function()` الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عند إغلاق `InfoWindow`. على سبيل المثال، يمكن أن يكون ذلك من خلال استدعاء طريقة `InfoWindow.close` أو الضغط على مفتاح Escape لإغلاق InfoWindow أو النقر على زر الإغلاق أو نقل InfoWindow إلى خريطة أخرى.
`closeclick`	`function()` الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عند النقر على زر الإغلاق.
`content_changed`	`function()` الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عند تغيير سمة المحتوى.
`domready`	`function()` الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عندما يتم إرفاق `<div>` الذي يحتوي على محتوى `InfoWindow` بنموذج العناصر في المستند (DOM). قد ترغب في مراقبة هذا الحدث إذا كنت تنشئ محتوى نافذة المعلومات ديناميكيًا.
`headercontent_changed`	`function()` الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عند تغيير السمة headerContent.
`headerdisabled_changed`	`function()` الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عند تغيير السمة headerDisabled.
`position_changed`	`function()` الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عند تغيير سمة الموضع.
`visible`	`function()` الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عندما يكون `InfoWindow` مرئيًا بالكامل. لا يتم تنشيط هذا الحدث عند تحريك `InfoWindow` خارج الشاشة ثم إعادته إليها.
`zindex_changed`	`function()` الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عند تغيير zIndex في `InfoWindow`.

InfoWindowOptions interface

واجهة google.maps.InfoWindowOptions

عنصر InfoWindowOptions يُستخدَم لتحديد السمات التي يمكن ضبطها في InfoWindow.

الخصائص
`ariaLabel` اختياري	النوع: `string optional` ‫AriaLabel المطلوب تخصيصه لـ InfoWindow
`content` اختياري	النوع: `string\|Element\|Text optional` المحتوى الذي سيتم عرضه في InfoWindow يمكن أن يكون هذا عنصر HTML أو سلسلة نص عادي أو سلسلة تحتوي على HTML. سيتم تحديد حجم InfoWindow وفقًا للمحتوى. لضبط حجم صريح للمحتوى، اضبط المحتوى ليكون عنصر HTML بهذا الحجم.
`disableAutoPan` اختياري	النوع: `boolean optional` القيمة التلقائية: `false` إيقاف تحريك الخريطة لجعل InfoWindow مرئيًا بالكامل عند فتحه
`headerContent` اختياري	النوع: `string\|Element\|Text optional` المحتوى الذي سيتم عرضه في صف عنوان InfoWindow. يمكن أن يكون هذا عنصر HTML أو سلسلة من النص العادي. سيتم تحديد حجم InfoWindow وفقًا للمحتوى. لضبط حجم صريح لمحتوى العنوان، اضبط headerContent ليكون عنصر HTML بهذا الحجم.
`headerDisabled` اختياري	النوع: `boolean optional` يؤدي هذا الإعداد إلى إيقاف صف العنوان بالكامل في InfoWindow. عند ضبط هذه السمة على "صحيح"، ستتم إزالة العنوان لإخفاء محتواه وزر الإغلاق.
`maxWidth` اختياري	النوع: `number optional` الحد الأقصى لعرض InfoWindow، بغض النظر عن عرض المحتوى. لا يتم أخذ هذه القيمة في الاعتبار إلا إذا تم ضبطها قبل استدعاء `open()`. لتغيير الحد الأقصى للعرض عند تغيير المحتوى، يمكنك استدعاء `close()` و`setOptions()` ثم `open()`.
`minWidth` اختياري	النوع: `number optional` الحد الأدنى لعرض InfoWindow، بغض النظر عن عرض المحتوى عند استخدام هذه السمة، ننصح بشدة بضبط `minWidth` على قيمة أقل من عرض الخريطة (بالبكسل). لا يتم أخذ هذه القيمة في الاعتبار إلا إذا تم ضبطها قبل استدعاء `open()`. لتغيير الحد الأدنى للعرض عند تغيير المحتوى، يمكنك استدعاء `close()` و`setOptions()` ثم `open()`.
`pixelOffset` اختياري	النوع: `Size optional` تمثّل هذه السمة الإزاحة بالبكسل لطرف نافذة المعلومات من النقطة على الخريطة التي تم تثبيت نافذة المعلومات عندها وفقًا لإحداثياتها الجغرافية. إذا تم فتح InfoWindow باستخدام علامة ارتساء، سيتم احتساب `pixelOffset` من السمة `anchorPoint` لعلامة الارتساء.
`position` اختياري	النوع: `LatLng\|LatLngLiteral optional` تمثّل هذه السمة LatLng التي سيتم عرض InfoWindow فيها. إذا تم فتح InfoWindow باستخدام علامة ارتساء، سيتم استخدام موضع علامة الارتساء بدلاً من ذلك.
`zIndex` اختياري	النوع: `number optional` يتم عرض جميع نوافذ المعلومات على الخريطة بترتيب zIndex، مع عرض القيم الأعلى أمام نوافذ المعلومات ذات القيم الأقل. يتم تلقائيًا عرض نوافذ المعلومات وفقًا لخط العرض، حيث تظهر نوافذ المعلومات ذات خطوط العرض المنخفضة أمام نوافذ المعلومات ذات خطوط العرض الأعلى. يتم عرض InfoWindows دائمًا أمام العلامات.

واجهة InfoWindowOpenOptions

واجهة google.maps.InfoWindowOpenOptions

خيارات فتح InfoWindow

الخصائص
`anchor` اختياري	النوع: `MVCObject\|AdvancedMarkerElement optional` نقطة الارتساء التي سيتم وضع InfoWindow عليها. إذا كانت نقطة الارتساء غير فارغة، سيتم وضع InfoWindow في أعلى وسط نقطة الارتساء. سيتم عرض InfoWindow على الخريطة أو الصورة البانورامية نفسها مثل نقطة الارتساء (عند توفّرها).
`map` اختياري	النوع: `Map\|StreetViewPanorama optional` الخريطة أو الصورة البانورامية التي سيتم عرض InfoWindow عليها
`shouldFocus` اختياري	النوع: `boolean optional` ما إذا كان يجب نقل التركيز داخل InfoWindow عند فتحه أم لا. عندما لا يتم ضبط هذه السمة أو عندما يتم ضبطها على `null` أو `undefined`، يتم استخدام أسلوب إرشادي لتحديد ما إذا كان يجب نقل التركيز أم لا. ننصحك بضبط هذه السمة بشكل صريح لتناسب احتياجاتك لأنّ الأسلوب الإرشادي عرضة للتغيير وقد لا يعمل بشكل جيد مع جميع حالات الاستخدام.

Info Window تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فئة InfoWindow

الشركة المصنِّعة

الخصائص

الطُرق

الفعاليات

InfoWindowOptions interface

الخصائص

واجهة InfoWindowOpenOptions

الخصائص

Info Window