render_block_core_search()


WordPressのrender_block_core_search()関数は、検索ブロックをレンダリングするために使用されます。この関数は、検索フォームのHTMLを生成し、フロントエンドに表示します。

構文

render_block_core_search( array $attributes );
  • $attributes(array) — 検索ブロックの属性を指定します。例えば、プレースホルダーテキストやボタンのテキストなどを含むことができます。

例1: 基本的な検索ブロックのレンダリング

この例では、デフォルトの属性を使用して検索ブロックをレンダリングします。

echo render_block_core_search( array() );

例2: カスタムプレースホルダーテキストの設定

検索フィールドのプレースホルダーテキストをカスタマイズします。

echo render_block_core_search( array( 'placeholder' => 'ここで検索...' ) );

例3: 検索ボタンのテキスト変更

検索ボタンのテキストを変更します。

echo render_block_core_search( array( 'buttonText' => '検索開始' ) );

例4: 検索フィールドの幅を指定

検索フィールドの幅を指定します。

echo render_block_core_search( array( 'width' => 300 ) );

例5: 検索フォームのクラス名を追加

検索フォームにカスタムクラスを追加します。

echo render_block_core_search( array( 'className' => 'custom-search-form' ) );

例6: 検索ボタンの無効化

検索ボタンを無効にします。

echo render_block_core_search( array( 'showButton' => false ) );

例7: 検索フィールドのデフォルト値を設定

検索フィールドにデフォルト値を設定します。

echo render_block_core_search( array( 'defaultValue' => '初期値' ) );

注意点

  • render_block_core_search()は、WordPressのコアブロックシステムに依存しているため、テーマやプラグインのカスタマイズによって動作が変わる可能性があります。
  • この関数は、主にブロックエディタ内で使用されることを想定しています。直接テーマファイルで使用する場合は、適切なエスケープ処理を行ってください。

関連機能: