الفرق بين المراجعتين لصفحة: «Sass/map merge»
< Sass
جميل-بيلوني (نقاش | مساهمات) ط مراجعة الصفحة وتدقيقها. |
ط استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}' |
||
| (مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين) | |||
| سطر 26: | سطر 26: | ||
== أمثلة == | == أمثلة == | ||
مثال عن استخدام الدالة <code>map_merge()</code>:<syntaxhighlight lang="sass"> | |||
map-merge(("foo": 1), ("bar": 2)) // ("foo": 1, "bar": 2) | map-merge(("foo": 1), ("bar": 2)) // ("foo": 1, "bar": 2) | ||
map-merge(("foo": 1, "bar": 2), ("bar": 3)) // ("foo": 1, "bar": 3) | map-merge(("foo": 1, "bar": 2), ("bar": 3)) // ("foo": 1, "bar": 3) | ||
| سطر 38: | سطر 38: | ||
== مصادر == | == مصادر == | ||
* [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_merge-instance_method قسم الدالة map_merge في صفحة الدوال في توثيق Sass الرسمي. | * [https://sass-lang.com/documentation/Sass/Script/Functions.html#map_merge-instance_method قسم الدالة map_merge في صفحة الدوال في توثيق Sass الرسمي]. | ||
[[تصنيف:Sass]] | [[تصنيف:Sass|{{SUBPAGENAME}}]] | ||
[[تصنيف: Sass Function]] | [[تصنيف: Sass Function|{{SUBPAGENAME}}]] | ||
المراجعة الحالية بتاريخ 07:00، 20 مايو 2018
تدمج الدالة map_merge() خريطتين (maps) في خريطة واحدة جديدة. المفاتيح في الخريطة الثانية $map2 ستكون لها الأسبقيَّة على المفاتيح في الخريطة الأولى $map1. هذه هي أفضل طريقة لإضافة قيم جديدة إلى خريطة.
جميع مفاتيح الخريطة الناتجة سيكون لها نفس الترتيب كما في الخريطة الأولى $map1، وستوضع المفاتيح الجديدة للخريطة الثانية $map2 في نهاية تلك الخريطة الناتجة.
تُعيد الدالة map_merge() خريطة جديدة، مثل جميع دوال الخرائط، بدلًا من تعديل معاملاتها موضعيًا.
البنية العامة
map_merge($map1, $map2)
المعاملات
$map1
الخريطة الأولى.
$map2
الخريطة الثانية.
القيم المعادة
تُعاد خريطة جديدة ناتجة عن دمج الخريطة $map1 والخريطة $map2.
الأخطاء والاستثناءات
سيُرمى الخطأ ArgumentError إن لم يكن أيّ من المعاملات الممرَّرة خريطة.
أمثلة
مثال عن استخدام الدالة map_merge():
map-merge(("foo": 1), ("bar": 2)) // ("foo": 1, "bar": 2)
map-merge(("foo": 1, "bar": 2), ("bar": 3)) // ("foo": 1, "bar": 3)
انظر أيضًا
- الدالة
map_remove(): تعيد خريطة مع حذف مفاتيح محدَّدة منها. - الدالة
map_keys(): تعيد قائمة تحتوي على مفاتيح الخريطة فقط. - الدالة
map_values(): تعيد قائمة تحتوي على قيم الخريطة فقط. - الدالة
map_has_key(): تتحقَّق إن كانت الخريطة الممرَّرة إليها تحتوي على مفتاح معيّن وهذا المفتاح مرتبط بقيمة ما. - الدالة
map_get(): تعيد القيمة الموجودة في الخريطة والمرتبطة بالمفتاح المُعطى.