본문으로 건너뛰기

Node 없이 Tailwind v4 사용

각 페이지는 PHP에서 사용하는 클래스만 컴파일합니다.

설정 하나, 빌드 단계 없음

blockstudio.json에서 tailwind.enabled을 설정하고 원하는 템플릿에 유틸리티 클래스를 작성하세요. 프런트엔드 요청이 들어올 때마다 Blockstudio는 완성된 HTML에서 클래스 후보를 수집하고, Tailwind CSS 4.3을 PHP로 포팅한 TailwindPHP를 사용해 해당 클래스만 컴파일합니다.

Node.js도, CLI도, 감시자도 없습니다. 전체 페이지를 검색하므로 블록 템플릿, 테마 템플릿, 플러그인 및 the_content에 있는 클래스도 모두 포함됩니다.

blockstudio.json
{
  "tailwind": {
    "enabled": true
  }
}

Node 런타임 없음

TailwindPHP은 요청 중에 컴파일되므로 빌드하거나 배포할 것이 없습니다.

Tailwind 4.3 유틸리티

Tailwind CSS 4.3의 유틸리티, 변형, 임의 값 및 지시문.

전체 페이지 검색

최종 HTML의 어디에 있든 클래스가 포함됩니다.

클래스 집합별 캐시

같은 클래스를 사용하는 페이지는 컴파일된 파일 하나를 공유합니다.

CSS 우선 구성

blockstudio.json 또는 필터에서 @theme 토큰과 @utility 규칙을 사용합니다.

실시간 편집기 미리보기

번들로 제공되는 브라우저 빌드에서 입력 중인 클래스를 미리 볼 수 있습니다.

연결된 출력

브라우저와 엣지 캐시에 저장할 수 있는 콘텐츠 해시 스타일시트 하나.

Typography 및 forms

공식 플러그인 두 가지를 PHP용으로 포팅했으며 @plugin으로 로드합니다.

CSS에서 설정됨

Tailwind v4은 JavaScript 파일이 아닌 CSS로 설정합니다. 토큰, 규칙, 레이어를 tailwind.config에 넣거나 여러 줄에 걸쳐 있다면 blockstudio/tailwind/css 필터를 통해 추가하세요. @theme 토큰과 @utility 규칙을 사용합니다.

공식 typography 및 forms 플러그인은 PHP용으로 포팅되어 @plugin과 함께 로드됩니다. JavaScript 패키지로만 제공되는 플러그인은 실행되지 않습니다. Node를 실행하는 것이 없기 때문입니다.

클래스 별칭은 @layer utilities 안의 @apply 규칙입니다. 예를 들어 패딩 및 반경 유틸리티로 만든 .btn이 있습니다. 프런트엔드와 편집기 미리보기에서 모두 컴파일됩니다.

functions.php
add_filter('blockstudio/tailwind/css', function (string $css): string {
  return $css . '
    @plugin "@tailwindcss/typography";
    @theme { --color-brand: #4f46e5; }
    @utility container-narrow {
      max-width: 48rem;
      margin-inline: auto;
    }
  ';
});

필드로 사용하는 클래스

classes 필드에 "tailwind": true을 지정하면 편집기에서 전체 클래스 목록의 자동 완성을 사용할 수 있고, 번들로 제공되는 Tailwind 브라우저 빌드가 캔버스에서 변경 사항을 미리 보여줍니다.

assets.reset.enabled을 사용하면 편집기 래퍼 규칙이 덮어쓸 수 있는 flex, grid, sticky 등의 표시 및 위치 유틸리티도 캔버스에서 복원됩니다.

block.json
{
  "name": "acme/hero",
  "title": "Hero",
  "blockstudio": {
    "attributes": [
      {
        "id": "classes",
        "type": "classes",
        "label": "Classes",
        "tailwind": true,
        "default": "bg-white text-gray-900"
      }
    ]
  }
}

클래스 집합별로 캐시되는 스타일시트 하나

컴파일된 CSS은 페이지의 정렬된 클래스 후보와 CSS 입력으로 만든 키를 사용해 디스크에 캐시됩니다. 따라서 nonce와 타임스탬프로 캐시가 무효화되지 않으며, 같은 클래스를 사용하는 페이지는 파일 하나를 공유합니다.

기본값은 인라인 출력입니다. "output": "link"을 사용하면 캐시 파일이 콘텐츠 해시가 적용된 스타일시트로 출력됩니다. 10월 8일 이 사이트의 로컬 복사본에서 측정한 결과, 홈페이지 크기는 451,648에서 296,379 바이트로 줄었습니다(2026, HTML).

cache.path이(가) 비공개 볼륨을 가리키면 Blockstudio은(는) 인라인 CSS(으)로 대체됩니다. 단, blockstudio/files/url 필터가 tailwind 범위에 공개 URL를 반환하는 경우는 예외이며, 예를 들면 CDN 호스트가 있습니다.

blockstudio.json
{
  "tailwind": {
    "enabled": true,
    "output": "link"
  }
}

PHP에서 클래스 병합

bs_tw_merge()은 충돌하는 유틸리티를 정리해 직접 작성한 클래스가 기본 클래스보다 우선하도록 합니다. bs_tw_variants()은 기본 클래스, 변형, 기본값 및 복합 변형을 지정할 수 있는 함수를 반환합니다.

둘 다 TailwindPHP이 이미 번들에 포함한 Blockstudio 엔진을 사용하므로 테마에 엔진을 따로 포함할 필요가 없습니다.

index.php
echo bs_tw_merge('px-2 text-sm', 'px-4');
// text-sm px-4

$button = bs_tw_variants([
  'base' => 'inline-flex items-center',
  'variants' => [
    'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
  ],
  'defaultVariants' => ['size' => 'sm'],
]);

echo $button(['size' => 'lg', 'class' => 'rounded']);

필요할 때 정리

Runtime_Cache::purge(‘tailwind’)은(는) 컴파일된 CSS을(를) 지우며, 다음 요청에서 다시 컴파일됩니다.

선택적 페이지 버퍼

Tailwind도 블록 에셋도 사용하지 않는 사이트는 blockstudio/buffer/enabled 필터로 페이지 버퍼를 끌 수 있습니다.

소스별로 격리

논리적 검색 소스를 사용하면 선택한 소스와 런타임 컨텍스트가 캐시 네임스페이스에 포함되므로, 마지막으로 정상 작동한 CSS이(가) 미리보기 간에 유출되지 않습니다.

표준 계층 순서

Tailwind CSS에서처럼 테마, 기반, 컴포넌트, 유틸리티 순서로 적용되어 뒤의 계층이 앞의 계층을 덮어씁니다.

Plus

공식 확장 키트

프리미엄 사이트 템플릿, AI 시스템 지침, 비공개 Discord 커뮤니티를 제공합니다. 한 번 구매하면 업데이트를 평생 받을 수 있습니다.

  • 500개 이상의 사이트 템플릿
  • AI 시스템 지침
  • 평생 업데이트
  • 비공개 Discord 커뮤니티