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، يجب استدعاء open لعرضها على الخريطة. يمكن للمستخدم النقر على زر الإغلاق في InfoWindow لإزالته من الخريطة، أو يمكن للمطوّر استدعاء close() للحصول على التأثير نفسه.

الخصائص
isOpen	النوع:  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 محتوى العنوان الخاص بنافذة المعلومات هذه. يمكنك الاطّلاع على 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 تمثّل هذه السمة ترتيب العرض لـ InfoWindow. سيتم عرض InfoWindow بمؤشر z أكبر أمام جميع InfoWindow الأخرى بمؤشر 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	function() الوسيطات:  لا شيء يتم تنشيط هذا الحدث عند تغيير السمة headerContent.
headerdisabled_changed	function() الوسيطات:  لا شيء يتم تنشيط هذا الحدث عند تغيير السمة headerDisabled.
position_changed	function() الوسيطات:  لا شيء يتم تنشيط هذا الحدث عند تغيير السمة "الموضع".
visible	function() الوسيطات:  لا شيء يتم تنشيط هذا الحدث عندما يكون InfoWindow مرئيًا بالكامل. لا يتم تنشيط هذا الحدث عند إيقاف InfoWindow ثم إعادة عرضه على الشاشة.
zindex_changed	function() الوسيطات:  لا شيء يتم تنشيط هذا الحدث عند تغيير قيمة zIndex الخاصة بـ InfoWindow.

InfoWindowOptions interface

google.maps.InfoWindowOptions interface

عنصر 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	النوع:  string|Element|Text optional المحتوى الذي سيتم عرضه في صف عنوان InfoWindow. يمكن أن يكون هذا العنصر عنصر HTML أو سلسلة نص عادي. سيتم تحديد حجم InfoWindow وفقًا للمحتوى. لضبط حجم صريح لمحتوى العنوان، اضبط headerContent ليكون عنصر HTML بهذا الحجم.
headerDisabled optional	النوع:  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 تمثّل هذه السمة قيمة LatLng التي سيتم عرض InfoWindow فيها. إذا تم فتح InfoWindow باستخدام عنصر ربط، سيتم استخدام موضع عنصر الربط بدلاً من ذلك.
zIndex optional	النوع:  number optional يتم عرض جميع InfoWindows على الخريطة بترتيب zIndex، مع عرض القيم الأعلى أمام InfoWindows ذات القيم الأقل. يتم تلقائيًا عرض InfoWindows وفقًا لخطوط العرض الخاصة بها، مع ظهور InfoWindows ذات خطوط العرض الأقل أمام InfoWindows ذات خطوط العرض الأعلى. يتم دائمًا عرض نوافذ المعلومات أمام العلامات.

واجهة InfoWindowOpenOptions

google.maps.InfoWindowOpenOptions interface

خيارات فتح نافذة InfoWindow

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