Moodle表单：如何将Select选项的文本值作为值传递

本文档旨在解决Moodle表单中``元素选项值传递的问题。通过使用`get_records_menu`函数简化数据获取，并结合表单API的`set_data`方法，我们可以轻松地将选项的文本值作为实际值传递到表单中，从而实现更灵活的数据处理和提交。

在Moodle表单开发中，经常需要使用元素让用户选择选项。默认情况下，传递给表单的值可能是选项的索引或者数据库记录的ID。但有时，我们需要将选项的文本值（例如课程名称）直接作为值传递。本文将介绍如何实现这一目标。

1. 使用 get_records_menu 函数获取选项

Moodle提供了一个便捷的函数 get_records_menu，用于从数据库中获取数据并构建 元素的选项。该函数能够直接返回一个键值对数组，其中键是选项的值，值是选项的显示文本。

$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' 是 元素的名称。get_string('selectcourse') 用于获取本地化的标签文本。$options 是我们刚刚创建的选项数组。

示例：

假设 m_tl_mastercourse 表包含以下数据：

那么 $options 数组将是：

Molica AI

一款聚合了多种AI工具的一站式创作平台

下载

$options = [
    1 => 'PHP01',
    2 => 'iOS01',
    3 => 'Android01',
];

生成的 HTML 代码将如下所示：

    PHP01
    iOS01
    Android01

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，这将导致 元素中 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 表单中将 元素的文本值作为实际值传递，从而实现更灵活的数据处理。 get_records_menu 简化了从数据库获取选项数据的过程，而 set_data 方法则允许我们设置表单的初始数据，包括预先选中选项。 理解并熟练运用这两个函数，能够极大地提高 Moodle 表单开发的效率。