تخطَّ إلى المحتوى

محرر التعبيرات

اكتب التعبيرات التي تتحكم في الطبقات ذات التشغيل التلقائي في مصمم العناصر، مع نتيجة مباشرة أثناء الكتابة، وعلامات البيانات المتاحة، وما هو مدعوم.

التعبير صيغة قصيرة تحسب قيمة من الوقت والبيانات. [m] * 6 يدوّر الطبقة 6 درجات مع كل دقيقة، وهذا عقرب دقائق. [bat_w] < 20 يكون صوابًا (true) ما دامت بطارية الساعة أقل من 20%، لذا لا تظهر الطبقة التي لها هذا الظهور إلا عندما توشك البطارية على النفاد.

يُفتح محرر التعبيرات من قائمة التشغيل التلقائي، ومن أزرار التشغيل التلقائي في صفحات النمط، ومن أجل الكائن العام. يذكر عنوانه ما تشغّله تلقائيًا («تشغيل التدوير تلقائيًا»).

محرر التعبيرات أثناء التشغيل التلقائي للتدوير بالتعبير [m] * 6: حقل التعبير، وصف الإدراج السريع، والنتيجة 270، وعلامات الوقتمحرر التعبيرات أثناء التشغيل التلقائي للتدوير بالتعبير [m] * 6: حقل التعبير، وصف الإدراج السريع، والنتيجة 270، وعلامات الوقت
  • إغلاق

    يغلق المحرر. إذا غيّرت التعبير، يسألك أولًا هل تريد تجاهل التغييرات.

  • حفظ

    يحفظ التعبير. لا يمكن حفظ تعبير لا يعمل: يوضح صف النتيجة ما الخطأ.

  • التعبير

    المكان الذي تكتب فيه التعبير. تظهر علامات البيانات كشرائح، ولا تقترح لوحة المفاتيح كلمات، حتى لا تصحّح التعليمات البرمجية التي تكتبها.

  • محو

    يفرّغ الحقل بعد أن يطلب التأكيد. حفظ تعبير فارغ يزيل التشغيل التلقائي.

  • مساعدة

    يفتح مستندات التشغيل التلقائي.

  • إدراج سريع

    العوامل والأقواس ومقتطفات التعليمات البرمجية التي كان عليك أن تبحث عنها في لوحة المفاتيح. انقر على أحدها لإدراجه في موضع المؤشر. لا يعرض الصف إلا ما يمكن لواجهة ساعة Wear OS 6 استخدامه.

  • القيمة الناتجة

    نتيجة التعبير، محسوبة أثناء الكتابة بالوقت والبيانات الحالية (أو بقيم المحاكي). عندما لا يعمل التعبير، يوضح هذا الصف السبب بدلًا من ذلك.

  • العلامات

    كل علامات البيانات، حسب الفئة، مع القيمة الحالية لكل منها. انقر على علامة لإدراجها. انقر على قيمة كائن بيانات لرؤية أعضائه وأمثلة على المقتطفات.

ما يجب أن تكون عليه النتيجة

Section titled “ما يجب أن تكون عليه النتيجة”

تتوقع كل خاصية نوعًا واحدًا من النتائج، ويتحقق المحرر منه أثناء الكتابة:

الخاصيةالنتيجةمثال
التدويرعدد من الدرجات، في اتجاه عقارب الساعة حول مركز تدوير الطبقة[s] * 6
النقل أفقيًا وعموديًامسافة؛ اليمين والأسفل قيم موجبة[s] / 60 - 0.5
الحجم، والحجم الأفقي والعموديمعامل، حيث 1 هو الحجم الذي رسمته[steps] / [step_goal]
الظهورصواب (true) لإظهار الطبقة، وخطأ (false) لإخفائها[h] >= 22
لونلون[color].rgb(255, [m] * 4, 0)
نصنص[m] > 30 ? "late" : "early"

عندما يكون النوع خاطئًا، يذكر صف النتيجة النوع المتوقع. للحصول على نص من رقم، اربطه بنص: [m] + " min".

التعبير جزء صغير من JavaScript. في واجهة ساعة Wear OS 6 يُحوَّل إلى التنسيق الخاص بالساعة، الذي لا يفهم من اللغة إلا الجزء المذكور هنا. هذه القائمة دقيقة: أي شيء غير موجود فيها يمنع إرسال الواجهة إلى ساعة Wear OS 6. إذا كنت تستعين بمساعد ذكاء اصطناعي لكتابة التعبيرات، فأعطه هذا القسم.

  • الأرقام: 12، 12.5، -3. كل الأرقام عشرية، لذا 7 / 2 يساوي 3.5.
  • النصوص بين علامتي تنصيص مزدوجتين أو مفردتين: "Low"، 'Low'. لا يمكن أن يحتوي النص على فاصل أسطر.
  • صواب وخطأ: true، false.
  • علامات البيانات: [bat_w]، [steps]، [h]. كل منها رقم أو نص، وتوضح قائمة العلامات أيهما.
  • القيم العامة: [global].progress، وتُضبط في الكائن العام.
  • الحساب: +، -، *، /، % (باقي القسمة)، و- في البداية لعكس الإشارة.
  • ربط النصوص: يربط + عندما يكون أحد الطرفين نصًا: [m] + " min"، "Steps: " + [steps].
  • المقارنة: ==، !=، <، <=، >، >=. يعمل === و!== أيضًا، ويعنيان ما يعنيه == و!=.
  • المنطق: && (و)، || (أو)، ! (ليس).
  • الاختيار: condition ? a : b يعطي a عندما يتحقق الشرط، وإلا فيعطي b. يمكن وضع اختيار داخل آخر.
  • التجميع: الأقواس، ([s] + 30) % 60.

تحتاج - و* و/ و% والمقارنات إلى رقمين أو نصين: [steps] == "5" لا يعمل.

يمكن أن يمتد التعبير على عدة أسطر، لتمنح قيمة اسمًا عندما تُستخدم أكثر من مرة:

var goal = [step_goal] / 2
const done = [steps] / goal
return Math.min(1, done)
  • عرّف القيم بـvar أو const (وليس let). غيّر قيمة بـ= أو += أو -= أو *= أو /= أو %=.
  • يبدأ سطر النتيجة بـreturn بمجرد وجود أكثر من سطر.
  • يمكن أن تحمل القيمة كائنًا، يُقرأ بنقطة: var size = { small: 10, big: 20 }، ثم size.big. أما القائمة فلا تُقرأ إلا عند موضع ثابت: var steps = [10, 20]، ثم steps[0].
  • الفاصلة المنقوطة في نهاية السطر اختيارية.
  • التعليقات: /* … */ في أي مكان، و// في أي مكان إلا في نهاية السطر الأخير (لأنها ستُخفي نهاية التعبير).

كل هذه تأخذ أرقامًا وتعطي رقمًا:

  • Math.min(a, b) وMath.max(a, b): قيمتان بالضبط لكل منهما. لأكثر من قيمتين، ضع إحداهما داخل الأخرى.
  • Math.round، Math.floor، Math.ceil، Math.trunc، Math.abs، Math.sign.
  • Math.sqrt، Math.cbrt، Math.pow(x, y)، Math.exp، Math.expm1، Math.log، Math.log2، Math.log10.
  • Math.sin، Math.cos، Math.tan، Math.asin، Math.acos، Math.atan، Math.atan2(y, x)، بالراديان.
  • Math.random(): رقم جديد من 0 إلى 1.
  • الثوابت: Math.PI، Math.E، Math.LN2، Math.LN10، Math.LOG2E، Math.LOG10E، Math.SQRT1_2، Math.SQRT2.
  • x.toFixed(2) يحوّل رقمًا إلى نص بهذا العدد من المنازل العشرية، وx.toFixed() بلا منازل عشرية. يجب أن يكون العدد رقمًا صريحًا.
  • t.length: عدد الأحرف.
  • t.substring(start, end) وt.substr(start, length): جزء من نص. احذف القيمة الثانية للحصول على بقية النص.
  • t.charAt(i): حرف واحد.
  • t.startsWith("a") وt.endsWith("a"): صواب أو خطأ.
  • t.repeat(3): النص ثلاث مرات. يجب أن يكون العدد رقمًا صريحًا.
  • parseInt(t) يقرأ عددًا صحيحًا من نص (مع التقريب)، وparseFloat(t) يقرأ عددًا عشريًا.
  • x.toString() يحوّل قيمة إلى نص.

يمكن أن يكون النص المربوط ("a" + x، أو x.toString()) هو النتيجة، لكن دوال النصوص أعلاه لا تعمل عليه، ولا تعمل عليه المقارنة ولا شرط الاختيار. لتحويل رقم إلى نص يمكنك العمل عليه، استخدم toFixed(): اكتب [steps].toFixed(0).length، وليس [steps].toString().length.

  • [frmt].lzero(x, 2) يكتب x بخانتين على الأقل، مع إضافة أصفار بادئة: [m] عند الدقيقة 5 يعطي 05. يجب أن يكون عدد الخانات رقمًا صريحًا.
  • [frmt].frmt_ms(ms) يكتب مدة بالمللي ثانية بالشكل mm:ss:mmm. اختر الأجزاء والفاصل بـ[frmt].frmt_ms(ms, { hh: true, mm: true, ss: true, sep: "." })؛ والجزء الذي لا تذكره لا يظهر.
  • [frmt].frmt_number(x, "#,###") يكتب x بنمط أرقام: "#,###" يضيف فواصل الآلاف (12345 يعطي 12,345)، و"0.00" يعرض دائمًا منزلتين عشريتين، و"0.###E0" يكتب بالترميز العلمي. يجب أن يكون النمط نصًا عاديًا بين علامتي تنصيص، لا مبنيًا من قيم أخرى. وتتبع الفواصل لغة الساعة: الساعة المضبوطة على الهولندية تعرض 12.345 و3,14.
  • [color].rgb(r, g, b) يُنشئ لونًا من الأحمر والأخضر والأزرق، كل منها من 0 إلى 255.
  • [color].argb(a, r, g, b) يُنشئ لونًا يمكن أن يكون شفافًا: قيمة ألفا a تأتي أولًا، من 0 (غير مرئي) إلى 255 (معتم تمامًا). [color].argb(128, 255, 0, 0) لون أحمر بنصف العتامة.

التعبير الذي يستخدم شيئًا غير مذكور هنا يظل يعمل في معاينة المصمم، لكن لا يمكن إرسال الواجهة إلى ساعة Wear OS 6 حتى تعيد كتابته: تبيّن قائمة غير متوافق بعد في صف الطبقة التعبير الذي يجب إصلاحه.

لإبقاء قيمة ضمن حدود، اجمع بين الاثنتين: Math.min(100, Math.max(0, [steps] / 100)).

يحتوي الكائن العام على قيم وعمليات حسابية تتشاركها طبقات العنصر، فتكتبها مرة واحدة. افتحه من الزر الموجود في نهاية القيمة المعروضة فوق لوحة الرسم. يضبط كل سطر قيمة واحدة على [global]:

[global].progress = Math.min(1, [steps] / [step_goal])
[global].low = [bat_w] < 20

يمكن بعد ذلك لتعبير أي طبقة أن يستخدم [global].progress أو [global].low. يعمل الكائن العام قبل تعبيرات الطبقات، لذا تكون قيمه محدّثة دائمًا عند استخدامها. في قائمة العلامات، توجد [global] تحت «العلامات العامة».

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

للتحقق من سلوك تعبير في وقت آخر أو مع بيانات أخرى، اضبط القيم في المحاكي (في قائمة «المزيد» في الشريط العلوي) وراقب صف النتيجة.