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])
المَعلمات: 
تُنشئ نافذة معلومات بالخيارات المحددة. يمكن وضع 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])
المَعلمات: 
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional إما كائن InfoWindowOpenOptions (يُنصح به) أو الخريطة|البانوراما المطلوب عرض InfoWindow هذا عليها.
  • anchorMVCObject|AdvancedMarkerElement optional الإرساء الذي سيتم وضع InfoWindow عليه. وإذا لم يكن الارتساء فارغًا، فسيتم وضع InfoWindow في منتصف أعلى علامة الارتساء. سيتم عرض InfoWindow على نفس الخريطة أو البانوراما مثل علامة الارتساء (عند توفرها).
قيمة الإرجاع: لا شيء
يؤدي هذا الاختصار إلى فتح InfoWindow هذا على الخريطة المحددة. وبشكل اختياري، يمكن ربط InfoWindow بعلامة ارتساء. في واجهة برمجة التطبيقات الأساسية، يكون الرابط الوحيد هو فئة "أداة العلامة". في المقابل، يمكن أن يكون الارتساء أي عنصر MVCObject يعرض خاصية LatLng position واختياريًا سمة نقطة anchorPoint لحساب pixelOffset (يمكنك الاطّلاع على InfoWindowOptions). تمثّل السمة anchorPoint إزاحة من موضع علامة الارتساء حتى طرف InfoWindow. ننصح باستخدام واجهة InfoWindowOpenOptions كوسيطة واحدة لهذه الطريقة. لمنع تغيير تركيز المتصفِّح على "فتح"، اضبِط InfoWindowOpenOptions.shouldFocus على false.
setContent
setContent([content])
المَعلمات: 
  • contentstring|Element|Text optional المحتوى الذي سيتم عرضه من خلال InfoWindow هذه.
قيمة الإرجاع: لا شيء
setOptions
setOptions([options])
المَعلمات: 
قيمة الإرجاع: لا شيء
setPosition
setPosition([position])
المَعلمات: 
  • positionLatLng|LatLngLiteral optional موضع خط الطول والعرض الذي يتم فيه عرض InfoWindow هذا.
قيمة الإرجاع: لا شيء
setZIndex
setZIndex(zIndex)
المَعلمات: 
  • zIndexnumber فهرس 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). ننصحك بمراقبة هذا الحدث إذا كنت تنشئ محتوى نافذة المعلومات بشكل ديناميكي.
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 مرئية بالكامل عند فتحها.
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، يتم استخدام موجِّه لتحديد ما إذا كان يجب نقل التركيز أم لا. ننصحك بضبط هذه السمة بشكل واضح لتناسب احتياجاتك لأنّ أسلوب التوجيه عرضة للتغيير، وقد لا يكون مناسبًا لجميع حالات الاستخدام.