Skip to content

VahidN/DNTPersianComponents.Blazor

Repository files navigation

DNTPersianComponents.Blazor

مجموعه کامپوننت‌های فارسی مخصوص Blazor

GitHub Actions status

نصب از طریق NuGet

برای نصب DNTPersianComponents.Blazor، می‌توانید دستور پاورشل زیر را اجرا کنید:

Nuget

PM> Install-Package DNTPersianComponents.Blazor

مشاهده‌ی صفحه‌ی این بسته در سایت نیوگت

پیشنیازها

این کامپوننت‌ها، مخصوص بوت استرپ 5 راست به چپ استاندارد تهیه شده‌اند. به همین جهت پیش از کار با آن‌ها نیاز است تنظیمات مخصوص به بوت استرپ را انجام دهید که شامل موارد زیر هستند:

الف) نصب بوت استرپ، آیکن‌های آن و نصب یک فونت اختیاری

dotnet tool update -g Microsoft.Web.LibraryManager.Cli
libman install bootstrap --provider unpkg --destination wwwroot/lib/bootstrap
libman install bootstrap-icons --provider unpkg --destination wwwroot/lib/bootstrap-icons
libman install samim-font --provider unpkg --destination wwwroot/lib/samim-font

ب) اصلاح فایل app.css جهت معرفی فونت‌ها

ج) اصلاح فایل آغازین برنامه مانند index.html جهت راست به چپ کردن آن و همچنین استفاده از فایل‌های CSS دریافتی

د) فضاهای نام زیر را به فایل Imports.razor اضافه کنید:

@using DNTPersianComponents.Blazor
@using DNTPersianUtils.Core
@using DNTPersianUtils.Core.IranCities

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

  • DntInputPersianDate: ورودی تاریخ شمسی به همراه امکان انتخاب آن از یک تقویم شمسی
  • DntPersianCalendar: تقویم شمسی به همراه امکان نمایش مناسبت‌های رسمی و وقایع و مناسبت‌های سفارشی
  • DntIranMap: نقشه ایران با قابلیت انتخاب استان‌ها و یا تغییر رنگ آن‌ها
  • DntInputIranCities: ورودی انتخاب نام استان‌ها و شهرستان‌های ایران
  • DntInputNumber: ورودی عددی با امکان دریافت و یا نمایش اعداد فارسی
  • DntInputCurrency: ورودی مبالغ فارسی به همراه جداکننده‌ی سه رقمی هزارها و نمایش عدد به رقم
  • DntInputFarsi و DntInputTextAreaFarsi: ورودی تمام فارسی برای مواقعی که صفحه کلید فارسی در دسترس نیست
  • DntInputText و DntInputTextArea: ورودی متنی با امکان تشخیص جهت راست به چپ و یا چپ به راست ورودی

مثال‌ها

DNTPersianComponents

دمو

مشاهده‌ی دموی مثال‌های فوق