Dimensions في React Native
التوابع
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) يحتوي الأبعاد المراد ضبطها.