الفرق بين المراجعتين لصفحة: «Twig/format number»
< Twig
أسامه-دمراني (نقاش | مساهمات) 1.0: إضافة عنوان الصفحة | 2.0 محتوى الصفحة |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
سطر 10: | سطر 10: | ||
</syntaxhighlight>قائمة الخيارات المدعومة هي: | </syntaxhighlight>قائمة الخيارات المدعومة هي: | ||
* <code>grouping_used</code> | * <code>grouping_used</code> | ||
* <code>decimal_always_shown</code> | * <code>decimal_always_shown</code> | ||
* <code>max_integer_digit</code> | * <code>max_integer_digit</code> | ||
* <code>min_integer_digit</code> | * <code>min_integer_digit</code> | ||
* <code>integer_digit</code> | * <code>integer_digit</code> | ||
* <code>max_fraction_digit</code> | * <code>max_fraction_digit</code> | ||
* <code>min_fraction_digit</code> | * <code>min_fraction_digit</code> | ||
* <code>fraction_digit</code> | * <code>fraction_digit</code> | ||
* <code>multiplier</code> | * <code>multiplier</code> | ||
* <code>grouping_size</code> | * <code>grouping_size</code> | ||
* <code>rounding_mode</code> | * <code>rounding_mode</code> | ||
* <code>rounding_increment</code> | * <code>rounding_increment</code> | ||
* <code>format_width</code> | * <code>format_width</code> | ||
* <code>padding_position</code> | * <code>padding_position</code> | ||
* <code>secondary_grouping_size</code> | * <code>secondary_grouping_size</code> | ||
* <code>significant_digits_used</code> | * <code>significant_digits_used</code> | ||
* <code>min_significant_digits_used</code> | * <code>min_significant_digits_used</code> | ||
* <code>max_significant_digits_used</code> | * <code>max_significant_digits_used</code> | ||
* <code>lenient_parse</code> | * <code>lenient_parse</code> | ||
يستطيع المرشح أن ينسق صيغًا عددية كثيرة غير الأعداد الصحيحة، انظر:<syntaxhighlight lang="twig"> | يستطيع المرشح أن ينسق صيغًا عددية كثيرة غير الأعداد الصحيحة، انظر:<syntaxhighlight lang="twig"> | ||
سطر 41: | سطر 42: | ||
</syntaxhighlight>الصيغ الرقمية التي يمكن تنسيقها هي: | </syntaxhighlight>الصيغ الرقمية التي يمكن تنسيقها هي: | ||
* <code>decimal | * <code>decimal</code> | ||
* <code>currency</code> | * <code>currency</code> | ||
* <code>percent</code> | * <code>percent</code> | ||
* <code>scientific</code> | * <code>scientific</code> | ||
* <code>spellout</code> | * <code>spellout</code> | ||
* <code>ordinal</code> | * <code>ordinal</code> | ||
* <code>duration</code> | * <code>duration</code> | ||
تُستخدم مرشحات <code>format_*_number</code> كاختصار عن طريق استبدال الصيغة المطلوبة بمحرف <code>*</code> الموجود في الاختصار:<syntaxhighlight lang="twig"> | تُستخدم مرشحات <code>format_*_number</code> كاختصار عن طريق استبدال الصيغة المطلوبة بمحرف <code>*</code> الموجود في الاختصار:<syntaxhighlight lang="twig"> | ||
سطر 71: | سطر 73: | ||
$ composer require twig/extra-bundle | $ composer require twig/extra-bundle | ||
</syntaxhighlight> | </syntaxhighlight> | ||
أما غير ذلك فأضف | أما غير ذلك فأضف التوسعة صراحة إلى بيئة Twig: | ||
<syntaxhighlight lang="twig"> | <syntaxhighlight lang="twig"> | ||
use Twig\Extra\Intl\IntlExtension; | use Twig\Extra\Intl\IntlExtension; | ||
سطر 85: | سطر 87: | ||
* <code>style</code>: صيغة العدد المُخرج. | * <code>style</code>: صيغة العدد المُخرج. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* [[Twig/intro|مقدمة عن محرك القوالب Twig | * [[Twig/intro|مقدمة عن محرك القوالب Twig]] | ||
* [[Twig/advanced|توسيع Twig | * [[Twig/advanced|توسيع Twig]] | ||
* [[Twig/internals|المكونات الداخلية لـ Twig | * [[Twig/internals|المكونات الداخلية لـ Twig]] | ||
* [[Twig/tags|الوسوم في Twig]] | * [[Twig/tags|الوسوم في Twig]] | ||
* [[ Twig/filters|المرشحات في Twig]] | * [[ Twig/filters|المرشحات في Twig]] | ||
== المصادر == | == المصادر == | ||
* [https://twig.symfony.com/doc/3.x/filters/format_number.html صفحة توثيق المرشح format_number في توثيق Twig الرسمي] | * [https://twig.symfony.com/doc/3.x/filters/format_number.html صفحة توثيق المرشح format_number في توثيق Twig الرسمي] | ||
[[تصنيف:Twig]] | [[تصنيف:Twig]] | ||
[[تصنيف:Twig Filters]] | [[تصنيف:Twig Filters]] |
المراجعة الحالية بتاريخ 19:15، 5 مايو 2021
المرشح format_number
يغير تنسيق الصيغ العددية:
{{ '12.345'|format_number }}
يمكن تمرير السمات إليه من أجل تعديل الخرج كما يلي:
{# 12.34 #}
{{ '12.345'|format_number({rounding_mode: 'floor'}) }}
{# 1000000.0000 #}
{{ '1000000'|format_number({fraction_digit: 4}) }}
قائمة الخيارات المدعومة هي:
grouping_used
decimal_always_shown
max_integer_digit
min_integer_digit
integer_digit
max_fraction_digit
min_fraction_digit
fraction_digit
multiplier
grouping_size
rounding_mode
rounding_increment
format_width
padding_position
secondary_grouping_size
significant_digits_used
min_significant_digits_used
max_significant_digits_used
lenient_parse
يستطيع المرشح أن ينسق صيغًا عددية كثيرة غير الأعداد الصحيحة، انظر:
{# 1,234% #}
{{ '12.345'|format_number(style='percent') }}
{# twelve point three four five #}
{{ '12.345'|format_number(style='spellout') }}
{# 12 sec. #}
{{ '12'|format_duration_number }}
الصيغ الرقمية التي يمكن تنسيقها هي:
decimal
currency
percent
scientific
spellout
ordinal
duration
تُستخدم مرشحات format_*_number
كاختصار عن طريق استبدال الصيغة المطلوبة بمحرف *
الموجود في الاختصار:
{# 1,234% #}
{{ '12.345'|format_percent_number }}
{# twelve point three four five #}
{{ '12.345'|format_spellout_number }}
تمرَّر السمات من أجل التعديل على الخرج كما يلي:
{# 12.3% #}
{{ '0.12345'|format_percent_number({rounding_mode: 'floor', fraction_digit: 1}) }}
يستخدم المرشح الإعدادات المحلية افتراضيًا، وتمرَّر إليه صراحة كما يلي:
{# 12,345 #}
{{ '12.345'|format_number(locale='fr') }}
لاحظ أن المرشح format_number
جزء من IntlExtension
وهذا لا يكون مثبتًا افتراضيًا، لذا ثبته أولًا:
$ composer require twig/intl-extra
ثم ثبت twig/extra-bundle
في حالة مشاريع Symfony:
$ composer require twig/extra-bundle
أما غير ذلك فأضف التوسعة صراحة إلى بيئة Twig:
use Twig\Extra\Intl\IntlExtension;
$twig = new \Twig\Environment(...);
$twig->addExtension(new IntlExtension());
الوسائط
locale
: الإعدادات المحلية.attrs
: خريطة السمات.style
: صيغة العدد المُخرج.