نافذة الإعدادات

مربع حوار إعدادات على مستوى التطبيق متحكَّم به مع طرق عرض عامة وملف شخصي وأدوات وتخزين. يُنقل إلى جسم المستند، ويمتلك تنقله الداخلي بين الصفحات، ويترك عنصر التشغيل وحالة الفتح لأي صفحة أو شريط جانبي أو قائمة حساب تقوم بتثبيته.

التثبيت

نافذة الإعدادات هي كتلة تطبيق متعددة الملفات مع عدة تبعيات للمكوّنات الأساسية. ثبّتها عبر CLI حتى يتم حل مجلد الإعدادات الكامل والمكوّنات المشتركة والخطافات والأنماط وحزم npm معاً:

الوضع الداكن جاهز - هذا مكوّن يتبع رموز التصميم الدلالية لـ BoardUI تلقائياً. إعداد تبديل السمة.

npx boardui@latest add settings-modal

هل تستخدم حزمة واجهة مستخدم مشتركة أو أسماء استيراد مختصرة مخصصة؟ تهيئة مسارات التثبيت قبل تشغيل CLI. تستخدم أمثلة النسخ واللصق الاستيرادات الافتراضية.

تشغيل النافذة المنبثقة

لا يُصيّر الكتلة عامل التشغيل الخاص بها. احتفظ بـ isOpen في المضيف الذي يملك الإجراء - مثل الشريط الجانبي أو قائمة المستخدم أو زر الإعدادات - وأغلقه من خلال onClose. الضغط على الخلفية، ومفتاح Escape، وزر الإغلاق، كلها تستدعي المعالج ذاته.

const [settingsOpen, setSettingsOpen] = useState(false);
<SidebarItem onPress={() => setSettingsOpen(true)}>  Settings</SidebarItem>
<SettingsModal  isOpen={settingsOpen}  onClose={() => setSettingsOpen(false)}  defaultPage="profile"/>

الصفحة الأولية

استخدام defaultPage عندما يجب أن يفتح إجراء سياقي مباشرةً على General أو Profile أو Tools أو Storage. تُعاد الصفحة المحددة إلى تلك القيمة في كل مرة يُفتح فيها مربع الحوار.

<SettingsModal isOpen={isOpen} onClose={close} defaultPage="storage"/>

صورة الخطة

تتضمن العرض العام معالجةً تجريديةً أصيلة للمكوّن بشكل افتراضي. مرّر صورتك العامة الخاصة عبر planArtSrc لتغذية عمل الخطة الحالية المتحرك دون ربط الكتلة المثبّتة بأصول BoardUI.

<SettingsModal  isOpen={isOpen}  onClose={close}  planArtSrc="/brand/your-plan-art.png"/>;
// Omit planArtSrc to use the built-in token-based abstract artwork.