Sass Map Functions
توابع map
در Sass داده‌های نوع map معرف یک یا تعداد بیشتری از جفت‌های کلید / مقدار (key/value pair) است.
نکته: این امکان وجود دارد که توابع لیست را برای map به کار ببریم. آنگاه map به عنوان لیستی با دو مقدار فرض می‌شود.
map در Sass غیر قابل تغییر است (immutable) بنابراین توابع map که یک map را برمی‌گرداند، map اصلی را تغییر نمی‌دهند و یک map جدید را برمی‌گرداند.
در زیر توابع map موجود در Sass آورده شده است.
| تابع | توضیح |
|---|---|
| map-get(map, key) |
مقدار مربوط به کلید مشخص شده از map را برمی‌گرداند.
مثال: font-sizes: ("small": 12px, "normal": 18px, "large": 24px)$ map-get($font-sizes, "small") Result: 12px |
| map-has-key(map, key) |
چک می‌کند که map کلید مشخص شده را دارد یا خیر.
مثال: font-sizes: ("small": 12px, "normal": 18px, "large": 24px)$ map-has-key($font-sizes, "big") Result: false |
| map-keys(map) |
یک لیست از تمام کلیدهای داخل map را برمی‌گرداند.
مثال: font-sizes: ("small": 12px, "normal": 18px, "large": 24px)$ map-keys($font-sizes) "Result: "small", "normal, "large |
| map-merge(map1, map2) |
map2 را به آخر map1 اضافه می‌کند.
مثال: font-sizes: ("small": 12px, "normal": 18px, "large": 24px)$ font-sizes2: ("x-large": 30px, "xx-large": 36px)$ map-merge($font-sizes, $font-sizes2) Result: "small": 12px, "normal": 18px, "large": 24px, "x-large": 30px, "xx-large": 36px |
| map-remove(map, keys...) |
کلیدهای مشخص شده از map را حذف می‌کند.
مثال: font-sizes: ("small": 12px, "normal": 18px, "large": 24px)$ map-remove($font-sizes, "small") Result: ("normal": 18px, "large": 24px) |
| map-values(map) |
یک لیست از تمام مقادیر داخل map را برمی‌گرداند.
مثال: font-sizes: ("small": 12px, "normal": 18px, "large": 24px)$ map-values($font-sizes) Result: 12px, 18px, 24px |