### [wpforms_field_properties](https://wpforms.com/developers/wpforms_field_properties/) **公開日:** 2021年2月17日 **著者:** David Ozokoye **抜粋:** wpforms_field_propertiesフィルターは、フォームの読み込み時に、ラベル、サブラベル、説明などのフィールドプロパティを表示するために実行されます。 **コンテンツ:** ## 説明 `wpforms_field_properties`フィルターは、フォームの読み込み時に、ラベル、サブラベル、説明などのフィールドプロパティをフォームフィールドの上に表示するために実行されます。 ## パラメータ $properties*(配列)* ラベル、サブラベル、説明などのフィールドプロパティの配列。 $field*(配列)* サニタイズされたフィールドデータ。 $form\_data*(配列)* 後で使用するために準備された、処理済みのフォーム設定/データ。 ## ソース `wpforms/includes/fields/class-base.php` ## 詳細情報 このフィルターは、特定のフォームフィールドプロパティの配列に適用されます。このフィルターを使用すると、すべてのフォームフィールドが変更されます。 各フォームフィールドには、独自のユニークなフィルター名があります。文書化された例の完全なリストについては、以下のセクションを参照してください。たとえば、**Email**フォームフィールドのみを変更したい場合は、`wpforms_field_properties_email`を使用します。 ## 例 以下の例では、フォームID **225** の場合のみ、フィールド **Description** がフィールド自体の上に表示されるようにします。 ``` /** * フィールドの説明をフォームフィールドの上に移動します。 * * @link https://wpforms.com/developers/wpforms_field_properties/ * * @param array $properties フィールドプロパティ。 * @param array $field フィールド設定。 * @param array $form_data フォームデータと設定。 * * @return array */ function wpf_dev_field_properties( $properties, $field, $form_data ) { // このスニペットはフォームID 225 の場合にのみ処理します if ( absint( $form_data[ 'id' ] ) !== 225 ) { return $properties; } // フィールドの説明をフォームフィールドの下から上に移動します $properties[ 'description' ][ 'position' ] = 'before'; return $properties; } add_filter( 'wpforms_field_properties', 'wpf_dev_field_properties', 10, 3 ); ``` ## 参照記事 - [フィールドの説明をフォームフィールドの上に配置する方法](https://wpforms.com/developers/how-to-position-the-field-description-above-the-form-field/ "フィールドの説明をフォームフィールドの上に配置する方法") - [メールフィールドのサブラベルを変更する方法](https://wpforms.com/developers/how-to-change-sublabels-for-the-email-field/ "メールフィールドのサブラベルを変更する方法") - [HTMLフィールドのスマートタグを処理する方法](https://wpforms.com/developers/how-to-process-smart-tags-in-html-fields/ "HTMLフィールドのスマートタグを処理する方法") - [名前フィールドのサブラベルを変更する方法](https://wpforms.com/developers/how-to-change-sublabels-for-the-name-field/ "名前フィールドのサブラベルを変更する方法") - [住所フィールドのサブラベルを変更する方法](https://wpforms.com/developers/how-to-change-the-address-field-sublabels/ "住所フィールドのサブラベルを変更する方法") - [パスワードフィールドのサブラベルを変更する方法](https://wpforms.com/developers/how-to-change-the-password-field-sublabels/ "パスワードフィールドのサブラベルを変更する方法") - [非表示フィールドの名前属性を変更する方法](https://wpforms.com/developers/how-to-change-the-name-attribute-of-a-hidden-field/ "非表示フィールドの名前属性を変更する方法") **カテゴリ:** フィルターフック **タグ:** PHP ---