Rating Bar (نوار امتیاز) متریال دیزاین در اندروید

امتیاز 4.00 ( 1 رای )

سلام دوستان در این سری از آموزش برنامه نویسی اندروید به آموزش Rating Bar (نوار امتیاز) متریال دیزاین در اندروید می پردازیم شاید Ratin Bar اندروید را دیده باشید البته می توان گفت آن نوار امتیاز نیز متریال دیزاین است اما امکانات سفارشی سازی ندارد در ادامه می توانید پیش نمایشی از Rating Bar متریال دیزاین را مشاهده کنید.

همانطور که مشاهده می کنید چقدر زیبا و متریال دیزاین طراحی شده است.
برای مشاهده فایل متحرک (gif) کلیک کنید .
یک خبر خوب این کتاب خانه از api 16 به بالا کار می کند ! یعنی MinSdk برابر با 16 به بالا باشد.
برای استفاده از این کتاب خانه متریال دیزاین ابتدا باید آن را به پروژه اضافه کنید.
برای اینکار وارد فایل Build.gradle از نوع Module شده سپس در بخش dependencies خط زیر را اضافه کنید.

compile 'com.stepstone.apprating:app-rating:1.2.0'

1	compile 'com.stepstone.apprating:app-rating:1.2.0'

پروژه را sync کنید.
ساده ترین مثال برای استفاده از آن

new AppRatingDialog.Builder()
                .setPositiveButtonText("Submit")
                .setNegativeButtonText("Cancel")
                .setNoteDescriptions(Arrays.asList("Very Bad", "Not good", "Quite ok", "Very Good", "Excellent !!!"))
                .setDefaultRating(2)
                .setTitle("Rate this application")
                .setDescription("Please select some stars and give your feedback")
                .setTitleTextColor(R.color.titleTextColor)
                .setDescriptionTextColor(R.color.contentTextColor)
                .setCommentTextColor(R.color.commentTextColor)
                .setCommentBackgroundColor(R.color.colorPrimaryDark)
                .setPositiveButtonClickedListener(listener)
                .setWindowAnimation(R.style.MyDialogFadeAnimation)
                .create(MainActivity.this)
                .show();

new AppRatingDialog.Builder()

.setPositiveButtonText("Submit")

.setNegativeButtonText("Cancel")

.setNoteDescriptions(Arrays.asList("Very Bad", "Not good", "Quite ok", "Very Good", "Excellent !!!"))

.setDefaultRating(2)

.setTitle("Rate this application")

.setDescription("Please select some stars and give your feedback")

.setTitleTextColor(R.color.titleTextColor)

.setDescriptionTextColor(R.color.contentTextColor)

.setCommentTextColor(R.color.commentTextColor)

.setCommentBackgroundColor(R.color.colorPrimaryDark)

.setPositiveButtonClickedListener(listener)

.setWindowAnimation(R.style.MyDialogFadeAnimation)

.create(MainActivity.this)

.show();

setPositiveButtonText : متن دکمه PositiveButton را تعیین می کند.
setNegativeButtonText :متن دکمه NegativeButton را تعیین می کند.
setNoteDescriptions : متن هر کدام از ستاره های امتیاز دهی را تعیین می کند.
setDefaultRating : به صورت پیشفرض بروی چند ستاره باشد .
setTitle : عنوان را تنظیم می کند.
setDescription : متنی که زیر عنوان نمایش داده می شود را تنظیم می کند.
setTitleTextColor : رنگ متن عنوان را تنظیم می کند.
setDescriptionTextColor : رنگ متنی که زیر عنوان قرار می گیرد را تنظیم می کند.
setCommentTextColor : رنگ متنی که در بخش feedback نوشته می شود را تنظیم می کند.
setCommentBackgroundColor : رنگ پس زمینه نایحه comment یا همان بخش feedback را مشخص می کند.
setPositiveButtonClickedListener : این بخش را در ادامه توضیح خواهم داد.
setWindowAnimation : برای دادن انیمیشن به Alert استفاده می شود.
create : باعث ساخت آن.
show : نمایش آن.
در بالا یک بخش را گفتم در ادامه توضیح خواهم داد برای اینکه رویداد کلیک برای دکمه ها تعریف کنیم باید از void زیر استفاده کنیم.

private OnPositiveButtonClickedListener listener = new OnPositiveButtonClickedListener() {
        @Override
        public void onClicked(int rate, String comment) {
            // result
        }
    };
}