CyrefJS
CCyrefJS
EN
بازگشت به مستندات
رشته/از نسخه 1.38.0

slugify

یک رشته را به یک slug نرمال‌شده، کوچک و مناسب برای URL تبدیل می‌کند.

slugify(value):string

نرمال‌سازی

ابتدا ورودی با استفاده از نرمال‌سازی Unicode از نوع NFKC نرمال می‌شود. این کار می‌تواند نمایش‌های سازگار Unicode را قبل از ساخت slug یکسان‌سازی کند.

تبدیل به حروف کوچک

پس از نرمال‌سازی و حذف فاصله‌های ابتدا و انتها، کل رشته به حروف کوچک تبدیل می‌شود.

جایگزینی کاراکترها

هر دنباله متوالی از کاراکترهایی که حرف یا عدد Unicode نیستند، با یک خط تیره جایگزین می‌شود. از Unicode property escapes استفاده شده است، بنابراین حروف و اعداد اسکریپت‌های پشتیبانی‌شده Unicode حفظ می‌شوند.

پاک‌سازی نهایی

تمام خط تیره‌های موجود در ابتدا یا انتهای slug تولیدشده حذف می‌شوند.

پارامترها

valuestringالزامی

رشته‌ای که باید به slug تبدیل شود.

مقدار بازگشتی

string

یک slug با حروف کوچک که در آن دنباله‌های کاراکترهای غیرحرف و غیرعدد با یک خط تیره جایگزین شده‌اند.

مثال‌ها

01

استفاده پایه

تبدیل یک عبارت معمولی به slug مناسب برای URL.

TypeScript
slugify("Hello World");
// "hello-world"
02

چند جداکننده

فاصله‌ها و علائم نگارشی پشت سر هم به یک خط تیره تبدیل می‌شوند.

TypeScript
slugify("Hello,   World!!!");
// "hello-world"
03

جداکننده‌های ابتدا و انتها

خط تیره‌های ابتدا و انتهای نتیجه حذف می‌شوند.

TypeScript
slugify("---Hello World---");
// "hello-world"
04

متن یونیکد

حروف و اعداد یونیکد حفظ می‌شوند.

TypeScript
slugify("سلام دنیا");
// "سلام-دنیا"
05

حذف فاصله‌های ابتدا و انتها

فاصله‌های ابتدا و انتهای رشته قبل از ساخت slug حذف می‌شوند.

TypeScript
slugify("  Hello World  ");
// "hello-world"
06

نتیجه خالی

رشته‌ای که فقط شامل کاراکترهای خارج از دسته حروف و اعداد باشد، یک رشته خالی تولید می‌کند.

TypeScript
slugify("!!! @@@ ###");
// ""
ساخته شده با@cyref/js·مستندات رسمی