A package that handles the creation and state of a dynamic questionnaire/survey with conditional questions. Have you ever wanted to implement a form/questionnaire/survey like the ones you see on Google forms? Have you ever wanted to implement conditional questions that show or hide the questions that follow, based on the user's input? All you need to do is frame the questions in a specific way and the package handles the widget creation and the state management for you.
This project requires the latest version of Dart. You can download the latest and greatest here.
Add this to your package's pubspec.yaml file:
dependencies:
conditional_questions: '^2.0.0'You can install packages from the command line:
$ pub get
..Alternatively, your editor might support pub. Check the docs for your editor to learn more.
Now in your Dart code, you can use:
import 'package:conditional_questions/conditional_questions.dart';First, you must initialize the question structure where you specify the type of questions and their possible answers, if any. You can also nest questions to form conditional questions. You can even mark them as mandatory.
There are three types of questions.
This is an instance of a regular question where the answer is not limited to any specific choice. The answer to this question can be typed in by the user, single line or multiline.
Question(
question: "What is your name?",
validate:(field){
if (field.isEmpty) return "Field cannot be empty";
return null;
}
)This is an instance of a Closed-Ended question where the answer is limited to a set of pre-defined choices. The answer list provided to this instance is rendered as a set of Radio buttons.
PolarQuestion(
question: "Have you made any donations in the past?",
answers: ["Yes", "No"],
isMandatory: true,
)This is an instance of a Closed-Ended question where the answer is limited to a set of pre-defined choices. But they are slightly different from PolarQuestions. They can hold or 'nest' other questions. The nested questions or the children are associated to a particular answer of the parent question. They are dynamically shown depending on the selected choice.
NestedQuestion(
question: "The series will depend on your answer",
answers: ["Yes", "No"],
children: {
'Yes': [
PolarQuestion(
question: "Have you ever taken medication for H1n1?",
answers: ["Yes", "No"]),
PolarQuestion(
question: "Have you ever taken medication for Rabies?",
answers: ["Yes", "No"]),
Question(
question: "Comments",
),
],
'No': [
NestedQuestion(
question: "Have you sustained any injuries?",
answers: [
"Yes",
"No"
],
children: {
'Yes': [
PolarQuestion(
question: "Did it result in a disability?",
answers: ["Yes", "No", "I prefer not to say"]),
],
'No': [
PolarQuestion(
question:
"Have you ever been infected with chicken pox?",
answers: ["Yes", "No"]),
]
}),
],
},
) List<Question> questions() {
return [
Question(
question: "What is your name?",
//isMandatory: true,
validate: (field) {
if (field.isEmpty) return "Field cannot be empty";
return null;
},
),
PolarQuestion(
question: "Have you made any donations in the past?",
answers: ["Yes", "No"],
isMandatory: true),
PolarQuestion(
question: "In the last 3 months have you had a vaccination?",
answers: ["Yes", "No"]),
PolarQuestion(
question: "Have you ever taken medication for HIV?",
answers: ["Yes", "No"]),
NestedQuestion(
question: "The series will depend on your answer",
answers: ["Yes", "No"],
children: {
'Yes': [
PolarQuestion(
question: "Have you ever taken medication for H1n1?",
answers: ["Yes", "No"]),
PolarQuestion(
question: "Have you ever taken medication for Rabies?",
answers: ["Yes", "No"]),
Question(
question: "Comments",
),
],
'No': [
NestedQuestion(
question: "Have you sustained any injuries?",
answers: [
"Yes",
"No"
],
children: {
'Yes': [
PolarQuestion(
question: "Did it result in a disability?",
answers: ["Yes", "No", "I prefer not to say"]),
],
'No': [
PolarQuestion(
question:
"Have you ever been infected with chicken pox?",
answers: ["Yes", "No"]),
]
}),
],
},
)
];
}This is the main widget that handles the form.
ConditionalQuestions(
key: _key,
children: questions(),
trailing: [
MaterialButton(
color: Colors.deepOrange,
splashColor: Colors.orangeAccent,
onPressed: () async {
if (_key.currentState!.validate()) {
print("validated!");
}
},
child: Text("Submit"),
)
],
leading: [Text("TITLE")],
),import 'package:conditional_questions/conditional_questions.dart';
import 'package:flutter/material.dart';
void main() {
runApp(MyApp());
}
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'Flutter Demo',
theme: ThemeData(
primarySwatch: Colors.blue,
),
home: MyHomePage(title: 'Flutter Demo Home Page'),
);
}
}
class MyHomePage extends StatefulWidget {
MyHomePage({Key? key, this.title}) : super(key: key);
final String? title;
@override
_MyHomePageState createState() => _MyHomePageState();
}
class _MyHomePageState extends State<MyHomePage> {
final _key = GlobalKey<QuestionFormState>();
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text(widget.title!),
),
body: ConditionalQuestions(
key: _key,
children: questions(),
trailing: [
MaterialButton(
color: Colors.deepOrange,
splashColor: Colors.orangeAccent,
onPressed: () async {
if (_key.currentState!.validate()) {
print("validated!");
}
},
child: Text("Submit"),
)
],
leading: [Text("TITLE")],
),
);
}
}
List<Question> questions() {
return [
Question(
question: "What is your name?",
//isMandatory: true,
validate: (field) {
if (field.isEmpty) return "Field cannot be empty";
return null;
},
),
PolarQuestion(
question: "Have you made any donations in the past?",
answers: ["Yes", "No"],
isMandatory: true),
PolarQuestion(
question: "In the last 3 months have you had a vaccination?",
answers: ["Yes", "No"]),
PolarQuestion(
question: "Have you ever taken medication for HIV?",
answers: ["Yes", "No"]),
NestedQuestion(
question: "The series will depend on your answer",
answers: ["Yes", "No"],
children: {
'Yes': [
PolarQuestion(
question: "Have you ever taken medication for H1n1?",
answers: ["Yes", "No"]),
PolarQuestion(
question: "Have you ever taken medication for Rabies?",
answers: ["Yes", "No"]),
Question(
question: "Comments",
),
],
'No': [
NestedQuestion(
question: "Have you sustained any injuries?",
answers: [
"Yes",
"No"
],
children: {
'Yes': [
PolarQuestion(
question: "Did it result in a disability?",
answers: ["Yes", "No", "I prefer not to say"]),
],
'No': [
PolarQuestion(
question: "Have you ever been infected with chicken pox?",
answers: ["Yes", "No"]),
]
}),
],
},
)
];
}Visit my LinkedIn at https://www.linkedin.com/in/michel98