الفرق بين المراجعتين ل"ReactNative/usecolorscheme"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'== الخطّاف useColorScheme == <syntaxhighlight lang="javascript"> import { useColorScheme } from 'react-native'; </syntaxhighlight>يوفّر خطّاف <code>useC...')
 
ط
 
(3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
== الخطّاف useColorScheme ==
+
<noinclude>{{DISPLAYTITLE:الدالة useColorScheme في React Native}}</noinclude>
<syntaxhighlight lang="javascript">
+
يوفّر الخطّاف <code>useColorScheme</code> الخاص بمكتبة React ويشترك في تحديثات نظام الألوان من الوحدة <code>[[ReactNative/appearance|Appearance]]</code>. تشير القيمة المُعادة إلى نظام الألوان المفضل للمستخدم الحالي، وقد تحدَّث القيمة لاحقًا، إما من خلال إجراء المستخدم المباشر (مثل اختيار القالب theme في إعدادات الجهاز) أو وفقًا لجدول زمني (مثل القوالب الفاتحة والداكنة التي تتبع دورة النهار أو الليل).<syntaxhighlight lang="javascript">
 
import { useColorScheme } from 'react-native';
 
import { useColorScheme } from 'react-native';
</syntaxhighlight>يوفّر خطّاف <code>useColorScheme</code> React ويشترك في تحديثات نظام الألوان من وحدة المظهر. تشير قيمة الإرجاع إلى نظام الألوان المفضل للمستخدم الحالي. قد يتم تحديث القيمة لاحقًا ، إما من خلال إجراء المستخدم المباشر (مثل اختيار الموضوع في إعدادات الجهاز) أو وفقًا لجدول زمني (مثل السمات الفاتحة والداكنة التي تتبع دورة النهار / الليل).
+
</syntaxhighlight>
 +
== أنظمة الألوان المدعومة ==
 +
<code>"light"</code>: يفضل المستخدم قالب لون فاتح.
  
أنظمة الألوان المتوافقة #
+
<code>"dark"</code>: يفضل المستخدم  قالب لون داكن.
  
"فاتح": يفضل المستخدم مظهر اللون الفاتح.
+
<code>null</code>: لم يحدّد المستخدم قالب اللون المفضل.
  
"داكن": يفضل المستخدم سمة اللون الداكن.
+
'''ملاحظة''': سيعيد هذا الخطاف دائمًا القيمة <code>"light"</code> عند تفعيل منقّح أخطاء Chrome نظرًا للقيود التقنية حاليًا.
  
خالية: لم يشر المستخدم إلى سمة اللون المفضلة.
+
== مثال ==
 +
إليك المثال التالي ([https://snack.expo.dev/@hsoubwiki/usecolorscheme-example تجربة حية]):<syntaxhighlight lang="javascript">
 +
import React from 'react';
 +
import { Text, StyleSheet, useColorScheme, View } from 'react-native';
  
ملاحظة: نظرًا للقيود التقنية حاليًا ، عند تمكين مصحح أخطاء Chrome ، سيعود هذا الخطاف دائمًا "light".
+
const App = () => {
 +
  const colorScheme = useColorScheme();
 +
  return (
 +
    <View style={styles.container}>
 +
      <Text>useColorScheme(): {colorScheme}</Text>
 +
    </View>
 +
  );
 +
};
  
مثال
+
const styles = StyleSheet.create({
 +
  container: {
 +
    flex: 1,
 +
    alignItems: "center",
 +
    justifyContent: "center"
 +
  },
 +
});
 +
 
 +
export default App;
 +
</syntaxhighlight>يمكنك العثور على مثال كامل يوضح استخدام هذا الخطاف ضمن سياق React لإضافة الدعم للقوالب الفاتحة والداكنة لتطبيقك في <code>[https://github.com/facebook/react-native/blob/master/packages/rn-tester/js/examples/Appearance/AppearanceExample.js AppearanceExample.js]</code>.
 +
 
 +
== مصادر ==
 +
 
 +
* [https://reactnative.dev/docs/usecolorscheme صفحة useColorScheme في توثيق React Native الرسمي.]
 +
[[تصنيف:ReactNative]]
 +
[[تصنيف:React Native API]]

المراجعة الحالية بتاريخ 14:13، 9 أكتوبر 2021

يوفّر الخطّاف useColorScheme الخاص بمكتبة React ويشترك في تحديثات نظام الألوان من الوحدة Appearance. تشير القيمة المُعادة إلى نظام الألوان المفضل للمستخدم الحالي، وقد تحدَّث القيمة لاحقًا، إما من خلال إجراء المستخدم المباشر (مثل اختيار القالب theme في إعدادات الجهاز) أو وفقًا لجدول زمني (مثل القوالب الفاتحة والداكنة التي تتبع دورة النهار أو الليل).

import { useColorScheme } from 'react-native';

أنظمة الألوان المدعومة

"light": يفضل المستخدم قالب لون فاتح.

"dark": يفضل المستخدم قالب لون داكن.

null: لم يحدّد المستخدم قالب اللون المفضل.

ملاحظة: سيعيد هذا الخطاف دائمًا القيمة "light" عند تفعيل منقّح أخطاء Chrome نظرًا للقيود التقنية حاليًا.

مثال

إليك المثال التالي (تجربة حية):

import React from 'react';
import { Text, StyleSheet, useColorScheme, View } from 'react-native';

const App = () => {
  const colorScheme = useColorScheme();
  return (
    <View style={styles.container}>
      <Text>useColorScheme(): {colorScheme}</Text>
    </View>
  );
};

const styles = StyleSheet.create({
  container: {
    flex: 1,
    alignItems: "center",
    justifyContent: "center"
  },
});

export default App;

يمكنك العثور على مثال كامل يوضح استخدام هذا الخطاف ضمن سياق React لإضافة الدعم للقوالب الفاتحة والداكنة لتطبيقك في AppearanceExample.js.

مصادر