Migrating Theme.json to Newer Versions

v1 から v2 への移行

v2 へのアップグレードにより、新しい機能がいくつか追加され、古い機能の名前がより一貫性のあるものに調整されます。

v1 から v2 への移行方法:

• 1. version を 2 に更新します。
• 2. 使用している場合は、更新されたプロパティの名前を変更します（下記参照）。

それぞれの v1 および v2 バージョンについては、リリースの開発ノートおよびリファレンス文書を参照してください。

名前が変更されたプロパティ

新しいプロパティ

新しいトップレベルプロパティ: customTemplates, templateParts.

設定への追加:

• settings.appearanceTools
• settings.border.color
• settings.border.style
• settings.border.width
• settings.color.background
• settings.color.defaultGradients
• settings.color.defaultPalette
• settings.color.text
• settings.spacing.blockGap
• settings.typography.fontFamilies
• settings.typography.fontStyle
• settings.typography.fontWeight
• settings.typography.letterSpacing
• settings.typography.textColumns
• settings.typography.textDecoration
• settings.typography.textTransform

スタイルへの追加:

• styles.border.color
• styles.border.style
• styles.border.width
• styles.filter.duotone
• styles.spacing.blockGap
• styles.typography.fontFamily
• styles.typography.fontStyle
• styles.typography.fontWeight
• styles.typography.letterSpacing
• styles.typography.textColumns
• styles.typography.textDecoration
• styles.typography.textTransform
  

プロパティ値の変更

コアによって提供されるデフォルトのフォントサイズ（settings.typography.fontSizes）が更新されました。ノーマルおよびヒュージサイズ（normalおよびhugeスラッグ）はリストから削除され、エクストララージ（x-largeスラッグ）が追加されました。UI コントロールがコアによって提供されるデフォルト値を表示する際、ノーマルおよびヒュージはもはや存在しません。ただし、それらの CSS クラスおよび CSS カスタムプロパティは、既存のコンテンツが期待通りに動作するようにキューに入れられています。

v2 から v3 への移行

v3 へのアップグレードにより、プリセットのデフォルトがより一貫性のあるものに調整されます。

v2 から v3 への移行方法:

• 1. version を 3 に更新します。
• 2. 変更されたデフォルトを設定します（下記参照）。
  

変更されたデフォルト

settings.typography.defaultFontSizes

theme.json v2 では、デフォルトのフォントサイズはテーマサイズが定義されていない場合にのみ表示されました。同じスラッグを持つフォントサイズを提供するテーマは常にそれらを上書きします。

デフォルトの fontSizes スラッグは: small, medium, large, x-large, および xx-large です。

新しい defaultFontSizes オプションは、デフォルトのフォントサイズを表示し、それらのデフォルトが上書きされないように制御します。

• true に設定すると、デフォルトのフォントサイズが表示され、テーマによって上書きされるのを防ぎます。
• false に設定すると、デフォルトのフォントサイズが非表示になり、テーマがデフォルトのスラッグを使用できるようになります。

v3 に切り替えると、デフォルトでは true です。これは、default* の他のオプション（settings.color.defaultPalette など）と一貫性を持たせるためですが、v2 の動作とは異なります。

v3 の theme.json で v2 と同様の動作を維持するには:

• fontSizes が定義されていない場合、defaultFontSizes は省略するか true に設定できます。

• いくつかの fontSizes が定義されている場合、defaultFontSizes を false に設定します。

settings.spacing.defaultSpacingSizes

theme.json v2 では、テーマレベルの間隔サイズを設定するために使用できる 2 つの設定があります: settings.spacing.spacingSizes と settings.spacing.spacingScale。両方の spacingSizes および spacingScale を設定すると、spacingSizes の値のみが使用されます。そして、どちらか一方を設定すると、WordPress によって提供されるデフォルトの間隔サイズ全体が常に置き換えられます。

WordPress によって提供されるデフォルトの spacingSizes スラッグは: 20, 30, 40, 50, 60, 70, および 80 です。

新しい defaultSpacingSizes オプションは、デフォルトの間隔サイズを表示し、それらのデフォルトが上書きされないように制御します。

• true に設定すると、デフォルトの間隔サイズが表示され、テーマによって上書きされるのを防ぎます。
• false に設定すると、デフォルトの間隔サイズが非表示になり、テーマがデフォルトのスラッグを使用できるようになります。

defaultSpacingSizes は v3 に切り替えると true です。これは、default* の他のオプション（settings.color.defaultPalette など）と一貫性を持たせるためですが、v2 の動作とは異なります。

さらに、v3 では spacingSizes と spacingScale を同時に設定できます。spacingSizes で定義されたプリセットが spacingSizes から生成されたプリセットとスラッグが一致する場合、それらは生成されたものを上書きします。

v3 の theme.json で v2 と同様の動作を維持するには:

• spacingSizes プリセットや spacingScale 設定が定義されていない場合、defaultSpacingSizes は省略するか true に設定できます。

• spacingScale を { "steps": 0 } に設定してデフォルトの間隔サイズを無効にした場合、spacingScale 設定を削除し、defaultSpacingSizes を false に設定します。

• spacingScale または spacingSizes のいずれか一方だけをプリセットとして定義した場合、defaultSpacingSizes を false に設定します。

• spacingScale と spacingSizes の両方を定義した場合、spacingSizes 設定を削除し、defaultSpacingSizes を false に設定します。