معرفی کتابخانه Commons در فلاتر

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

این پکیج فلاتر شامل موارد زیر می باشد:

• آلرت دیالوگ
• پیغام های Toast
• ویجت لودینگ
• متد های کمکی برای Shared Preferences
• اعتبار سنجی مقادیر
• متد های زمان و تقویم
• متد های چک کردن اتصال(اینترنت و…)
• متدهای درخواست http

نصب

برای نصب این پکیج باید حتما از نسخه SDK زبان دارت 2.6+ و به بالا استفاده کنید.

برای نصب این کتابخونه فایل pubspec.yaml شوید و کد زیر را قرار دهید.

 dependencies:  
  commons: ^0.4.9

دیالوگ ها

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

import 'package:commons/commons.dart';

دیالوگ های مختلفی در این کتابخانه فلاتر وجود دارد که میتوانید بنا به نیاز از آنها استفاده کنید.

• Success Dialog
• Error Dialog
• Warning Dialog
• Info Dialog
• Confirmation Dialog
• Wait Dialog
• Single Input Dialog

برای نمایش یک دیالوگ از نوع Success Dialog میتونید از کد های زیر استفاده کنید.

 
successDialog(  
    context,  
    "Success message",  
    negativeText: "Try Again",  
    negativeAction: () {},  
    positiveText: "Details",  
    positiveAction: () {},  
);

همانطور که در کد بالا میبینید برای کلیک کردن کاربر روی گزینه های مختلف متد های اکشن قرار داده شده است.

در کد پایین مثالی از نوع Confirm Dialog قرار داده ایم.

 
confirmationDialog(
    context, 
    "Confirm demo dialog", 
    positiveText: "Delete", 
    positiveAction: () {}
);

Toasts

برای بخش Toasts ها هم چندین نوع مختلف در دست انتخاب دارید.

Toasts ها پیغام های کوتاهی هستند که در طول استفاده از برنامه به کاربر نمایش داده می شود و بعد از چند ثانیه محو می شوند.

• Success Toast
• Error Toast
• Warning Toast
• Info Toast

این کتابخونه از OKToast برای پیاده سازی پیغام ها استفاده می کند.

 successToast("Success toast");

Loading screen

برای پیاده سازی یک لودینگ زیبا و جمع و جور میتونید از ویجتی به نام loadingScreen استفاده کنید.

 push(
    context,
    loadingScreen(  
        context,  
        duration: Duration(  
            seconds: 5,  
        ),  
        loadingType: LoadingType.JUMPING,
    ),
);

مخزن کتابخانه: Commons