Joomla! Documentation - User contributions [en]

Subform form field type/fr

2022-03-18T11:33:37Z

Shim-sao:

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

Un exemple de définition de '''champ''' XML pour le mode '''unique''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Exemple XML de ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

Un exemple XML de ''exampleform.xml'' avec des ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

Le sous-formulaire XML peut également être spécifié en ligne au lieu de placer le sous-formulaire XML dans un fichier séparé. L'exemple suivant illustre cela :

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (facultatif) est la valeur par défaut, chaîne JSON.
* '''formsource''' (obligatoire) la source du formulaire à inclure. Un chemin relatif vers le fichier xml (relatif au dossier racine du site Joomla installé) ou un nom de formulaire valide qui peut être trouvé par ''JForm::getInstance()''.
* '''multiple''' (facultatif) si les champs du sous-formulaire sont répétables ou non.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/18/fr

2022-03-18T11:33:36Z

Shim-sao:

* '''multiple''' (facultatif) si les champs du sous-formulaire sont répétables ou non.

Translations:Subform form field type/17/fr

2022-03-18T11:33:28Z

Shim-sao:

* '''formsource''' (obligatoire) la source du formulaire à inclure. Un chemin relatif vers le fichier xml (relatif au dossier racine du site Joomla installé) ou un nom de formulaire valide qui peut être trouvé par ''JForm::getInstance()''.

Subform form field type/fr

2022-03-18T11:33:10Z

Shim-sao:

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

Un exemple de définition de '''champ''' XML pour le mode '''unique''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Exemple XML de ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

Un exemple XML de ''exampleform.xml'' avec des ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

Le sous-formulaire XML peut également être spécifié en ligne au lieu de placer le sous-formulaire XML dans un fichier séparé. L'exemple suivant illustre cela :

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (facultatif) est la valeur par défaut, chaîne JSON.
'''formsource''' (obligatoire) la source du formulaire à inclure. Un chemin relatif vers le fichier xml (relatif au dossier racine du site Joomla installé) ou un nom de formulaire valide qui peut être trouvé par ''JForm::getInstance()''.
'''multiple''' (facultatif) si les champs du sous-formulaire sont répétables ou non.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/18/fr

2022-03-18T11:32:56Z

Shim-sao:

'''multiple''' (facultatif) si les champs du sous-formulaire sont répétables ou non.

Subform form field type/fr

2022-03-18T11:32:41Z

Shim-sao: Created page with "'''multiple''' multiple (facultatif) si les champs du sous-formulaire sont répétables ou non."

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

Un exemple de définition de '''champ''' XML pour le mode '''unique''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Exemple XML de ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

Un exemple XML de ''exampleform.xml'' avec des ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

Le sous-formulaire XML peut également être spécifié en ligne au lieu de placer le sous-formulaire XML dans un fichier séparé. L'exemple suivant illustre cela :

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (facultatif) est la valeur par défaut, chaîne JSON.
'''formsource''' (obligatoire) la source du formulaire à inclure. Un chemin relatif vers le fichier xml (relatif au dossier racine du site Joomla installé) ou un nom de formulaire valide qui peut être trouvé par ''JForm::getInstance()''.
'''multiple''' multiple (facultatif) si les champs du sous-formulaire sont répétables ou non.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/18/fr

2022-03-18T11:32:38Z

Shim-sao: Created page with "'''multiple''' multiple (facultatif) si les champs du sous-formulaire sont répétables ou non."

'''multiple''' multiple (facultatif) si les champs du sous-formulaire sont répétables ou non.

Subform form field type/fr

2022-03-18T11:31:19Z

Shim-sao: Created page with "'''formsource''' (obligatoire) la source du formulaire à inclure. Un chemin relatif vers le fichier xml (relatif au dossier racine du site Joomla installé) ou un nom de form..."

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

Un exemple de définition de '''champ''' XML pour le mode '''unique''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Exemple XML de ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

Un exemple XML de ''exampleform.xml'' avec des ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

Le sous-formulaire XML peut également être spécifié en ligne au lieu de placer le sous-formulaire XML dans un fichier séparé. L'exemple suivant illustre cela :

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (facultatif) est la valeur par défaut, chaîne JSON.
'''formsource''' (obligatoire) la source du formulaire à inclure. Un chemin relatif vers le fichier xml (relatif au dossier racine du site Joomla installé) ou un nom de formulaire valide qui peut être trouvé par ''JForm::getInstance()''.
* '''multiple''' (optional) whether the subform fields are repeatable or not.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/17/fr

2022-03-18T11:31:13Z

'''formsource''' (obligatoire) la source du formulaire à inclure. Un chemin relatif vers le fichier xml (relatif au dossier racine du site Joomla installé) ou un nom de formulaire valide qui peut être trouvé par ''JForm::getInstance()''.

Subform form field type/fr

2022-03-14T16:12:28Z

Shim-sao: Created page with "* '''default''' (facultatif) est la valeur par défaut, chaîne JSON."

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

Un exemple de définition de '''champ''' XML pour le mode '''unique''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Exemple XML de ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

Un exemple XML de ''exampleform.xml'' avec des ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

Le sous-formulaire XML peut également être spécifié en ligne au lieu de placer le sous-formulaire XML dans un fichier séparé. L'exemple suivant illustre cela :

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (facultatif) est la valeur par défaut, chaîne JSON.
* '''formsource''' (mandatory) the form source to be included. A relative path to the xml file (relative to the root folder for the installed Joomla site) or a valid form name which can be found by ''JForm::getInstance()''.
* '''multiple''' (optional) whether the subform fields are repeatable or not.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/16/fr

2022-03-14T16:12:25Z

Shim-sao: Created page with "* '''default''' (facultatif) est la valeur par défaut, chaîne JSON."

* '''default''' (facultatif) est la valeur par défaut, chaîne JSON.

Subform form field type/fr

2022-03-14T16:11:12Z

Shim-sao: Created page with "Le sous-formulaire XML peut également être spécifié en ligne au lieu de placer le sous-formulaire XML dans un fichier séparé. L'exemple suivant illustre cela :"

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

Un exemple de définition de '''champ''' XML pour le mode '''unique''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Exemple XML de ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

Un exemple XML de ''exampleform.xml'' avec des ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

Le sous-formulaire XML peut également être spécifié en ligne au lieu de placer le sous-formulaire XML dans un fichier séparé. L'exemple suivant illustre cela :

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (optional) is the default value, JSON string.
* '''formsource''' (mandatory) the form source to be included. A relative path to the xml file (relative to the root folder for the installed Joomla site) or a valid form name which can be found by ''JForm::getInstance()''.
* '''multiple''' (optional) whether the subform fields are repeatable or not.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/44/fr

2022-03-14T16:11:03Z

Shim-sao: Created page with "Le sous-formulaire XML peut également être spécifié en ligne au lieu de placer le sous-formulaire XML dans un fichier séparé. L'exemple suivant illustre cela :"

Le sous-formulaire XML peut également être spécifié en ligne au lieu de placer le sous-formulaire XML dans un fichier séparé. L'exemple suivant illustre cela :

Subform form field type/fr

2022-03-14T16:10:12Z

Shim-sao:

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

Un exemple de définition de '''champ''' XML pour le mode '''unique''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Exemple XML de ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

Un exemple XML de ''exampleform.xml'' avec des ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

The subform XML may also be specified inline as an alternative to placing the subform XML in a separate file. The following example illustrates this:

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (optional) is the default value, JSON string.
* '''formsource''' (mandatory) the form source to be included. A relative path to the xml file (relative to the root folder for the installed Joomla site) or a valid form name which can be found by ''JForm::getInstance()''.
* '''multiple''' (optional) whether the subform fields are repeatable or not.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/8/fr

2022-03-14T16:10:09Z

Shim-sao:

Un exemple XML de ''exampleform.xml'' avec des ''fieldsets''

Subform form field type/fr

2022-03-14T16:08:04Z

Shim-sao: Created page with "Un exemple XML de ''exampleform.xml'' avec des ''ensembles de champs''"

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

Un exemple de définition de '''champ''' XML pour le mode '''unique''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Exemple XML de ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

Un exemple XML de ''exampleform.xml'' avec des ''ensembles de champs''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

The subform XML may also be specified inline as an alternative to placing the subform XML in a separate file. The following example illustrates this:

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (optional) is the default value, JSON string.
* '''formsource''' (mandatory) the form source to be included. A relative path to the xml file (relative to the root folder for the installed Joomla site) or a valid form name which can be found by ''JForm::getInstance()''.
* '''multiple''' (optional) whether the subform fields are repeatable or not.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/8/fr

2022-03-14T16:07:57Z

Shim-sao: Created page with "Un exemple XML de ''exampleform.xml'' avec des ''ensembles de champs''"

Un exemple XML de ''exampleform.xml'' avec des ''ensembles de champs''

Subform form field type/fr

2022-03-14T16:06:22Z

Shim-sao: Created page with "Exemple XML de ''exampleform.xml''"

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

Un exemple de définition de '''champ''' XML pour le mode '''unique''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Exemple XML de ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

An example XML of ''exampleform.xml'' with ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

The subform XML may also be specified inline as an alternative to placing the subform XML in a separate file. The following example illustrates this:

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (optional) is the default value, JSON string.
* '''formsource''' (mandatory) the form source to be included. A relative path to the xml file (relative to the root folder for the installed Joomla site) or a valid form name which can be found by ''JForm::getInstance()''.
* '''multiple''' (optional) whether the subform fields are repeatable or not.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/7/fr

2022-03-14T16:06:15Z

Shim-sao: Created page with "Exemple XML de ''exampleform.xml''"

Exemple XML de ''exampleform.xml''

Subform form field type/fr

2022-03-14T16:05:12Z

Shim-sao: Created page with "Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :"

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

Un exemple de définition de '''champ''' XML pour le mode '''unique''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Example XML of ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

An example XML of ''exampleform.xml'' with ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

The subform XML may also be specified inline as an alternative to placing the subform XML in a separate file. The following example illustrates this:

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (optional) is the default value, JSON string.
* '''formsource''' (mandatory) the form source to be included. A relative path to the xml file (relative to the root folder for the installed Joomla site) or a valid form name which can be found by ''JForm::getInstance()''.
* '''multiple''' (optional) whether the subform fields are repeatable or not.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/6/fr

2022-03-14T16:04:52Z

Shim-sao: Created page with "Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :"

Un exemple de définition de '''champ''' XML pour le mode '''multiple''' :

Subform form field type/fr

2022-03-14T16:04:22Z

Shim-sao: Created page with "Un exemple de définition de '''champ''' XML pour le mode '''unique''' :"

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

Un exemple de définition de '''champ''' XML pour le mode '''unique''' :

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

An example XML '''field''' definition for '''multiple''' mode:

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Example XML of ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

An example XML of ''exampleform.xml'' with ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

The subform XML may also be specified inline as an alternative to placing the subform XML in a separate file. The following example illustrates this:

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (optional) is the default value, JSON string.
* '''formsource''' (mandatory) the form source to be included. A relative path to the xml file (relative to the root folder for the installed Joomla site) or a valid form name which can be found by ''JForm::getInstance()''.
* '''multiple''' (optional) whether the subform fields are repeatable or not.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/5/fr

2022-03-14T16:04:20Z

Shim-sao: Created page with "Un exemple de définition de '''champ''' XML pour le mode '''unique''' :"

Un exemple de définition de '''champ''' XML pour le mode '''unique''' :

Subform form field type/fr

2022-03-14T16:01:48Z

Shim-sao: Created page with "Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en..."

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

An example XML '''field''' definition for '''single''' mode:

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

An example XML '''field''' definition for '''multiple''' mode:

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Example XML of ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

An example XML of ''exampleform.xml'' with ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

The subform XML may also be specified inline as an alternative to placing the subform XML in a separate file. The following example illustrates this:

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (optional) is the default value, JSON string.
* '''formsource''' (mandatory) the form source to be included. A relative path to the xml file (relative to the root folder for the installed Joomla site) or a valid form name which can be found by ''JForm::getInstance()''.
* '''multiple''' (optional) whether the subform fields are repeatable or not.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/3/fr

2022-03-14T16:01:47Z

Le champ a deux mises en page "prédéfinies" pour afficher le sous-formulaire sous forme de '''tableau''' ou de conteneur '''div''', ainsi que la prise en charge des mises en page personnalisées.

Subform form field type/fr

2022-03-14T15:59:30Z

Shim-sao: Created page with "Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''."

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

The Field has two "predefined" layouts for displaying the subform as either a '''table''' or as a '''div''' container, as well as support for custom layouts.

An example XML '''field''' definition for '''single''' mode:

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

An example XML '''field''' definition for '''multiple''' mode:

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Example XML of ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

An example XML of ''exampleform.xml'' with ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

The subform XML may also be specified inline as an alternative to placing the subform XML in a separate file. The following example illustrates this:

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (optional) is the default value, JSON string.
* '''formsource''' (mandatory) the form source to be included. A relative path to the xml file (relative to the root folder for the installed Joomla site) or a valid form name which can be found by ''JForm::getInstance()''.
* '''multiple''' (optional) whether the subform fields are repeatable or not.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/2/fr

2022-03-14T15:59:25Z

Shim-sao: Created page with "Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''."

Si l'attribut multiple est défini sur '''true''', le formulaire inclus sera '''répétable'''.

Subform form field type/fr

2022-03-14T15:58:19Z

Shim-sao: Created page with "Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un f..."

<noinclude><languages /></noinclude>
Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.
If attribute '''multiple''' is set to '''true''' then the included form will be '''repeatable'''.

The Field has two "predefined" layouts for displaying the subform as either a '''table''' or as a '''div''' container, as well as support for custom layouts.

An example XML '''field''' definition for '''single''' mode:

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml"
label="Subform Field" description="Subform Field Description" /></source>

An example XML '''field''' definition for '''multiple''' mode:

<source lang="xml"><field name="field-name" type="subform"
formsource="path/to/exampleform.xml" multiple="true"
label="Subform Field" description="Subform Field Description" /></source>

Example XML of ''exampleform.xml''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</form></source>

An example XML of ''exampleform.xml'' with ''fieldsets''

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<form>
<fieldset name="section1" label="Section1">
<field name="example_text" type="text" label="Example Text" />
<field name="example_textarea" type="textarea" label="Example Textarea" cols="40" rows="8" />
</fieldset>
<fieldset name="section2" label="Section2">
<field name="example_list" type="list" default="1" class="advancedSelect" label="Example List">
<option value="1">JYES</option>
<option value="0">JNO</option>
</field>
</fieldset>
</form></source>

The subform XML may also be specified inline as an alternative to placing the subform XML in a separate file. The following example illustrates this:

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<field
name="field-name"
type="subform"
label="Subform Field"
description="Subform Field Description"
multiple="true"
min="1"
max="10"
>
<form>
<field
name="example_text"
type="text"
label="Example Text"
/>
<field
name="example_textarea"
type="textarea"
label="Example Textarea"
cols="40"
rows="8"
/>
</form>
</field></source>

Attributs de champ :
* '''type''' (obligatoire) doit être "subform".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''required''' (requis) (facultatif) le champ doit être complété avant la soumission du formulaire.
* '''message''' (facultatif) le message d'erreur qui sera affiché à la place du message par défaut.
* '''default''' (optional) is the default value, JSON string.
* '''formsource''' (mandatory) the form source to be included. A relative path to the xml file (relative to the root folder for the installed Joomla site) or a valid form name which can be found by ''JForm::getInstance()''.
* '''multiple''' (optional) whether the subform fields are repeatable or not.
* '''min''' (optional) count of minimum repeating in multiple mode. Default: ''0''.
* '''max''' (optional) count of maximum repeating in multiple mode. Default: ''1000''.
* '''groupByFieldset''' (optional) whether to group the subform fields by its fieldset (''true'' or ''false''). Default: ''false''.
* '''buttons''' (optional) which buttons to show in multiple mode. Default: ''add,remove,move''.
* '''layout''' (optional) the name of the layout to use when displaying '''subform''' fields.
* '''validate''' (optional) should be set to ''SubForm'' (note that this is case-sensitive!) to ensure that fields in the subform are individually validated. Default: Fields in the subform are not validated, even if validation rules are specified.

Mises en page disponibles :
* '''joomla.form.field.subform.default''' render the subform in a div container, without support of repeating. Default for single mode.
* '''joomla.form.field.subform.repeatable''' render the subform in a div container, used for multiple mode. Support groupByFieldset.
* '''joomla.form.field.subform.repeatable-table''' render the subform as a table, used for multiple mode. Supports groupByFieldset. By default each field is rendered as a table column, but if ''groupByFieldset=true'' then each fieldset is rendered as a table column.

'''Attention'''

If your field in the subform has additional JavaScript logic then it may not work in '''multiple''' mode, because do not see the fields which added by the subform field dynamically. If it happened then you need to adjust your field to support it.
L'exemple suivant devrait pouvoir vous aider :

<source lang="javascript">jQuery(document).ready(function(){
... here the code for setup your field as usual...

jQuery(document).on('subform-row-add', function(event, row){
... here is the code to set up the fields in the new row ...
})
});
</source>

Because of this some extra Joomla! fields may not work for now.

==Fields Validation and Filters==
The subform form field does not provide the Validation and Filters for child fields.

Addition: Since a security fix in Joomla 3.9.7 the <code>filter="example"</code> attributes in subform child fields are supported and the fields will be validated; '''but NOT''' in custom form fields that extend the <code>JFormFieldSubform</code> class. You have to adapt such custom fields yourself!
===Beware!===
'''All extensions that use subform fields MUST add an attribute <code>filter</code> to their subform child fields of type <code>editor</code>, <code>textarea</code>, <code>text</code> (maybe others, too) since Joomla 3.9.7 like it's common for "normal" JForm fields, if you want to allow HTML input. Otherwise the validation falls back to STRING, which is the common behavior for "normal" JForm fields.'''
Examples:
<source lang="xml">
filter="safehtml"
filter="JComponentHelper::filterText"
filter="raw" (bad decision in most cases)
</source>

==Exemple==

'''Problème '''

After adding new rows selects are not "chosen".

'''Solution '''

Here is an example how to reinit jQuery Chosen on newly added repeated rows:

<source lang="javascript">jQuery(document).ready(function(){
jQuery(document).on('subform-row-add', function(event, row){
jQuery(row).find('select').chosen();
})
});
</source>

Or a PHP snippet to be used in e.g. your plugin in **onBeforeCompileHead** method or in your component view.

<source lang="php">
$doc = JFactory::getDocument();
$js = '
jQuery(document).on(\'subform-row-add\', function(event, row){
jQuery(row).find(\'select\').chosen();
})
';
$doc->addScriptDeclaration($js);
</source>

So newly added rows now are "chosen" now

'''Problem'''

Subform data not getting stored to database on custom component.

'''Solution'''

Add the following line to the beginning of your corresponding table class:

<source lang="php">
protected $_jsonEncode = array('fieldnamehere');
</source>

More information [https://joomla.stackexchange.com/questions/19163/subform-multiple-data-not-saving Here].

==Voir également==
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types{{#translation:}}]]
</noinclude>

Translations:Subform form field type/1/fr

2022-03-14T15:58:17Z

Le type de champ de formulaire de '''sous-formulaire''' fournit une méthode pour utiliser des formulaires XML les uns dans les autres ou réutiliser des formulaires dans un formulaire existant.

Standard form field types/fr

2022-03-11T15:01:11Z

Shim-sao:

<noinclude><languages /></noinclude>
De nombreux types de [[S:MyLanguage/form field|champs de formulaires]] sont disponibles dans Joomla. Le tableau ci-dessous dresse la liste de ces types standards ainsi que leur disponibilité. Veuillez utiliser la [[S:MyLanguage/Standard_form_field_types/Single-page_reference|page de références]] si vous souhaitez imprimer la documentation sur l'ensemble des champs de formulaires existants.

Pour les versions {{JVer|1.5}}. Veuillez noter que plusieurs de ces champs sont disponibles en tant que [[S:MyLanguage/Parameter|types de paramètres]] pour Joomla! 1.5. Pour une liste des types de paramètres, veuillez consulter [[S:MyLanguage/J1.5:Standard parameter types|les types de paramètres standards pour Joomla! 1.5]]. Pour une comparaison entre les champs et les types de paramètres, veuillez consulter [[S:MyLanguage/Standard form field and parameter types|les champs de formulaires standards et les types de paramètres]].
{| class="wikitable" style="vertical-align:top; border:1px solid Sienna; background-color:Cornsilk;"
|- style="background-color:Wheat; font-weight:bold; text-align: left;"
!width=15%|Type
!width=65%|Description
!width=20%|Disponibilité

|-
|[[S:MyLanguage/Accessiblemedia form field type|accessiblemedia]]
|fournit un accès modal au gestionnaire de médias pour l'insertion d'images avec téléchargement pour les utilisateurs disposant des autorisations appropriées et un champ de texte pour ajouter un texte alternatif.
|{{JVer|4.0}} et suivant

|-
|[[S:MyLanguage/Accesslevel form field type|accesslevel]]
|fournit une liste déroulante de visualisation des niveaux d'accès.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Cachehandler form field type|cachehandler]]
|fournit une liste d'options de mise en cache disponibles.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Calendar form field type|calendar]]
|fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte fournit un lien vers un calendrier en fenêtre modale, qui peut également être utilisé pour entrer la valeur de la date.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Captcha form field type|captcha]]
|Permet l'utilisation d'un plugin captcha.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Category form field type|category]]
|fournit une liste déroulante des catégories pour une extension.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Checkbox form field type|checkbox]]
|fournit une case simple à cocher ou décocher.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Checkboxes form field type|checkboxes]]
|fournit un nombre illimité de cases à cocher qui peuvent être utilisées pour les multi-sélections.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ChromeStyle form field type|Chrome Style]]
|fournit une liste des templates avec options de style chrome regroupés par templates.
|{{JVer|3.0}} et suivant
|-
|[[S:MyLanguage/Color form field type|color]]
|fournit un sélecteur de couleur en cliquant dans la zone de saisie.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ContentLanguage form field type|Content Language]]
|fournit une liste des langues de contenu.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Contenttype form field type|Content Type]]
|fournit une liste des types de contenu.
|{{JVer|3.1}} et suivant
|-
|[[S:MyLanguage/Combo form field type|combo]]
|fournit une un ensemble de champs cases.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Componentlayout form field type|componentlayout]]
|fournit une liste regroupant des templates et d'affichages natifs alternatifs pour un élément de composant.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Contentlanguage form field type|contentlanguage]]
|fournit une liste de langues de contenu installées pour une utilisation avec le plugin de sélection des langues.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/DatabaseConnection form field type|Database Connection]]
|fournit une liste de connexions à la base de données disponible, éventuellement en limitant à une liste donnée.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Editor form field type|editor]]
|fournit un champ de zone de texte pour l'éditeur.
|{{JVer|1.6}} et suivant
|-
|[[S:MyLanguage/Editors form field type|editors]]
|fournit une liste déroulante des éditeurs WYSIWYG disponibles. Depuis la version {{JVer|2.5}}, il convient d'utiliser à la place les [[S:MyLanguage/Plugins form field type|plugins de types de champs de formulaire]].
|{{JVer|1.6}}
|-
|[[S:MyLanguage/Email form field type|email]]
|fournit un champ de courriel.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/File form field type|file]]
|fournit un champ de saisie pour les fichiers.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Filelist form field type|filelist]]
|fournit une liste déroulante de fichiers d'un répertoire spécifié.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Folderlist form field type|folderlist]]
|fournit une liste déroulante des dossiers d'un répertoire spécifié.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Groupedlist form field type|groupedlist]]
|fournit une liste déroulante d'éléments organisés en groupes.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/HeaderTag form field type|header tag]]
|fournit une liste déroulante des balises de titre (h1-h6).
|{{JVer|3.0}} et suivant
|-
|[[S:MyLanguage/Helpsite form field type|helpsite]]
|fournit une liste déroulante des sites d'aide pour votre installation Joomla.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Hidden form field type|hidden]]
|fournit un champ caché pour l'enregistrement d'un champ de formulaire dont la valeur ne peut pas être modifiée directement par un utilisateur dans l'administration (elle peut être modifiée dans le code ou par modification du fichier "params.ini").
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Imagelist form field type|imagelist]]
|fournit une liste déroulante de fichiers image d'un répertoire spécifié.
|{{JVer|2.5}} et suivant
|-
|-
|[[S:MyLanguage/Integer form field type|integer]]
|fournit une liste déroulante d'entiers compris entre un minimum et un maximum.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Language form field type|language]]
|fournit une liste déroulante des langues installées pour le frontend ou le backend.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/List form field type|list]]
|fournit une liste déroulante d'entrées personnalisées.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Media form field type|media]]
|fournit un accès en modal au gestionnaire de médias pour l'insertion d'images avec chargement par les utilisateurs disposant des autorisations appropriées.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Menu form field type|menu]]
|fournit une liste déroulante des menus disponibles à partir de votre site Joomla.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Menuitem form field type|Menu Item]]
|fournit une liste déroulante des éléments de menu disponibles à partir de votre site Joomla.
|{{JVer|2.5}} et suivant
|-
|[[Meter form field type|meter]]
|fournit un compteur pour afficher la valeur dans une plage.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Modulelayout form field type|Module Layout]]
|fournit une liste d'affichages alternatifs pour un groupe de modules natifs et de templates.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ModuleOrder form field type|Module Order]]
|fournit une liste déroulante pour définir les modules d'une position donnée.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ModulePosition form field type|Module Position]]
|fournit une zone de texte pour définir la position d'un module.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ModuleTag form field type|Module Tag]]
|fournit une liste des éléments HTML5 (utilisé pour l'intégration de module dans une fenêtre).
|{{JVer|3.0}} et suivant
|-
|[[S:MyLanguage/Note form field type|note]]
|fournit un champ texte d'une ligne.
|{{JVer|3.1}} et suivant
|-
|[[S:MyLanguage/Number form field type|number]]
|fournit une zone de texte d'une ligne avec un champ déroulant de chiffres pour définir le champ.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Password form field type|password]]
|fournit une zone de texte pour la saisie d'un mot de passe. Les caractères du mot de passe seront masqués lors de la saisie.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Plugins form field type|plugins]]
|fournit une liste de plugins à partir d'un dossier donné.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Predefined List form field type|predefinedlist]]
|Champ de formulaire pour charger une liste de valeurs prédéfinies.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Radio form field type|radio]]
|fournit des boutons radio pour sélectionner différentes options.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Range form field type|range]]
|fournit une barre de défilement horizontale pour spécifier une valeur dans une plage donnée.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Repeatable form field type|repeatable]]
|autorise les champs de formulaire proposant autant d'options que souhaitées par l'utilisateur.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Rules form field type|rules]]
|fournit une matrice de groupe par options d'action pour la gestion des contrôles d'accès. L'affichage dépend du contexte.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Sessionhandler form field type|sessionhandler]]
|fournit une liste déroulante de gestionnaire des options de session.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Spacer form field type|spacer]]
|fournit un séparateur visible entre les champs de formulaire. Ceci est simplement une aide visuelle et aucune valeur n'est enregistrée.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/SQL form field type|sql]]
|fournit une liste déroulante des entrées obtenues par l'exécution d'une requête dans la base de données Joomla. La première colonne de résultats retournée par la requête fournit les valeurs de la liste déroulante.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/subform form field type|subform]]
|Permet l'utilisation des formulaires XML à l’intérieur les uns des autres ou de réutiliser vos formulaires existants à l’intérieur de vos propres formulaires.
|{{JVer|3.6}} et suivant
|-
|[[S:MyLanguage/Tag form field type|tag]]
|fournit un point d'entrée pour les balises (AJAX ou imbriquées).
|{{JVer|3.1}} et suivant
|-
|[[S:MyLanguage/Tel form field type|tel]]
|fournit un champ de saisie pour numéro de téléphone.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Templatestyle form field type|templatestyle]]
|fournit une liste déroulante des styles de templates.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Text form field type|text]]
|fournit une zone de texte pour la saisie des données.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Textarea form field type|textarea]]
|fournit une zone de texte pour la saisie de texte en multi-ligne.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Timezone form field type|timezone]]
|fournit une liste déroulante des fuseaux horaires.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/URL form field type|URL]]
|fournit un champ de saisie d'URL.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/User form field type|user]]
|Champ pour sélectionner un utilisateur à partir d'une liste modale. Affiche le nom d'utilisateur et stocke l'ID d'utilisateur.
|{{JVer|1.6}} et suivant
|-
|[[S:MyLanguage/UserActive form field type|useractive]]
|fournit une liste des utilisateurs actifs.
|{{JVer|3.2}} et suivant
|
|-
|[[S:MyLanguage/Usergroup form field type|usergroup]]
|fournit une liste déroulante des groupes d'utilisateurs. Depuis la version {{JVer|3.2}}, il convient d'utiliser à la place '[[S:MyLanguage/User Group List form field type|usergrouplist]]'.
|{{JVer|2.5}} et suivant
|
|-
|[[S:MyLanguage/User Group List form field type|usergrouplist]]
|fournit une liste déroulante des groupes d'utilisateurs. Remplace le type de champ de formulaire 'usergroup'.
|{{JVer|3.2}} et suivant
|
|-
|[[S:MyLanguage/User State form field type|userstate]]
|Champ pour charger une liste des statuts utilisateurs disponibles.
|{{JVer|3.2}} et suivant
|}

<noinclude>
[[Category:Form fields/fr|Champs de formulaires]]
[[Category:Development Reference/fr|Références pour le développement]]
</noinclude>

Filelist form field type/fr

2022-03-09T11:01:31Z

Shim-sao:

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''filelist''' fournit une liste déroulante de fichiers d'un dossier spécifique. Si le champ a une valeur enregistrée, cette option est sélectionnée lors du premier chargement de la page. Sinon, la valeur par défaut (le cas échéant) est sélectionnée.
[[Image:Params.filelist.jpg|right]]
Par défaut, le premier élément de la liste est '- Ne pas utiliser -' (traduisible) et a pour valeur '-1' et suivi par '- Utiliser par défaut -' (traduisible) avec pour valeur '0'.

* '''type''' (obligatoire) doit être "filelist".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''directory''' (répertoire) (facultatif) est le chemin du fichier système d'accès au répertoire contenant les fichiers devant être listés. Si omis, le répertoire donné par JPATH_ROOT sera utilisé.
* '''default''' (par défaut) (facultatif) est le nom de fichier par défaut.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la liste déroulante.
* '''filter''' ({{JVer | 3.x }}) or '''fileFilter''' ({{JVer | 4.0 }} et suivant) (facultatif) est une expression régulière qui est utilisé pour filtrer la liste des fichiers sélectionnés pour inclusion dans la liste déroulante. Si ce paramètre est omis, tous les fichiers du répertoire sont inclus. L'argument du filtre est appliquée avant l'argument d'exclusion. Pour plus d'informations sur la construction des expressions régulières, veuillez consulter : [[S:MyLanguage/Regular expressions in parameter arguments|Les expressions régulières dans les arguments]].
* '''exclude''' (facultatif) est une expression régulière qui est utilisée pour exclure des fichiers de la liste. L'argument 'exclude' est appliqué après l'argument 'filter'. Pour plus d'informations sur la construction des expressions régulières, veuillez consulter : [[S:MyLanguage/Regular expressions in parameter arguments|Les expressions régulières dans les arguments]].
* '''stripext''' (facultatif) est un argument booléen. Si la valeur est 'true', alors les extensions des noms de fichiers seront supprimés de la liste des noms de fichiers. Notez également que le nom de fichier sera enregistré également sans l'extension.
* '''hide_none''' (facultatif) est un argument booléen. Si la valeur est 'true', l'élément '- None Selected -' est exclu de la liste déroulante.
* '''hide_default''' (facultatif) est un argument booléen. Si la valeur est 'true', l'élément '- Use default -' est exclu de la liste déroulante.

Exemple de définition de champ XML :

<source lang="xml"><field name="myfile" type="filelist" default="" label="Select a file" description="" directory="administrator" filter="" exclude="" stripext="" /></source>

===Voir également===
* [[S:MyLanguage/Folderlist form field type|Type de champ de formulaire folderlist]]
* [[S:MyLanguage/Imagelist form field type|Type de champ de formulaire imagelist]]
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaire standards]]

<noinclude>[[Category:Standard form field types/fr|Types de champ de formulaire standard]]</noinclude>

Translations:Filelist form field type/9/fr

2022-03-09T10:58:59Z

Shim-sao:

* '''filter''' ({{JVer | 3.x }}) or '''fileFilter''' ({{JVer | 4.0 }} et suivant) (facultatif) est une expression régulière qui est utilisé pour filtrer la liste des fichiers sélectionnés pour inclusion dans la liste déroulante. Si ce paramètre est omis, tous les fichiers du répertoire sont inclus. L'argument du filtre est appliquée avant l'argument d'exclusion. Pour plus d'informations sur la construction des expressions régulières, veuillez consulter : [[S:MyLanguage/Regular expressions in parameter arguments|Les expressions régulières dans les arguments]].

Standard Module Chromes/fr

2022-03-05T11:42:05Z

Shim-sao:

<noinclude><languages /></noinclude>
Notez que cet exemple comprend des ajouts de classes puisque les exemples sont le résultat de l'utilisation de mod_mainmenu. Le suffixe "_menu" de la classe div ainsi que la classe "menu" de la balise ul ne sont pas présents avec d'autres modules.

{| style="width:100%" class="wikitable"
|+ '''Comparaison des modules Joomla! Chromes standards'''
Ceci est identique de la série Joomla! 1.5 à la série 3.x.
!width="100" | Style
!Sortie
!width="210" | Apparence
|-
!rounded (arrondi)<br />
|<source lang="html4strict">
<div class="module_menu">
<div>
<div>
<div>
<h3>Main Menu</h3>
<ul class="menu">
<li></li>
</ul>
</div>
</div>
</div>
</div>
</source>
|[[Image:Module_chrome_rounded.png]]
|-
!none (aucun)
|<source lang="html4strict">
<ul class="menu">
<li></li>
</ul>
</source>
|
[[Image:Module_chrome_none.png]]
|-
!table (tableau)
|<source lang="html4strict">
<table cellpadding="0" cellspacing="0" class="moduletable_menu">
<tr>
<th valign="top">Main Menu</th>
</tr>
<tr>
<td>
<ul class="menu">
<li></li>
</ul>
</td>
</tr>
</table>
</source>
|[[Image:Module_chrome_table.png]]
|-
!horz
|<source lang="html4strict">
<table cellspacing="1" cellpadding="0" border="0" width="100%">
<tr>
<td valign="top">
<table cellpadding="0" cellspacing="0" class="moduletable_menu">
<tr>
<th valign="top">Main Menu</th>
</tr>
<tr>
<td>
<ul class="menu">
<li></li>
</ul>
</td>
</tr>
</table>
</td>
</tr>
</table>
</source>
|[[Image:Module_chrome_horz.png]]
|-
!xhtml
|<source lang="html4strict">
<div class="moduletable_menu">
<h3>Main Menu</h3>
<ul class="menu">
<li></li>
</ul>
</div>
</source>
|[[Image:Module_chrome_xhtml.png]]
|-
!html5
|
<source lang="html4strict">
<div class="well _menu">
<h3 class="page-header">Main Menu</h3>
<ul class="nav menu">
<li></li>
</ul>
</div>
</source>
|[[Image:Module_chrome_html5.png]]
|-
!outline
|<source lang="html4strict">
<div class="mod-preview">
<div class="mod-preview-info">left[outline]</div>
<div class="mod-preview-wrapper">
<ul class="menu">
<li></li>
</ul>
</div>
</div>
</source>
| [[Image:Module_chrome_outline.png]]
|-
|}

Notez que le module chrome ne va pas nécessairement changer de façon substantielle l'apparence du module. Cela dépend principalment des CSS utilisé par le template. Par exemple, les <tt>none</tt> et <tt>horz</tt> sont très similaires, bien que le code HTML soit très différent.

Autres remarques : le <tt>horiz</tt> est juste la mise en page d'une <tt>table</tt> incorporée dans une <tt>table</tt>, <tt>tr</tt> et <tt>td</tt>.

Depuis Joomla! 3 : Le logiciel va contrôler ceci dans le fichier <tt>/templates/system/html/modules.php</tt>.

'''Changes since Joomla! 4'''
* The standard chromes <tt>horz</tt>, <tt>rounded</tt> and <tt>xhtml</tt> have been removed from core.
* The core module chromes are controlled by <tt>JLayout</tt> files in directory <tt>/layouts/chromes/</tt>.

<noinclude>
[[Category:Advanced/fr|Chrome]]
[[Category:Module Development/fr|Développement de Modules]]
[[Category:Template Development/fr|Développement de Templates]]
[[Category:CSS/fr|CSS]]
</noinclude>

Translations:Standard Module Chromes/14/fr

2022-03-05T11:42:04Z

Shim-sao:

Depuis Joomla! 3 : Le logiciel va contrôler ceci dans le fichier

Standard Module Chromes/fr

2022-03-05T11:40:36Z

Shim-sao:

<noinclude><languages /></noinclude>
Notez que cet exemple comprend des ajouts de classes puisque les exemples sont le résultat de l'utilisation de mod_mainmenu. Le suffixe "_menu" de la classe div ainsi que la classe "menu" de la balise ul ne sont pas présents avec d'autres modules.

{| style="width:100%" class="wikitable"
|+ '''Comparaison des modules Joomla! Chromes standards'''
Ceci est identique de la série Joomla! 1.5 à la série 3.x.
!width="100" | Style
!Sortie
!width="210" | Apparence
|-
!rounded (arrondi)<br />
|<source lang="html4strict">
<div class="module_menu">
<div>
<div>
<div>
<h3>Main Menu</h3>
<ul class="menu">
<li></li>
</ul>
</div>
</div>
</div>
</div>
</source>
|[[Image:Module_chrome_rounded.png]]
|-
!none (aucun)
|<source lang="html4strict">
<ul class="menu">
<li></li>
</ul>
</source>
|
[[Image:Module_chrome_none.png]]
|-
!table (tableau)
|<source lang="html4strict">
<table cellpadding="0" cellspacing="0" class="moduletable_menu">
<tr>
<th valign="top">Main Menu</th>
</tr>
<tr>
<td>
<ul class="menu">
<li></li>
</ul>
</td>
</tr>
</table>
</source>
|[[Image:Module_chrome_table.png]]
|-
!horz
|<source lang="html4strict">
<table cellspacing="1" cellpadding="0" border="0" width="100%">
<tr>
<td valign="top">
<table cellpadding="0" cellspacing="0" class="moduletable_menu">
<tr>
<th valign="top">Main Menu</th>
</tr>
<tr>
<td>
<ul class="menu">
<li></li>
</ul>
</td>
</tr>
</table>
</td>
</tr>
</table>
</source>
|[[Image:Module_chrome_horz.png]]
|-
!xhtml
|<source lang="html4strict">
<div class="moduletable_menu">
<h3>Main Menu</h3>
<ul class="menu">
<li></li>
</ul>
</div>
</source>
|[[Image:Module_chrome_xhtml.png]]
|-
!html5
|
<source lang="html4strict">
<div class="well _menu">
<h3 class="page-header">Main Menu</h3>
<ul class="nav menu">
<li></li>
</ul>
</div>
</source>
|[[Image:Module_chrome_html5.png]]
|-
!outline
|<source lang="html4strict">
<div class="mod-preview">
<div class="mod-preview-info">left[outline]</div>
<div class="mod-preview-wrapper">
<ul class="menu">
<li></li>
</ul>
</div>
</div>
</source>
| [[Image:Module_chrome_outline.png]]
|-
|}

Notez que le module chrome ne va pas nécessairement changer de façon substantielle l'apparence du module. Cela dépend principalment des CSS utilisé par le template. Par exemple, les <tt>none</tt> et <tt>horz</tt> sont très similaires, bien que le code HTML soit très différent.

Autres remarques : le <tt>horiz</tt> est juste la mise en page d'une <tt>table</tt> incorporée dans une <tt>table</tt>, <tt>tr</tt> et <tt>td</tt>.

<div class="mw-translate-fuzzy">
Le logiciel va contrôler ceci dans le fichier
</div> <tt>/templates/system/html/modules.php</tt>.

'''Changes since Joomla! 4'''
* The standard chromes <tt>horz</tt>, <tt>rounded</tt> and <tt>xhtml</tt> have been removed from core.
* The core module chromes are controlled by <tt>JLayout</tt> files in directory <tt>/layouts/chromes/</tt>.

<noinclude>
[[Category:Advanced/fr|Chrome]]
[[Category:Module Development/fr|Développement de Modules]]
[[Category:Template Development/fr|Développement de Templates]]
[[Category:CSS/fr|CSS]]
</noinclude>

Standard Module Chromes/fr

2022-03-05T11:39:02Z

Shim-sao:

<noinclude><languages /></noinclude>
Notez que cet exemple comprend des ajouts de classes puisque les exemples sont le résultat de l'utilisation de mod_mainmenu. Le suffixe "_menu" de la classe div ainsi que la classe "menu" de la balise ul ne sont pas présents avec d'autres modules.

{| style="width:100%" class="wikitable"
|+ '''Comparaison des modules Joomla! Chromes standards'''
Ceci est identique de la série Joomla! 1.5 à la série 3.x.
!width="100" | Style
!Sortie
!width="210" | Apparence
|-
!rounded (arrondi)<br />
|<source lang="html4strict">
<div class="module_menu">
<div>
<div>
<div>
<h3>Main Menu</h3>
<ul class="menu">
<li></li>
</ul>
</div>
</div>
</div>
</div>
</source>
|[[Image:Module_chrome_rounded.png]]
|-
!none (aucun)
|<source lang="html4strict">
<ul class="menu">
<li></li>
</ul>
</source>
|
[[Image:Module_chrome_none.png]]
|-
!table (tableau)
|<source lang="html4strict">
<table cellpadding="0" cellspacing="0" class="moduletable_menu">
<tr>
<th valign="top">Main Menu</th>
</tr>
<tr>
<td>
<ul class="menu">
<li></li>
</ul>
</td>
</tr>
</table>
</source>
|[[Image:Module_chrome_table.png]]
|-
!horz
|<source lang="html4strict">
<table cellspacing="1" cellpadding="0" border="0" width="100%">
<tr>
<td valign="top">
<table cellpadding="0" cellspacing="0" class="moduletable_menu">
<tr>
<th valign="top">Main Menu</th>
</tr>
<tr>
<td>
<ul class="menu">
<li></li>
</ul>
</td>
</tr>
</table>
</td>
</tr>
</table>
</source>
|[[Image:Module_chrome_horz.png]]
|-
!xhtml
|<source lang="html4strict">
<div class="moduletable_menu">
<h3>Main Menu</h3>
<ul class="menu">
<li></li>
</ul>
</div>
</source>
|[[Image:Module_chrome_xhtml.png]]
|-
!html5
|
<source lang="html4strict">
<div class="well _menu">
<h3 class="page-header">Main Menu</h3>
<ul class="nav menu">
<li></li>
</ul>
</div>
</source>
|[[Image:Module_chrome_html5.png]]
|-
!outline
|<source lang="html4strict">
<div class="mod-preview">
<div class="mod-preview-info">left[outline]</div>
<div class="mod-preview-wrapper">
<ul class="menu">
<li></li>
</ul>
</div>
</div>
</source>
| [[Image:Module_chrome_outline.png]]
|-
|}

Notez que le module chrome ne va pas nécessairement changer de façon substantielle l'apparence du module. Cela dépend principalment des CSS utilisé par le template. Par exemple, les <tt>none</tt> et <tt>horz</tt> sont très similaires, bien que le code HTML soit très différent.

<div class="mw-translate-fuzzy">
Autres remarques : le <tt>horiz</tt> est juste la mise en page d'une <tt>table</tt> incorporée dans une <tt>table</tt>, <tt>tr</tt> et <tt>td</tt>.
</div>

<div class="mw-translate-fuzzy">
Le logiciel va contrôler ceci dans le fichier
</div> <tt>/templates/system/html/modules.php</tt>.

'''Changes since Joomla! 4'''
* The standard chromes <tt>horz</tt>, <tt>rounded</tt> and <tt>xhtml</tt> have been removed from core.
* The core module chromes are controlled by <tt>JLayout</tt> files in directory <tt>/layouts/chromes/</tt>.

<noinclude>
[[Category:Advanced/fr|Chrome]]
[[Category:Module Development/fr|Développement de Modules]]
[[Category:Template Development/fr|Développement de Templates]]
[[Category:CSS/fr|CSS]]
</noinclude>

Form field/fr

2022-02-22T13:02:19Z

Shim-sao: Created page with "Si vous avez lu une ancienne version de notre documentation pour les développeurs ou pris le code d'affichage de votre formulaire à partir d'une extension existante, vous re..."

<noinclude><languages /></noinclude>
<onlyinclude>
==Introduction==
Les champs de formulaire sont des champs contenus dans des balises HTML <code><form></code>. La version Joomla! {{JVer|2.5}} et les plus récentes, proposent une classe JForm permettant de créer facilement et avec beaucoup de flexibilité des formulaires avec un très nombreux choix de types de champs. Chaque type de champ de formulaire est une sous-classe de JFormField.

En plus d'être un outil à la création de page flexible, JFormFields sont également utilisés par Joomla! pour permettre aux [[S:MyLanguage/Administrator (User)|administrateurs]] de configurer Joomla! ou ses extensions sans avoir à changer le code sous-jacent. Avec Joomla! 1.5, cela était réalisé via les classes désormais obsolètes [[S:MyLanguage/API15:JParameter|JParameter]] et [[S:MyLanguage/API15:JElement|JElement]].

Pour définir les champs de formulaire dans la configuration d'une extension, vous devez les inclure dans un "fieldset" tel que <code><fieldset name="basic"></code>, placé à l'intérieur de <code><fields name="params"></code> de la section élément <code><config></code> dans votre [[S:MyLanguage/Manifest files|fichier manifest XML]].
</onlyinclude>

== Validation de formulaires ==
{{:Form validation/fr}}
==Types de champs pour formulaires standards==
{{:Standard form field types/fr}}
== Types de champs de formulaires personnalisés ==
Une [[S:MyLanguage/extension|extension]] peut définir ses propres types de champ, qui peuvent ensuite être utilisés dans ses propres formulaires ou ceux créés par d'autres extensions. Pour plus d'informations, veuillez consulter : [[S:MyLanguage/Creating a custom form field type|Création d'un type de champ de formulaire personnalisé]].
==Types de champs pour formulaires modales==
Si vous avez un champ avec de nombreuses valeurs qui ne conviennent pas pour une zone de sélection, vous pouvez toujours utiliser un type de champ de formulaire modal qui permettra à l'utilisateur de sélectionner un élément à partir d'une fenêtre modale avec un tableau, des options de filtres, etc. (comme pour les fenêtres dans l'administration comme par exemple pour les "articles").
Veuillez consulter [[S:MyLanguage/Creating a modal form field|Création de formulaires modales]]

== Attributs communs ==
=== Labelclass ===
L'ajout de l'attribut <code>labelclass</code> permet d'ajouter une classe CSS pour les étiquettes des champs de formulaires. Source : http://joomlacode.org/gf/project/joomla/tracker/?action=TrackerItemEdit&tracker_item_id=28450

=== Showon ===
L'ajout de l'attribut <code>showon</code> permet de cacher le champ basé sur la valeur d'un autre champ.

La syntaxe permettant d'afficher le champ <tt>bar</tt> uniquement lorsque <tt>foo</tt> est sur "1" et <tt>baz</tt> est sur "1" :

<source 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"
/></source>

Pour correspondre à de multiples valeurs, on peut fournir une liste de valeurs, séparées par des virgules. Comme par exemple <code>showon="foo:1,2"</code>

Pour combiner plusieurs champs, vous pouvez utiliser <code>[AND]</code>. Comme ceci <code>showon="foo:1[AND]bar:1"</code>

La syntaxe permettant d'afficher le champ <tt>bar</tt> quand <tt>foo</tt> est paramétré sur "1" et <tt>baz</tt> sur "1" :

<source 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"
/></source>

Pour combiner plusieurs champs, vous pouvez utiliser <code>[OR]</code>. Comme ceci <code>showon="foo:1[OR]bar:1"</code>

La syntaxe permettant d'afficher le champ <tt>bar</tt> uniquement lorsque <tt>foo</tt> est paramétré sur "1" ou <tt>baz</tt> sur "1" :

<source 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"
/></source>

Vous pouvez aussi utiliser une valeur "différente de" telle que <tt>showon="foo!:1"</tt>.

La syntaxe permettant d'afficher le champ "baz" lorsque "foo" n'est pas égal à "1" :

<source 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>
</source>
Pour afficher un champ lorsqu'un autre champ (par exemple foo) est sélectionné (et donc quand ce champ n'est pas vide), vous pouvez utiliser <tt>showon="foo!:"</tt> (sans spécifier de valeur).

Ceci a été introduit avec le PullRequest : https://github.com/joomla/joomla-cms/pull/3379 et disponible à partir de Joomla! 3.2.4.
=== Dépannage : Les attributs ne fonctionnent pas ===

Si vous avez lu une ancienne version de notre documentation pour les développeurs ou pris le code d'affichage de votre formulaire à partir d'une extension existante, vous rencontrez peut-être des problèmes avec des attributs tels que <code>showon</code> qui ne fonctionnent pas du tout. Pour que certains attributs spéciaux fonctionnent, vos champs doivent être rendus à l'aide de leur méthode <code>renderField()</code>. Par exemple:

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

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

Translations:Form field/33/fr

2022-02-22T13:02:18Z

Si vous avez lu une ancienne version de notre documentation pour les développeurs ou pris le code d'affichage de votre formulaire à partir d'une extension existante, vous rencontrez peut-être des problèmes avec des attributs tels que <code>showon</code> qui ne fonctionnent pas du tout. Pour que certains attributs spéciaux fonctionnent, vos champs doivent être rendus à l'aide de leur méthode <code>renderField()</code>. Par exemple:

Form field/fr

2022-02-22T12:59:30Z

Shim-sao: Created page with "=== Dépannage : Les attributs ne fonctionnent pas ==="

<noinclude><languages /></noinclude>
<onlyinclude>
==Introduction==
Les champs de formulaire sont des champs contenus dans des balises HTML <code><form></code>. La version Joomla! {{JVer|2.5}} et les plus récentes, proposent une classe JForm permettant de créer facilement et avec beaucoup de flexibilité des formulaires avec un très nombreux choix de types de champs. Chaque type de champ de formulaire est une sous-classe de JFormField.

En plus d'être un outil à la création de page flexible, JFormFields sont également utilisés par Joomla! pour permettre aux [[S:MyLanguage/Administrator (User)|administrateurs]] de configurer Joomla! ou ses extensions sans avoir à changer le code sous-jacent. Avec Joomla! 1.5, cela était réalisé via les classes désormais obsolètes [[S:MyLanguage/API15:JParameter|JParameter]] et [[S:MyLanguage/API15:JElement|JElement]].

Pour définir les champs de formulaire dans la configuration d'une extension, vous devez les inclure dans un "fieldset" tel que <code><fieldset name="basic"></code>, placé à l'intérieur de <code><fields name="params"></code> de la section élément <code><config></code> dans votre [[S:MyLanguage/Manifest files|fichier manifest XML]].
</onlyinclude>

== Validation de formulaires ==
{{:Form validation/fr}}
==Types de champs pour formulaires standards==
{{:Standard form field types/fr}}
== Types de champs de formulaires personnalisés ==
Une [[S:MyLanguage/extension|extension]] peut définir ses propres types de champ, qui peuvent ensuite être utilisés dans ses propres formulaires ou ceux créés par d'autres extensions. Pour plus d'informations, veuillez consulter : [[S:MyLanguage/Creating a custom form field type|Création d'un type de champ de formulaire personnalisé]].
==Types de champs pour formulaires modales==
Si vous avez un champ avec de nombreuses valeurs qui ne conviennent pas pour une zone de sélection, vous pouvez toujours utiliser un type de champ de formulaire modal qui permettra à l'utilisateur de sélectionner un élément à partir d'une fenêtre modale avec un tableau, des options de filtres, etc. (comme pour les fenêtres dans l'administration comme par exemple pour les "articles").
Veuillez consulter [[S:MyLanguage/Creating a modal form field|Création de formulaires modales]]

== Attributs communs ==
=== Labelclass ===
L'ajout de l'attribut <code>labelclass</code> permet d'ajouter une classe CSS pour les étiquettes des champs de formulaires. Source : http://joomlacode.org/gf/project/joomla/tracker/?action=TrackerItemEdit&tracker_item_id=28450

=== Showon ===
L'ajout de l'attribut <code>showon</code> permet de cacher le champ basé sur la valeur d'un autre champ.

La syntaxe permettant d'afficher le champ <tt>bar</tt> uniquement lorsque <tt>foo</tt> est sur "1" et <tt>baz</tt> est sur "1" :

<source 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"
/></source>

Pour correspondre à de multiples valeurs, on peut fournir une liste de valeurs, séparées par des virgules. Comme par exemple <code>showon="foo:1,2"</code>

Pour combiner plusieurs champs, vous pouvez utiliser <code>[AND]</code>. Comme ceci <code>showon="foo:1[AND]bar:1"</code>

La syntaxe permettant d'afficher le champ <tt>bar</tt> quand <tt>foo</tt> est paramétré sur "1" et <tt>baz</tt> sur "1" :

<source 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"
/></source>

Pour combiner plusieurs champs, vous pouvez utiliser <code>[OR]</code>. Comme ceci <code>showon="foo:1[OR]bar:1"</code>

La syntaxe permettant d'afficher le champ <tt>bar</tt> uniquement lorsque <tt>foo</tt> est paramétré sur "1" ou <tt>baz</tt> sur "1" :

<source 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"
/></source>

Vous pouvez aussi utiliser une valeur "différente de" telle que <tt>showon="foo!:1"</tt>.

La syntaxe permettant d'afficher le champ "baz" lorsque "foo" n'est pas égal à "1" :

<source 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>
</source>
Pour afficher un champ lorsqu'un autre champ (par exemple foo) est sélectionné (et donc quand ce champ n'est pas vide), vous pouvez utiliser <tt>showon="foo!:"</tt> (sans spécifier de valeur).

Ceci a été introduit avec le PullRequest : https://github.com/joomla/joomla-cms/pull/3379 et disponible à partir de Joomla! 3.2.4.
=== Dépannage : Les attributs ne fonctionnent pas ===

If you have read an older version of our developer documentation, or took your form display code from an existing extension, you may be experiencing issues with attributes like <code>showon</code> not working at all. In order for some special attributes to function, your fields must be rendered using their <code>renderField()</code> method. For example:

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

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

Translations:Form field/32/fr

2022-02-22T12:59:28Z

Shim-sao: Created page with "=== Dépannage : Les attributs ne fonctionnent pas ==="

=== Dépannage : Les attributs ne fonctionnent pas ===

Standard form field types/fr

2022-02-18T12:32:37Z

Shim-sao:

Translations:Standard form field types/193/fr

2022-02-18T12:32:37Z

Shim-sao:

fournit un accès modal au gestionnaire de médias pour l'insertion d'images avec téléchargement pour les utilisateurs disposant des autorisations appropriées et un champ de texte pour ajouter un texte alternatif.

Standard form field types/fr

2022-02-18T12:30:14Z

Shim-sao: Created page with "et suivant"

<noinclude><languages /></noinclude>
De nombreux types de [[S:MyLanguage/form field|champs de formulaires]] sont disponibles dans Joomla. Le tableau ci-dessous dresse la liste de ces types standards ainsi que leur disponibilité. Veuillez utiliser la [[S:MyLanguage/Standard_form_field_types/Single-page_reference|page de références]] si vous souhaitez imprimer la documentation sur l'ensemble des champs de formulaires existants.

Pour les versions {{JVer|1.5}}. Veuillez noter que plusieurs de ces champs sont disponibles en tant que [[S:MyLanguage/Parameter|types de paramètres]] pour Joomla! 1.5. Pour une liste des types de paramètres, veuillez consulter [[S:MyLanguage/J1.5:Standard parameter types|les types de paramètres standards pour Joomla! 1.5]]. Pour une comparaison entre les champs et les types de paramètres, veuillez consulter [[S:MyLanguage/Standard form field and parameter types|les champs de formulaires standards et les types de paramètres]].
{| class="wikitable" style="vertical-align:top; border:1px solid Sienna; background-color:Cornsilk;"
|- style="background-color:Wheat; font-weight:bold; text-align: left;"
!width=15%|Type
!width=65%|Description
!width=20%|Disponibilité

|-
|[[S:MyLanguage/Accessiblemedia form field type|accessiblemedia]]
|fournit un accès modal au gestionnaire de médias pour l'insertion d'images avec téléchargement pour les utilisateurs ayant les autorisations appropriées et un champ de texte pour ajouter un texte alternatif.
|{{JVer|4.0}} et suivant

|-
|[[S:MyLanguage/Accesslevel form field type|accesslevel]]
|fournit une liste déroulante de visualisation des niveaux d'accès.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Cachehandler form field type|cachehandler]]
|fournit une liste d'options de mise en cache disponibles.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Calendar form field type|calendar]]
|fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte fournit un lien vers un calendrier en fenêtre modale, qui peut également être utilisé pour entrer la valeur de la date.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Captcha form field type|captcha]]
|Permet l'utilisation d'un plugin captcha.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Category form field type|category]]
|fournit une liste déroulante des catégories pour une extension.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Checkbox form field type|checkbox]]
|fournit une case simple à cocher ou décocher.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Checkboxes form field type|checkboxes]]
|fournit un nombre illimité de cases à cocher qui peuvent être utilisées pour les multi-sélections.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ChromeStyle form field type|Chrome Style]]
|fournit une liste des templates avec options de style chrome regroupés par templates.
|{{JVer|3.0}} et suivant
|-
|[[S:MyLanguage/Color form field type|color]]
|fournit un sélecteur de couleur en cliquant dans la zone de saisie.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ContentLanguage form field type|Content Language]]
|fournit une liste des langues de contenu.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Contenttype form field type|Content Type]]
|fournit une liste des types de contenu.
|{{JVer|3.1}} et suivant
|-
|[[S:MyLanguage/Combo form field type|combo]]
|fournit une un ensemble de champs cases.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Componentlayout form field type|componentlayout]]
|fournit une liste regroupant des templates et d'affichages natifs alternatifs pour un élément de composant.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Contentlanguage form field type|contentlanguage]]
|fournit une liste de langues de contenu installées pour une utilisation avec le plugin de sélection des langues.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/DatabaseConnection form field type|Database Connection]]
|fournit une liste de connexions à la base de données disponible, éventuellement en limitant à une liste donnée.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Editor form field type|editor]]
|fournit un champ de zone de texte pour l'éditeur.
|{{JVer|1.6}} et suivant
|-
|[[S:MyLanguage/Editors form field type|editors]]
|fournit une liste déroulante des éditeurs WYSIWYG disponibles. Depuis la version {{JVer|2.5}}, il convient d'utiliser à la place les [[S:MyLanguage/Plugins form field type|plugins de types de champs de formulaire]].
|{{JVer|1.6}}
|-
|[[S:MyLanguage/Email form field type|email]]
|fournit un champ de courriel.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/File form field type|file]]
|fournit un champ de saisie pour les fichiers.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Filelist form field type|filelist]]
|fournit une liste déroulante de fichiers d'un répertoire spécifié.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Folderlist form field type|folderlist]]
|fournit une liste déroulante des dossiers d'un répertoire spécifié.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Groupedlist form field type|groupedlist]]
|fournit une liste déroulante d'éléments organisés en groupes.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/HeaderTag form field type|header tag]]
|fournit une liste déroulante des balises de titre (h1-h6).
|{{JVer|3.0}} et suivant
|-
|[[S:MyLanguage/Helpsite form field type|helpsite]]
|fournit une liste déroulante des sites d'aide pour votre installation Joomla.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Hidden form field type|hidden]]
|fournit un champ caché pour l'enregistrement d'un champ de formulaire dont la valeur ne peut pas être modifiée directement par un utilisateur dans l'administration (elle peut être modifiée dans le code ou par modification du fichier "params.ini").
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Imagelist form field type|imagelist]]
|fournit une liste déroulante de fichiers image d'un répertoire spécifié.
|{{JVer|2.5}} et suivant
|-
|-
|[[S:MyLanguage/Integer form field type|integer]]
|fournit une liste déroulante d'entiers compris entre un minimum et un maximum.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Language form field type|language]]
|fournit une liste déroulante des langues installées pour le frontend ou le backend.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/List form field type|list]]
|fournit une liste déroulante d'entrées personnalisées.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Media form field type|media]]
|fournit un accès en modal au gestionnaire de médias pour l'insertion d'images avec chargement par les utilisateurs disposant des autorisations appropriées.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Menu form field type|menu]]
|fournit une liste déroulante des menus disponibles à partir de votre site Joomla.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Menuitem form field type|Menu Item]]
|fournit une liste déroulante des éléments de menu disponibles à partir de votre site Joomla.
|{{JVer|2.5}} et suivant
|-
|[[Meter form field type|meter]]
|fournit un compteur pour afficher la valeur dans une plage.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Modulelayout form field type|Module Layout]]
|fournit une liste d'affichages alternatifs pour un groupe de modules natifs et de templates.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ModuleOrder form field type|Module Order]]
|fournit une liste déroulante pour définir les modules d'une position donnée.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ModulePosition form field type|Module Position]]
|fournit une zone de texte pour définir la position d'un module.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ModuleTag form field type|Module Tag]]
|fournit une liste des éléments HTML5 (utilisé pour l'intégration de module dans une fenêtre).
|{{JVer|3.0}} et suivant
|-
|[[S:MyLanguage/Note form field type|note]]
|fournit un champ texte d'une ligne.
|{{JVer|3.1}} et suivant
|-
|[[S:MyLanguage/Number form field type|number]]
|fournit une zone de texte d'une ligne avec un champ déroulant de chiffres pour définir le champ.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Password form field type|password]]
|fournit une zone de texte pour la saisie d'un mot de passe. Les caractères du mot de passe seront masqués lors de la saisie.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Plugins form field type|plugins]]
|fournit une liste de plugins à partir d'un dossier donné.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Predefined List form field type|predefinedlist]]
|Champ de formulaire pour charger une liste de valeurs prédéfinies.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Radio form field type|radio]]
|fournit des boutons radio pour sélectionner différentes options.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Range form field type|range]]
|fournit une barre de défilement horizontale pour spécifier une valeur dans une plage donnée.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Repeatable form field type|repeatable]]
|autorise les champs de formulaire proposant autant d'options que souhaitées par l'utilisateur.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Rules form field type|rules]]
|fournit une matrice de groupe par options d'action pour la gestion des contrôles d'accès. L'affichage dépend du contexte.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Sessionhandler form field type|sessionhandler]]
|fournit une liste déroulante de gestionnaire des options de session.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Spacer form field type|spacer]]
|fournit un séparateur visible entre les champs de formulaire. Ceci est simplement une aide visuelle et aucune valeur n'est enregistrée.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/SQL form field type|sql]]
|fournit une liste déroulante des entrées obtenues par l'exécution d'une requête dans la base de données Joomla. La première colonne de résultats retournée par la requête fournit les valeurs de la liste déroulante.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/subform form field type|subform]]
|Permet l'utilisation des formulaires XML à l’intérieur les uns des autres ou de réutiliser vos formulaires existants à l’intérieur de vos propres formulaires.
|{{JVer|3.6}} et suivant
|-
|[[S:MyLanguage/Tag form field type|tag]]
|fournit un point d'entrée pour les balises (AJAX ou imbriquées).
|{{JVer|3.1}} et suivant
|-
|[[S:MyLanguage/Tel form field type|tel]]
|fournit un champ de saisie pour numéro de téléphone.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Templatestyle form field type|templatestyle]]
|fournit une liste déroulante des styles de templates.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Text form field type|text]]
|fournit une zone de texte pour la saisie des données.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Textarea form field type|textarea]]
|fournit une zone de texte pour la saisie de texte en multi-ligne.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Timezone form field type|timezone]]
|fournit une liste déroulante des fuseaux horaires.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/URL form field type|URL]]
|fournit un champ de saisie d'URL.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/User form field type|user]]
|Champ pour sélectionner un utilisateur à partir d'une liste modale. Affiche le nom d'utilisateur et stocke l'ID d'utilisateur.
|{{JVer|1.6}} et suivant
|-
|[[S:MyLanguage/UserActive form field type|useractive]]
|fournit une liste des utilisateurs actifs.
|{{JVer|3.2}} et suivant
|
|-
|[[S:MyLanguage/Usergroup form field type|usergroup]]
|fournit une liste déroulante des groupes d'utilisateurs. Depuis la version {{JVer|3.2}}, il convient d'utiliser à la place '[[S:MyLanguage/User Group List form field type|usergrouplist]]'.
|{{JVer|2.5}} et suivant
|
|-
|[[S:MyLanguage/User Group List form field type|usergrouplist]]
|fournit une liste déroulante des groupes d'utilisateurs. Remplace le type de champ de formulaire 'usergroup'.
|{{JVer|3.2}} et suivant
|
|-
|[[S:MyLanguage/User State form field type|userstate]]
|Champ pour charger une liste des statuts utilisateurs disponibles.
|{{JVer|3.2}} et suivant
|}

<noinclude>
[[Category:Form fields/fr|Champs de formulaires]]
[[Category:Development Reference/fr|Références pour le développement]]
</noinclude>

Translations:Standard form field types/194/fr

2022-02-18T12:30:14Z

Shim-sao: Created page with "et suivant"

et suivant

Standard form field types/fr

2022-02-18T12:29:55Z

Shim-sao: Created page with "fournit un accès modal au gestionnaire de médias pour l'insertion d'images avec téléchargement pour les utilisateurs ayant les autorisations appropriées et un champ de te..."

<noinclude><languages /></noinclude>
De nombreux types de [[S:MyLanguage/form field|champs de formulaires]] sont disponibles dans Joomla. Le tableau ci-dessous dresse la liste de ces types standards ainsi que leur disponibilité. Veuillez utiliser la [[S:MyLanguage/Standard_form_field_types/Single-page_reference|page de références]] si vous souhaitez imprimer la documentation sur l'ensemble des champs de formulaires existants.

Pour les versions {{JVer|1.5}}. Veuillez noter que plusieurs de ces champs sont disponibles en tant que [[S:MyLanguage/Parameter|types de paramètres]] pour Joomla! 1.5. Pour une liste des types de paramètres, veuillez consulter [[S:MyLanguage/J1.5:Standard parameter types|les types de paramètres standards pour Joomla! 1.5]]. Pour une comparaison entre les champs et les types de paramètres, veuillez consulter [[S:MyLanguage/Standard form field and parameter types|les champs de formulaires standards et les types de paramètres]].
{| class="wikitable" style="vertical-align:top; border:1px solid Sienna; background-color:Cornsilk;"
|- style="background-color:Wheat; font-weight:bold; text-align: left;"
!width=15%|Type
!width=65%|Description
!width=20%|Disponibilité

|-
|[[S:MyLanguage/Accessiblemedia form field type|accessiblemedia]]
|fournit un accès modal au gestionnaire de médias pour l'insertion d'images avec téléchargement pour les utilisateurs ayant les autorisations appropriées et un champ de texte pour ajouter un texte alternatif.
|{{JVer|4.0}} and newer

|-
|[[S:MyLanguage/Accesslevel form field type|accesslevel]]
|fournit une liste déroulante de visualisation des niveaux d'accès.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Cachehandler form field type|cachehandler]]
|fournit une liste d'options de mise en cache disponibles.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Calendar form field type|calendar]]
|fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte fournit un lien vers un calendrier en fenêtre modale, qui peut également être utilisé pour entrer la valeur de la date.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Captcha form field type|captcha]]
|Permet l'utilisation d'un plugin captcha.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Category form field type|category]]
|fournit une liste déroulante des catégories pour une extension.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Checkbox form field type|checkbox]]
|fournit une case simple à cocher ou décocher.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Checkboxes form field type|checkboxes]]
|fournit un nombre illimité de cases à cocher qui peuvent être utilisées pour les multi-sélections.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ChromeStyle form field type|Chrome Style]]
|fournit une liste des templates avec options de style chrome regroupés par templates.
|{{JVer|3.0}} et suivant
|-
|[[S:MyLanguage/Color form field type|color]]
|fournit un sélecteur de couleur en cliquant dans la zone de saisie.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ContentLanguage form field type|Content Language]]
|fournit une liste des langues de contenu.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Contenttype form field type|Content Type]]
|fournit une liste des types de contenu.
|{{JVer|3.1}} et suivant
|-
|[[S:MyLanguage/Combo form field type|combo]]
|fournit une un ensemble de champs cases.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Componentlayout form field type|componentlayout]]
|fournit une liste regroupant des templates et d'affichages natifs alternatifs pour un élément de composant.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Contentlanguage form field type|contentlanguage]]
|fournit une liste de langues de contenu installées pour une utilisation avec le plugin de sélection des langues.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/DatabaseConnection form field type|Database Connection]]
|fournit une liste de connexions à la base de données disponible, éventuellement en limitant à une liste donnée.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Editor form field type|editor]]
|fournit un champ de zone de texte pour l'éditeur.
|{{JVer|1.6}} et suivant
|-
|[[S:MyLanguage/Editors form field type|editors]]
|fournit une liste déroulante des éditeurs WYSIWYG disponibles. Depuis la version {{JVer|2.5}}, il convient d'utiliser à la place les [[S:MyLanguage/Plugins form field type|plugins de types de champs de formulaire]].
|{{JVer|1.6}}
|-
|[[S:MyLanguage/Email form field type|email]]
|fournit un champ de courriel.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/File form field type|file]]
|fournit un champ de saisie pour les fichiers.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Filelist form field type|filelist]]
|fournit une liste déroulante de fichiers d'un répertoire spécifié.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Folderlist form field type|folderlist]]
|fournit une liste déroulante des dossiers d'un répertoire spécifié.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Groupedlist form field type|groupedlist]]
|fournit une liste déroulante d'éléments organisés en groupes.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/HeaderTag form field type|header tag]]
|fournit une liste déroulante des balises de titre (h1-h6).
|{{JVer|3.0}} et suivant
|-
|[[S:MyLanguage/Helpsite form field type|helpsite]]
|fournit une liste déroulante des sites d'aide pour votre installation Joomla.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Hidden form field type|hidden]]
|fournit un champ caché pour l'enregistrement d'un champ de formulaire dont la valeur ne peut pas être modifiée directement par un utilisateur dans l'administration (elle peut être modifiée dans le code ou par modification du fichier "params.ini").
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Imagelist form field type|imagelist]]
|fournit une liste déroulante de fichiers image d'un répertoire spécifié.
|{{JVer|2.5}} et suivant
|-
|-
|[[S:MyLanguage/Integer form field type|integer]]
|fournit une liste déroulante d'entiers compris entre un minimum et un maximum.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Language form field type|language]]
|fournit une liste déroulante des langues installées pour le frontend ou le backend.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/List form field type|list]]
|fournit une liste déroulante d'entrées personnalisées.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Media form field type|media]]
|fournit un accès en modal au gestionnaire de médias pour l'insertion d'images avec chargement par les utilisateurs disposant des autorisations appropriées.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Menu form field type|menu]]
|fournit une liste déroulante des menus disponibles à partir de votre site Joomla.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Menuitem form field type|Menu Item]]
|fournit une liste déroulante des éléments de menu disponibles à partir de votre site Joomla.
|{{JVer|2.5}} et suivant
|-
|[[Meter form field type|meter]]
|fournit un compteur pour afficher la valeur dans une plage.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Modulelayout form field type|Module Layout]]
|fournit une liste d'affichages alternatifs pour un groupe de modules natifs et de templates.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ModuleOrder form field type|Module Order]]
|fournit une liste déroulante pour définir les modules d'une position donnée.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ModulePosition form field type|Module Position]]
|fournit une zone de texte pour définir la position d'un module.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/ModuleTag form field type|Module Tag]]
|fournit une liste des éléments HTML5 (utilisé pour l'intégration de module dans une fenêtre).
|{{JVer|3.0}} et suivant
|-
|[[S:MyLanguage/Note form field type|note]]
|fournit un champ texte d'une ligne.
|{{JVer|3.1}} et suivant
|-
|[[S:MyLanguage/Number form field type|number]]
|fournit une zone de texte d'une ligne avec un champ déroulant de chiffres pour définir le champ.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Password form field type|password]]
|fournit une zone de texte pour la saisie d'un mot de passe. Les caractères du mot de passe seront masqués lors de la saisie.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Plugins form field type|plugins]]
|fournit une liste de plugins à partir d'un dossier donné.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Predefined List form field type|predefinedlist]]
|Champ de formulaire pour charger une liste de valeurs prédéfinies.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Radio form field type|radio]]
|fournit des boutons radio pour sélectionner différentes options.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Range form field type|range]]
|fournit une barre de défilement horizontale pour spécifier une valeur dans une plage donnée.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Repeatable form field type|repeatable]]
|autorise les champs de formulaire proposant autant d'options que souhaitées par l'utilisateur.
|{{JVer|3.2}} et suivant
|-
|[[S:MyLanguage/Rules form field type|rules]]
|fournit une matrice de groupe par options d'action pour la gestion des contrôles d'accès. L'affichage dépend du contexte.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Sessionhandler form field type|sessionhandler]]
|fournit une liste déroulante de gestionnaire des options de session.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Spacer form field type|spacer]]
|fournit un séparateur visible entre les champs de formulaire. Ceci est simplement une aide visuelle et aucune valeur n'est enregistrée.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/SQL form field type|sql]]
|fournit une liste déroulante des entrées obtenues par l'exécution d'une requête dans la base de données Joomla. La première colonne de résultats retournée par la requête fournit les valeurs de la liste déroulante.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/subform form field type|subform]]
|Permet l'utilisation des formulaires XML à l’intérieur les uns des autres ou de réutiliser vos formulaires existants à l’intérieur de vos propres formulaires.
|{{JVer|3.6}} et suivant
|-
|[[S:MyLanguage/Tag form field type|tag]]
|fournit un point d'entrée pour les balises (AJAX ou imbriquées).
|{{JVer|3.1}} et suivant
|-
|[[S:MyLanguage/Tel form field type|tel]]
|fournit un champ de saisie pour numéro de téléphone.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Templatestyle form field type|templatestyle]]
|fournit une liste déroulante des styles de templates.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Text form field type|text]]
|fournit une zone de texte pour la saisie des données.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Textarea form field type|textarea]]
|fournit une zone de texte pour la saisie de texte en multi-ligne.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/Timezone form field type|timezone]]
|fournit une liste déroulante des fuseaux horaires.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/URL form field type|URL]]
|fournit un champ de saisie d'URL.
|{{JVer|2.5}} et suivant
|-
|[[S:MyLanguage/User form field type|user]]
|Champ pour sélectionner un utilisateur à partir d'une liste modale. Affiche le nom d'utilisateur et stocke l'ID d'utilisateur.
|{{JVer|1.6}} et suivant
|-
|[[S:MyLanguage/UserActive form field type|useractive]]
|fournit une liste des utilisateurs actifs.
|{{JVer|3.2}} et suivant
|
|-
|[[S:MyLanguage/Usergroup form field type|usergroup]]
|fournit une liste déroulante des groupes d'utilisateurs. Depuis la version {{JVer|3.2}}, il convient d'utiliser à la place '[[S:MyLanguage/User Group List form field type|usergrouplist]]'.
|{{JVer|2.5}} et suivant
|
|-
|[[S:MyLanguage/User Group List form field type|usergrouplist]]
|fournit une liste déroulante des groupes d'utilisateurs. Remplace le type de champ de formulaire 'usergroup'.
|{{JVer|3.2}} et suivant
|
|-
|[[S:MyLanguage/User State form field type|userstate]]
|Champ pour charger une liste des statuts utilisateurs disponibles.
|{{JVer|3.2}} et suivant
|}

<noinclude>
[[Category:Form fields/fr|Champs de formulaires]]
[[Category:Development Reference/fr|Références pour le développement]]
</noinclude>

Translations:Standard form field types/193/fr

2022-02-18T12:29:55Z

fournit un accès modal au gestionnaire de médias pour l'insertion d'images avec téléchargement pour les utilisateurs ayant les autorisations appropriées et un champ de texte pour ajouter un texte alternatif.

Translations:Standard form field types/192/fr

2022-02-18T12:28:16Z

Shim-sao: Created page with "accessiblemedia"

accessiblemedia

J4.x:Http Header Management/fr

2021-01-12T13:41:12Z

Shim-sao: Created page with "Interface de Stratégie de Sécurité du Contenu"

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=4.0}}</noinclude>
{{Top portal heading|color=white-bkgd|icon=magic|icon-color=#5091cd|size=3x|text-color=#333|title=Didacticiel<br />Comment utiliser le nouveau gestionnaire d'en-têtes HTTP dans Joomla 4.0}}

À partir de Joomla 4.0, Joomla a introduit un système de gestion d'en-tête HTTP. Ce système est conçu pour aider les propriétaires de sites à configurer les en-têtes de sécurité HTTP à partir du serveur principal.

Dans ce didacticiel, vous trouverez les informations sur comment paramétrer ce nouveau système.

==Plugin==

===Système - En-têtes HTTP (plg_system_httpheaders)===
Naviguez à {{rarr|Système,Plugins,Système- En-têtes HTTP}} pour accéder à la configuration du plugin.

==== Configuration du Plugin ====

Sur cette page, vous pouvez choisir d'activer l'écriture des en-têtes dans les fichiers de configuration du serveur (.htaccess et web.config) et de définir si les en-têtes http suivants sont activés.
* [https://scotthelme.co.uk/hardening-your-http-response-headers/#x-frame-options X-Frame-Options]
* [https://scotthelme.co.uk/a-new-security-header-referrer-policy/ Referrer-Policy]
* [https://www.chromestatus.com/feature/5432089535053824 Cross-Origin-Opener-Policy]

En utilisant le formulaire "Forcer l'en-tête", vous pouvez également forcer les en-têtes suivants avec ses valeurs:
* [https://scotthelme.co.uk/hsts-the-missing-link-in-tls/ Strict-Transport-Security]
* [https://scotthelme.co.uk/content-security-policy-an-introduction/ Content-Security-Policy]
* [https://scotthelme.co.uk/content-security-policy-an-introduction/#testingapolicy Content-Security-Policy-Report-Only]
* [https://scotthelme.co.uk/a-new-security-header-expect-ct/ Expect-CT]
* [https://scotthelme.co.uk/a-new-security-header-feature-policy/ Feature-Policy & Permissions-Policy]
* [https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/report-to Report-to]

[[File:Plg-system-httpheaders-options-en.png|center|800px]]

===Configuration Strict-Transport-Security (HSTS)===

À partir de cette page, vous pouvez choisir d'activer l'en-tête Strict-Transport-Security (HSTS) ainsi que de configurer la valeur max-age si les sous-domaines doivent être inclus et si vous souhaitez être ajouté à la liste de préchargement des navigateurs.

[[File:Plg-system-httpheaders-options-hsts-en.png|center|800px]]

== Composant ==

===Politique de sécurité du contenu (com_csp)===
Accédez à {{rarr|System,Politique de Sécurité du Contenu}} pour accéder au tableau de bord Rapports de Politique de Sécurité du Contenu.

====Rapports====

À partir de cet écran, l'administrateur a une vue d'ensemble des rapports de Stratégie de Sécurité du Contenu collectés et a la possibilité de réviser, publier, dépublier et supprimer les règles suggérées pour la directive de Stratégie de Sécurité du Contenu.

[[Image:content-security-policy-reports-en.png|center|800px]]

Pour en savoir plus, veuillez consulter: [[S:MyLanguage/Help4.x:Components_CSP_Reports|Interface de Stratégie de Sécurité du Contenu]]

====Paramètres====

From this screen you can configure the options of the component like the permissions and specificly the settings for the Content-Security-Policy, including different modes and whether the headers are in read only mode.

[[Image:content-security-policy-options-en.png|center|800px]]

To learn more, please see: [[S:MyLanguage/Help4.x:Components_CSP_Reports_Options|Content Security Policy Options]]

==Notes==

When you have configured some HTTP Security Headers directly on the server, then our tooling might create double entries.

Check the output of your HTTP Headers after configuring in the browser console. In Google Chrome: Inspect > Network > the output under Headers). You can than disable the headers that cause double entries. Also check the console of your browser for possible errors.

==Développeurs d'extension==
As you might know the big security advantage concerning Content Security Policy jumps in when we can use the Header to block all inline JavaScript and inline CSS affecting for example JavaScript event handlers via HTML attributes.
So with this browser protection enabled we will block inline JavaScript and inline CSS usage also for your extensions. That protection is not enabled by default but can be enabled by your users.

For 4.0 it would be recommended to get the frontend of your extension running with strict Content Security Policy enabled. For 4.1 compatibility it would be recommended that this also applies to your backend.

We know that it is still a requirement to have inline JavaScript and CSS, for that reason we have implemented nonce and hash support into our Document APIs when you use them the core will make sure they are whitelisted but we will still block any malicious to protect our sites.

=== Important notes for Extension Developers ===
Starting with Joomla 4.0 Content Security Policy:
* is shipped by the core
* is disabled by default
* can be enabled by your users
* it is strongly recommended that your extension frontend works by 4.0 with Content Security Policy enabled
* it is recommended that your extension backend works by 4.1 with Content Security Policy enabled

With strict Content Security Policy enabled the following features will be blocked:
* the execution of JavaScript via the HTML event handlers (onXXX handlers like onClick and similar)
* the execution of in-page JavaScript not passed to the page via the Document API
* the execution of JavaScript code injected into DOM APIs such as eval()
* the usage of inline in-page CSS not passed to the page via the Document API
* the usage of inline CSS using the HTML style attribute

To get your extensions work even with strict Content Security Policy enabled, the easiest way is to use the Document API to apply your inline JavaScript and CSS, please check the examples below.

===Ajout de JavaScript à l'aide de l'API Joomla===

<source lang="php">
use Joomla\CMS\Factory;

/** @var Joomla\CMS\WebAsset\WebAssetManager $wa */
$wa = Factory::getApplication()->getDocument()->getWebAssetManager();

// Add JavaScript from URL
$wa->registerAndUseScript('com_example.sample', 'https://example.org/sample.js', [], ['defer' => true]);

// Add inline JavaScript
$wa->addInlineScript('
document.addEventListener("DOMContentLoaded", function(event) {
alert("An inline JavaScript Declaration");
});
');
</source>

===Ajout de CSS à l'aide de l'API Joomla===

<source lang="php">
use Joomla\CMS\Factory;

/** @var Joomla\CMS\WebAsset\WebAssetManager $wa */
$wa = Factory::getApplication()->getDocument()->getWebAssetManager();

// Add Style from URL
$wa->registerAndUseStyle('com_example.sample', 'https://example.org/sample.css');

// Add inline Style
$wa->addInlineStyle('
body {
background: #00ff00;
color: rgb(0,0,255);
}
');
</source>

Plus de détails ici:[[S:MyLanguage/J3.x:Adding_JavaScript_and_CSS_to_the_page|Ajouter du JavaScript et des CSS à une page]]

== Additional resources about Content Security Policy and HTTP Headers ==

* [https://scotthelme.co.uk/csp-cheat-sheet/| CSP Cheat Sheet]
* [https://scotthelme.co.uk/content-security-policy-an-introduction/| Content Security Policy - An Introduction]
* [https://securityheaders.com/| SecurityHeaders.com (by Scott Helme)]
* [https://csp-evaluator.withgoogle.com/| CSP Evaluator]
* [https://developers.google.com/web/fundamentals/security/csp| Web Fundamentals Content Security Policy]
* [https://csp.withgoogle.com/docs/index.html| Google's CSP Documentation]
* [https://research.google/pubs/pub45542/| CSP Is Dead, Long Live CSP! On the Insecurity of Whitelists and the Future of Content Security Policy]
* [https://web.dev/tags/security/| web.dev tag Security]

<noinclude>
[[Category:Components{{#translation:}}]]
[[Category:Joomla! 4.0{{#translation:}}]]
[[Category:Joomla! 4.x{{#translation:}}]]
[[Category:Plugins{{#translation:}}]]
[[Category:Security{{#translation:}}]]
</noinclude>

Translations:J4.x:Http Header Management/22/fr

2021-01-12T13:41:11Z

Shim-sao: Created page with "Interface de Stratégie de Sécurité du Contenu"

Interface de Stratégie de Sécurité du Contenu

J4.x:Http Header Management/fr

2021-01-12T13:40:30Z

Shim-sao: Created page with "Pour en savoir plus, veuillez consulter:"

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=4.0}}</noinclude>
{{Top portal heading|color=white-bkgd|icon=magic|icon-color=#5091cd|size=3x|text-color=#333|title=Didacticiel<br />Comment utiliser le nouveau gestionnaire d'en-têtes HTTP dans Joomla 4.0}}

À partir de Joomla 4.0, Joomla a introduit un système de gestion d'en-tête HTTP. Ce système est conçu pour aider les propriétaires de sites à configurer les en-têtes de sécurité HTTP à partir du serveur principal.

Dans ce didacticiel, vous trouverez les informations sur comment paramétrer ce nouveau système.

==Plugin==

===Système - En-têtes HTTP (plg_system_httpheaders)===
Naviguez à {{rarr|Système,Plugins,Système- En-têtes HTTP}} pour accéder à la configuration du plugin.

==== Configuration du Plugin ====

Sur cette page, vous pouvez choisir d'activer l'écriture des en-têtes dans les fichiers de configuration du serveur (.htaccess et web.config) et de définir si les en-têtes http suivants sont activés.
* [https://scotthelme.co.uk/hardening-your-http-response-headers/#x-frame-options X-Frame-Options]
* [https://scotthelme.co.uk/a-new-security-header-referrer-policy/ Referrer-Policy]
* [https://www.chromestatus.com/feature/5432089535053824 Cross-Origin-Opener-Policy]

En utilisant le formulaire "Forcer l'en-tête", vous pouvez également forcer les en-têtes suivants avec ses valeurs:
* [https://scotthelme.co.uk/hsts-the-missing-link-in-tls/ Strict-Transport-Security]
* [https://scotthelme.co.uk/content-security-policy-an-introduction/ Content-Security-Policy]
* [https://scotthelme.co.uk/content-security-policy-an-introduction/#testingapolicy Content-Security-Policy-Report-Only]
* [https://scotthelme.co.uk/a-new-security-header-expect-ct/ Expect-CT]
* [https://scotthelme.co.uk/a-new-security-header-feature-policy/ Feature-Policy & Permissions-Policy]
* [https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/report-to Report-to]

[[File:Plg-system-httpheaders-options-en.png|center|800px]]

===Configuration Strict-Transport-Security (HSTS)===

À partir de cette page, vous pouvez choisir d'activer l'en-tête Strict-Transport-Security (HSTS) ainsi que de configurer la valeur max-age si les sous-domaines doivent être inclus et si vous souhaitez être ajouté à la liste de préchargement des navigateurs.

[[File:Plg-system-httpheaders-options-hsts-en.png|center|800px]]

== Composant ==

===Politique de sécurité du contenu (com_csp)===
Accédez à {{rarr|System,Politique de Sécurité du Contenu}} pour accéder au tableau de bord Rapports de Politique de Sécurité du Contenu.

====Rapports====

À partir de cet écran, l'administrateur a une vue d'ensemble des rapports de Stratégie de Sécurité du Contenu collectés et a la possibilité de réviser, publier, dépublier et supprimer les règles suggérées pour la directive de Stratégie de Sécurité du Contenu.

[[Image:content-security-policy-reports-en.png|center|800px]]

Pour en savoir plus, veuillez consulter: [[S:MyLanguage/Help4.x:Components_CSP_Reports|Content Security Policy Interface]]

====Paramètres====

From this screen you can configure the options of the component like the permissions and specificly the settings for the Content-Security-Policy, including different modes and whether the headers are in read only mode.

[[Image:content-security-policy-options-en.png|center|800px]]

To learn more, please see: [[S:MyLanguage/Help4.x:Components_CSP_Reports_Options|Content Security Policy Options]]

==Notes==

When you have configured some HTTP Security Headers directly on the server, then our tooling might create double entries.

Check the output of your HTTP Headers after configuring in the browser console. In Google Chrome: Inspect > Network > the output under Headers). You can than disable the headers that cause double entries. Also check the console of your browser for possible errors.

==Développeurs d'extension==
As you might know the big security advantage concerning Content Security Policy jumps in when we can use the Header to block all inline JavaScript and inline CSS affecting for example JavaScript event handlers via HTML attributes.
So with this browser protection enabled we will block inline JavaScript and inline CSS usage also for your extensions. That protection is not enabled by default but can be enabled by your users.

For 4.0 it would be recommended to get the frontend of your extension running with strict Content Security Policy enabled. For 4.1 compatibility it would be recommended that this also applies to your backend.

We know that it is still a requirement to have inline JavaScript and CSS, for that reason we have implemented nonce and hash support into our Document APIs when you use them the core will make sure they are whitelisted but we will still block any malicious to protect our sites.

=== Important notes for Extension Developers ===
Starting with Joomla 4.0 Content Security Policy:
* is shipped by the core
* is disabled by default
* can be enabled by your users
* it is strongly recommended that your extension frontend works by 4.0 with Content Security Policy enabled
* it is recommended that your extension backend works by 4.1 with Content Security Policy enabled

With strict Content Security Policy enabled the following features will be blocked:
* the execution of JavaScript via the HTML event handlers (onXXX handlers like onClick and similar)
* the execution of in-page JavaScript not passed to the page via the Document API
* the execution of JavaScript code injected into DOM APIs such as eval()
* the usage of inline in-page CSS not passed to the page via the Document API
* the usage of inline CSS using the HTML style attribute

To get your extensions work even with strict Content Security Policy enabled, the easiest way is to use the Document API to apply your inline JavaScript and CSS, please check the examples below.

===Ajout de JavaScript à l'aide de l'API Joomla===

<source lang="php">
use Joomla\CMS\Factory;

/** @var Joomla\CMS\WebAsset\WebAssetManager $wa */
$wa = Factory::getApplication()->getDocument()->getWebAssetManager();

// Add JavaScript from URL
$wa->registerAndUseScript('com_example.sample', 'https://example.org/sample.js', [], ['defer' => true]);

// Add inline JavaScript
$wa->addInlineScript('
document.addEventListener("DOMContentLoaded", function(event) {
alert("An inline JavaScript Declaration");
});
');
</source>

===Ajout de CSS à l'aide de l'API Joomla===

<source lang="php">
use Joomla\CMS\Factory;

/** @var Joomla\CMS\WebAsset\WebAssetManager $wa */
$wa = Factory::getApplication()->getDocument()->getWebAssetManager();

// Add Style from URL
$wa->registerAndUseStyle('com_example.sample', 'https://example.org/sample.css');

// Add inline Style
$wa->addInlineStyle('
body {
background: #00ff00;
color: rgb(0,0,255);
}
');
</source>

Plus de détails ici:[[S:MyLanguage/J3.x:Adding_JavaScript_and_CSS_to_the_page|Ajouter du JavaScript et des CSS à une page]]

== Additional resources about Content Security Policy and HTTP Headers ==

* [https://scotthelme.co.uk/csp-cheat-sheet/| CSP Cheat Sheet]
* [https://scotthelme.co.uk/content-security-policy-an-introduction/| Content Security Policy - An Introduction]
* [https://securityheaders.com/| SecurityHeaders.com (by Scott Helme)]
* [https://csp-evaluator.withgoogle.com/| CSP Evaluator]
* [https://developers.google.com/web/fundamentals/security/csp| Web Fundamentals Content Security Policy]
* [https://csp.withgoogle.com/docs/index.html| Google's CSP Documentation]
* [https://research.google/pubs/pub45542/| CSP Is Dead, Long Live CSP! On the Insecurity of Whitelists and the Future of Content Security Policy]
* [https://web.dev/tags/security/| web.dev tag Security]

<noinclude>
[[Category:Components{{#translation:}}]]
[[Category:Joomla! 4.0{{#translation:}}]]
[[Category:Joomla! 4.x{{#translation:}}]]
[[Category:Plugins{{#translation:}}]]
[[Category:Security{{#translation:}}]]
</noinclude>