توابع لیستی Sass

توابع لیستی Sass

توابع لیست برای دسترسی به ارزش‌های لیست، ترکیب لیست‌ها و اضافه کردن موارد به لیست استفاده می‌شوند.

لیست Sass تغییرناپذیر است (نمی‌توانند تغییر کنند). بنابراین، توابعی که لیست را بازمی‌گردانند، لیست جدیدی را بازمی‌گردانند و لیست اصلی را تغییر نمی‌دهند.

لیست Sass بر اساس 1 است. اولین عنصر لیست در موقعیت 1 قرار دارد، نه 0.

در اینجا تمام توابع لیست Sass لیست شده‌اند:

تابع توضیح و مثال
append(لیست, مقدار, [separator])

ارزش‌های مجزا را به انتهای لیست اضافه کنید.
جداکننده می‌تواند auto، comma یا space باشد. auto مقدار پیش‌فرض است.

مثال:

append((a b c), d)

نتایج: a b c d

append((a b c), (d), comma)

نتایج: a, b, c, d

index(لیست, مقدار)

موقعیت شماره‌گذاری شده ارزش در لیست را بازمی‌گرداند.

مثال:

index(a b c, b)

نتایج: 2

index(a b c, f)

نتایج: null

is-bracketed(لیست)

بررسی کنید که لیست دارای برچسب‌های گوشه‌ای است.

مثال:

is-bracketed([a b c])

نتایج: true

is-bracketed(a b c)

نتایج: false

join(list1, list2, [separator, bracketed])

تغییر list2 پیوست به list1 در انتهای
جداکننده می‌تواند auto، comma یا space باشد.
auto مقدار پیش‌فرض است (استفاده از جداکننده اولین لیست).
bracketed می‌تواند auto، true یا false باشد. auto مقدار پیش‌فرض است.

مثال:

join(a b c, d e f)

نتایج: a b c d e f

join((a b c), (d e f), comma)

نتایج: a, b, c, d, e, f

join(a b c, d e f, $bracketed: true)

نتیجه: [a b c d e f]

length(لیست)

بازگشت طول لیست.

مثال:

length(a b c)

نتیجه: 3

list-separator(لیست)

بازگشت به صورت رشته‌ای از جداکننده‌های لیست استفاده شده. می‌تواند space یا comma باشد.

مثال:

list-separator(a b c)

نتیجه: "space"

list-separator(a, b, c)

نتیجه: "comma"

nth(لیست, n)

برگرفتن عنصر n‌ام از لیست.

مثال:

nth(a b c, 3)

نتیجه: c

set-nth(لیست, n, مقدار)

تعیین مقدار مشخص شده برای عنصر n‌ام لیست.

مثال:

set-nth(a b c, 2, x)

نتیجه: a x c

zip(lists)

ترکیب لیست‌ها به یک لیست چندبعدی.

مثال:

zip(1px 2px 3px, solid dashed dotted, red green blue)

نتیجه: 1px solid red, 2px dashed green, 3px dotted blue