إضافة اتجاه الشاشة في كوردوفا

تُستخدم إضافة اتجاه الشاشة (cordova-plugin-screen-orientation) لتعيين أو تجميد (lock) اتجاه الشاشة بطريقة مُوحّدة في المنصات iOS و أندرويد و منصة ويندوز الكونية (windows-uwp). تعتمد هذه الإضافة على الواجهة البرمجية لاتجاه الشاشة، حتى تتطابق مع المواصفات الحالية.

تضيف هذه الإضافة العناصر التالية إلى كائن الشاشة (window.screen):

// تجميد توجيه الجهاز
.orientation.lock('portrait')
// تحرير توجيه الجهاز
.orientation.unlock()
// الاتجاه الحالي
.orientation‎

التثبيت

يمكن تثبيت هذه الإضافة عبر الأمر التالي:

cordova plugin add cordova-plugin-screen-orientation‎

الاتجاهات المدعومة

portrait-primary

يمثل هذا الاتجاه الوضع العمودي الأولي (primary portrait mode).

portrait-secondary

الوضع العمودي الثانوي (secondary portrait mode).

landscape-primary

الوضع الأفقي الأولي (primary landscape mode).

landscape-secondary

الوضع الأفقي الثانوي (secondary landscape mode).

portrait

الوضع العمودي الأولي أو الثانوي (sensor).

landscape

الوضع الأفقي الأولي أو الثانوي (sensor).

any

تحرير التوجيه، بحيث تُدعم جميع الاتجاهات.

طريقة الاستخدام

// تعين الاتجاه إلى أحد الوضعين الأفقيين
screen.orientation.lock('landscape');
// إتاحة إدارة الاتجاه من قِبل المستخدم
screen.orientation.unlock();
// الحصول على الاتجاه الحالي
console.log('Orientation is ' + screen.orientation.type);‎

الأحداث

ستُطلق كلٌّ من منصتي أندرويد و iOS الحدث orientationchange من الكائن window. في هذا الإصدار من الإضافة، استخدم الكائن window إن كنت تريد طريقة للتنبيه بتغيير الاتجاه.

أمثلة

window.addEventListener("orientationchange", function(){
    console.log(screen.orientation.type); // مثلا الوضع العمودي 
});‎

في الشيفرة التالية سنُضيف مُنصتًا (listener) للحدث change في الكائن screen.orientation.

screen.orientation.addEventListener('change', function(){
    console.log(screen.orientation.type); // مثلا الوضع العمودي 
});
    // أو
screen.orientation.onchange = function(){console.log(screen.orientation.type);
};‎

ملاحظات حول أندرويد

لن تُحدَّث الخاصية screen.orientation عندما يُدار الهاتف 180 درجة.

ملاحظات حول منصة ويندوز الكونية UWP

لن تَعرض تطبيقات متجر ويندوز (windows-uwp) تغييرات الاتجاه إلّا إن كان الجهاز مُزودًا بمقياسٍ للتسارع (accelerometer). ستُحفظ الحالة الداخلية للكائن orientation، ولكن لن يتم تدوير الشاشة فعليًا ما لم يكن الجهاز يدعم ذلك.

سجِل التغييرات

يمكنك زيارة صفحة التوثيق الرسمي لمطالعة تاريخ التغييرات على هذه الإضافة.

انظر أيضا

• إضافة حالة الجهاز
• إضافة شاشة البدء
• دليل تطوير الإضافات في كوردوفا

مصادر

• صفحة Cordova Screen Orientation Plugin في توثيق كوردوفا الرسمي.