Info Window

فئة InfoWindow

google.maps.InfoWindow class

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

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

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

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

InfoWindow

InfoWindow([opts]) المَعلمات:  opts:  InfoWindowOptions optional لإنشاء نافذة معلومات تتضمّن الخيارات المحدّدة يمكن وضع 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 محتوى عنوان InfoWindow هذا. يُرجى الاطّلاع على InfoWindowOptions.headerContent.
getHeaderDisabled	getHeaderDisabled() المَعلمات:  بدون القيمة المعروضة:  boolean|undefined ما إذا كان صف الرأس بأكمله غير مفعّل أم لا. يُرجى الاطّلاع على InfoWindowOptions.headerDisabled.
getPosition	getPosition() المَعلمات:  بدون القيمة المعروضة:  LatLng|null|undefined موضع LatLng لـ InfoWindow هذا.
getZIndex	getZIndex() المَعلمات:  بدون القيمة المعروضة:  number مقياس zIndex لإطار المعلومات هذا.
open	open([options, anchor]) المَعلمات:  options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional إما عنصر InfoWindowOpenOptions (مُستحسَن) أو map|panorama لعرض InfoWindow هذا. anchor:  MVCObject|AdvancedMarkerElement optional عنصر الربط الذي سيتم وضع "نافذة المعلومات" هذا عليه. إذا لم يكن العنصر الرابط فارغًا، سيتم وضع نافذة المعلومات في أعلى وسط العنصر الرابط. سيتم عرض "إطار المعلومات" على الخريطة أو الصورة البانورامية نفسها التي يتضمّن عنصر الربط (عند توفّره). القيمة المعروضة:  لا شيء يفتح هذا العنصر InfoWindow على الخريطة المحدّدة. يمكن اختياريًا ربط نافذة معلومات بعنصر تثبيت. في واجهة برمجة التطبيقات الأساسية، تكون العلامة الوحيدة هي فئة Marker. ومع ذلك، يمكن أن يكون العنصر الأساسي أيّ عنصر MVC يعرِض سمة LatLng position واختياريًا سمة Point anchorPoint لاحتساب pixelOffset (راجِع InfoWindowOptions). يمثّل anchorPoint القيمة المُعدَّلة من موضع العنصر الأساسي إلى رأس InfoWindow. ننصحك باستخدام واجهة InfoWindowOpenOptions كوسيطة واحدة لهذه الطريقة. لمنع تغيير تركيز المتصفّح عند فتحه، اضبط InfoWindowOpenOptions.shouldFocus على false.
setContent	setContent([content]) المَعلمات:  content:  string|Element|Text optional المحتوى الذي سيتم عرضه في "نافذة المعلومات" هذه. القيمة المعروضة:  لا شيء
setHeaderContent	setHeaderContent([headerContent]) المَعلمات:  headerContent:  string|Element|Text optional محتوى العنوان الذي سيتم عرضه في "نافذة المعلومات" هذه. يُرجى الاطّلاع على InfoWindowOptions.headerContent. القيمة المعروضة:  لا شيء
setHeaderDisabled	setHeaderDisabled([headerDisabled]) المَعلمات:  ‫headerDisabled:  boolean optional تحدّد هذه السمة ما إذا كان سيتم إيقاف صف العنوان بالكامل. يُرجى الاطّلاع على InfoWindowOptions.headerDisabled. القيمة المعروضة:  لا شيء
setOptions	setOptions([options]) المَعلمات:  options:  InfoWindowOptions optional القيمة المعروضة:  لا شيء
setPosition	setPosition([position]) المَعلمات:  position:  LatLng|LatLngLiteral optional موضع LatLng لعرض "نافذة المعلومات" هذه. القيمة المعروضة:  لا شيء
setZIndex	setZIndex(zIndex) المَعلمات:  ‫zIndex:  numberفهرس z لـ InfoWindow هذا. سيتم عرض InfoWindow الذي يحتوي على قيمة أكبر لسمة z-index أمام جميع InfoWindows الأخرى التي تحتوي على قيمة أقل لسمة z-index. القيمة المعروضة:  لا شيء
مُكتسَبة: 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() الوسيطات:  بدون يتمّ تشغيل هذا الحدث عند تغيير خاصيّة position.
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 المحتوى الذي سيتم عرضه في نافذة المعلومات يمكن أن يكون عنصر HTML أو سلسلة نص عادي أو سلسلة تحتوي على HTML. سيتم تحديد حجم InfoWindow وفقًا للمحتوى. لتحديد حجم صريح للمحتوى، اضبط المحتوى على أنّه عنصر HTML بهذا الحجم.
disableAutoPan optional	النوع:  boolean optional القيمة التلقائية: false أوقِف تمرير الخريطة أفقيًا أو عموديًا لعرض "نافذة المعلومات" بالكامل عند فتحها.
headerContent optional	النوع:  string|Element|Text optional المحتوى الذي سيتم عرضه في صف عنوان InfoWindow يمكن أن يكون هذا عنصر HTML أو سلسلة من النصوص العادية. سيتم تحديد حجم InfoWindow وفقًا للمحتوى. لضبط حجم صريح لمحتوى العنوان، اضبط headerContent على أنّه عنصر HTML بهذا الحجم.
headerDisabled optional	النوع:  boolean optional يؤدي ذلك إلى إيقاف صف العنوان بالكامل في InfoWindow. عند ضبطها على true، ستتم إزالة العنوان لإخفاء محتوى العنوان وزر الإغلاق.
maxWidth optional	النوع:  number optional الحد الأقصى لعرض نافذة المعلومات، بغض النظر عن عرض المحتوى ولا يتمّ أخذ هذه القيمة في الاعتبار إلا إذا تمّ ضبطها قبل طلب 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 باستخدام عنصر تثبيت، سيتم استخدام موضع عنصر التثبيت بدلاً من ذلك.
zIndex optional	النوع:  number optional يتم عرض جميع نوافذ المعلومات على الخريطة بترتيب zIndex، مع عرض القيم الأعلى أمام نوافذ المعلومات ذات القيم الأقل. يتم عرض نوافذ المعلومات تلقائيًا حسب خط العرض، مع ظهور نوافذ المعلومات ذات خطوط العرض الأقلّ أمام نوافذ المعلومات ذات خطوط العرض الأعلى. يتم دائمًا عرض نوافذ المعلومات أمام العلامات.

InfoWindowOpenOptions

google.maps.InfoWindowOpenOptions واجهة

خيارات فتح نافذة معلومات

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