الفرق بين المراجعتين لصفحة: «Cordova/cordova plugin screen orientation»

من موسوعة حسوب
التعديل اللاحق ←
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:إضافة اتجاه الشبكة في كوردوفا}}</noinclude> تصنيف: Cordova تصنيف: Plugin تُستخدم إضا...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:إضافة اتجاه الشبكة في كوردوفا}}</noinclude>
<noinclude>{{DISPLAYTITLE:إضافة اتجاه الشبكة في كوردوفا}}</noinclude>
[[تصنيف: Cordova]]
[[تصنيف: Cordova]]
[[تصنيف: Plugin]]
[[تصنيف: Plugin]]
تُستخدم إضافة اتجاه الشبكة (cordova-plugin-screen-orientation) لتعيين أو قفل (lock) اتجاه الشاشة بطريقة موحدة في المنصاتـiOS و أندرويد و windows-uwp. تعتمد هذه الإضافة على [http://www.w3.org/TR/screen-orientation/ Screen Orientation API]، حتى تتطابق الواجهة البرمجية مع المواصفات الحالية.  
تُستخدم إضافة اتجاه الشبكة (<code>cordova-plugin-screen-orientation</code>) لتعيين أو قفل (lock) اتجاه الشاشة بطريقة مُوحّدة في المنصات iOS و أندرويد و منصة ويندوز الكونية (windows-uwp). تعتمد هذه الإضافة على [http://www.w3.org/TR/screen-orientation/ الواجهة البرمجية لاتجاه الشبكة]، حتى تتطابق مع المواصفات الحالية.


تضيف هذه الإضافة العناصر التالية إلى كائن الشاشة (<code>window.screen</code>):  
تضيف هذه الإضافة العناصر التالية إلى كائن الشاشة (<code>window.screen</code>):  
<syntaxhighlight lang="javascript">// lock the device orientation
<syntaxhighlight lang="javascript">// قفل توجيه الجهاز
.orientation.lock('portrait')
.orientation.lock('portrait')
// unlock the orientation
// تحرير توجيه الجهاز
.orientation.unlock()
.orientation.unlock()
// current orientation
// الاتجاه الحالي
.orientation‎</syntaxhighlight>  
.orientation‎</syntaxhighlight>  


== التثبيت ==  
== التثبيت ==
<syntaxhighlight lang="javascript">cordova plugin add cordova-plugin-screen-orientation‎</syntaxhighlight>  
يمكن تثبيت هذه الإضافة عبر الأمر التالي:<syntaxhighlight lang="shell">cordova plugin add cordova-plugin-screen-orientation‎</syntaxhighlight>  


== التوجيهات المدعومة ==  
== الاتجاهات المدعومة ==  
====portrait-primary====  
===<code>portrait-primary</code>===  
الاتجاه يكون في الوضع العمودي الأولي (primary portrait mode).  
يمثل هذا الاتجاه الوضع العمودي الأولي (primary portrait mode).  
====portrait-secondary====  
===<code>portrait-secondary</code>===  
الاتجاه في الوضع العمودي الثانوي.  
الوضع العمودي الثانوي (secondary portrait mode).  
====landscape-primary====  
===<code>landscape-primary</code>===  
الاتجاه في الوضع الأفقي الأولي (primary landscape mode).  
الوضع الأفقي الأولي (primary landscape mode).  
====landscape-secondary====  
===<code>landscape-secondary</code>===  
الاتجاه في الوضع الأفقي الثانوي (secondary landscape mode).  
الوضع الأفقي الثانوي (secondary landscape mode).  
====portrait====  
===<code>portrait</code>===  
الاتجاه إما في الوضع العمودي الأولي أو الوضع العمودي الثانوي (sensor).  
الوضع العمودي الأولي أو الثانوي (sensor).  
====landscape====  
===<code>landscape</code>===  
الاتجاه إما في الوضع الأفقي الأولي أو الثانوي (sensor).  
الوضع الأفقي الأولي أو الثانوي (sensor).  
====any====  
===<code>any</code>===  
تحرير التوجيه، بحيث يتم دعم جميع الاتجاهات.  
تحرير التوجيه، بحيث تُدعم جميع الاتجاهات.  


==الاستخدام==  
==طريقة الاستخدام==  
<syntaxhighlight lang="javascript">// set to either landscape
<syntaxhighlight lang="javascript">// تعين الاتجاه إلى أحد الوضعين الأفقيين
screen.orientation.lock('landscape');
screen.orientation.lock('landscape');
// allow user rotate
// إتاحة إدارة الاتجاه من قِبل المستخدم
screen.orientation.unlock();
screen.orientation.unlock();
// access current orientation
// الحصول على الاتجاه الحالي
console.log('Orientation is ' + screen.orientation.type);‎</syntaxhighlight>  
console.log('Orientation is ' + screen.orientation.type);‎</syntaxhighlight>  


==الأحداث==  
==الأحداث==  


سيطلق كل من منصتي أندرويد و iOS الحدث orientationchange من الكائن window. في هذا الإصدار من الإضافة، استخدم الكائن window إذا كنت تريد طريقة للتنبيه.  
ستُطلق كلٌّ من منصتي أندرويد و iOS الحدث <code>orientationchange</code> من الكائن <code>window</code>. في هذا الإصدار من الإضافة، استخدم الكائن <code>window</code> إذا كنت تريد طريقة للتنبيه لتغيير الاتجاه.  
=== مثال للاستخدام ===  
=== أمثلة ===  
<syntaxhighlight lang="javascript">window.addEventListener("orientationchange", function(){
<syntaxhighlight lang="javascript">window.addEventListener("orientationchange", function(){
     console.log(screen.orientation.type); // e.g. portrait
     console.log(screen.orientation.type); // الوضع العمودي مثلا
});‎</syntaxhighlight>  
});‎</syntaxhighlight>  


تمت إضافة مُنصتٍ (listener) للحدث changeأيضًا إلى الكائن screen.orientation.  
في الشيفرة التالية سنُضيف مُنصتًا (listener) للحدث <code>change</code> في الكائن <code>screen.orientation</code>. <syntaxhighlight lang="javascript">screen.orientation.addEventListener('change', function(){
=== مثال للاستخدام ===
     console.log(screen.orientation.type); // الوضع العمودي مثلا
<syntaxhighlight lang="javascript">screen.orientation.addEventListener('change', function(){
     console.log(screen.orientation.type); // e.g. portrait
});
});
     // OR
     // أو
screen.orientation.onchange = function(){console.log(screen.orientation.type);
screen.orientation.onchange = function(){console.log(screen.orientation.type);
};‎</syntaxhighlight>  
};‎</syntaxhighlight>  
سطر 58: سطر 56:
== ملاحظات حول أندرويد ==  
== ملاحظات حول أندرويد ==  


لن تُحدّث الخاصية <code>screen.orientation</code> عندما يكون يُدار الهاتف [http://www.quirksmode.org/dom/events/orientationchange.html rotated 180 degrees].  
لن تُحدّث الخاصية <code>screen.orientation</code> عندما [http://www.quirksmode.org/dom/events/orientationchange.html يُدار الهاتف 180 درجة].  


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


لن تعرض تطبيقات متجر ويندوز (windows-uwp) تغييرات الاتجاه إلا إن كان الجهاز مُزودًا بمقياسٍ للتسارع (accelerometer). ستُحفظ الحالة الداخلية للكائن orientation، ولكن لن يتم تدوير الشاشة فعليًا ما لم يكن الجهاز يدعم ذلك.  
لن تعرض تطبيقات متجر ويندوز (windows-uwp) تغييرات الاتجاه إلّا إن كان الجهاز مُزودًا بمقياسٍ للتسارع (accelerometer). ستُحفظ الحالة الداخلية للكائن <code>orientation</code>، ولكن لن يتم تدوير الشاشة فعليًا ما لم يكن الجهاز يدعم ذلك.  
 
== سجل التغييرات ==
يمكنك زيارة على [https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-screen-orientation/index.html#Changelog صفحة التوثيق الرسمي] لمطالعة تاريخ التغييرات على هذه الإضافة.
 
== انظر أيضا ==
* إضافة <nowiki/>[[Cordova/cordova plugin device|حالة الجهاز]]
* إضافة [[Cordova/cordova plugin geolocation|تحديد الموقع الجغرافي]]
* [[Cordova/plugins|دليل تطوير الإضافات في كوردوفا]]


==مصادر==
==مصادر==
*[https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-screen-orientation/index.html صفحة Cordova Screen Orientation Plugin في توثيق كوردوفا الرسمي.]
*[https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-screen-orientation/index.html صفحة Cordova Screen Orientation Plugin في توثيق كوردوفا الرسمي.]

مراجعة 11:38، 22 ديسمبر 2018

تُستخدم إضافة اتجاه الشبكة (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، ولكن لن يتم تدوير الشاشة فعليًا ما لم يكن الجهاز يدعم ذلك.

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

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

انظر أيضا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Cordova/cordova_plugin_screen_orientation&oldid=26586»