پرش به محتوا

کتابخانه

دانلود @trendyol/baklava و نشانی CDN ایرانی

@trendyol/baklava یه کتابخانه رابط کاربری متن باز از تیم Trendyol Tech با مجوز MIT است که سیستم طراحی Baklava رو به شکل مجموعه ای از کامپوننت های آماده و بسته npm ارائه می ده. به درد پروژه هایی می خوره که می خوان دکمه، فرم و عناصر رابط یکدست باشن و نمی خوان از صفر بسازن.

نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.

آخرین نسخه
۳.۵.۰
نسخه‌ها در مخزن
۱۱
مجوز
MIT
سازنده
Trendyol Tech
آخرین بررسی
آخرین به‌روزرسانی
توضیحات

آخرین نسخه

آخرین نسخه ۳.۵.۰ آخرین

۹۰۵ کیلوبایت· ۱۳۰ فایل· انتشار

دانلود
نشانی مستقیم فایل اصلی https://mirror.wbweb.ir/npm/@trendyol/baklava@3.5.0/dist/baklava.js
کد آماده با SRI <script src="https://mirror.wbweb.ir/npm/@trendyol/baklava@3.5.0/dist/baklava.js" integrity="sha256-UuiCEGsCx4G0d8npdgdAKHuZHBumP8Mkypwarbr0feM=" crossorigin="anonymous"></script>

SHA-256: 52e882106b02c781b477c9e9760740287b991c1ba63fc324ca9c1aadbaf47de3

درباره @trendyol/baklava (باکلاوا ترندیول)

@trendyol/baklava سیستم طراحی (Design System) تیم فنی Trendyol Tech است، یعنی تیم پشت یکی از فروشگاه های اینترنتی بزرگ ترکیه. اسمش رو از شیرینی معروف گرفته، ولی کارش جدی تره: یه مجموعه کامپوننت رابط کاربری که ظاهر و رفتارشون از قبل تعریف شده، تا هر صفحه ای که می سازی شبیه بقیه صفحه ها دربیاد. چیزهایی مثل دکمه، فیلد ورودی، پنجره گفتگو و هشدار توی چنین مجموعه ای پیدا می شن. فهرست دقیق کامپوننت ها رو از مستندات خود پروژه چک کن، چون با هر نسخه ممکنه کم و زیاد بشه.

مشکلی که حل می کنه آشناست. وقتی چند نفر روی یه سایت یا پنل کار می کنن، هر کس دکمه و فرم رو یه جور می سازه و بعد از چند ماه رابط کاربری به هم می ریزه. با یه سیستم طراحی مشترک، به جای بحث سر رنگ، فاصله و اندازه دکمه، از یه تعریف واحد شروع می کنی. قدم اول خیلی سریع تر برداشته می شه و ظاهر پروژه هم منسجم می مونه. کامپوننت های Baklava بر پایه وب کامپوننت ها (Web Components) ساخته شدن، یعنی به یه فریم ورک خاص وابسته نیستن. توی یه صفحه ساده HTML کار می کنن و توی پروژه ای که با فریم ورک های رایج نوشته شده هم می شه ازشون استفاده کرد.

برای کی مناسبه؟ برای توسعه دهنده هایی که پنل مدیریت، داشبورد یا اپلیکیشن وب می سازن و دنبال یه پایه آماده و مرتب هستن. اگه تیمت چند پروژه موازی داره و می خوای همه شون ظاهر یکسان داشته باشن، هم به کارت می آد. ولی برای یه سایت وردپرسی ساده یا یه قالب آماده، معمولا زیادی سنگینه و لازم نیست.

قبل از اینکه انتخابش کنی، چند نکته رو بررسی کن. اول اینکه این کتابخانه رو یه تیم ترکیه ای برای محصول خودش ساخته. پس پشتیبانی از راست به چپ و نمایش درست فونت فارسی رو روی یه صفحه نمونه تست کن، بعد تصمیم بگیر. دوم اینکه ببین فونت، آیکون یا فایل دیگه ای از سرور خارجی لود می شه یا نه. توی روزهایی که اینترنت بین الملل محدوده، همین یه مورد می تونه ظاهر صفحه رو خراب کنه. سوم اینکه اگه فقط چند کامپوننت لازم داری، ببین می شه همون ها رو جدا لود کرد یا باید کل کتابخونه رو بیاری.

نسخه های رسمی و بدون تغییر @trendyol/baklava توی مخزن داخلی ما هم در دسترسه، پس برای نصب لازم نیست حتما به رجیستری npm وصل باشی.

راهنمای استفاده

کار با Baklava توی یه صفحه معمولی چند قدم ساده بیشتر نداره. کد آماده برای افزودن به صفحه، پایین همین صفحه گذاشته شده.

  • اول بسته رو از مخزن همین صفحه بگیر. اگه به npm دسترسی داری، می تونی مستقیم به پروژه اضافه ش کنی.
  • فایل جاوااسکریپت کتابخانه و فایل استایل تم رو با کد آماده پایین صفحه توی هدر یا انتهای صفحه لود کن.
  • بعدش کامپوننت ها رو مثل تگ HTML معمولی توی صفحه بنویس. تگ ها با پیشوند bl- شروع می شن، مثل bl-button.
  • ویژگی ها (attribute) و رویدادهای هر کامپوننت رو از مستندات رسمی پروژه ببین و با addEventListener بهشون وصل کن.
  • اگه سایتت فارسیه، صفحه رو روی حالت راست به چپ (dir="rtl") بذار و نمایش متن و فاصله ها رو چک کن. اگه جایی به هم ریخت، با CSS خودت اصلاحش کن.

پیشنهادم اینه که اول توی یه صفحه آزمایشی امتحانش کنی و بعد بیاریش توی پروژه اصلی. اگه از فریم ورکی مثل React یا Vue استفاده می کنی، یه نگاه هم به نحوه کار همون فریم ورک با وب کامپوننت ها بنداز، چون ثبت رویدادها و پاس دادن ویژگی ها یه کم فرق داره.

همه نسخه‌ها (۱۱)

نسخه‌های ۳.x ۹ نسخه
  • ۳.۵.۰ آخرین نسخه ۹۰۵ کیلوبایت·
    دانلودنسخه 3.5.0
    نشانی مستقیم فایل اصلی 3.5.0 https://mirror.wbweb.ir/npm/@trendyol/baklava@3.5.0/dist/baklava.js
  • ۳.۴.۲ ۸۹۱ کیلوبایت·
    دانلودنسخه 3.4.2
    نشانی مستقیم فایل اصلی 3.4.2 https://mirror.wbweb.ir/npm/@trendyol/baklava@3.4.2/dist/baklava.js
  • ۳.۴.۱ ۸۹۱ کیلوبایت·
    دانلودنسخه 3.4.1
    نشانی مستقیم فایل اصلی 3.4.1 https://mirror.wbweb.ir/npm/@trendyol/baklava@3.4.1/dist/baklava.js
  • ۳.۴.۰ ۸۸۹ کیلوبایت·
    دانلودنسخه 3.4.0
    نشانی مستقیم فایل اصلی 3.4.0 https://mirror.wbweb.ir/npm/@trendyol/baklava@3.4.0/dist/baklava.js
  • ۳.۳.۱ ۵۶۴ کیلوبایت·
    دانلودنسخه 3.3.1
    نشانی مستقیم فایل اصلی 3.3.1 https://mirror.wbweb.ir/npm/@trendyol/baklava@3.3.1/dist/baklava.js
  • ۳.۳.۰ ۵۶۵ کیلوبایت·
    دانلودنسخه 3.3.0
    نشانی مستقیم فایل اصلی 3.3.0 https://mirror.wbweb.ir/npm/@trendyol/baklava@3.3.0/dist/baklava.js
  • ۳.۲.۰ ۵۳۸ کیلوبایت·
    دانلودنسخه 3.2.0
    نشانی مستقیم فایل اصلی 3.2.0 https://mirror.wbweb.ir/npm/@trendyol/baklava@3.2.0/dist/baklava.js
  • ۳.۱.۰ ۸۱۶ کیلوبایت·
    دانلودنسخه 3.1.0
    نشانی مستقیم فایل اصلی 3.1.0 https://mirror.wbweb.ir/npm/@trendyol/baklava@3.1.0/dist/baklava.js
  • ۳.۰.۰ ۷۴۲ کیلوبایت·
    دانلودنسخه 3.0.0
    نشانی مستقیم فایل اصلی 3.0.0 https://mirror.wbweb.ir/npm/@trendyol/baklava@3.0.0/dist/baklava.js
نسخه‌های ۲.x ۲ نسخه
  • ۲.۳.۰ ۶۸۷ کیلوبایت·
    دانلودنسخه 2.3.0
    نشانی مستقیم فایل اصلی 2.3.0 https://mirror.wbweb.ir/npm/@trendyol/baklava@2.3.0/dist/baklava.js
  • ۲.۰.۰ قدیمی‌ترین نسخه ۶۲۹ کیلوبایت·
    دانلودنسخه 2.0.0
    نشانی مستقیم فایل اصلی 2.0.0 https://mirror.wbweb.ir/npm/@trendyol/baklava@2.0.0/dist/baklava.js

پرسش‌های رایج

  • یه سیستم طراحی متن باز از Trendyol Tech که مجموعه ای از کامپوننت های آماده رابط کاربری رو به شکل بسته npm ارائه می ده. باهاش می تونی دکمه، فرم و عناصر مشابه رو بدون طراحی از صفر توی پروژه وب بذاری و ظاهر یکدستی بگیری. برای پنل، داشبورد و اپلیکیشن وب مناسبه.

  • نه. کامپوننت ها بر پایه وب کامپوننت ها ساخته شدن و به فریم ورک خاصی وابسته نیستن. می تونی مستقیم توی HTML ازشون استفاده کنی. اگه پروژه ات با فریم ورک دیگه ای نوشته شده، فقط باید ببینی اون فریم ورک با وب کامپوننت ها چطور کار می کنه.

  • از روی توضیح رسمی نمی شه قطعی گفت. چون برای محصول ترکیه ای ساخته شده، پیشنهاد می کنم قبل از استفاده اصلی، یه صفحه آزمایشی با متن فارسی و حالت راست به چپ بسازی و ظاهر کامپوننت ها و فونت رو چک کنی.

  • مجوزش MIT است و معمولا استفاده تجاری، تغییر و بازتوزیع رو مجاز می کنه، به شرطی که متن مجوز و اطلاعات حق نشر رو نگه داری. با این حال متن کامل مجوز همراه پروژه هست و بهتره یه بار بخونیش.

چیزی که لازم دارید اینجا نیست؟

نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.