Info Window

فئة InfoWindow

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

عنصر مركّب على شكل فقاعة تفسيرية ويرتبط غالبًا بعلامة

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

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

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

InfoWindow

InfoWindow([opts]) المعلّمات:  opts:  InfoWindowOptions optional يتم إنشاء نافذة معلومات بالخيارات المحددة. يمكن وضع InfoWindow على الخريطة في موضع معيّن أو فوق علامة، اعتمادًا على ما يتم تحديده في الخيارات. ما لم يتم إيقاف العرض التلقائي، ستعمل PanWindow على عرض الخريطة لإظهارها تلقائيًا عند فتحها. بعد إنشاء 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 موضع LatLang لـ InfoWindow.
getZIndex	getZIndex() المعلّمات: بدون قيمة العرض:  number The zIndex of this InfoWindow.
open	open([options, anchor]) المعلّمات:  options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional إما كائن InfoWindowOpenOptions (إجراء مُقترَح) أو الخريطة|العرض البانورامي الذي يتم عرض عنصر InfoWindow عليه. anchor:  MVCObject|AdvancedMarkerElement optional سيتم وضع علامة الارتساء التي سيتم تحديد موضع المعلومات هذا في InfoWindow. وإذا كانت علامة الارتساء غير فارغة، سيتم وضع InfoWindow في أعلى منتصف الارتساء. سيتم عرض InfoWindow على الخريطة أو البانوراما نفسها مثل علامة الارتساء (عند توفرها). قيمة العرض: بدون يتم فتح هذا InfoWindow على الخريطة المحددة. اختياريًا، يمكن ربط InfoWindow بمذيع. في واجهة برمجة التطبيقات الأساسية، يكون الارتساء الوحيد هو فئة أداة التحديد. ومع ذلك، يمكن أن تكون علامة الارتساء هي أي عنصر MVCObject يعرض السمة position LatLang وسمة النقطة anchorPoint اختياريًا لاحتساب pixelOffset (راجِع InfoWindowOptions). تمثّل السمة anchorPoint إزاحة من موضع علامة الارتساء إلى طرف المعلومات الكاملة. ننصحك باستخدام واجهة 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 موضع خط العرض قيمة العرض: بدون
setZIndex	setZIndex(zIndex) المعلّمات:  zIndex:  number فهرس z لـ InfoWindow سيتم عرض InfoWindow مع فهرس z أكبر أمام جميع InfoWindows الأخرى ذات فهرس 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 يمكنك إيقاف العرض الشامل للخريطة لجعل المعلومات.
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 خط LatLNG الذي تعرض عليه InfoWindow. وإذا تم فتح InfoWindow مع علامة ارتساء، سيتم استخدام موضع الارتساء بدلاً من ذلك.
zIndex optional	النوع:  number optional يتم عرض جميع InfoWindows على الخريطة بترتيب zIndex، مع عرض قيم أعلى أمام InfoWindows مع قيم أقل. وفقًا للإعدادات التلقائية، يتم عرض InfoWindows وفقًا لخطوط العرض، مع ظهور WindowsWindows لخطوط العرض السفلية أمام خطوط المعلومات على Windows بخطوط عرض أعلى. يتم دائمًا عرض 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، يتم استخدام الدليل الإرشادية لتحديد ما إذا كان يجب نقل التركيز أم لا. ننصح بضبط هذه السمة صراحةً لتلائم احتياجاتك، لأنّ إرشادات الدليل تخضع للتغيير وقد لا تعمل بشكل جيد في جميع حالات الاستخدام.