بنود صور XFA المتقدمة
فعّل TXFAWidgetRuntimeOptions.ScriptOptions.EnableJavaScript لاستخدام هذه الصور في أحداث FormCalc وسكربتات الحساب والتحقق عبر محرك QuickJS المرفق
Format(picture, value) تنتج نص عرض وParse(picture, text) تنتج قيمًا مقننة؛ وانتقاء locale والحرفيات المقتبسة والبدائل تتبع دوال locale وpictures في FormCalc
الدقة العددية والترميز العلمي
| الرمز | السلوك |
|---|---|
E | تنسّق أُسًا بعأساس 10 موقّعًا بعد الـ mantissa؛ ومواضع الأرقام الرائدة والكسرية تحدد دقة الـ mantissa، مع تطبيق حمل التقريب قبل صدور الأُس |
8 | تحفظ الدقة الكسرية المعبر عنها لنص عشري مقدَّم، بما يشمل الأصفار الختامية؛ والأرقام الكسرية الغائبة تحذف جذر العدد العشري، وتسلسلة من 8 رموز يمكنها حفظ أرقام كسرية مقدَّمة أكثر من طولها |
mantissas علمية تستخدم على الأكثر 15 موضع رقم؛ ومقادير الأُس والتوسع العشري محدودان بـ 10000، والقيم غير المنتهية تنتج نصًا فارغًا
صور الدقة تحفظ الحرفيات المقتبسة قبل وبعد المواضع الكسرية؛ وتكيس النسبة المئوية يزيح نص العدد العشري الأصلي دون فقد الأصفار الختامية عبر تحويل الفاصلة العائمة الثنائية
مرّر سلاسل عشرية عندما تكون الدقة المعبر عنها مهمة؛ والقيم العددية في JavaScript سبق أن خضعت لتحويل الفاصلة العائمة الثنائية قبل التنسيق
Format("num{99.999E}", 12345) // 12.345E+3
Parse("num{99.999E}", "12.345E-2") // 0.12345
Format("num{zzz,zz9.8}", "12345.0000") // 12,345.0000
Parse("num{zz9.8}", "12.3400") // 12.3400
Format("num{zz9.8%}", "0.1250") // 12.50%
التواريخ الترتيبية والأسبوعية
| الرمز | السلوك |
|---|---|
J, JJJ | يوم السنة، من 1 إلى 366؛ وJJJ تحشو إلى ثلاث خانات وتحليل التحقق يفحص السنوات الكبيسة |
E | يوم أسبوع عددي من 1 للأحد إلى 7 للسبت؛ وEEE وEEEE تواصلان استخدام أسماء أيام الأسبوع المختصرة والكاملة لـ locale |
e | يوم أسبوع ISO من 1 للاثنين إلى 7 للأحد |
WW | أسبوع ISO من 01 إلى 53؛ والأسبوع 01 يحتوي 4 يناير، والسنة في هذه الصورة هي سنة أسبوع ISO |
w | أسبوع الشهر من 0 إلى 5، يبدأ بالأحد؛ والأسبوع الأول يجب أن يحتوي أربعة أيام على الأقل من الشهر |
تحليل التواريخ الترتيبية أو الأسبوعية يعيد التاريخ المقابل بالتقويم ISO؛ وقيم اليوم أو الشهر أو يوم الأسبوع أو الأسبوع المتضاربة تعيد نصًا فارغًا
السنوات المبكرة ذوات الأربع خانات تُبنى دون تعديل قرن JavaScript، بما يشمل السنوات 0000 إلى 0099؛ والعصور البديلة التاريخية تبقى خارج هذه الصور
Format("date{YYYY-JJJ}", "2024-02-29") // 2024-060
Parse("date{YYYY-WW-e}", "2020-53-5") // 2021-01-01
Format("date{w}", "2004-07-03") // 0
تنويعات ساعات إضافية
k وkk تعبّران ساعة 0–11 داخل الـ meridiem؛ وK وKK تعبّران ساعة 1–24 داخل اليوم، و24 تمثل منتصف الليل
استخدم A مع ساعات k للتمييز بين AM وPM؛ وz الصغيرة تنسّق إزاحة ISO بلا نقطتين وzz تستخدم نقطتين، وZ كبيرة تُصدر GMT أو GMT مع إزاحة صريحة
رموز الصور العامة
| الرمز | تحليل الإدخال | التنسيق للمخرج |
|---|---|---|
? | يستهلك نقطة شيفرة Unicode واحدة | ينتج مسافة واحدة |
* | يستهلك صفرًا أو أكثر من محارف الفراغ القابلة للكسر | ينتج مسافة واحدة |
+ | يستهلك واحدًا أو أكثر من محارف الفراغ القابلة للكسر | ينتج مسافة واحدة |
هذه الرموز تعمل داخل صور date وtime وdatetime وnumber وtext؛ والرموز المقتبسة تبقى محارف حرفية والمحارف التكميلية في Unicode تُحتسب محرفًا واحدًا والمسافات غير الكاسرة مستثناة من مطابقة الفراغات
التحليل المركب للإدخال
بنود التاريخ والوقت المركبة تجتمع إلى نص ISO مقنّن للتاريخ والوقت؛ والتمثيلات المتكررة للقيمة نفسها يجب أن تتفق، والفواصل الحرفية تُفحص قبل قبول الإدخال
بنود scalar المتكررة يجب أن تنتج نفس العدد أو النص المقنّن؛ والتراكيب غير المتوافقة للفئات والقيم المتضاربة والاستهلاك غير المكتمل أو النتائج المقننة المميزة المتعددة تنتج نصًا فارغًا
التحليل المركب يسمح 64 جزءًا و8192 وحدة UTF-16 إدخالًا و8192 محاولة تحليل، متشاركًا ميزانيتي عمليات ووقت بيئة التشغيل المنقضية؛ وتجاوز هذه الحدود يفشل معاملة الحدث
Parse("date{YYYY-MM-DD} time{HH:MM:SS}", "2024-02-29 12:34:56")
// 2024-02-29T12:34:56
Parse("date{YYYYMMDD}time{HHMMSS}", "20240229123456")
// 2024-02-29T12:34:56
سلوك runtime والحدود الحالية
الحقول المحسوبة والأحداث تستخدم التنفيذ وmetadata locale نفسه؛ والسكربتات الفاشلة تستعيد قيم المستند وحالة JavaScript المُرسَلة، وبيانات XDP المحفوظة تحفظ النتائج الناجحة
تقاويم العصور البديلة والتمثيلات إيديوغرافية وذات العرض الكامل والرموز المعروضة المحلية فقط وسياسات التجميع الكاملة تبقى أهدافًا منفصلة
انظر بيئة تشغيل widgets XFA التفاعلية لسلوك المعاملة وإعادة التشغيل وميزانية العمليات