Sass List Functions
توابع لیست
توابع لیست برای دسترسی به مقادیر داخل لیست، ترکیب لیست‌ها و اضافه کردن آیتم‌ها به لیست مورد استفاده قرار می‌گیرند.
لیست‌ها در Sass غیر قابل تغییر هستند (immutable) بنابراین توابع لیستی که یک لیست را برمی‌گرداند، لیست اصلی را تغییر نمی‌دهند و یک لیست جدید را برمی‌گرداند.
ایندکس لیست از یک شروع می‌شود. در زیر توابع لیست موجود در Sass آورده شده است.
| تابع | توضیح |
|---|---|
| append(list, value, [separator]) |
یک مقدار مشخص شده را به انتهای لیست اضافه می‌کند. جدا کننده (separator) می‌تواند auto، علامت کاما یا فاصله باشد. پیش‌فرض auto است.
مثال: append((a b c), d) Result: a b c d append((a b c), (d), comma) Result: a, b, c, d |
| index(list, value) |
ایندکس مقدار داده شده به آن را برمی‌گرداند.
مثال: index(a b c, b) Result: 2 index(a b c, f) Result: null |
| is-bracketed(list) |
چک می‌کند که لیست دارای کروشه است یا خیر.
مثال: is-bracketed([a b c]) Result: true is-bracketed(a b c) Result: false |
| join(list1, list2, [separator, bracketed]) |
لیست ۲ را به انتهای لیست ۱ اضافه می‌کند. جدا کننده (separator) می‌تواند auto، علامت کاما یا فاصله باشد. پیش‌فرض auto است. (جدا کننده را برای لیست اول استفاده می‌کنیم). bracketed می‌تواند auto, true یا false باشد. پیش‌فرض auto است.
مثال: join(a b c, d e f) Result: a b c d e f join((a b c), (d e f), comma) Result: a, b, c, d, e, f join(a b c, d e f, $bracketed: true) Result: [a b c d e f] |
| length(list) |
طول لیست را برمی‌گرداند.
مثال: length(a b c) Result: 3 |
| list-separator(list) |
جدا کننده لیست استفاده شده را به صورت رشته برمی‌گرداند.
مثال: list-separator(a b c) "Result: "space list-separator(a, b, c) "Result: "comma |
| nth(list, n) |
عنصر nام داخل لیست را برمی‌گرداند.
مثال: nth(a b c, 3) Result: c |
| set-nth(list, n, value) |
عنصر nام لیست را برابر مقدار مشخص شده قرار می‌دهد.
مثال: set-nth(a b c, 2, x) Result: a x c |
| zip(lists) |
لیست‌های داده شده به آن را به یک لیست چند بعدی تبدیل می‌کند.
مثال: zip(1px 2px 3px, solid dashed dotted, red green blue) Result: 1px solid red, 2px dashed green, 3px dotted blue |