本文档旨在解决Moodle表单中`
在Moodle表单开发中，经常需要使用zuojiankuohaophpcnselect>元素让用户选择选项。默认情况下，传递给表单的值可能是选项的索引或者数据库记录的ID。但有时，我们需要将选项的文本值（例如课程名称）直接作为值传递。本文将介绍如何实现这一目标。
1. 使用 get_records_menu 函数获取选项
Moodle提供了一个便捷的函数 get_records_menu，用于从数据库中获取数据并构建 <select> 元素的选项。该函数能够直接返回一个键值对数组，其中键是选项的值，值是选项的显示文本。
$options = $DB->get_records_menu('m_tl_mastercourse', [], 'id', 'id, name');
$mform->addElement('select', 'master_id', get_string('selectcourse'), $options);这段代码做了以下几件事：
- $DB->get_records_menu('m_tl_mastercourse', [], 'id', 'id, name'): 从 m_tl_mastercourse 表中获取数据。第二个参数 [] 表示没有 WHERE 条件。'id' 表示按照 id 字段排序。'id, name' 表示只选择 id 和 name 两个字段。返回的数组将以 id 作为键， name 作为值。
- $mform->addElement('select', 'master_id', get_string('selectcourse'), $options): 将生成的选项数组添加到表单中。'master_id' 是 <select> 元素的名称。get_string('selectcourse') 用于获取本地化的标签文本。$options 是我们刚刚创建的选项数组。
示例：
假设 m_tl_mastercourse 表包含以下数据：
| id | name |
|---|---|
| 1 | PHP01 |
| 2 | iOS01 |
| 3 | Android01 |
那么 $options 数组将是：
$options = [
1 => 'PHP01',
2 => 'iOS01',
3 => 'Android01',
];生成的 HTML 代码将如下所示：
<select id="id_master_id" name="master_id">
<option value="1">PHP01</option>
<option value="2">iOS01</option>
<option value="3">Android01</option>
</select>2. 设置表单的初始数据
为了在编辑表单时预先选中某个选项，或者在提交后重新显示表单时保留用户选择，我们需要使用表单 API 的 set_data 方法。
$formdata = new \stdClass(); $formdata->master_id = 2; // 假设要预先选中 iOS01 $mform = new edit_form(); $mform->set_data($formdata); $mform->display();
这段代码做了以下几件事：
- $formdata = new \stdClass(): 创建一个标准对象，用于存储表单数据。
- $formdata->master_id = 2: 设置 master_id 字段的值为 2，这将导致 <select> 元素中 value 为 2 的选项被选中 (也就是 iOS01)。
- $mform = new edit_form(): 创建表单实例。
- $mform->set_data($formdata): 将数据设置到表单中。
- $mform->display(): 显示表单。
注意事项：
- 确保传递给 $formdata->master_id 的值与 $options 数组中的键相匹配。
- get_records_menu 函数的第三个参数指定了排序字段，可以根据实际需求进行调整。
- 如果需要添加 WHERE 条件来过滤数据，可以在 get_records_menu 函数的第二个参数中传递一个条件数组。
总结：
通过结合 get_records_menu 函数和 set_data 方法，我们可以轻松地在 Moodle 表单中将 <select> 元素的文本值作为实际值传递，从而实现更灵活的数据处理。 get_records_menu 简化了从数据库获取选项数据的过程，而 set_data 方法则允许我们设置表单的初始数据，包括预先选中选项。 理解并熟练运用这两个函数，能够极大地提高 Moodle 表单开发的效率。
