window.ar.md

WebPlatform

[English]

[رجوع]

نافذة (Window)

صنف يمثل النافذة الرئيسية للتطبيق، والتي تقابل نافذة اللسان في المتصفح أو نافذة التطبيق في حالة تطبيقات الويب.

النموذج (instance)

عرف النموذج: نـافذة(0~مثل[مؤشر])؛

@shared def instance: Window(0~cast[ptr]);

الكائن الوحيد من هذا الصنف والذي يمثل نافذة التطبيق الرئيسية.

الطراز (style)

عملية هذا.الطراز: سـندنا[طـقم_طرز]

handler this.style: SrdRef[StyleSet];

الحصول على طقم الطرز الخاص بالنافذة. ستنشئ الدالة طقم طرز للنافذة إن لم يكن منشأً مسبقًا.

مخزن_الجلسة (sessionStorage)

عرف مخزن_الجلسة: مـخزن(0)؛

def sessionStorage: Storage(0);

المخزن المستعمل لحفظ معلومات الجلسة.

المخزن_المحلي (localStorage)

عرف المخزن_المحلي: مـخزن(1)؛

def localStorage: Storage(1);

المخزن المستعمل لحفظ المعلومات المحلية الخاصة بالمستخدم على جهازه.

حدد_المشهد (setView)

عملية هذا.حدد_المشهد(مشهد: سـندنا[ودجـة])؛

handler this.setView(v: SrdRef[Widget]);

دالة لتحديد المشهد الرئيسي الذي نريد عرضه في النافذة.

أزل_المشهد (unsetView)

عملية هذا.أزل_المشهد()؛

handler this.unsetView();

دالة لإزالة المشهد المعروض حالياً.

الموقع (location)

عملية هذا.الموقع: نـص؛

handler this.location: String;

العنوان الكامل الحالي كما هو في شريط العنوان في المتصفح. يشمل هذا البروتوكول والخادم والمسار والاستعلامات والوسم.

بروتوكول_الموقع (locationProtocol)

عملية هذا.بروتوكول_الموقع: نـص؛

handler this.locationProtocol: String;

خصلة تستعيد البروتوكول (http أو https) من العنوان.

خادم_الموقع (locationHost)

عملية هذا.خادم_الموقع: نـص؛

handler this.locationHost: String;

خصلة تستعيد عنوان الخادم فقط دون بقية عناصر العنوان. أي تستعيد فقط الـDNS.

مسار_الموقع (locationPath)

عملية هذا.مسار_الموقع: نـص؛

handler this.locationPath: String;

خصلة تستعيد مسار الصفحة دون عنوان الخادم أو بقية عناصر العنوان.

استعلام_الموقع (locationQuery)

عملية هذا.استعلام_الموقع: نـص؛

handler this.locationQuery: String;

تستعيد الجزء من العنوان الذي يلي علامة ؟.

وسم_الموقع (locationHash)

عملية هذا.وسم_الموقع: نـص؛

handler this.locationHash: String;

خصلة تستعيد الجزء من العنوان الذي يلي علامة #.

هات_متغير_استعلام (getQueryParam)

عملية هذا.هات_متغير_استعلام(اسم_المتغير: مـؤشر_محارف): نـص؛

handler this.getQueryParam(paramName: CharsPtr): String;

ترجع هذه الدالة قيمة واحد من متغيرات الاستعلام (query params) من العنوان. ترجع نصًا فارغًا إن لم يوجد متغير بالاسم المعطى.

ادفع_مسارا (pushLocation)

عملية هذا.ادفع_مسارا(مسار: مؤشر[مصفوفة[مـحرف]])؛

handler this.pushLocation (url: ptr[array[Char]]);

دالة لإضافة مسار إلى تاريخ المتصفح. تسمح هذه الدالة بتغيير عنوان المتصفح دون إعادة تحميل الصفحة.

مرئية (visible)

عملية هذا.مرئية: ثـنائي؛

handler this.visible: Bool;

ترجع 1 إن كانت الصفحة مرئية و 0 في حالة لم تكن مرئية (مثلًا عندما تكون نافذة المتصفح مصغرة إلى شريط التطبيقات أو أن المتصفح يعرض في الوقت الحالية صفحة أخرى في لسان منفصل).

أرسل_رسالة (postMessage)

عملية هذا.أرسل_رسالة(نوع_الرسالة: مـؤشر_محارف، متن_الرسالة: مـؤشر_محارف)؛

handler this.postMessage (msgType: CharsPtr, msgBody: CharsPtr);

تُستخدم لإرسالة رسالة مخصصة للنافذة الحالية. تُرسل الرسالة بصيغة جيسون بعنصرين: type و body، وقيمتاهما من معطيات الدالة.

ارسل_رسالة_للمالك (postMessageToParent)

عملية هذا.ارسل_رسالة_للمالك(نوع_الرسالة: مـؤشر_محارف، متن_الرسالة: مـؤشر_محارف)؛

handler this.postMessageToParent (msgType: CharsPtr, msgBody: CharsPtr);

مماثلة لدالة أرسل_رسالة (postMessage) لكنها ترسل الرسالة لمالك هذه النافذة وهذا ينطبق فقط في حالة كان الموقع مفتوحًا ضمن عنصر iframe لموقع آخر، فتكون الرسالة للموقع الذي يحتوي الiframe.

عند_بدء_الكبسة (onKeyDown)

عرف عند_بدء_الكبسة: إشـارة_حدث_دوم[نـافذة، نـص]؛

def onKeyDown: DomEventSignal[Window, String];

حدث يُثار عند الضغط على زر في لوحة المفاتيح.

عند_انتهاء_الكبسة (onKeyUp)

عرف عند_انتهاء_الكبسة: إشـارة_حدث_دوم[نـافذة، نـص]؛

def onKeyUp: DomEventSignal[Window, String];

حدث يُثار عند انتهاء الضغط على زر في لوحة المفاتيح.

عند_تغير_احتكار_المؤشر (onPointerLockChange)

عرف عند_تغير_احتكار_المؤشر: إشـارة_حدث_دوم[نـافذة، ثـنائي]؛

def onPointerLockChange: DomEventSignal[Window, Bool];

حدث يُثار عند تغير احتكار المؤشر.

عند_تغير_ملء_الشاشة (onFullScreenChange)

عرف عند_تغير_ملء_الشاشة: إشـارة_حدث_دوم[نـافذة، ثـنائي]؛

def onFullScreenChange: DomEventSignal[Window, Bool];

حدث يُثار عند تغير حالة ملء الشاشة.

عند_ربط_مقبض (onGamepadConnected)

عرف عند_ربط_مقبض: إشـارة_حدث_دوم[نـافذة، نـص]؛

def onGamepadConnected: DomEventSignal[Window, String];

حدث يُثار عند ربط مقبض ألعاب.

عند_فصل_مقبض (onGamepadDisconnected)

عرف عند_فصل_مقبض: إشـارة_حدث_دوم[نـافذة، نـص]؛

def onGamepadDisconnected: DomEventSignal[Window, String];

حدث يُثار عند فصل مقبض ألعاب.

عند_تغير_المسار (onLocationChanged)

عرف عند_تغير_المسار: إشـارة_حدث_دوم[نـافذة، صـحيح]؛

def onLocationChanged: DomEventSignal[Window, Int];

حدث يُثار عند تغير المسار في المتصفح دون إعادة تحميل الصفحة. يُثار هذا الحدث عند استدعاء دالة ادفع_مسارا (pushLocation) أو عند كبس المستخدم على زر الرجوع أو التقدم في المتصفح.

عند_تغير_المرئية (onVisibilityChanged)

عرف عند_تغير_المرئية: إشـارة_حدث_دوم[نـافذة، صـحيح]؛

def onVisibilityChanged: DomEventSignal[Window, Int];

حدث يُثار عند تغير حالة مرئية الصفحة في المتصفح. يُثار هذا الحدث عند تغير الحالة من مرئي إلى غير مرئي (مثلا تصغير نافذة المتصفح إلى شريط التطبيقات، أو قلب لسان المتصفح إلى صفحة مختلفة أو الانتقال من المتصفح إلى تطبيق آخر على هاتف أو حاسوب لوحي) والعكس.

عند_استلام_رسالة (onMessage)

عرف عند_استلام_رسالة: إشـارة_حدث_دوم[نـافذة، جـيسون]؛

def onMessage: DomEventSignal[Window, Json];

حدث يُثار عند وصول رسالة إلى هذه النافذة.