블록 테마 스타일 목록 디자인 깔끔하게 보이도록 하는 방법

다양한 스타일을 블록 테마에 주고 싶어서 스타일 파일을 만들었다.
하지만 다른 참고용 테마에서 나타나는 카드형태가 아니라
색상 팔레트 형식으로만 나타나고 색상 대비도 그다지 명확하지 않았다.
왜그런지 여러가지로 알아보니 내가 설정한 스타일이 너무 단순해서였다.

스타일 변형이 보이는 최소 조건

테마 루트에 styles/ 폴더.
그 안에 light.json, dark.json 같은 파일.

각 파일은 JSON.
필수 키는 version, title.
주석·트레일링 콤마 금지.
UTF-8(BOM 없음).

{
  "version": 3,
  "title": "Light"
}

카드가 참조하는 대표 속성

카드는 아주 제한적으로 미리봄.

가장 확실하게 드러나는 것:

  • styles.color.background (배경색)
  • styles.color.text (본문 텍스트 색)
  • styles.typography.* (Aa 샘플: 폰트/크기/줄간격)

결국 카드에서 나타나는 것은 이 3가지 인데 타이포가 없으면 색상 팔레트만 나타

카드에서 “확” 다르게 보이게 하는 법

배경과 본문 텍스트 대비를 크게.
폰트 패밀리를 변형마다 바꾸기(serif vs sans).

{
  "styles": {
    "color": {
      "background": "var(--wp--preset--color--bg)",
      "text": "var(--wp--preset--color--fg)"
    },
    "typography": {
      "fontFamily": "var(--wp--preset--font-family--serif)",
      "fontSize": "var(--wp--preset--font-size--base)"
    }
  }
}

팔레트만 살짝 바꾸면 카드가 비슷해 보임.
배경/텍스트/폰트를 함께 조정해 차이를 키워라.

변형은 “토큰”을 바꿔야 효과적

패턴/템플릿에서는 직접 색값 대신
토큰을 사용하도록 설계.

변형 파일은 토큰 값만 교체.
사이트 전반 룩이 한 번에 바뀜.

{
  "settings": {
    "color": {
      "palette": [
        { "slug": "bg", "color": "#ffffff" },
        { "slug": "fg", "color": "#111111" },
        { "slug": "accent", "color": "#2563eb" }
      ]
    }
  }
}

에디터/프론트 일치

가능하면 theme.jsonstyles/*.json으로 스타일링.
필요시 style.css 보완 가능.

에디터에 동일 스타일 보이려면
add_editor_style('style.css') 사용.

파일 배치와 작동 순서

  1. 테마 활성화.
  2. styles/변형.json 추가.
  3. 관리자 → 편집기 → 스타일 → 스타일 둘러보기.
  4. 카드에서 변형 선택.
  5. 스타일 저장.

네이밍과 개수

title은 짧고 명확하게.
Light / Dark / Mint / Rose 등.

처음엔 3~6개가 적당.
너무 많으면 선택 피로.

자주 하는 실수 체크리스트

styles/ 폴더가 맞는가.
파일에 title이 있는가.
JSON 문법 오류가 없는가.
스타일 패널에서 팔레트 화면이 아닌
스타일 둘러보기를 열었는가.
배경/텍스트/폰트가 변형마다 충분히 다른가.

정리

카드는 배경/텍스트/타이포 중심으로만 미리봄.
그러니 bg/fg 대비폰트 차이에 집중.

팔레트만 바꾸지 말고
타이포까지 함께 바꿔야
hover 없이도 카드가 확 다르게 보인다.