ReactNative/dimensions

التوابع

‎‎addEventListener()‎‎

static addEventListener(type, handler)

أضف معالج أحداث. الأحداث المدعومة:

• ‎‎change‎: يُطلَق عند تغيّر خاصيةٍ داخل كائن ‎‎Dimensions‎‎. المعامل المُمرَّر لمعالج الحدث هو كائن ذو الخاصيتين ‎‎window‎‎، و‎‎screen‎‎ والتي تكون قيمتاهما نفسهما القيمتان المُعادتان من استدعاء كل من ‎‎Dimensions.get('window')‎‎، و‎‎Dimensions.get('screen')‎‎ على التوالي.

‎‎get()‎‎

static get(dim)

تُعيَّن الأبعاد الأولية قبل استدعاء‎‎runApplication‎‎، لذا من المفترض أن تكون متوفرة قبل تشغيل أي متطلبات (‎‎require‎‎) أخرى، ولكنها قد تُحدَّث لاحقًا.

ملاحظة: على الرغم من توفر الأبعاد على الفور، إلا أنها قد تتغير (بسبب تدوير الجهاز مثلا)، لذلك ينبغي لأي منطق تصيير (rendering logic) أو أنماطٍ (styles) تعتمد على هذه الثوابت مُحاولةُ استدعاء هذه الدالة عند كل تصيير، بدلاً من التخزين المؤقت (caching) للقيمة (استخدام الأنماط السطرية [inline styles] عوضًا عن تعيين قيمة في ‎‎StyleSheet‎‎ مثلا).

مثال

var {height, width} = Dimensions.get('window');

المعاملات

• ‎dim‎‎ (سلسلة نصيّة): اسم البعد كما هو محدد عند استدعاء ‎‎set‎‎.

القيمة المعادة

قيمةُ البُعد.

ملاحظة: في Android، سيستبعد البُعد ‎‎window‎‎ الحجم المُستخدَم من طرف شريط الحالة (إن لم يكن شفافًا) وشريط التنقل السفلي.

‎‎removeEventListener()‎‎

static removeEventListener(type, handler)

إزالة معالج الأحداث.

‎‎set()‎‎

static set(dims)

يجب أن يُستدعى هذا فقط من طرف الشيفرة الأصيلة عن طريق إرسال الحدث ‎‎didUpdateDimensions‎‎.

المعاملات

• ‎‎dims‎‎ (كائن): كائنٌ مفاتيحه نصيّة (string-keyed) يحتوي الأبعاد المراد ضبطها.

مصادر

• صفحة Dimensions في توثيق React Native الرسمي.