WordPress 7.2 に背景クリップ（グラデーション文字など）の設定が入った場合、管理画面のトグルから有効にできない #7

概要

Gutenberg に入った 2 つの新機能が、WordPress 7.2 に入るかどうかを Beta の間に確認します。入った分だけ、本プラグインに反映します。

背景のクリップを text にすると、背景のグラデーションが文字の形に切り抜かれ、「グラデーション文字」になります。

theme.json は、テーマが「編集画面で使える機能」と「見た目」を JSON で定義するファイルです。Raw JSON 編集モードは、JSON を直接書く上級者向けの編集画面です。

着手時期: WordPress 7.2 Beta の間に、取り込まれたかどうかを確認します。最終判断は RC（リリース候補版）の時点で行います。

前提（登場するもの）

今回の 2 つは、Gutenberg には入っていますが、WordPress 本体にはまだ入っていません。本体に入らない限り、7.2 の利用者には効きません。

背景・現状（2026-10-20 時点）

背景のクリップ

• Gutenberg には入っている
  • WordPress/gutenberg#77141（背景クリップの仕組みを追加した PR）
  • WordPress/gutenberg#77142（その操作画面を追加した PR）
• WordPress 本体への取り込みは、まだ終わっていない
  • WordPress/wordpress-develop#13491（背景クリップを本体へ取り込む PR）が未マージ

settings.background.backgroundClip には、次のどちらかの形で値を書きます。

• true / false：すべての方法を許可する / 許可しない（既定値は false）
• 配列（例：["text", "padding-box"]）：許可する方法だけを並べる。書ける値は text / padding-box / border-box / content-box

label 要素

• Gutenberg 23.9 に入っている
  • WordPress/gutenberg#81160（<label> を、スタイルを書ける要素として登録した PR）
• WordPress 本体への取り込みは、まだ終わっていない
  • WordPress/wordpress-develop#13105（label 要素の対応を本体へ取り込む PR）が未マージ
  • 本体の要素一覧（WP_Theme_JSON::ELEMENTS＝theme.json でスタイルを書ける HTML 要素の一覧）に、まだ label が無い
• 2026 年 9 月の開発者向け記事では、label 要素が紹介されている。ただし、7.2 に入るかはまだ決まっていない

やること

• 7.2 Beta の間に、Editor: Add a background clip block support to facilitate text gradients WordPress/wordpress-develop#13491（背景クリップの取り込み）と Backport: add support for label on the elements API WordPress/wordpress-develop#13105（label 要素の取り込み）がマージされたかを確認する
• RC の前に公開される theme.json 関連の dev note（変更点の公式解説記事）で、ほかに追加・変更が無いかを確認する

背景のクリップが本体に入った場合は、次を行います。

• 「背景」カテゴリに settings.background.backgroundClip のトグルを追加する
  • ON で true、OFF で false を保存する。wpDefault（テーマが値を指定していないときに「WordPress の既定値」として表示する値）は false
  • 配列での指定は Raw JSON 編集モードで行う、と説明文と SPEC.md に書く
• 上書きに配列が保存されているときに、トグルの表示が崩れないことを確認する（今のトグルは true / false だけを想定しているため）
• SPEC.md の styles の節に styles.background.backgroundClip を追記する
• 翻訳ファイル（languages/ の .pot と英語訳）を更新する

label 要素が本体に入った場合は、次を行います。

• SPEC.md の styles の節に styles.elements.label を追記する
  • 効く範囲は、検索・フォーム入力・コメントフォーム・アーカイブ・カテゴリーの各ブロックが出す <label>

入らなかった場合は、次を行います。

• この issue に「7.2 には入らなかった」と記録し、WordPress 7.3 の変更点を調べるときに見直す

完了条件

• 7.2 RC の時点で、2 つの機能それぞれについて「対応した」か「7.2 には入らなかった」かが、この issue に記録されている
• 背景のクリップに対応した場合は、7.2 RC 環境で動きを確認する
  • トグルを ON にして保存すると、ブロックの背景の設定に「クリップ」の操作欄が出る
  • OFF にすると出なくなる

関連

• WordPress 7.2 で増えるテキストシャドウ（文字の影）の設定を、管理画面のトグルで切り替えられない #6（7.2 に入ることが確定しているテキストシャドウ設定のトグル追加と、SPEC.md への追記）
  • 同じ v0.6.0 にまとめるか、別のバージョンにするかは、取り込みの時期を見て決める