يحتوي Pine Script® على محرر بنمط VSC جديد

Oct 4, 2022

أو لأسباب وجيهة، أصبح برنامج Visual Studio Code™ من Microsoft محررًا شائعًا للغاية في السنوات القليلة الماضية. يستخدم محرر Pine Script® الجديد محرك Monacoالخاص به، لذلك سيشعر الأشخاص المطلعون على VSC الآن وكأنهم في المنزل عند تحرير كود Pine الخاص بهم.

يأتي هذا الإصدار الأول من محررنا الجديد مع الكثير من الميزات الجديدة ويضع الأساس لإضافة المزيد في المستقبل. إنه يحقق تكاملاً أفضل مع بيئة Pine والمزيد من الميزات التي يتوقعها المبرمجون من أفضل محرري الكود.

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

دعنا نلقي نظرة على بعض ميزات محررك الجديد!

لوحة الأوامر واختصارات لوحة المفاتيح

يأتي المحرر الجديد مع عدد كبير من الخيارات والأوامر والاختصارات، والتي تشكل مجموعة فرعية من تلك المتوفرة في VSC. ستجد أكثر من 100 أمر في لوحة الأوامر، والتي يمكنك الوصول إليها باستخدام F1 أو بالنقر بزر الماوس الأيمن في المحرر لإظهار القائمة المنبثقة. يمكنك التمرير عبر لوحة الألوان أو البحث عنها بكتابة الكلمات الأساسية:

على سبيل المثال، تسمح لك أوامر تكبير / تصغير الخط / إعادة تعيين الخط في لوحة الأوامر بتغيير حجم الخط المستخدم في التعليمات البرمجية الخاصة بك:

هذه هي القائمة المنبثقة الجديدة للمحرر والتي تظهر الآن عند النقر بزر الماوس الأيمن. يحتوي على ميزات شائعة الاستخدام:

اقتراحات المعلمات الديناميكية والوثائق الإرشادية

عند كتابة استدعاءات الدوال، يرشدك إطار منبثق عبر كل معلمة من معلمات الدوال ويعرض نص الدليل المرجعي لكل منها، بحيث يمكنك بسهولة رؤية نوع النموذج والمدخلات المتوقعة. عندما يكون المؤشر داخل أقواس الدوال، يمكنك أيضًا استخدام Ctrl + Shift + Space (Windows) أو Cmd + Shift + Space (MacOS) لعرض النافذة المنبثقة عند العودة إلى استدعاء دالة موجودة:

بالإضافة إلى ذلك، ستظهر الآن ميزة الإكمال التلقائي (Ctrl + Space على Windows، أو Option + Space / Cmd + I على نظام MacOS) قائمة بالمعلمات للاختيار من بينها عند استخدامها داخل أقواس الدوال:

هذه الميزة متاحة أيضًا للدوال المصدرة من المكتبات وللدوال والمتغيرات المعلنة داخل النص الحالي، طالما تم توثيقها باستخدام //@function و//@param و//@ لإرجاع التعليقات التوضيحية:

الإكمال التلقائي

ميزة الإكمال التلقائي (Ctrl + Space على Windows أو Option + Space أو Cmd + I على MacOS) نشطة الآن دائمًا أثناء كتابة نص جديد. كما كان من قبل، يقدم لك قائمة بالكلمات الرئيسية المطابقة لأي نص كتبته، ولكن الآن يمكنه أيضًا عرض أوصاف الدليل المرجعي وأمثلة لكل كلمة من الكلمات الرئيسية في القائمة. لإحضار الأوصاف، اضغط على مفتاح التشغيل السريع للإكمال التلقائي مرة أخرى، أو قم بالمرور فوق عنصر نشط في القائمة واضغط على سهم “قراءة المزيد” إلى اليمين. سيتذكر المحرر إعداد العرض للأوصاف حتى تقوم بتحديث علامة تبويب المتصفح:

تمتد هذه الدالة أيضًا إلى الدوال والمتغيرات التي يحددها المستخدم من كل من البرنامج النصي الحالي والمكتبات المستوردة، بشرط توثيقها باستخدام //@function و//@param و//@returns لإرجاع التعليقات التوضيحية للدوال و//@variable لـلمتغيرات:

تمييز الخطأ والتحذير

المحرر الجديد يتفاعل الآن ديناميكيًا مع المترجم. عندما يُنشئ سطر جديد خطأً في التجميع أو تحذيرًا، يتم وضع خط تحته باللون الأحمر فورًا بالنسبة للأخطاء والبرتقالي للتحذيرات. عند التمرير فوق الخط، يعرض تلميح أداة الخطأ أو نص التحذير. لا مزيد من إضافة النص البرمجي إلى الرسم البياني الخاص بك فقط لتعلم أنك أخطأت في كتابة شيء ما قبل ساعة! كما كان من قبل، سيؤدي النقر فوق رسالة خطأ وحدة التحكم إلى نقلك إلى السطر الذي يسبب الخطأ.

الطي حسب النطاقات أو المناطق المخصصة

يمكن الآن طي الأسطر ذات المسافة البادئة أو الملتفة بالنقر فوق السهم الذي يظهر بجانبها عند وضع المؤشر في الهامش الأيسر:

 

يمكنك الطي بشكل جماعي أو انتقائي باستخدام عدد من خيارات الطي. استخدم لوحة الأوامر (اضغط على F1 واكتب “طي”) لرؤيتها:

يمكن أيضًا تحديد المناطق القابلة للطي المخصصة باستخدام تعليقات //#region و //#endregion compiler  التوضيحية، والتي تحل محل التعليقات التوضيحية السابقة //{ and //} :

 

خريطة مصغرة

يعرض الجانب الأيمن من المحرر الجديد شريطًا جانبيًا مصغرًا، وهو تمثيل مصغر للنص. يمكنك استخدامه للتنقل بسرعة حول التعليمات البرمجية الخاصة بك، أو لفحص الأسطر التي تولد أخطاء / تحذيرات، ونتائج البحث، وما إلى ذلك. سيُظهر أيضًا مكان حدوث الكلمة أو التحديد الحالي في البرنامج النصي الخاص بك:

تحسين دالة البحث والاستبدال

تبحث دوال البحث الجديدة (Ctrl + F في نظام التشغيل Windows و Cmd + F في نظام MacOS) والاستبدال (Ctrl + H في Windows و Option + Cmd + F في نظام MacOS) الآن عن الكلمة التي يوجد بها المؤشر أو التحديد الحالي. كما تقوم بتحديث عدد الاكتشافات ديناميكيًا عند استبدالها.

يمكنك البحث ضمن التحديد باستخدام هذه الأيقونة:

يمكن أيضًا استبدال النص بتحديد مثيلات متكررة للكلمة باستخدام Ctrl + D / Cmd + D أو Ctrl + K Ctrl + D / Cmd + K Cmd + D وكتابة الاستبدال. سيحدد Ctrl + Shift + L / Cmd + Shift + L جميع تكرارات الكلمة، والتي يمكنك استبدالها بعد ذلك بكتابة استبدالها.

أداة انتقاء اللون

يظهر حامل اللون الآن في أي مكان تحدده للون، سواء كان ذلك باستخدام ثابت مضمّن مثل color.blackأو قيمة سداسية عشرية أو دالة مرتبطة بالألوان مثل color.new() أو color.rgb(). سيؤدي التمرير فوق اللون أو حامله إلى إظهار منتقي الألوان، حيث يمكنك فحص القيم وتغيير الألوان أثناء التنقل:

تحرير في أي مكان

يدعم المحرر الجديد جميع الأجهزة حيث يمكنك تشغيل TradingView. على الأجهزة المحمولة حيث لا يظهر محرر Pine في المتصفح افتراضيًا، يمكنك الوصول إليه بفتح ملف رابط محرر منفصل. بالإضافة إلى ذلك، تتضمن القائمة المنبثقة على هذه الأجهزة أيضًا خيار “نسخ الكل” لنسخ الكود بالكامل بسهولة إلى الحافظة.

تحرير أكثر أمانًا

يقوم المحرر الآن بتخزين الكود الخاص بك مؤقتًا محليًا في المتصفح / التطبيق الخاص بك، مما يعني أنه لن يتم فقده بعد الآن في تحديثات المخطط. يمكنك الآن تحديث الصفحات بحرية دون فقد الشفرة غير المحفوظة.

للبقاء على اطلاع بميزات Pine الجديدة، راقب دليل المستخدم ملاحظات الإصدار. يبث حساب PineCoders أيضًا تحديثات من Squawk Box على تيليغرام، وحساب تويتر، ومن الدردشة العامة “Pine Script® Q&A” على TradingView.

نأمل أن تجد محررنا الجديد مفيدًا. الرجاء الاستمرار في إرسال ملاحظاتك إلينا. نحن نبني TradingView لمستخدمينا ونحب أن نسمع منك.

Look first Then leap

تم إنشاء TradingView خصيصًا لك، لذا تأكد من حصولك على أقصى استفادة من خدماتنا الرائعة
فتح الرسم البياني