get_block_wrapper_attributes

説明

string get_block_wrapper_attributes( string[] $extra_attributes = array() )
ブロックのラッパー要素向けの属性を取得する。

パラメータ

  • $extra_attributes
    'id'、'class'、'style'キーを持つ連想配列を指定(省略時はarray())。

返り値

ブロックのラッパー要素向けの属性文字列を返す。ラッパー要素に指定する属性がない場合は''を返す。

注意

本関数はダイナミックブロックをレンダリングするコールバック関数内で、対象ブロックの始まりの要素向けの属性を取得する際に使用する。

パラメータ$extra_attributesの連想配列は、キーに属性名、その内容に属性値を指定する。それぞれは対象ブロックのデフォルト属性(ブロックのattributesやsupportsプロパティに依存)とマージされ、最終的なラッパー要素の属性文字列となる。

各属性値は本関数内でエスケープ処理される。


使用例

  • デフォルトのラッパー要素向けの属性を取得する
    $wrapper_attributes = get_block_wrapper_attributes();
  • style属性を追加したラッパー要素向けの属性を取得する
    $wrapper_attributes = get_block_wrapper_attributes( array( 'style' => 'width:300px;height:300px;' ) );

フィルター

直接実行するフィルターはありません。

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/class-wp-block-supports.php

最終更新 : 2024年07月18日 13:59


お勧め

CSSやJavaScriptファイルのバージョン番号を変える(2018年5月27日 更新)

WordPress 4.7系の脆弱性をついた攻撃も落ち着いた感じなので、標準でヘッダーやフッター内に出力されるWordPressのバージョン番号について一考しました。

テーブルブロックを投稿メタ(カスタムフィールド)に保存する(2022年1月5日 更新)

ふと「テーブルブロックの内容を投稿メタ(カスタムフィールド)として保存できたら便利なのでは」と思い、投稿メタの使い方を調べてみた。

カスタム投稿タイプの投稿保存には専用アクションを使おう(2014年7月4日 更新)

カスタム投稿タイプを登録して、専用ウィジェット(meta_box)を使って拡張情報を入力させ、それらの情報をsave_postアクションで保存する。これまではこんな感じだったのだが、久しぶりにカスタム投稿タイプを使ったら、save_postアクションの前にsave_postに投稿タイプ名がくっついたアクションが追加されていた。

Fotepo:プラグイン作ってみました(2019年9月19日 更新)

仕事柄、Chromeの「デベロッパーツール」を使ってページのフォントを変更することがある。そんな時、無効なフォント名を指定してしまったり、フォント名をまちがえることがあり、もう少しお手軽にできないかと思って作ったのが今回紹介するプラグイン「Fotepo」である。

5.3への準備:投稿写真を使っているサイトは準備しておこう(2019年10月10日 更新)

この記事は先日公開した「5.3の新機能:JPEG画像の向きを調整」の続きのようなものになる。高解像度の投稿写真を扱っているサイトは、5.3のリリースに合わせて対応を検討しておくべきことをまとめてみた。