محرّر الشفرة: المفاتيح والهامش والتلوين والإكمال
محرّر صفحة البرمجة النصية منطقة نصّ شفّافة فوق هامش متزامن وطبقة ملوَّنة. وهو يضيف أرقام الأسطر، ومفاتيح الإزاحة، وألوان الصياغة، وقائمة إكمال للواجهة البرمجية، دون جلب أي مكتبة محرّرات.
Senzoukria · التوثيق · آخر تحديث: سبتمبر 2026
أين تجده
- الموضع
- صفحة البرمجة النصية ← سطح التحرير المركزي
- وحدة الإزاحة
- مسافتان — مثل سكربتات العيّنة ومثل مخرجات المساعد
- التدقيق الإملائي
- معطَّل
- مصدر الإكمال
- lib.* في JavaScript، وof.* في Python — واللغة هي التي تقرّر أي قائمة تُعرَض
- الاسم المتاح للقارئات
- «Script source code»
ما الذي يفعله
منطقة النصّ المجرَّدة تفقد مفتاح Tab لصالح تنقّل التركيز، ولا تعرض أرقام أسطر، ولا تقدّم اختصارات — وثلاثتها تهمّ بمجرّد أن تكتب سكربتًا حقيقيًّا. وهذا المحرّر يحتفظ بسلوك الكتابة الأصلي في المتصفّح (التحديد، والتراجع، ومحرّر طرق الإدخال، وإتاحة الوصول) ويضيف الأجزاء الناقصة حوله: هامشًا يتمرّر مع النصّ، وطبقة ملوَّنة تحته، وقائمة إكمال.
ويعلّم الهامش سطر المؤشر النصّي، ويُبرَز بالأحمر السطرُ الذي يبلّغ عنه تشغيل فاشل، فتشير «Line 23» الآتية من الكونسول إلى شيء تستطيع رؤيته.
المفاتيح
| المفتاح | الافتراضي | ما الذي يغيّره |
|---|---|---|
| Tab | إدراج مسافتين | وعلى تحديد متعدّد الأسطر يُزيح الكتلة كلّها بدل ذلك. |
| Shift+Tab | — | يزيل مستوى إزاحة واحدًا من السطر أو من الكتلة المحدَّدة. |
| Enter | الحفاظ على الإزاحة | يحافظ على إزاحة السطر الجاري، ويضيف مستوًى بعد سطر يفتح كتلة. |
| Ctrl/Cmd+S | — | يحفظ السكربت. |
| Ctrl/Cmd+Enter | — | يشغّل السكربت على بيانات العيّنة. |
| السهم لأعلى / لأسفل | — | يتنقّل في قائمة الإكمال ما دامت مفتوحة. |
| Enter أو Tab (والقائمة مفتوحة) | — | يقبل الإكمال المُبرَز، فيستبدل البادئة المكتوبة. |
| Escape | — | يغلق قائمة الإكمال دون إدراج. |
التلوين والإكمال
- المُرمِّز يمرّ مرّةً واحدة، حرفًا حرفًا، ويصدر أصناف CSS بدل الألوان، فتبقى لوحة الألوان مع رموز تصميم المنتج وتتبع السمة.
- ومجموعات الكلمات المفتاحية لكل لغة على حدة: فلـ JavaScript ولـ Python ولـ C++ مجموعة خاصة بكلٍّ منها.
- وتقدّم قائمة الإكمال مساعدات الحساب المشتركة بين اللغتين — sma وema وwilder وstdev وhighest وlowest وrsi وatr — إضافةً إلى بُناة المخرجات في اللغة المعلَنة.
- وبُناة مخرجات JavaScript هي line وhistogram وmarkers وlevels وtable وpanel. ولدى Python الستّة نفسها إضافةً إلى bands، وmarker() مفردة، وlevel() مفردة، وهي تأخذ الوقت وسيطًا أول بدل الشموع.
- وكل إكمال منسوخ من الشفرة التي تنفّذه، لا مكتوب من الذاكرة أبدًا: فإكمال خاطئ سيعلّم واجهة برمجية غير موجودة.
الحدود والمزالق
- التمرير يغلق قائمة الإكمال عمدًا — فقائمة موضوعة بتموضع مطلق كانت ستنتهي مشيرةً إلى سطر شفرة مختلف.
- ولا طيّ للشفرة، ولا مؤشرات نصّية متعدّدة، ولا خادم لغة: فهذا محرّر صغير بالتصميم، ولا يضيف وزنًا إلى الحزمة.
- ويجب أن تتشارك الطبقة الملوَّنة ومنطقة النصّ القياسات نفسها. فإن تجاوزت الخطوط أو التباعد في سمة مخصَّصة، فقد تنحرف الألوان عن النصّ المكتوب.
صفحات ذات صلة
- نظرة عامة على صفحة البرمجة النصية
- كونسول السكربت ومعاينة المخرجات
- البرمجة النصية: كتابة مؤشر (JavaScript)
- البرمجة النصية
هذه الصفحة بلغات أخرى
أسئلة شائعة
- لماذا يقدّم الإكمال of.* في سكربت وlib.* في آخر؟
- القائمة تتبع اللغة المعلَنة للسكربت. فسكربتات JavaScript تبني المخرجات عبر lib، وسكربتات Python عبر of، وتقديم الاثنتين سيعلّم نصف واجهة برمجية غير موجودة في الملفّ الذي تكتبه.
- هل أستطيع استعمال إزاحة بأربع مسافات؟
- تستطيع كتابتها، لكن Tab يُدرج مسافتين، وهو ما تنتجه سكربتات العيّنة والمساعد. وخلط الاثنتين في ملفّ Python واحد هو المصدر المعتاد لخطأ الإزاحة.
- هل يتحقّق المحرّر من شفرتي أثناء الكتابة؟
- لا. فالتحقّق يقع حين تشغّل: التشغيل يبلّغ عن السطر المخفِق، ويُبرَز ذلك السطر عندئذٍ في الهامش.