npm i --save nativescript-rating-dialog
- Version: 1.0.3
- GitHub:
- NPM: https://www.npmjs.com/package/nativescript-rating-dialog
- Downloads:
- Last Day: 0
- Last Week: 0
- Last Month: 0
Nativescript Rating Dialog
Installation
tns plugin add nativescript-rating-dialog
Usage
import { RatingDialog, RatingDialogOption } from 'nativescript-rating-dialog';
let ratingDialog = new RatingDialog();
const option: RatingDialogOption = {
title: "Title",
icon: "favorite",
android: {
positiveButtonText: "Send",
negativeButtonText: "Cancel",
threshold: 3,
onThresholdCleared: (dialog, rating, thresholdCleared) => {
},
onThresholdFailed: (dialog, rating) => {
},
onDialogDismiss: (rating) => {
if (rating < 3) {
console.log(`Negative Rate of ${rating} out of 5`);
alert(`Negative Rate of ${rating} out of 5`);
} else {
alert(`Positive Rate of ${rating} out of 5`);
console.log(`Positive Rate of ${rating} out of 5`);
}
}
},
ios: {
onPositiveButtonText: "Done",
onNegativeButtonText: "Send Feedback",
onPositiveRate: (rating) => {
console.log('Positive', rating);
},
onNegativeRate: (rating) => {
console.log('Negative', rating);
},
onDismiss: () => {
console.log('Dismiss');
}
}
};
ratingDialog.show(option);
API
Rating Dialog Option
Property | Type | Description |
---|---|---|
icon | string |
Set icon (use app icon as default) (optional) . |
title | string |
Set title |
textColor | string |
Set title text color (optional) |
backgroundColor | string |
Set background color (optional) |
android | AndroidRatingDialogOption |
Set android options (optional) |
ios | IOSRatingDialogOption |
Set iOS options (optional) |
Android Rating Dialog Option
Property | Type | Description |
---|---|---|
threshold | number |
Set threshold (number of rating) to trigger the feedback (default is 2) |
positiveButtonTextColor | string |
Set positive button text color (optional) |
negativeButtonTextColor | string |
Set negative buttonText color (optional) |
positiveButtonText | string |
Set positive button text |
negativeButtonText | string |
Set negative button text (optional) |
ratingBarColor | string |
Set rating bar color (optional) |
ratingBarBackgroundColor | string |
Set rating bar background color (optional) |
playstoreUrl | string |
Set playstore url (to redirect user to the app on app store) (optional) |
feedbackForm | AndroidRatingDialogFeedbackForm |
Set feedback form options (optional) |
onThresholdCleared (ratingDialog: any, rating: number, thresholdCleared: boolean) | Callback Function |
Set onThresholdCleared callback which fired when your rating score is greater than the threshold. (override the default redirection to Google Play) (optional) |
onThresholdFailed (ratingDialog: any, rating: number, thresholdCleared: boolean) | Callback Function |
Set onThresholdFailed callback which fired when your rating score is less than the threshold. (use when you want to show your custom feedback form) (optional) |
onRatingChanged (rating: number, thresholdCleared: boolean) | Callback Function |
Set onRatingChanged callback which fires when the rating changed (optional) |
onRatingBarFormSumbit (feedback: string) | Callback Function |
Set onRatingBarFormSumbit callback which fires when the rating is submitted (optional) |
onDialogDismiss(rating: number) | Callback Function |
Set onDialogDismiss callback which fires when the user dismissed the dialog (optional) |
Android RatingDialog Feedback Form
Property | Type | Description |
---|---|---|
formTitle | string |
Set form title |
formSubmitText | string |
Set form submit button text |
cancelText | string |
Set cancel button text |
feedbackFormHint | string |
Set feedback form hint (optional) |
feedBackTextColor | string |
Set feedBack text color (optional) |
iOS Rating Dialog Option
Property | Type | Description |
---|---|---|
subtitle | number |
Set subtitle (optional) (default is: "Please rate your experience") |
onPositiveButtonColor | string |
Set positive button color (optional) |
onNegativeButtonColor | string |
Set negative button color (optional) |
onPositiveButtonText | string |
Set positive button text (optional) |
onNegativeButtonText | string |
Set negative button text (optional) |
positiveText | string |
Set positive text (optional) (default is: "Awesome!") |
negativeText | string |
Set negative text (optional) (default is: "Darn. we should have been better.") |
textColor | string |
Set tex color (optional) |
emptyStarImage | string |
Set name of the empty star image resource (optional) |
fullStarImage | string |
Set name of the full star image resource (optional) |
dismissButtonColor | string |
Set dismiss button color (optional) |
itunesId | string |
Set itunesId (optional) |
onPositiveRate (rating: number) | Callback Function |
Set onPositiveRate callback which fires when the user chose more than 3 stars and click the rate (optional) |
onNegativeRate (rating: number) | Callback Function |
Set onNegativeRate callback which fires when the user chose less than 4 stars and click the rate (optional) |
onDismiss () | Callback Function |
Set onDismiss callback which fires when the user dismissed that screen without choosing anything (optional) |
Author
Jonathan Mayunga, [email protected]
Credits
For Android we're using the Smart App Rate by Codemy, and for iOS MBRateApp by MatiBot.
License
Apache License Version 2.0, January 2004