Info Window

فئة InfoWindow

google.maps.InfoWindow class
extends MVCObject
library "maps", "streetView"

هي تراكب يشبه الفقاعة وغالبًا ما يكون متصلاً بعلامة.

const {InfoWindow} = await google.maps.importLibrary("maps");

أو

const {InfoWindow} = await google.maps.importLibrary("streetView");

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

InfoWindow

InfoWindow([opts]) المَعلمات: opts: InfoWindowOptions optional تنشئ هذه الدالة نافذة معلومات بالخيارات المحدّدة. يمكن وضع InfoWindow على خريطة في موضع معيّن أو فوق علامة، استنادًا إلى ما تم تحديده في الخيارات. ما لم يتم إيقاف التحريك التلقائي، ستعمل نافذة InfoWindow على تحريك الخريطة لتصبح مرئية عند فتحها. بعد إنشاء InfoWindow، يجب استدعاء open لعرضها على الخريطة. يمكن للمستخدم النقر على زر الإغلاق في InfoWindow لإزالته من الخريطة، أو يمكن للمطوّر استدعاء close()‎ للحصول على التأثير نفسه.

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

InfoWindowOptions interface

واجهة google.maps.InfoWindowOptions

عنصر InfoWindowOptions يُستخدَم لتحديد السمات التي يمكن ضبطها في InfoWindow.

الخصائص
ariaLabel اختياري	النوع: string optional ‫AriaLabel المطلوب تخصيصه لـ InfoWindow
content اختياري	النوع: string|Element|Text optional المحتوى الذي سيتم عرضه في InfoWindow يمكن أن يكون هذا عنصر HTML أو سلسلة نص عادي أو سلسلة تحتوي على HTML. سيتم تحديد حجم InfoWindow وفقًا للمحتوى. لضبط حجم صريح للمحتوى، اضبط المحتوى ليكون عنصر HTML بهذا الحجم.
disableAutoPan اختياري	النوع: boolean optional القيمة التلقائية: false إيقاف تحريك الخريطة لجعل InfoWindow مرئيًا بالكامل عند فتحه
headerContent اختياري	النوع: string|Element|Text optional المحتوى الذي سيتم عرضه في صف عنوان InfoWindow. يمكن أن يكون هذا عنصر HTML أو سلسلة من النص العادي. سيتم تحديد حجم InfoWindow وفقًا للمحتوى. لضبط حجم صريح لمحتوى العنوان، اضبط headerContent ليكون عنصر HTML بهذا الحجم.
headerDisabled اختياري	النوع: boolean optional يؤدي هذا الإعداد إلى إيقاف صف العنوان بالكامل في InfoWindow. عند ضبط هذه السمة على "صحيح"، ستتم إزالة العنوان لإخفاء محتواه وزر الإغلاق.
maxWidth اختياري	النوع: number optional الحد الأقصى لعرض InfoWindow، بغض النظر عن عرض المحتوى. لا يتم أخذ هذه القيمة في الاعتبار إلا إذا تم ضبطها قبل استدعاء open(). لتغيير الحد الأقصى للعرض عند تغيير المحتوى، يمكنك استدعاء close() وsetOptions() ثم open().
minWidth اختياري	النوع: number optional الحد الأدنى لعرض InfoWindow، بغض النظر عن عرض المحتوى عند استخدام هذه السمة، ننصح بشدة بضبط minWidth على قيمة أقل من عرض الخريطة (بالبكسل). لا يتم أخذ هذه القيمة في الاعتبار إلا إذا تم ضبطها قبل استدعاء open(). لتغيير الحد الأدنى للعرض عند تغيير المحتوى، يمكنك استدعاء close() وsetOptions() ثم open().
pixelOffset اختياري	النوع: Size optional تمثّل هذه السمة الإزاحة بالبكسل لطرف نافذة المعلومات من النقطة على الخريطة التي تم تثبيت نافذة المعلومات عندها وفقًا لإحداثياتها الجغرافية. إذا تم فتح InfoWindow باستخدام علامة ارتساء، سيتم احتساب pixelOffset من السمة anchorPoint لعلامة الارتساء.
position اختياري	النوع: LatLng|LatLngLiteral optional تمثّل هذه السمة LatLng التي سيتم عرض InfoWindow فيها. إذا تم فتح InfoWindow باستخدام علامة ارتساء، سيتم استخدام موضع علامة الارتساء بدلاً من ذلك.
zIndex اختياري	النوع: number optional يتم عرض جميع نوافذ المعلومات على الخريطة بترتيب zIndex، مع عرض القيم الأعلى أمام نوافذ المعلومات ذات القيم الأقل. يتم تلقائيًا عرض نوافذ المعلومات وفقًا لخط العرض، حيث تظهر نوافذ المعلومات ذات خطوط العرض المنخفضة أمام نوافذ المعلومات ذات خطوط العرض الأعلى. يتم عرض InfoWindows دائمًا أمام العلامات.

واجهة InfoWindowOpenOptions

واجهة google.maps.InfoWindowOpenOptions

خيارات فتح InfoWindow

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