Info Window

فئة InfoWindow

google.maps.InfoWindow الصف الدراسي

تراكب يبدو مثل فقاعة تفسيرية، ويكون متصلاً غالبًا بعلامة.

يمتد هذا الصف MVCObject.

يمكنك الوصول من خلال الاتصال بـ const {InfoWindow} = await google.maps.importLibrary("maps") أو const {InfoWindow} = await google.maps.importLibrary("streetView"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
InfoWindow
InfoWindow([opts])
المعلّمات: 
لإنشاء نافذة معلومات تتضمن الخيارات المحددة. يمكن وضع InfoWindow على الخريطة في موضع معين أو فوق علامة، اعتمادًا على ما هو محدد في الخيارات. ما لم يتم تعطيل التحريك التلقائي، سيشغّل InfoWindow الخريطة ليجعل نفسه مرئيًا عندما يكون مفتوحًا. بعد إنشاء InfoWindow، يجب استدعاء فتح لعرضه على الخريطة. يمكن للمستخدم النقر على زر الإغلاق في InfoWindow لإزالته من الخريطة، أو يمكن لمطور البرامج الاتصال بـ()() للحصول على التأثير نفسه.
close
close()
المعلّمات: بدون
قيمة الإرجاع: بدون
لإغلاق InfoWindow من خلال إزالته من بنية DOM.
focus
focus()
المعلّمات: بدون
قيمة الإرجاع: بدون
لضبط التركيز على InfoWindow هذا. قد ترغب في استخدام هذه الطريقة بالإضافة إلى حدث visible للتأكد من أن InfoWindow مرئي قبل ضبط التركيز عليه. ولا يمكن التركيز على InfoWindow غير المرئي.
getContent
getContent()
المعلّمات: بدون
قيمة العرض:  string|Element|null|Text|undefined محتوى محتوى InfoWindow هذا. تمامًا مثل المحتوى السابق.
getPosition
getPosition()
المعلّمات: بدون
قيمة العرض:  LatLng|null|undefined موضع خط الطول والعرض لـ InfoWindow.
getZIndex
getZIndex()
المعلّمات: بدون
قيمة العرض:  number فهرس z لـ InfoWindow.
open
open([options, anchor])
المعلّمات: 
  • options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional إما كائن InfoWindowOpenOptions (موصى به) أو map|panorama التي سيتم عرض InfoWindow عليها.
  • anchor:  MVCObject|AdvancedMarkerView optional نقطة الارتساء التي سيتم تحديد موضع InfoWindow لها. إذا كانت المرساة غير خالية، فسيتم وضع InfoWindow في أعلى منتصف المرساة. سيتم عرض InfoWindow على نفس الخريطة أو بانوراما مثل الارتساء (عندما يكون متاحًا).
قيمة الإرجاع: بدون
فتح InfoWindow على الخريطة المحددة. اختياريًا، يمكن ربط InfoWindow بمرسى. في واجهة برمجة التطبيقات الأساسية، تكون نقطة الارتساء هي فئة "أداة التمييز". ومع ذلك، يمكن أن تكون علامة الارتساء أي عنصر MVCObject يعرض الخاصية position LatLng ويُمكن اختياريًا استخدام خاصية النقطة anchorPoint لحساب pixelOffset (راجِع InfoWindowOptions). تمثل الخاصية anchorPoint الإزاحة من موضع الارتساء إلى رأس InfoWindow. من المستحسن استخدام واجهة InfoWindowOpenOptions كوسيطة واحدة لهذه الطريقة. لمنع تغيير تركيز المتصفح عند الفتح، اضبط InfoWindowOpenOptions.shouldFocus على false.
setContent
setContent([content])
المعلّمات: 
  • content:  string|Element|Text optional المحتوى المراد عرضه بواسطة InfoWindow.
قيمة الإرجاع: بدون
setOptions
setOptions([options])
المعلّمات: 
قيمة الإرجاع: بدون
setPosition
setPosition([position])
المعلّمات: 
  • position:  LatLng|LatLngLiteral optional موضع خط عرض خط الطول والعرض لعرض InfoWindow هذا.
قيمة الإرجاع: بدون
setZIndex
setZIndex(zIndex)
المعلّمات: 
  • zIndex:  number فهرس z لأداة InfoWindow هذه. سيتم عرض InfoWindow مع مؤشر z أكبر أمام جميع نوافذ Windows الأخرى ذات مؤشر z الأقل.
قيمة الإرجاع: بدون
موروث: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
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 في خطوط العرض الأعلى. يتم عرض Windows Info دائمًا أمام العلامات.

InfoWindowOpenOptions واجهة

واجهة google.maps.InfoWindowOpenOptions

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