pl-rich-text-editor元件¶
提供浏览器内的富文本编辑器，主要针对手动评分论文类型的问题。该编辑器基于Quill富文本编辑器。
样品元素¶
<pl-rich-text-editor file-name="answer.html"> </pl-rich-text-editor>
定制¶
| 属性 | 类型 | 默认 | 描述 |
|---|---|---|---|
allow-blank |
布尔 | 假 | 是否允许输入框为空。默认情况下，空提交不会被评分（格式无效）。 |
clipboard-enabled |
布尔 | 真实 | 该元素是否支持从用户界面剪切、复制和粘贴编辑器的内容。请注意，编辑器内容仍然可以在浏览器的开发人员工具中使用，这将允许学生无论如何复制内容。另请注意，阻止复制或粘贴文本等操作可能会损害学生的体验，因此除非绝对必要，否则应避免这样做。 |
counter |
"word"、"character" 或 "none" |
查看描述 | 是否应在编辑器底部显示字数或字符数。如果设置了min-word-count或max-word-count，则counter默认为"word"，不能设置为"none"或"character"。否则，默认为 "none"。 |
directory |
字符串 | 查看描述 | 包含现有代码的源文件所在的目录。仅当使用 source-file-name 时才有用。如果它包含特殊名称 "clientFilesCourse" 或 "serverFilesCourse" 之一，则从课程的特殊目录中读取源文件名，否则该目录应位于问题自己的目录中。如果未提供，则应在问题的主目录中找到源文件名。 |
file-name |
字符串 | "answer.html" |
输出文件的名称；将用于将学生的答案存储在 _files 提交的答案中。如果问题中包含多个 pl-rich-text-editor 元素，则必须是唯一的。 |
format |
"html" 或 "markdown" |
"html" |
用于解释指定源文件或起始内容的格式。该选项不影响输出格式。 |
markdown-shortcuts |
布尔 | 真实 | 编辑器是否接受基于 Markdown 格式的快捷方式（例如，输入 _word_ 会导致单词变为斜体）。 |
max-word-count |
整数 | — | 提交答案的最大字数。较长的答案将被标记为无效（不可评分）。 |
min-word-count |
整数 | — | 提交答案的最小字数。较短的答案将被标记为无效（不可评分）。当 min-word-count 大于 0 时，不能与设置为 "true" 的 allow-blank 组合。 |
placeholder |
字符串 | "Your answer here" |
当没有学生输入时，文本将在编辑器中显示为占位符。 |
quill-theme |
字符串 | "snow" |
指定 Quill 编辑器主题；最常见的主题是 "snow"（使用默认工具栏）或 "bubble"（隐藏默认工具栏，在选择文本时显示格式选项）。有关其他主题的更多信息，请参阅 Quill 文档。 |
source-file-name |
字符串 | — | 具有要在编辑器中显示的现有内容的源文件的名称。该文件的格式必须与 format 属性中指定的格式匹配。 |
字数统计¶
该算法通过按空格分割来识别单词，这种约定适用于大多数标准英语文本。在公式、编程语法或没有空格分隔单词的语言等上下文中，生成的计数可能不对应于有意义的语言单位。
在一个问题中使用多个元素¶
pl-rich-text-editor 元素创建与学生答案的 HTML 内容相对应的文件提交。如果未提供文件名，则使用名称 answer.html。如果一个问题中包含多个 pl-rich-text-editor，则它们必须各自包含不同的文件名；在这种情况下，必须显式提供文件名，因为默认名称会在元素之间发生冲突。
关于可访问性的说明¶
一种常见的构造（通常继承自其他工具导入的问题）是使用具有“结构化”起始内容的富文本编辑器，例如带有空单元格的表格或一组子问题的标题。这样做通常是为了鼓励学生提供结构化答案（例如，填写包含特定信息的表格）。然而，这种方法可能会导致可访问性问题，因为屏幕阅读器可能难以导航和解释内容的结构。它还允许学生完全忽略结构，这可能会让评分者感到困惑并导致答案不一致。
如果您想鼓励结构化答案，请考虑为每条信息使用单独的输入字段，而不是依赖具有复杂格式的富文本编辑器。这可以帮助确保所有学生，包括使用辅助技术的学生，都可以有效地访问问题并与之互动。例如，您可以创建一个包含每个单元格单独元素的表格，而不是将表格作为富文本编辑器的起始内容，从而允许学生填写答案，而无需导航复杂的格式。这还提供了额外的好处，即允许每个单元格基于最适合预期答案的特定格式（例如数字、字符串、多行文本），并允许更精确的评分和反馈。它还允许在适用时对这些值进行自动评分，而当答案嵌入到富文本编辑器中时这是不可能的。
即使您希望学生提供富文本答案，也可以考虑将问题分成多个部分，每个部分都有自己的输入字段，而不是要求学生提供格式复杂的单一答案。这可以帮助学生专注于问题的每个部分并提供更有条理的答案，同时还简化评分过程并提高可访问性。
示例实现¶
- [元素/richTextEditor]