عرض مصدر ReactNative/usecolorscheme

<noinclude>{{DISPLAYTITLE:الدالة useColorScheme في React Native}}</noinclude>
يوفّر الخطّاف <code>useColorScheme</code> الخاص بمكتبة React ويشترك في تحديثات نظام الألوان من الوحدة <code>[[ReactNative/appearance|Appearance]]</code>. تشير القيمة المُعادة إلى نظام الألوان المفضل للمستخدم الحالي، وقد تحدَّث القيمة لاحقًا، إما من خلال إجراء المستخدم المباشر (مثل اختيار القالب theme في إعدادات الجهاز) أو وفقًا لجدول زمني (مثل القوالب الفاتحة والداكنة التي تتبع دورة النهار أو الليل).<syntaxhighlight lang="javascript">
import { useColorScheme } from 'react-native';
</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';

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]]