الفرق بين المراجعتين ل"Liquid/types"
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة) |
|||
سطر 1: | سطر 1: | ||
− | + | <noinclude>{{DISPLAYTITLE: أنواع البيانات في لغة Liquid}}</noinclude> | |
لكائنات لغة Liquid أحد الأنواع الستة التالية: | لكائنات لغة Liquid أحد الأنواع الستة التالية: | ||
− | * سلسلة نصية String | + | * سلسلة نصية String |
− | * عدد Number | + | * عدد Number |
− | * قيمة منطقية Boolean | + | * قيمة منطقية Boolean |
− | * القيمة Nil | + | * القيمة Nil |
− | * مصفوفة Array | + | * مصفوفة Array |
− | * القيمة EmptyDrop | + | * القيمة EmptyDrop |
يمكنك تهيئة المتغيرات في لغة Liquid باستخدام [[Liquid/variable|الوسم <code>assign</code> أو الوسم <code>capture</code>]]. | يمكنك تهيئة المتغيرات في لغة Liquid باستخدام [[Liquid/variable|الوسم <code>assign</code> أو الوسم <code>capture</code>]]. | ||
− | + | == السلسلة النصية String == | |
+ | |||
السلاسل النصية هي عبارة عن تسلسلات من المحارف مُغلَّفة ضمن علامات اقتباس مفردة أو مزدوجة:<syntaxhighlight lang="liquid"> | السلاسل النصية هي عبارة عن تسلسلات من المحارف مُغلَّفة ضمن علامات اقتباس مفردة أو مزدوجة:<syntaxhighlight lang="liquid"> | ||
{% assign my_string = "Hello World!" %} | {% assign my_string = "Hello World!" %} | ||
− | </syntaxhighlight>لا تحوّل لغة Liquid | + | </syntaxhighlight>لا تحوّل لغة Liquid سلاسل الهروب escape sequences إلى محارف خاصة. |
+ | |||
+ | == العدد Number == | ||
− | |||
يتضمن الأعداد العشرية floats والأعداد الصحيحة integers:<syntaxhighlight lang="liquid"> | يتضمن الأعداد العشرية floats والأعداد الصحيحة integers:<syntaxhighlight lang="liquid"> | ||
{% assign my_int = 25 %} | {% assign my_int = 25 %} | ||
سطر 22: | سطر 24: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | == القيمة المنطقية Boolean == | |
+ | |||
القيم المنطقية إما <code>true</code> أو <code>false</code>، ولا حاجة لاستخدام علامات الاقتباس عند التصريح عن قيمة منطقية:<syntaxhighlight lang="liquid"> | القيم المنطقية إما <code>true</code> أو <code>false</code>، ولا حاجة لاستخدام علامات الاقتباس عند التصريح عن قيمة منطقية:<syntaxhighlight lang="liquid"> | ||
{% assign foo = true %} | {% assign foo = true %} | ||
سطر 28: | سطر 31: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | == القيمة الفارغة Nil == | |
− | القيمة | + | القيمة <code>nil</code> هي قيمة فارغة خاصة تعاد عندما لا يكون لشيفرة Liquid أيّ نتائج، وهي ليست سلسلة نصية مؤلفة مع الأحرف "nil". يجري التعامل مع القيمة <code>Nil</code> على أنها القيمة <code>false</code> ضمن شروط كتل <code>if</code> ووسوم لغة Liquid الأخرى التي تتحقق من صحة شرطٍ ما. |
إن لم يكن المستخدم موجودًا في المثال التالي (أي أعاد المستخدم <code>user</code> القيمة <code>nil</code>)، فلن تطبع لغة Liquid التحية:<syntaxhighlight lang="liquid"> | إن لم يكن المستخدم موجودًا في المثال التالي (أي أعاد المستخدم <code>user</code> القيمة <code>nil</code>)، فلن تطبع لغة Liquid التحية:<syntaxhighlight lang="liquid"> | ||
سطر 35: | سطر 38: | ||
Hello {{ user.name }}! | Hello {{ user.name }}! | ||
{% endif %} | {% endif %} | ||
− | </syntaxhighlight>لن تطبع الوسوم التي تعيد القيمة <code>nil</code> أيّ شيء على الصفحة. | + | </syntaxhighlight>لن تطبع الوسوم التي تعيد القيمة <code>nil</code> أيّ شيء على الصفحة.<syntaxhighlight lang="liquid"> |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
The current user is {{ user.name }} | The current user is {{ user.name }} | ||
− | </syntaxhighlight> | + | </syntaxhighlight>الخرج:<syntaxhighlight lang="liquid"> |
− | |||
The current user is | The current user is | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | == المصفوفة Array == | |
− | |||
المصفوفات تحتوي على قوائم من المتغيرات التي تكون من أيّ نوع. | المصفوفات تحتوي على قوائم من المتغيرات التي تكون من أيّ نوع. | ||
− | + | === الوصول إلى عناصر المصفوفة === | |
− | يمكنك الوصول إلى جميع عناصر المصفوفة من خلال المرور على كل عنصر في المصفوفة باستخدام [[Liquid/iteration|الوسوم ذات النوع التكراري iteration tag]]. | + | يمكنك الوصول إلى جميع عناصر المصفوفة من خلال المرور على كل عنصر في المصفوفة باستخدام [[Liquid/iteration|الوسوم ذات النوع التكراري iteration tag]].<syntaxhighlight lang="liquid"> |
− | |||
− | |||
− | |||
− | |||
− | |||
<!-- if site.users = "Tobi", "Laura", "Tetsuro", "Adam" --> | <!-- if site.users = "Tobi", "Laura", "Tetsuro", "Adam" --> | ||
{% for user in site.users %} | {% for user in site.users %} | ||
{{ user }} | {{ user }} | ||
{% endfor %} | {% endfor %} | ||
− | </syntaxhighlight> | + | </syntaxhighlight>الخرج:<syntaxhighlight lang="liquid"> |
− | |||
Tobi Laura Tetsuro Adam | Tobi Laura Tetsuro Adam | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | === الوصول إلى عناصر محددة في المصفوفات === | |
− | + | يمكنك استخدام صيغة <code>[</code> <code>]</code> الأقواس المربعة للوصول إلى عنصر محدّد في المصفوفة. تبدأ أدلة عناصر المصفوفة من الصفر، ويُحسَب الدليل السالب من نهاية المصفوفة.<syntaxhighlight lang="liquid"> | |
− | يمكنك استخدام صيغة <code>[</code> <code>]</code> الأقواس المربعة للوصول إلى عنصر محدّد في المصفوفة. تبدأ أدلة عناصر المصفوفة من الصفر، ويُحسَب الدليل السالب من نهاية المصفوفة. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
<!-- if site.users = "Tobi", "Laura", "Tetsuro", "Adam" --> | <!-- if site.users = "Tobi", "Laura", "Tetsuro", "Adam" --> | ||
{{ site.users[0] }} | {{ site.users[0] }} | ||
{{ site.users[1] }} | {{ site.users[1] }} | ||
{{ site.users[-1] }} | {{ site.users[-1] }} | ||
− | </syntaxhighlight> | + | </syntaxhighlight>الخرج:<syntaxhighlight lang="liquid"> |
− | |||
Tobi | Tobi | ||
Laura | Laura | ||
Adam | Adam | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | === تهيئة المصفوفات === | |
− | + | لا يمكنك تهيئة المصفوفات باستخدام لغة Liquid فقط، ولكن يمكنك استخدام مرشّح التقسيم <code>[[Liquid/filters|split]]</code> لتقسيم سلسلة نصية إلى مصفوفة من السلاسل النصية الفرعية. | |
− | لا يمكنك تهيئة المصفوفات باستخدام لغة Liquid فقط، ولكن يمكنك استخدام مرشّح | ||
− | == | + | == الكائن <code>EmptyDrop</code> == |
− | يُعاد كائن EmptyDrop إذا حاولت الوصول إلى كائن محذوف. تُعَدّ كلٌّ من الكائنات <code>page_1</code> و <code>page_2</code> و <code>page_3</code> في المثال التالي كائنات EmptyDrop:<syntaxhighlight lang="liquid"> | + | يُعاد كائن <code>EmptyDrop</code> إذا حاولت الوصول إلى كائن محذوف. تُعَدّ كلٌّ من الكائنات <code>page_1</code> و <code>page_2</code> و <code>page_3</code> في المثال التالي كائنات من النوع <code>EmptyDrop</code>:<syntaxhighlight lang="liquid"> |
{% assign variable = "hello" %} | {% assign variable = "hello" %} | ||
{% assign page_1 = pages[variable] %} | {% assign page_1 = pages[variable] %} | ||
سطر 96: | سطر 77: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | === التحقق من الفراغ === | |
+ | |||
يمكنك التحقق لمعرفة ما إذا كان الكائن موجودًا أم لا قبل الوصول إلى أيٍّ من سماته attributes كما يلي:<syntaxhighlight lang="liquid"> | يمكنك التحقق لمعرفة ما إذا كان الكائن موجودًا أم لا قبل الوصول إلى أيٍّ من سماته attributes كما يلي:<syntaxhighlight lang="liquid"> | ||
{% unless pages == empty %} | {% unless pages == empty %} | ||
سطر 107: | سطر 89: | ||
* [https://shopify.github.io/liquid/basics/types/ صفحة Types في توثيق Liquid الرسمي.] | * [https://shopify.github.io/liquid/basics/types/ صفحة Types في توثيق Liquid الرسمي.] | ||
+ | [[تصنيف:Liquid]] |
المراجعة الحالية بتاريخ 11:10، 5 أغسطس 2021
لكائنات لغة Liquid أحد الأنواع الستة التالية:
- سلسلة نصية String
- عدد Number
- قيمة منطقية Boolean
- القيمة Nil
- مصفوفة Array
- القيمة EmptyDrop
يمكنك تهيئة المتغيرات في لغة Liquid باستخدام الوسم assign
أو الوسم capture
.
السلسلة النصية String
السلاسل النصية هي عبارة عن تسلسلات من المحارف مُغلَّفة ضمن علامات اقتباس مفردة أو مزدوجة:
{% assign my_string = "Hello World!" %}
لا تحوّل لغة Liquid سلاسل الهروب escape sequences إلى محارف خاصة.
العدد Number
يتضمن الأعداد العشرية floats والأعداد الصحيحة integers:
{% assign my_int = 25 %}
{% assign my_float = -39.756 %}
القيمة المنطقية Boolean
القيم المنطقية إما true
أو false
، ولا حاجة لاستخدام علامات الاقتباس عند التصريح عن قيمة منطقية:
{% assign foo = true %}
{% assign bar = false %}
القيمة الفارغة Nil
القيمة nil
هي قيمة فارغة خاصة تعاد عندما لا يكون لشيفرة Liquid أيّ نتائج، وهي ليست سلسلة نصية مؤلفة مع الأحرف "nil". يجري التعامل مع القيمة Nil
على أنها القيمة false
ضمن شروط كتل if
ووسوم لغة Liquid الأخرى التي تتحقق من صحة شرطٍ ما.
إن لم يكن المستخدم موجودًا في المثال التالي (أي أعاد المستخدم user
القيمة nil
)، فلن تطبع لغة Liquid التحية:
{% if user %}
Hello {{ user.name }}!
{% endif %}
لن تطبع الوسوم التي تعيد القيمة nil
أيّ شيء على الصفحة.
The current user is {{ user.name }}
الخرج:
The current user is
المصفوفة Array
المصفوفات تحتوي على قوائم من المتغيرات التي تكون من أيّ نوع.
الوصول إلى عناصر المصفوفة
يمكنك الوصول إلى جميع عناصر المصفوفة من خلال المرور على كل عنصر في المصفوفة باستخدام الوسوم ذات النوع التكراري iteration tag.
<!-- if site.users = "Tobi", "Laura", "Tetsuro", "Adam" -->
{% for user in site.users %}
{{ user }}
{% endfor %}
الخرج:
Tobi Laura Tetsuro Adam
الوصول إلى عناصر محددة في المصفوفات
يمكنك استخدام صيغة [
]
الأقواس المربعة للوصول إلى عنصر محدّد في المصفوفة. تبدأ أدلة عناصر المصفوفة من الصفر، ويُحسَب الدليل السالب من نهاية المصفوفة.
<!-- if site.users = "Tobi", "Laura", "Tetsuro", "Adam" -->
{{ site.users[0] }}
{{ site.users[1] }}
{{ site.users[-1] }}
الخرج:
Tobi
Laura
Adam
تهيئة المصفوفات
لا يمكنك تهيئة المصفوفات باستخدام لغة Liquid فقط، ولكن يمكنك استخدام مرشّح التقسيم split
لتقسيم سلسلة نصية إلى مصفوفة من السلاسل النصية الفرعية.
الكائن EmptyDrop
يُعاد كائن EmptyDrop
إذا حاولت الوصول إلى كائن محذوف. تُعَدّ كلٌّ من الكائنات page_1
و page_2
و page_3
في المثال التالي كائنات من النوع EmptyDrop
:
{% assign variable = "hello" %}
{% assign page_1 = pages[variable] %}
{% assign page_2 = pages["does-not-exist"] %}
{% assign page_3 = pages.this-handle-does-not-exist %}
التحقق من الفراغ
يمكنك التحقق لمعرفة ما إذا كان الكائن موجودًا أم لا قبل الوصول إلى أيٍّ من سماته attributes كما يلي:
{% unless pages == empty %}
<h1>{{ pages.frontpage.title }}</h1>
<div>{{ pages.frontpage.content }}</div>
{% endunless %}
ستعيد كلٌّ من السلاسل النصية الفارغة والمصفوفات الفارغة القيمة true
إذا جرى التحقق منها بالمساواة مع empty
.