إشعار الأمان: نما إلى علمنا بمشكلة أمنية قد تؤثر في المواقع الإلكترونية التي تستخدم مكتبات معيّنة تابعة لجهات خارجية (بما في ذلك polyfill.io). وقد تؤدي هذه المشكلة في بعض الأحيان إلى إعادة توجيه الزائرين بعيدًا عن الموقع الإلكتروني المقصود بدون معرفة مالك الموقع أو إذنه. وفي السابق، كان يتضمّن العديد من نماذج JavaScript تعريف النص البرمجي polyfill.io. تمت إزالة هذا المحتوى من نماذجنا. إذا كنت قد استخدمت نماذج JavaScript التي تحتوي على هذا التعريف، ننصحك بإزالة التعريف.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Info Window

الفئة InfoWindow

صف واحد (google.maps.InfoWindow)

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

تمتد هذه الفئة إلى MVCObject.

يمكنك الوصول من خلال الاتصال على الرقم const {InfoWindow} = await google.maps.importLibrary("maps") أو الرقم const {InfoWindow} = await google.maps.importLibrary("streetView"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.

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

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

InfoWindow

InfoWindow([opts])

المَعلمات:

opts: InfoWindowOptions optional

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

الطُرق
`close`	`close()` المَعلمات: لا شيء قيمة الإرجاع: لا شيء يُستخدم لإغلاق نافذة InfoWindow هذه عن طريق إزالتها من بنية DOM.
`focus`	`focus()` المَعلمات: لا شيء قيمة الإرجاع: لا شيء للتركيز على هذا `InfoWindow`. ننصحك باستخدام هذه الطريقة مع حدث `visible` للتأكّد من أنّ `InfoWindow` يظهر قبل ضبط التركيز عليه. لا يمكن التركيز على `InfoWindow` غير المرئي.
`getContent`	`getContent()` المَعلمات: لا شيء قيمة العرض: `string\|Element\|Text\|null\|undefined` محتوى InfoWindow هذا. تمامًا كما تم ضبط المحتوى في السابق.
`getPosition`	`getPosition()` المَعلمات: لا شيء قيمة العرض: `LatLng\|null\|undefined` موضع خط الطول والعرض في InfoWindow هذا.
`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 بعلامة ارتساء. في واجهة برمجة التطبيقات الأساسية، يكون الرابط الوحيد هو فئة "أداة العلامة". في المقابل، يمكن أن يكون الارتساء أي عنصر MVCObject يعرض خاصية LatLng `position` واختياريًا سمة نقطة `anchorPoint` لحساب `pixelOffset` (يمكنك الاطّلاع على InfoWindowOptions). تمثّل السمة `anchorPoint` إزاحة من موضع علامة الارتساء حتى طرف InfoWindow. ننصح باستخدام واجهة `InfoWindowOpenOptions` كوسيطة واحدة لهذه الطريقة. لمنع تغيير تركيز المتصفِّح على "فتح"، اضبِط `InfoWindowOpenOptions.shouldFocus` على `false`.
`setContent`	`setContent([content])` المَعلمات: `content`: `string\|Element\|Text optional` المحتوى الذي سيتم عرضه من خلال InfoWindow هذه. قيمة الإرجاع: لا شيء
`setOptions`	`setOptions([options])` المَعلمات: `options`: `InfoWindowOptions optional` قيمة الإرجاع: لا شيء
`setPosition`	`setPosition([position])` المَعلمات: `position`: `LatLng\|LatLngLiteral optional` موضع خط الطول والعرض الذي يتم فيه عرض InfoWindow هذا. قيمة الإرجاع: لا شيء
`setZIndex`	`setZIndex(zIndex)` المَعلمات: `zIndex`: `number` فهرس z لـ InfoWindow هذا. سيتم عرض InfoWindow ذات فهرس z أكبر أمام كل InfoWindows الأخرى ذات فهرس z أقل. قيمة الإرجاع: لا شيء
المحتوى المُكتسَب: `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`	إشعار: متوفّر فقط في v=beta channel. `function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير سمة headerContent.
`headerdisabled_changed`	إشعار: متوفّر فقط في v=beta channel. `function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير الخاصية headerDisabled.
`position_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيُّر خاصية الموضع.
`visible`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما يكون `InfoWindow` مرئيًا بالكامل. لا يتم تنشيط هذا الحدث عند إيقاف "`InfoWindow`" ثم إعادة عرضه على الشاشة.
`zindex_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير zIndex لـ `InfoWindow`.

واجهة InfoWindowOptions

واجهة google.maps.InfoWindowOptions

الكائن InfoWindowOptions لتحديد الخصائص التي يمكن ضبطها على InfoWindow.

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

واجهة InfoWindowOpenOptions

واجهة google.maps.InfoWindowOpenOptions

خيارات فتح InfoWindow

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

Info Window

الفئة InfoWindow

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

الطُرق

فعاليات

واجهة InfoWindowOptions

أماكن إقامة

واجهة InfoWindowOpenOptions

أماكن إقامة