pl-checkbox元件¶
pl-checkbox 元素以随机顺序显示答案的子集
作为复选框。
样品元素¶
question.html
<pl-checkbox answers-name="vpos" weight="1">
<pl-answer correct="true">A-B</pl-answer>
<pl-answer correct="true">B-C</pl-answer>
<pl-answer> C-D</pl-answer>
<pl-answer correct="true">D-E</pl-answer>
<pl-answer> E-F</pl-answer>
<pl-answer> F-G</pl-answer>
</pl-checkbox>
定制¶
| 属性 | 类型 | 默认 | 描述 |
|---|---|---|---|
allow-blank |
布尔 | 假 | 是否允许空提交。当"false" (default)时，空提交将不予评分（格式无效）；当"true"时，空提交将被评分。 |
answers-name |
字符串 | — | 用于存储数据的变量名称。请注意，该属性在问题中必须是唯一的，即该属性的值不应在问题中重复。 |
detailed-help-text |
布尔 | 假 | 显示有效提交中可以选择的最小和最大选项数。请参阅下面的解释。 |
display |
字符串 | "block" |
如何显示答案选项："block"（单独行）或"inline"（单行）。 |
hide-help-text |
布尔 | 假 | 带有有关选择答案的提示的帮助文本。弹出按钮描述了所选的评分算法（"off"、"coverage"、"each-answer" 或 "net-correct"）。 |
hide-letter-keys |
布尔 | 假 | 隐藏答案列表中的字母键，即 (a)、(b)、(c) 等 |
hide-score-badge |
布尔 | 假 | 隐藏所选答案旁边的徽章。 |
max-correct |
整数 | 查看描述 | 显示的正确答案的最大数量。默认显示所有正确答案。 |
max-select |
整数 | 查看描述 | 在任何有效提交中可以选择的最大答案数。如果该属性与 detailed-help-text="true" 一起指定，则默认为 max-correct；否则，默认为显示答案的数量。 |
min-correct |
整数 | 查看描述 | 要显示的正确答案的最小数量。默认显示所有正确答案。 |
min-select |
整数 | 查看描述 | 任何有效提交中必须选择的最少答案数。如果该属性与 detailed-help-text="true" 一起指定，则默认为 min-correct；否则，默认为 1。如果 allow-blank="true"，则空提交时不强制执行 min-select。 |
number-answers |
整数 | 查看描述 | 要显示的答案选项总数。默认显示所有答案。 |
order |
字符串 | "random" |
答案选择顺序："random" (randomized) 或 "fixed"（按书面形式）。 |
partial-credit |
字符串 | "off" |
评分方法："off"（全有或全无，默认）、"net-correct"、"coverage" 或 "each-answer"。 |
show-number-correct |
布尔 | 假 | 在帮助文本中显示正确选项的数量。 |
weight |
整数 | 1 | 计算元素的加权平均分数时使用的权重。 |
在 pl-checkbox 元素内，每个选择都必须指定
pl-answer 具有以下属性：
| 属性 | 类型 | 默认 | 描述 |
|---|---|---|---|
correct |
布尔 | 假 | 这是问题的正确答案吗？ |
feedback |
字符串 | — | 如果学生选择了此选项，则在问题评分后，辅助文本 (HTML) 将在该选项旁边显示给学生。 |
部分信用评级¶
使用 partial-credit 属性可以使用四种分级方法：
"off"（全有或全无，默认）：学生只有选择所有正确答案且没有错误答案时才能获得满分。否则，他们将获得零信用。
"net-correct"（净正确）：每个正确答案标记为正确的加 1 分，每个错误答案标记为正确的扣 1 分。最终得分是得分总和除以正确答案总数。最低最终分数设置为零。
"coverage"(Coverage)：最终分数是通过将基本分数（选择正确答案的比例）乘以猜测因子（选择正确答案的比例）计算得出的。具体来说，如果t是所选正确答案的数量，c是正确答案的总数，n是所选答案的总数，则最终得分为(t / c) * (t / n)（在allow-blank="true"且提交为空白的特殊情况下，猜测因子未定义，因此得分设置为零）。此评分方案奖励包含 (i.e. "cover") 所有真实选项的提交。
"each-answer"（每个决定都很重要）：复选框答案被视为真/假答案列表。如果n是答案总数，则每个答案都分配1/n分。总分是选择的每个正确答案和未选择的每个错误答案的分数之和。
从已弃用的属性迁移¶
为了向后兼容，仍支持以下已弃用的属性：
| 旧语法 | 新语法 |
|---|---|
partial-credit="false" |
partial-credit="off" |
partial-credit="true" |
partial-credit="net-correct" |
partial-credit="true" partial-credit-method="PC" |
partial-credit="net-correct" |
partial-credit="true" partial-credit-method="EDC" |
partial-credit="each-answer" |
partial-credit="true" partial-credit-method="COV" |
partial-credit="coverage" |
inline="true" |
display="inline" |
fixed-order="true" |
order="fixed" |
hide-answer-panel="true" |
将元素包裹在 <pl-hide-in-panel answer="true">...</pl-hide-in-panel> |
使用 detailed-help-text 属性¶
detailed-help-text 属性可与 min-correct 和/或 max-correct 一起使用，以帮助学生选择正确的选项。如果未指定 min-select，则设置 detailed-help-text="true" 可确保有效提交中所选选项的数量至少为 min-correct 的值。同样，如果未指定 max-select，则设置 detailed-help-text="true" 可确保有效提交中所选选项的数量最多为 max-correct 的值。例如，如果复选框问题未指定 min-select 或 max-select，而是指定 min-correct="2"、max-correct="4" 和 detailed-help-text="true"，则所有有效提交必须选择 2 到 4 个选项。因此，我们通过阻止学生选择五个选项来帮助他们。事实上，如果选择了五个选项，则至少有一个所选选项是不正确的，因为最多有四个正确选项。
请注意，显式指定 min-select 会覆盖必须选择的最小选项数，同样，显式指定 max-select 会覆盖可以选择的最大选项数。
限制可选择的选项数量¶
min-select 和 max-select 属性确定有效提交中可以选择的选项的最小和最大数量。 min-select 的值通过以下步骤计算：
- 如果显式设置了
min-select属性，则我们使用min-select的指定值。 - 如果未指定
min-select，但与detailed-help-text="true"一起指定了min-correct，则我们使用min-correct的指定值。 - 如果步骤 1 和 2 不适用，则我们使用默认值 1。
- 如果
allow-blank="true"并且提交内容为空，则不强制执行min-select。
为了计算 max-select，我们使用类似的算法（注意步骤 3 中不同的默认值）：
- 如果显式设置了
max-select属性，则我们使用max-select的指定值。 - 如果未指定
max-select，但与detailed-help-text="true"一起指定了max-correct，则我们使用max-correct的指定值。 - 如果步骤 1 和 2 不适用，则
max-select默认为显示的复选框选项的数量（即学生默认可以选择所有显示的选项）。
示例实现¶
- [元素/复选框]
- [演示/随机复选框]