الفرق بين المراجعتين لصفحة: «ReactNative/dimensions»
إضافة الصّفحة |
|||
| سطر 13: | سطر 13: | ||
تُعيَّن الأبعاد الأولية قبل استدعاء<code>runApplication</code>، لذا يجب أن تكون متوفرة قبل تشغيل أي متطلبات (<code>require</code>) أخرى، ولكنها قد تُحدَّث لاحقًا. | تُعيَّن الأبعاد الأولية قبل استدعاء<code>runApplication</code>، لذا يجب أن تكون متوفرة قبل تشغيل أي متطلبات (<code>require</code>) أخرى، ولكنها قد تُحدَّث لاحقًا. | ||
'''ملاحظة:''' على الرغم من توفر الأبعاد على الفور، إلا أنها قد تتغير (بسبب تدوير الجهاز مثلا)، لذلك ينبغي لأي منطق تصيير (rendering logic) أو أنماطٍ (styles) تعتمد على هذه الثوابت | '''ملاحظة:''' على الرغم من توفر الأبعاد على الفور، إلا أنها قد تتغير (بسبب تدوير الجهاز مثلا)، لذلك ينبغي لأي منطق تصيير (rendering logic) أو أنماطٍ (styles) تعتمد على هذه الثوابت مُحاولةُ استدعاء هذه الدالة عند كل تصيير، بدلاً من التخزين المؤقت (caching) للقيمة (استخدام الأنماط السطرية [inline styles] عوضًا عن تعيين قيمة في <code>StyleSheet</code> مثلا). | ||
====مثال==== | ====مثال==== | ||
| سطر 26: | سطر 26: | ||
'''ملاحظة:''' في Android، سيستبعد البُعد <code>_</code> الحجم المُستخدَم من طرف شريط الحالة (إن لم يكن شفافًا) وشريط التنقل السفلي. | '''ملاحظة:''' في Android، سيستبعد البُعد <code>_</code> الحجم المُستخدَم من طرف شريط الحالة (إن لم يكن شفافًا) وشريط التنقل السفلي. | ||
===<code>removeEventListener()</code>=== | ===<code>removeEventListener()</code>=== | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
مراجعة 19:58، 15 ديسمبر 2019
التوابع
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، سيستبعد البُعد _ الحجم المُستخدَم من طرف شريط الحالة (إن لم يكن شفافًا) وشريط التنقل السفلي.
removeEventListener()
static removeEventListener(type, handler)
إزالة معالج الأحداث.
set()
static set(dims)
يجب أن يُستدعى هذا فقط من طرف الشيفرة الأصيلة عن طريق إرسال الحدث didUpdateDimensions.
المعاملات
-
dims (كائن): كائنٌ مفاتيحه نصيّة (string-keyed) يحتوي الأبعاد المراد ضبطها.