عن المشروع

توفر Bubbles مجموعة من العناصر الأساسية القابلة لإعادة الاستخدام لبناء واجهات مستخدم طرفية مع إطار عمل Bubble Tea في Go. تُستخدم هذه المكونات في الإنتاج في تطبيق Crush من Charm والعديد من التطبيقات الأخرى، والمشروع مرخص بموجب MIT كجزء من نظام Charm البيئي. المكونات المضمنة: - المؤشر (Spinner): مؤشرات متحركة للعمليات الجارية، مع عدة خيارات افتراضية ودعم لإطارات مخصصة. - إدخال النص (Text Input): حقل إدخال أحادي السطر مشابه لإدخال نص HTML، يدعم Unicode واللصق والتمرير الأفقي في المكان عندما تتجاوز القيمة عرض العنصر، وتخصيصًا واسعًا. - منطقة النص (Text Area): إدخال متعدد الأسطر مشابه لمنطقة نص HTML، مع دعم Unicode واللصق والتمرير الرأسي عندما يتجاوز المحتوى أبعاد العنصر. - الجدول (Table): يعرض ويتنقل في البيانات الجدولية في أعمدة وصفوف، مع تمرير رأسي وخيارات تخصيص. - التقدم (Progress): مقياس تقدم قابل للتخصيص مع حركة اختيارية عبر Harmonica، وتعبئة صلبة أو متدرجة، ورموز قابلة للتكوين للملء/الفراغ، وقراءة نسبة مئوية اختيارية. - المُرقّم (Paginator): يتعامل مع منطق الترقيم ويمكنه اختياريًا عرض واجهة ترقيم، مع دعم مؤشرات صفحات بنمط النقاط (مثل iOS) والأرقام؛ ويمكن أيضًا دمج المنطق مع تصورات مخصصة. - منفذ العرض (Viewport): منطقة محتوى قابلة للتمرير الرأسي مع اختياريًا مفاتيح تنقل قياسية ودعم عجلة الماوس، بالإضافة إلى وضع عالي الأداء للتطبيقات التي تستخدم مخزن الشاشة البديل. يتوافق جيدًا مع Reflow للإزاحة والتفاف مع مراعاة ANSI. - القائمة (List): مكون متكامل لتصفح مجموعات العناصر، مع ترقيم وترشيح ضبابي ومساعدة مولدة تلقائيًا ومؤشر نشاط ورسائل حالة، يمكن تشغيل كل منها أو إيقافه. تم استخلاصه أصلاً من Glow. - منتقي الملفات (File Picker): يتنقل في الدلائل ويختار الملفات، مع ترشيح اختياري حسب امتداد الملف. - المؤقت وساعة الإيقاف (Timer and Stopwatch): مكونات مرنة للعد التنازلي والتصاعدي مع تردد تحديث ومخرجات قابلة للتخصيص. - المساعدة (Help): عرض مساعدة أفقي صغير يُنشأ تلقائيًا من اختصارات المفاتيح، مع أوضاع أحادية ومتعددة الأسطر واقتطاع أنيق في المحطات الضيقة. - المفتاح (Key): مكون غير مرئي لإدارة اختصارات المفاتيح، مما يتيح إعادة تعيين المستخدم وإنشاء عروض مساعدة مرتبطة بتلك الاختصارات. يوفر المشروع دليل ترقية للانتقال من الإصدار v1، وروابط لأمثلة التعليمات البرمجية لكل مكون في دليل أمثلة Bubble Tea، ويشير إلى مجموعة مجتمعية من الفقاعات الإضافية (Charm & Friends) تقبل المساهمات. تشمل قنوات التغذية الراجعة تويتر وFediverse وDiscord.