Link

کامپوننت x-link برای ساخت لینک‌های قابل شخصی‌سازی و واکنش‌گرا در صفحات Blade استفاده می‌شود. این کامپوننت امکاناتی مانند تعیین نوع (variant)، آیکن، موقعیت آیکن، حالت غیرفعال، تزئین (underline/none)، هدف باز شدن لینک (target) و کلاس سفارشی را فراهم می‌کند. مناسب برای ساخت لینک‌های ساده، دکمه‌مانند، لینک با آیکن و لینک‌های با ظاهر متفاوت در رابط کاربری است.

ویژگی‌ها

پشتیبانی از انواع variant برای تعیین ظاهر لینک (info, primary, success, danger و ...)
امکان افزودن آیکن (FontAwesome یا هر آیکن دلخواه)
تعیین موقعیت آیکن (چپ یا راست)
پشتیبانی از حالت غیرفعال (disabled)
تعیین تزئین لینک (underline یا none)
تعیین target برای باز شدن لینک (مانند _blank)
امکان افزودن کلاس CSS سفارشی
اعتبارسنجی خودکار مقادیر ورودی و نمایش خطا در صورت مقدار نامعتبر
کاملاً واکنش‌گرا و قابل استفاده در هر جای قالب Blade

ورودی‌های کامپوننت

نام پراپ	نوع داده	مقدار پیش‌فرض	توضیحات
`href`	`string`	-	آدرس مقصد لینک (اجباری)
`variant`	`string\|Variant enum`	`info`	نوع ظاهر لینک (info, primary, success, danger و ...)
`decoration`	`string`	`none`	تزئین لینک (`none` یا `underline`)
`target`	`string`	`_self`	هدف باز شدن لینک (`_self`, `_blank`, `_parent`, `_top`)
`icon`	`string\|null`	`null`	کلاس آیکن (مثلاً `fa-solid fa-link`)
`iconPosition`	`string`	`right`	موقعیت آیکن (`left` یا `right`)
`disabled`	`bool`	`false`	غیرفعال کردن لینک
`class`	`string\|null`	`null`	کلاس CSS اضافی برای لینک

نکات مهم

مقدار variant می‌تواند یک رشته معتبر یا مقدار Enum باشد (در صورت نامعتبر بودن خطا می‌دهد).
مقدار target فقط باید یکی از مقادیر _self, _blank, _parent, _top باشد.
مقدار decoration فقط باید none یا underline باشد.
مقدار iconPosition فقط left یا right مجاز است.
اگر disabled برابر true باشد، لینک غیرفعال و غیرقابل کلیک خواهد بود.
برای شخصی‌سازی بیشتر می‌توانید از کلاس‌های سفارشی و اسلات‌ها استفاده کنید.

مثال‌ها

نمونه پایه

<x-link 
    href="https://www.google.com" 
    target="_blank"
    variant="primary" 
    icon="fa-solid fa-download" 
    iconPosition="left"
>
    لینک
</x-link>

<x-link
    href="https://www.google.com" 
    target="_blank"
    variant="secondary"
>
    لینک 
</x-link>

ویژگی‌ها​

ورودی‌های کامپوننت​

مثال‌ها​

نمونه پایه​

ویژگی‌ها

ورودی‌های کامپوننت

مثال‌ها

نمونه پایه