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

本文旨在解决Moodle表单中，在使用Select元素时，如何将选项的实际值（而非默认的数字索引）作为提交值传递的问题。我们将介绍如何使用`get_records_menu`函数简化数据获取，并展示如何通过`set_data`方法将值传递给表单，确保提交的是期望的实际值。

在Moodle表单开发中，select元素用于创建下拉选择框。默认情况下，select元素的option的value属性可能是从0开始的数字索引，但在某些情况下，我们需要将数据库中的实际值作为option的value传递，以便在表单提交时获取到这些实际值。

使用get_records_menu简化数据获取

Moodle提供了一个方便的函数get_records_menu，可以简化从数据库中获取数据并构建select元素选项的过程。相比于手动构建数组，它能更简洁地完成任务。

以下是使用get_records_menu的示例代码：

global $DB;

$options = $DB->get_records_menu('m_tl_mastercourse', [], 'id', 'id, name');

$mform->addElement('select', 'master_id', get_string('selectcourse'), $options);

这段代码做了以下几件事：

1. global $DB;：获取Moodle数据库连接对象。
2. $DB->get_records_menu('m_tl_mastercourse', [], 'id', 'id, name');：从m_tl_mastercourse表中获取数据，并构建一个关联数组。
   • 第一个参数是表名m_tl_mastercourse。
   • 第二个参数是WHERE条件，这里为空数组表示没有条件。
   • 第三个参数是排序字段，这里是id。
   • 第四个参数是需要获取的字段，格式为'id, name'，其中id将作为option的value，name将作为option的显示文本。
3. $mform->addElement('select', 'master_id', get_string('selectcourse'), $options);：将生成的$options数组传递给select元素，创建下拉选择框。

传递选定的值

Multiavatar

Multiavatar是一个免费开源的多元文化头像生成器，可以生成高达120亿个虚拟头像

下载

仅仅创建select元素还不够，如果需要在编辑表单时预先选中某个值，或者在表单提交后重新显示表单时保持选中的值，需要使用set_data方法。

以下是如何使用set_data传递选定值的示例代码：

$formdata = new \stdClass();
$formdata->master_id = 99; // 假设要选中的master_id是99

$mform = new edit_form();
$mform->set_data($formdata);
$mform->display();

这段代码做了以下几件事：

1. $formdata = new \stdClass();：创建一个标准对象，用于存储表单数据。
2. $formdata->master_id = 99;：将master_id设置为要选中的值，这里假设是99。 注意：这个值必须是数据库中实际存在的值。
3. $mform = new edit_form();：创建表单对象。
4. $mform->set_data($formdata);：将数据传递给表单。 set_data方法会将$formdata中的值填充到表单对应的元素中。
5. $mform->display();：显示表单。

注意事项

• 确保get_records_menu函数的第四个参数中，id字段确实是你想作为option的value传递的字段。
• 在使用set_data方法时，确保传递的值在数据库中是存在的，否则可能导致表单显示异常。
• 在使用get_records_menu时，如果表中的数据量很大，可以考虑添加WHERE条件，以减少查询的数据量，提高性能。
• 在实际应用中，$formdata->master_id的值通常是从数据库或者其他地方动态获取的，而不是硬编码的。

总结

通过使用get_records_menu函数，我们可以更方便地从数据库中获取数据并构建select元素。通过使用set_data方法，我们可以将实际的值传递给表单，确保提交的是期望的值。掌握这两个技巧，可以更高效地开发Moodle表单。