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 على خريطة في موضع معين أو أعلى علامة، اعتمادًا على ما هو محدد في الخيارات. ما لم يتم إيقاف التحريك التلقائي، ستعمل أداة InfoWindow على تحريك الخريطة لتظهر نفسها عند فتحها. بعد إنشاء InfoWindow، يجب استدعاء فتح لعرضه على الخريطة. يمكن للمستخدم النقر فوق زر الإغلاق في 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 موضع خط الطول والعرض في InfoWindow هذه.
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 يعرض سمة position LatLng وسمة anchorPoint Point اختياريًا لحساب 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 موضع خط الطول والعرض الذي يتم عنده عرض InfoWindow هذه. القيمة المعروضة: ما مِن قيمة
setZIndex	setZIndex(zIndex) المَعلمات:  zIndex:  number فهرس 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). ننصحك بمراقبة هذا الحدث إذا كنت تنشئ محتوى نافذة المعلومات بشكل ديناميكي.
headercontent_changed	function() الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما تتغير السمة headerContent.
headerdisabled_changed	function() الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير السمة headerDisabled.
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 مرئية بالكامل عند فتحها.
headerContent optional	النوع:  string|Element|Text optional المحتوى المطلوب عرضه في صف العنوان InfoWindow. يمكن أن يكون عنصر HTML أو سلسلة من نص عادي. سيتم تحديد حجم InfoWindow وفقًا للمحتوى. لتعيين حجم صريح لمحتوى الرأس، يمكنك تعيين headerContent على أنه عنصر HTML بهذا الحجم.
headerDisabled optional	النوع:  boolean optional لإيقاف صف الرأس بالكامل في InfoWindow. عند التعيين على "true"، ستتم إزالة الرأس حتى يكون محتوى الرأس وزر الإغلاق مخفيين.
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 الخريطة أو البانوراما التي سيتم عرض InfoWindow هذه عليها.
shouldFocus optional	النوع:  boolean optional تحديد ما إذا كان يجب نقل التركيز داخل InfoWindow عند فتحه أم لا. وفي حال ترك هذه السمة بدون ضبط أو ضبطها على null أو undefined، يتم استخدام إرشاد إرشادي لتحديد ما إذا كان يجب نقل التركيز أم لا. ننصح بضبط هذه السمة صراحةً لتناسب احتياجاتك لأنّ الموجِّه خاضع للتغيير وقد لا يعمل بشكل جيد مع جميع حالات الاستخدام.