QuizView

QuizView reduces developer time to think and cover all the possible cases for creating a quiz module in their android apps

Prerequisites

Add this in your root build.gradle file (not your module build.gradle file):

allprojects {
	repositories {
		...
		maven { url "https://jitpack.io" }
	}
}

Dependency

Add this to your module's build.gradle file:

dependencies {
	...
	implementation 'com.github.mrpascal1:QuizView:1.1.0'
}

Features implemented

• Text question
• Image question
• Image question with additional text
• Text based single select options
• Dynamic drawables for buttons
• Image based single select options
• Text based multi-select options
• Image based multi-select options
• Video question
• More customizations - Coming soon.

Configuration

Add to your design -

<com.shahid.quizview.QuizView
    android:id="@+id/quizView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="#EEEEEE"/>

To use QuizView, there are 2 important methods you need to know:

quizView.initView() //initView takes ArrayList<QuizModel>? as a parameter

quizView.setOnOptionClickListener(object : SubmitClickListener {
        override fun onSubmitClicked(isLast: Boolean, quizModel: ArrayList<QuizModel>) {
            if (isLast) {
                /* isLast will be true only when the last quiz submit is clicked
                 If you want you can process the data and find the correct answer count
                 Also, you can put custom logic here to open new activity or do something else */
            }
        }
    }
)

See full usage here

Data model and processing.

WARNING - You should always consider mapping data from your API models to this library models instead of directly using this models, because this might get change in future builds.

There are two in QuizView - QuizModel and QuizOption, see here

QuizModel -

data class QuizModel(
    var id: Int? = 0, // You should always pass a unique id to your quiz.
    var questionTitle: String? = "", // Title of the question
    var questionImageLink: String? = "", // If the Image link is Empty it won't be shown
    var answers: ArrayList<QuizOption>? = null, // Here you will supply a list of data answers to this particular quiz question.
    var quizType: QuizType? = null // QuizType is an enum which you will bind according to your quiz type per question.
)

Note - Right know only SINGLE_TEXT and SINGLE_IMAGE QuizType is working. Check all the types here

QuizOption -

data class QuizOption(
    var id: Int? = 0, // A unique id for every option
    var option: String? = "", // Option title text
    var isRightAnswer: Boolean = false, // As of now, only one option can be right
    var isSelected: Boolean = false // This will be modified by the library when user selects particular option, you could manually set it to true but only for one option.
)

There are other public methods you can use such as -

Buttons States

disablePreviousButton(isDisable: Boolean) - Can be used to disable previous button of the current quiz.

disableNextButton(isDisable: Boolean) - Can be used to disable next button of the current quiz.

Buttons Styling

setSubmitButtonDrawables(@DrawableRes enabledDrawable: Int, @DrawableRes disabledDrawable: Int) - Can be used to change drawable of submit button

setNextButtonDrawable(@DrawableRes enabledDrawable: Int, @DrawableRes disabledDrawable: Int) - Can be used to change drawable of next button

setPreviousButtonDrawable(@DrawableRes enabledDrawable: Int, @DrawableRes disabledDrawable: Int) - Can be used to change drawable of previous button

setSubmitButtonTextColor(@ColorRes enabledTextColor: Int, @ColorRes disabledTextColor: Int) - Can be used to change text color of submit button

setNextButtonTextColor(@ColorRes enabledTextColor: Int, @ColorRes disabledTextColor: Int) - Can be used to change text color of next button

setPreviousButtonTextColor(@ColorRes enabledTextColor: Int, @ColorRes disabledTextColor: Int) - Can be used to change text color of previous button

setSubmitTitle(title: String) - Can be used to change text of submit button

setNextTitle(title: String) - Can be used to change text of next button

setPreviousTitle(title: String) - Can be used to change text of previous button

Demo

License

GNU GPL v3