User:Frank Ralf/Moodle forms3

Read the whole story:

1. Frank Ralf/Moodle forms1
2. Frank Ralf/Moodle forms2 (aka Frank Ralf/Semantic HTML5)
3. Moodle forms - A peek under the hood

Moodle forms - A peek under the hood

Inspired by this forum discussion on "Question: Can I put a moodleform inside a table td?" I dug a little deeper into the way Moodle creates and handles forms.

We will use some helper styles to see what's going on under the hood of Moodle forms. See Stylish for some of them.

The code

We recreate a form similar to the one in the above mentioned forum discussion. This is just a textarea field with a save button put inside a table, nothing fancy. Note that we define only the absolute minimum of parameters for the form elements.

$mform =& $this->_form;

$table_html = '

' .'' .'

Select student	Comment entered	Comment
Student Alpha	Yes	'; $mform->addElement('html', $table_html); $mform->addElement('textarea'); $this->add_action_buttons(false); $mform->addElement('html', '

');

Screenshots

That's the way the form will look without any special CSS applied. Note that the button text is the default one provided by Moodle.

Let's add some borders to see where the table cells are:

For analyzing the form we add background colors to the individual form elements:

We add some padding and margins to the form elements to better see what's going on:

And to make things even clearer we finally add the names of the form elements using CSS (note that this will not work in every browser):

(Note that only applying background colors won't change the layout of the form, applying borders, margins, paddings and adding content will. Another option is using "outline", but that's not supported by all browsers.)

Discussion

As can be seen from the screenshots Moodle adds quite some markup by default. So let's have a look at the HTML.

The generated HTML

<form action="http://localhost/moodle_cvs/moodle/blocks/formdemo/view.php" method="post" accept-charset="utf-8" id="mform1" class="mform">

   <input name="MAX_FILE_SIZE" type="hidden" value="16777216" />
   <input name="sesskey" type="hidden" value="yArTmwqNJM" />
   <input name="_qf__formdemo_form" type="hidden" value="1" />

Select student	Comment entered	Comment
Student Alpha	Yes	<fieldset class="hidden"> <label for="id_"> </label> <textarea id="id_"></textarea> </fieldset> <fieldset class="hidden"> <label for="id_submitbutton"> </label> <input name="submitbutton" value="Save changes" type="submit" id="id_submitbutton" /> // <--

// This and the following line should have come </fieldset> // before the closing tag </form>

Observations

• There are a lot off additional form elements created by default, often wrapped in additional DIV elements.
• The form elements are wrapped in (hidden) fieldsets.
• The nesting of some HTML elements is not correct.
• The textarea doesn't get a proper ID like the submitbutton.

[TODO]

See also

• Development:lib/formslib.php Form Definition