الدالة ()map_merge في Sass

تدمج الدالة 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()‎: تعيد القيمة الموجودة في الخريطة والمرتبطة بالمفتاح المُعطى.

مصادر

• قسم الدالة map_merge في صفحة الدوال في توثيق Sass الرسمي.