Олег Давидович: 1 версия импортирована

2024-10-21T08:59:29Z

1 версия импортирована

← Предыдущая версия	Версия от 08:59, 21 октября 2024
(нет различий)

1>Jamiesensei: /* Make Sure You Name the Header of a Fieldset Within Which You Include Advanced Elements */ - problem with formatting fixed

2007-03-13T05:51:16Z

Make Sure You Name the Header of a Fieldset Within Which You Include Advanced Elements: - problem with formatting fixed

Новая страница

{{Formslib}}
==setAdvanced to specify one form element as an advanced option==
You can use MoodleQuickForm's method setAdvanced to specify a form element as an advanced option :

<code>
$mform->addElement('select', 'display', get_string('displaymode', 'choice'), $CHOICE_DISPLAY);
$mform->setAdvanced('display');
</code>

If you set any element in a form to be an advanced item then ''''show / hide advanced' buttons are shown automatically''' in the form. Show / hide buttons are currently displayed at the top right of all fieldsets containing advanced controls. The show / hide button shows or hides advanced controls using javascript or if no javascript is available then the whole page is submitted and redisplayed with advanced controls hidden or shown.

setAdvanced takes a second boolean parameter which defaults to true. True means set this control as an advanced control. False means it is not advanced.

===Make Sure You Name the Header of a Fieldset Within Which You Include Advanced Elements===

Ie. this is not good :

<code>
$mform->addElement('header', <nowiki>''</nowiki>, get_string('miscellaneoussettings', 'form'));
$mform->addElement('select', 'display', get_string('displaymode', 'choice'), $CHOICE_DISPLAY);
$mform->setAdvanced('display');
</code>

The second param of the addElement('header', ....) should be a unique name for the header.

If you don't then other sections of the form that also have an unnamed header may also get marked as advanced. This will also happen if header elements have identical names.

==setAdvanced to specify all form elements in a fieldset are advanced elements==
<code>
$mform->addElement('header', 'miscellaneoussettingshdr', get_string('miscellaneoussettings', 'form'));
$mform->setAdvanced('miscellaneoussettingshdr');
</code>

Will set the header element miscellaneoussettingshdr and '''all''' the elements it contains to advanced.

===What happens when a form is submitted with form elements hidden?===

If form elements are hidden and the form is submitted then no values are submitted by the form elements. But the 'default values' of the form elements are automatically passed to the processing functions from data_submitted(). Default values are set by setDefault normally called from within definition() function or by set_data which is called to load database contents into the form.

Development:lib/formslib.php setAdvanced - История изменений

Олег Давидович: 1 версия импортирована

1>Jamiesensei: /* Make Sure You Name the Header of a Fieldset Within Which You Include Advanced Elements */ - problem with formatting fixed