バージョン 2 (現在のリファレンス)

これは、theme.json バージョン2の現在の仕様です。このバージョンは、WordPress 5.9以降と最新のGutenberg プラグインで動作します。

関連するドキュメントとして、theme.json v1 仕様と theme.json v1 から v2 への移行リファレンス があります。

このリファレンスガイドは、theme.json スキーマで定義された設定 (settings) とスタイル (styles) プロパティの一覧です。theme.jsonの使用方法については、theme.json ガイド を参照してください。

スキーマ

開発中に theme.json の設定やプロパティを覚えておくのは難しいため、JSON スキーマが作成されました。スキーマは https://schemas.wp.org/trunk/theme.json で公開されています。

コードエディターはスキーマを読み込み、エディター内でツールチップ、オートコンプリート、スキーマ検証のような支援を提供できます。Visual Studio Code でスキーマを使用するには、theme.json ファイルの先頭に、”$schema”: “https://schemas.wp.org/trunk/theme.json” を追加してください。

Top ↑

settings

Top ↑

appearanceTools

以下のUIツールを有効にする設定です。

  • border: color, radius, style, width
  • color: link
  • spacing: blockGap, margin, padding
  • typography: lineHeight

Top ↑

border

ボーダー関連の設定です。

PropertyTypeDefaultProps
colorbooleanfalse
radiusbooleanfalse
stylebooleanfalse
widthbooleanfalse

Top ↑

color

色関連の設定です。

PropertyTypeDefaultProps
backgroundbooleantrue
custombooleantrue
customDuotonebooleantrue
customGradientbooleantrue
defaultDuotonebooleantrue
defaultGradientsbooleantrue
defaultPalettebooleantrue
duotonearraycolors, name, slug
gradientsarraygradient, name, slug
linkbooleanfalse
palettearraycolor, name, slug
textbooleantrue

Top ↑

layout

レイアウト関連の設定です。

PropertyTypeDefaultProps
contentSizestring
wideSizestring

Top ↑

spacing

スペース関連の設定です。

PropertyTypeDefaultProps
blockGapundefinednull
marginbooleanfalse
paddingbooleanfalse
unitsarraypx,em,rem,vh,vw,%
customSpacingSizebooleantrue
spacingSizesarrayname, size, slug
spacingScaleobject

Top ↑

typography

タイポグラフィ関連の設定です。

PropertyTypeDefaultProps
customFontSizebooleantrue
fontStylebooleantrue
fontWeightbooleantrue
letterSpacingbooleantrue
lineHeightbooleanfalse
textDecorationbooleantrue
textTransformbooleantrue
dropCapbooleantrue
fontSizesarrayname, size, slug
fontFamiliesarrayfontFace, fontFamily, name, slug

Top ↑

custom

--wp--custom--{key}--{nested-key}: {value};」形式のカスタム CSS カスタムプロパティを生成します。camelCased のキーは、CSSプロパティ命名スキーマに従うために、 kebab-case に変換されます。異なる深さのレベルのキーは -- で区切られるため、キーの名前に -- を含めないでください。


Top ↑

styles

Top ↑

border

ボーダーのスタイル。

PropertyTypeProps
colorstring
radiusundefined
stylestring
widthstring
topundefined
rightundefined
bottomundefined
leftundefined

Top ↑

color

色のスタイル。

PropertyTypeProps
backgroundstring
gradientstring
textstring

Top ↑

spacing

スペースのスタイル。

PropertyTypeProps
blockGapstring
marginobjectbottom, left, right, top
paddingobjectbottom, left, right, top

Top ↑

typography

タイポグラフィのスタイル。

PropertyTypeProps
fontFamilystring
fontSizestring
fontStylestring
fontWeightstring
letterSpacingstring
lineHeightstring
textDecorationstring
textTransformstring

Top ↑

filter

CSS and SVG filter styles.

PropertyTypeProps
duotonestring

原文

最終更新日: