目录
- 一、简介
- 二、安装方式
- 方式1：通过 npm 安装
- 方式2：直接下载原代码
- 三、概念讲解
- 四、创建一个选择题
- 五、创建一个选择组
- 四、选项 Option
- 构造函数
- 创建选项
- 五、选择题 ChoiceQuestion
- 构造函数
- 创建选择题
- 选择操作和设置
- 查找和删除操作
- 条件测试
- 计分
- 六、选择题组 ChoiceQuestionList
- 创建选择组
- 题目汇总
- 选择操作
- 查找和删除操作
- 条件测试
内容
一、简介
在很多需要中，选择题是很常见的功能，如：调查问卷、选项设置、选项验证 等等；无论对于什么样的业务，虽然选择题的页面效果、交互、规则 等都不一样，但是，经过合理的设置，完全可以抽离出一套选择题的逻辑、数据模型； option-model 就是这样一个模型；
option-model 作为 选择题的数据、逻辑模型；支持单选、多选、限制选、默认选择、管理、统计、汇总、测试、验证、打分 等等；
相关文档：
如果您在使用该库的过程中有遇到了问题，或者有好的建议和想法，您都可以通过以下方式联系我，期待与您的交流：
- 邮箱：guobinyong@qq.com
- QQ：guobinyong@qq.com
- 微信：keyanzhe
二、安装方式
目前，安装方式有以下几种：
方式1：通过 npm 安装
npm install --save option-model
方式2：直接下载原代码
您可直接从 本项目的Git仓库 下载，此仓库里包含了 option-model 和 下文的示例代码； option-model 库是 本项目的Git仓库 项目中的 package/ChoiceQuestionModel.js 文件，您可以直接把该文件拷贝到您的项目中去；然后使用如下代码在您的项目中引入你需要的类：
import {ChoiceQuestion,Option,ChoiceQuestionList,ChoiceCondition} from "path/to/package/ChoiceQuestionModel.js";
三、概念讲解
对于选择题业务，肯定会有这些概念：题、题的选项、一组题； 在 option-model 中，也这对应的概念，并把这些概念设计成了类，如下：
- ChoiceQuestion : 选择题类，表示一个选择题；
- Option : 选项类，表示选择题的选项；
- ChoiceQuestionList : 选择题组类，表示一组选择题，即选择题列表；
- ChoiceCondition : 选择题约束类，表示选择题的限制条件； 该类是个抽象类， 用于让其它类继承； 选择题类 ChoiceQuestion 也继承自 选择题约束类 ChoiceCondition ；
在 option-model 的概念中，多了个 选择题约束类 ChoiceCondition ，一般用不到这个类；
以上各类的详细信息请见《option-model的接口文档》
四、选项 Option
在选择题中，选项就是选择题提供的供用户选择的答案；在 option-model 中，用 Option 类 表示选项；
构造函数
Option(content,id,choiceQuestion)
- @param content : any 选项的内容
- @param id : any 选项的标识符，在一个题目中，需要唯一
- @param choiceQuestion : ChoiceQuestion 选择所属的题目
创建选项
选项的创建和设置有2种方式
-
方式1：用构造函数创建和配置
let option = new Option("河南人",1); -
方式2：先创建未配置的选项，再更改相关属性：
let option = new Option(); //先创建选项 option.content = "安徽人"; //设置选项的内容 option.id = "A"; //设置选项的标识符
五、选择题 ChoiceQuestion
选择题 是 问题 及 该问题提供的供用户选择的答案 一个集合；即：选择题 包含 问题 和 选项列表； 在 option-model 中，用 ChoiceQuestion 类 表示选择题；
构造函数
ChoiceQuestion(subject,minSelectCount,maxSelectCount,id,options,rightAnswerIds,defaultSelectedIds,scoreValuel,type)
- @param subject : any 选择题的问题、标题；
- @param minSelectCount : number 最小选择数目
- @param maxSelectCount : number 最大选择数目
- @param id : any 题目的唯一标识符
- @param options : Array<Option> = [] 盛装选择题的所有选项的数组
- @param rightAnswerIds : Array = [] 盛装正确答案id的数组
- @param defaultSelectedIds : Array = [] 盛装默认选中的答案id的数组
- @param scoreValuel : number = 1 题目的分值
- @param type : any 题目类型
创建选择题
选择题的创建和设置有2种方式
-
方式1：用构造函数创建和配置
let question = new ChoiceQuestion("你是哪里人？",1,2,1,optionArr); -
方式2：先创建未配置的选项，再更改相关属性：
let question = new ChoiceQuestion(); //先创建题目 question.subject = "你爱人是哪里人？"; //设置标题 question.minSelectCount = 1; //设置最小选择数目 question.maxSelectCount = 3; //设置最大选择数目 question.id = 1; //设置id question.options = optionArr; //设置选项
选择操作和设置
你可以通过 defaultSelectedIds 属性来设置 选择题默认的选中的选项；通过 selectedOptions 或者 selectedOptionIds 获取选择题中被选中的选项；
ChoiceQuestion 的实例有丰富的选中方法，如下：
- selectOptionOfId(optionID) : 选中 id 为 optionID 的选项
- selectOptionsOfIdList(idList) : 选中 idList 中指定的所有 选项
- onlySelectOptionsOfIdList(idList) : 只选中 idList 中指定的所有 选项
- onlySelectOptionsOutofIdList(idList) : 只选中除 idList 中指定的 之外的 所有选项
- deselectOptionOfId(optionID) : 取消选中 id 为 optionID 的选项
- deselectOptionsOfIdList(idList) : 取消选中 idList 中指定的所有 选项
- deselectAll() : 取消所有选项的选中
- resetSelect() : 重围选中，重置后只选中默认选中的选项
查找和删除操作
ChoiceQuestion 的实例中也提供了丰富的查找、删除方法，如下：
- findIndexForId(optionID) : 返回 id 为 optionID 的 选项 在 options 中的索引；如果没有符合条件的元素返回 -1
- findOptionForId(optionID) : 返回 id 为 optionID 的 选项；如果没有符合条件的元素返回 undefined
- findIndexListForIdList(idList)- : 返回 idList 中的 id 对应的 选项 在 options 中的索引的数组；
- findOptionListForIdList(idList) : 返回 idList 中的 id 对应的 选项 的数组；
- deleteOptionForId(optionID) : 删除 id 为 optionID 的 选项 ；
- deleteOptionForIdList(idList) : 删除 idList 中指定的所有选项 ；
条件测试
ChoiceQuestion 的实例有丰富的条件测试方法，有以下方法可用于条件测试：
- testRequisite() : 测试是否满足必须
- testMinSelectCount() : 测试是否满足最小选择数
- testMaxSelectCount() : 测试是否满足最大选择数
- testAllCondition() : 测试是否满足所有的约束条件
- testAnswer() : 测试是否回答正确，需要设置 rightAnswerIds
计分
如果给选择题 ChoiceQuestion 实例设置了 分值 scoreValuel ，则也可以通过ChoiceQuestion 实例的 score 属性 来获得得分情况；
六、选择题组 ChoiceQuestionList
在选择题的使用场景中，往往会有很多道选择题，多个选择题的集合 就称为 选择题组 或者 选择题列表 ； 在 option-model 中，用 ChoiceQuestionList 类 表示选择题组；
创建选择组
因为 ChoiceQuestionList 继承自 Array ，所以 ChoiceQuestionList 的构造函数 与 Array 相同；所以创建选择题组的方式也有很多种，分别如下：
-
方式1:
let questionList = new ChoiceQuestionList(); //先创建一个空的选择题组 //再把选择题实例一个一个的 push 进 选择题组 questionList.push(question1); questionList.push(question2); questionList.push(question3); -
方式2:
let questionList = new ChoiceQuestionList(question1,question2,question3); //创建选择题组实例时 直接把选择题作为参数传入构造函数 -
方式3:
let questionList = new ChoiceQuestionList(3); //先创建相应长度的空的选择题组 // 再通过的方括号语法设置相应的选择题 questionList[0] = question1; questionList[1] = question1; questionList[2] = question1;
当然，还有其它方式，这里不再一一介绍了！
题目汇总
通过 ChoiceQuestionList 实例，可以查看各种关于题目的统计、汇总数据，如下：
- passConditionOfQuestions : 获得符合约束条件的所有题目的列表
- passConditionOfQuestionIds : 获得符合约束条件的所有题目的id列表
- notPassConditionOfQuestions : 获得不符合约束条件的所有题目的列表
- notPassConditionOfQuestionIds : 获得不符合约束条件的所有题目的id列表
- answerRightQuestions : 获得回答正确的题目的列表
- answerRightQuestionIds : 获得回答正确的题目的id列表
- answerWrongQuestions : 获得回答错误的题目的列表
- answerWrongQuestionIds : 获得回答错误的题目的id列表
- totalScore : 所有题目的得分总和
选择操作
ChoiceQuestionList 的实例也有常用的选择操作的方法，如下：
- deselectAll() : 取消所有题目的选中
- resetSelect() : 重围所有题目的选中，重置后每个题目只选中默认选中的选项
查找和删除操作
虽然 ChoiceQuestionList 继承自 Array ，已经具备了 Array 所有的方法，但为了更方便您的使用，ChoiceQuestionList 的实例中仍然提供了丰富的查找、删除方法，如下：
- findIndexForId(questionID) : 返回 id 为 questionID 的 选择题 在 选择题组 中的索引；如果没有符合条件的元素返回 -1
- findQuestionForId(questionID) : 返回 id 为 questionID 的 选择题；如果没有符合条件的元素返回 undefined
- findIndexListForIdList(idList) : 返回 idList 中的 id 对应的 选择题 在 选择题组 中的索引的数组；
- findQuestionListForIdList(idList) : 返回 idList 中的 id 对应的 选择题 的数组；
- deleteQuestionForId(questionID) : 删除 id 为 questionID 的 选择题；
- deleteQuestionForIdList(idList) : 删除 idList 中指定的所有选择题 ；
条件测试
ChoiceQuestionList 的实例有丰富的条件测试方法，有以下方法可用于条件测试：
- testEveryAccordCondition() : 测试是否每一个题目都符合约束
- testSomeAccordCondition() : 测试是否有部分题目符合约束
- testEveryIsRight() : 测试是否每个题目都回答正确
- testSomeIsRight() : 测试是否部分题目回答正确
