Beschreibung
Die wpforms_field_properties wird beim Laden des Formulars ausgelöst, um die Feldeigenschaften wie Beschriftungen, Unterbeschriftungen und Beschreibungen oberhalb des Formularfelds anzuzeigen.
Parameter
- $Eigenschaften
- (Array) Ein Array mit Feldeigenschaften wie Bezeichnungen, Unterbezeichnungen und Beschreibung.
- $Feld
- (Array) Bereinigte Felddaten.
- $form_data
- (Array) Verarbeitete Formulareinstellungen/Daten, die für die spätere Verwendung vorbereitet sind.
Quelle
wpforms/includes/fields/class-base.php
Mehr Informationen
Der Filter wird auf ein Array für bestimmte Formularfeldeigenschaften angewendet. Bei Verwendung dieses Filters wird jedes Formularfeld geändert.
Jedes Formularfeld hat seinen eigenen eindeutigen Filternamen. Im folgenden Abschnitt finden Sie eine vollständige Liste der dokumentierten Beispiele. Wenn Sie zum Beispiel nur das Feld E-Mail Formularfeld, würden Sie verwenden wpforms_field_properties_email.
Beispiele
Im folgenden Beispiel zeigt die Funktion die Feldbeschreibung über dem Feld selbst an, allerdings nur für die Formular-ID 225.
/**
* Move the field description above the form field.
*
* @link https://wpforms.com/developers/wpforms_field_properties/
*
* @param array $properties Field properties.
* @param array $field Field settings.
* @param array $form_data Form data and settings.
*
* @return array
*/
function wpf_dev_field_properties( $properties, $field, $form_data ) {
// Only process this snippet on the form ID 225
if ( absint( $form_data[ 'id' ] ) !== 225 ) {
return $properties;
}
// move the field description from under the form field to above the form field
$properties[ 'description' ][ 'position' ] = 'before';
return $properties;
}
add_filter( 'wpforms_field_properties', 'wpf_dev_field_properties', 10, 3 );
Referenzartikel
- So positionieren Sie die Feldbeschreibung über dem Formularfeld
- Ändern von Unteretiketten für das E-Mail-Feld
- Verarbeitung von Smart Tags in HTML-Feldern
- Ändern von Unteretiketten für das Feld Name
- Ändern der Unteretiketten des Adressfeldes
- Ändern der Untertitel des Passwortfeldes
- So ändern Sie das Namensattribut eines ausgeblendeten Feldes