View source for Form field/nl

<noinclude><languages /></noinclude>
<onlyinclude>
== Inleiding ==
<div class="mw-translate-fuzzy">
Formuliervelden zijn velden in een HTML <code><form></code>. Joomla! 2.5 {{JVer|2.5}} en nieuwer leveren de JForm class om gemakkelijk en flexibel formulieren te maken met een groot aantal formuliervelden. Elk formulierveld type is een sub-class van JFormField.
</div>

<div class="mw-translate-fuzzy">
Naast een flexibel pagina-aanmaak hulpmiddel te zijn, worden JFormField's door Joomla! gebruikt om [[S:MyLanguage/Administrator (User)|administrators]] de mogelijkheid te geven Joomla! of zijn extensies in te stellen zonder de onderliggende code te wijzigen. In Joomla! 1.5, werd dit afgehandeld door de niet meer te gebruiken [[S:MyLanguage/API15:JParameter|JParameter]] en [[S:MyLanguage/API15:JElement|JElement]] classes.
</div>

<div class="mw-translate-fuzzy">
Om formuliervelden bij het instellen van extensies te definiëren, moet u ze opnemen in een benoemde fieldset, zoals <code><fieldset name="basic"></code>, die staat binnen de <code><fields name="params"></code> sectie van het <code><config></code> element in uw [[S:MyLanguage/Manifest files|XML manifest bestand]].
</div>
</onlyinclude>

<span class="mw-translate-fuzzy">== Formulier validatie ==</span>
{{:Form validation/nl}}
<span class="mw-translate-fuzzy">== Standaard formulierveld types ==</span>
{{:Standard form field types/nl}}
<span class="mw-translate-fuzzy">== Eigen formulierveld type's ==</span>
<div class="mw-translate-fuzzy">
Een [[S:MyLanguage/extension|extensie]] kan zijn eigen formulierveld types definiëren, welke daarna gebruikt kunnen worden in zijn eigen formulieren of in formulieren aangemaakt in een andere extensie. Zie [[S:MyLanguage/Creating a custom form field type|Het maken van een eigen formulierveld type]] voor uitleg.
</div>
<span class="mw-translate-fuzzy">=== Modale formulierveld types ===</span>
<div class="mw-translate-fuzzy">
Als u een veld heeft met veel waarden, die niet in een keuzelijst passen, dan kunt u altijd een modaal formulierveld maken dat de gebruiker de mogelijkheid geeft om een item op een modale pagina te kiezen via een tabel, filter-opties, etc. (net als iedere beheer-tabel, bijvoorbeeld "Artikelen").
</div>
Zie [[S:MyLanguage/Creating a modal form field|Het maken van een modaal formulierveld]]

<span class="mw-translate-fuzzy">== Algemene attributen ==</span>
<span class="mw-translate-fuzzy">=== Labelclass ===</span>
<div class="mw-translate-fuzzy">
Het toevoegen van het attribuut <code>labelclass</code> voegt een CSS class toe aan het label van het formulierveld. Bron:
</div> http://joomlacode.org/gf/project/joomla/tracker/?action=TrackerItemEdit&tracker_item_id=28450

<span class="mw-translate-fuzzy">=== Showon ===</span>
<div class="mw-translate-fuzzy">
Het toevoegen van het attribuut <code>showon</code> geeft de mogelijkheid het veld te verbergen afhankelijk van de waard(en) van een ander veld.
</div>

<div class="mw-translate-fuzzy">
Syntaxis om het veld alleen te tonen <tt>bar</tt> wanneer <tt>foo</tt> op "1" en <tt>baz</tt> op "1" staat:
</div>

<syntaxhighlight lang="php">
<field
    name="foo"
    type="list"
    >
    <option value="1">JYES</option>
    <option value="0">JNO</option>
</field>
<field
    name="bar"
    type="text"
    showon="foo:1"
/></syntaxhighlight>

<div class="mw-translate-fuzzy">
Om aan meerdere waarden te voldoen kan men een door komma's gescheiden lijst met waarden aanbieden. Zoals <code>showon="foo:1,2"</code>
</div>

<div class="mw-translate-fuzzy">
Om meerdere velden te combineren kunt u <code>[AND]</code> gebruiken. Zoals <code>showon="foo:1[AND]bar:1"</code>
</div>

<div class="mw-translate-fuzzy">
Syntaxis om het veld "bar" alleen te tonen wanneer "foo" op "1" en "baz" op "1" is gezet:
</div>

<syntaxhighlight lang="php">
<field
    name="foo"
    type="list"
    >
    <option value="1">JYES</option>
    <option value="0">JNO</option>
</field>
<field
    name="baz"
    type="list"
    >
    <option value="1">JYES</option>
    <option value="0">JNO</option>
</field>
<field
    name="bar"
    type="text"
    showon="foo:1[AND]baz:1"
/></syntaxhighlight>

<div class="mw-translate-fuzzy">
Om een keuze tussen verschillende velden aan te maken, kunt u <tt>[OR]</tt> gebruiken. Zoals <tt>showon="foo:1[OR]bar:1"</tt>.
</div>

<div class="mw-translate-fuzzy">
Syntaxis om het veld "bar" alleen te tonen wanneer "foo" op "1" of "baz" op "1" is gezet:
</div>

<syntaxhighlight lang="php">
<field
    name="foo"
    type="list"
    >
    <option value="1">JYES</option>
    <option value="0">JNO</option>
</field>
<field
    name="baz"
    type="list"
    >
    <option value="1">JYES</option>
    <option value="0">JNO</option>
</field>
<field
    name="bar"
    type="text"
    showon="foo:1[OR]baz:1"
/></syntaxhighlight>

<div class="mw-translate-fuzzy">
U kan ook "waarde niet gelijk aan" gebruiken zoals <tt>showon="field1!:1"</tt>.
</div>

<div class="mw-translate-fuzzy">
Syntaxis om het veld "bar" alleen te tonen wanneer "foo" niet gelijk is aan "1":
</div>

<syntaxhighlight lang="php">
<field
    name="foo"
    type="list"
    >
    <option value="1">JYES</option>
    <option value="0">JNO</option>
</field>
<field
    name="baz"
    type="list"
    showon="foo!:1"
    >
    <option value="1">JYES</option>
    <option value="0">JNO</option>
</field>
</syntaxhighlight>
<div class="mw-translate-fuzzy">
Om een veld te tonen als een ander veld (bijvoorbeeld foo) geselecteerd is (als dat andere veld niet leeg is), u kunt <tt>showon="foo!:"</tt> gebruiken (dus zonder een waarde op te geven).
</div>

<div class="mw-translate-fuzzy">
Dit is ingevoerd via PullRequest: https://github.com/joomla/joomla-cms/pull/3379, beschikbaar vanaf Joomla 3.2.4.
</div>
<div class="mw-translate-fuzzy">
=== Foutopsporing: Attributen werken niet ===
</div>

<div class="mw-translate-fuzzy">
Als je een oudere versie van onze ontwikkelaar documentatie hebt gelezen, of je formuliercode hebt overgenomen van een bestaande extensie, dan kunnen er problemen ontstaan dat attributen zoals <code>showon</code> helemaal niet werken. Om enkele specifieke attributen te laten werken moeten je velden gerenderd worden via de <code>renderField()</code> methode. Bijvoorbeeld:
</div>

<syntaxhighlight lang="php">
<div class="row-fluid">
    <div class="span6">
        <?php
            foreach($this->form->getFieldset() as $field) {
                echo $field->renderField();
            }
        ?>
    </div>
</div>
</syntaxhighlight>

<noinclude>
[[Category:Landing Pages{{#translation:}}]]
[[Category:Form fields{{#translation:}}]]
[[Category:Development{{#translation:}}]]
</noinclude>