에셋 처리
최소화
Blockstudio은 블록의 모든 CSS 및 JS 파일을 자동으로 최소화할 수 있습니다.
컴파일된 파일은 블록의 _dist 폴더에 저장되며 블록을 사용할 때 등록됩니다. 소스 파일이 업데이트되면 Blockstudio가 타임스탬프가 일치하는 컴파일 파일이 있는지 확인하고, 없으면 새로 생성합니다.
이 작업에는 minify 라이브러리를 사용합니다.
assets/minify 설정으로 최소화를 활성화할 수 있습니다:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
스타일을 SCSS로 작성하려면 SCSS 처리를 활성화할 수 있습니다:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
이 설정을 켜면 .css 파일에 SCSS 처리가 적용됩니다.
또는 .scss 확장자를 사용할 수 있습니다. 이 경우 위 설정이 true 상태여도 스타일이 자동으로 처리됩니다.
가져오기 경로
SCSS를 사용하면 다른 SCSS 파일을 가져올 수 있습니다. 가져오기 경로는 해당 파일을 가져오는 파일을 기준으로 합니다.
@import "modules.scss";
또한 blockstudio/assets/process/scss/import_paths 필터를 사용해 사용자 지정 가져오기 경로를 정의하면 폴더 구조를 지정하지 않고도 다른 디렉터리의 파일을 가져올 수 있습니다.
가져오기에서는 .scss 확장자를 생략할 수 있으며, _tokens.scss 같은 부분 파일이나 디렉터리의 _index.scss를 불러올 수 있습니다.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
프리루드
모든 SCSS 파일에서 공통 Sass 함수, 변수, 믹스인 또는 유틸리티를 사용할 수 있도록 컴파일 전에 전역 프리루드를 앞에 추가할 수 있습니다.
이는 Bootstrap 같은 프레임워크에서 유용합니다. 각 블록 에셋에서 가져오기를 반복하지 않고도 브레이크포인트 같은 공통 믹스인을 사용할 수 있습니다.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
blockstudio/assets/process/scss/import_paths와 결합하면 참조된 Sass 표면을 모든 컴파일 파일에서 사용할 수 있습니다.
다른 부분 파일이 가져오는 파일을 포함해 종속 파일의 수정 시간이 바뀌면 블록 에셋을 다시 컴파일합니다. Blockstudio는 프리루드 종속 파일과 설정된 가져오기 경로를 포함해 로컬 @import, @use, @forward 종속 파일을 추적합니다. 공통 종속 파일은 한 번만 추적하며, 순환 참조가 탐색을 무한 반복시키지 않습니다. 이 파일들은 런타임 캐시 감시 목록에도 포함됩니다.
예를 들어 mixins/_wysiwyg.scss을 편집하면 scss/_wysiwyg.scss을 가져오는 global-styles.scss이 다시 컴파일되고, 이 파일은 해당 믹스인을 가져옵니다. 변경 사항을 적용하기 위해 진입 파일을 수정할 필요는 없습니다. Sass 기본 제공 모듈과 원격 가져오기는 로컬 종속성 그래프에서 제외됩니다.
ES 모듈
Blockstudio의 모든 스크립트(인라인 및 기본)는 기본적으로 type="module"이 적용된 상태로 로드됩니다. 따라서 추가 설정 없이 블록 스크립트에서 import 구문을 사용할 수 있습니다.
참고
ES 모듈을 자세히 알아보려면 MDN 웹 문서를 참조하세요.
script.js 내부에 다음 코드를 작성한다고 가정해 보겠습니다:
import { h, render } from "https://esm.sh/preact@10.15.1";
import htm from "https://esm.sh/htm@3.1.1";
import confetti from "https://esm.sh/canvas-confetti@1.6.0";
const html = htm.bind(h);
function App(props) {
confetti();
return html`<h1>Hello ${props.name}!</h1>`;
}
render(
html`<${App} name="Hello from Preact!" />`,
document.querySelector("#element")
);
위 예시에서는 Preact를 사용해 컴포넌트를 만들고, ESM 호환 CDN에서 필요한 모든 컴포넌트와 함수를 가져옵니다. 여기서는 esm.sh를 사용합니다. 이 방법에 문제가 있는 것은 아니지만, 필요한 에셋을 외부 사이트에서 가져와야 하므로 CDN가 중단되면 스크립트가 작동하지 않을 수 있습니다.
Blockstudio에는 ES 모듈을 블록에 다운로드하는 편리한 기능이 있어, 프로덕션 환경에서 외부 ESM CDN이 필요하지 않습니다.
설정
모듈을 블록 디렉터리에 다운로드하려면 npm: 접두사 뒤에 패키지 이름과 버전을 입력합니다:
import { h, render } from "npm:preact@10.15.1";
import htm from "npm:htm@3.1.1";
import confetti from "npm:canvas-confetti@1.6.0";
이 구문은 Deno의 npm 지정자 규칙을 따릅니다.
참고
기존
blockstudio/접두사(e.g.,blockstudio/preact@10.15.1)도 이전 버전과의 호환성을 위해 계속 지원되지만, 새 프로젝트에는npm:접두사를 사용하는 것이 좋습니다. 자세한 내용은 마이그레이션 안내를 참조하세요.
Blockstudio는 변경된 .js 파일에서 가져오기를 자동으로 확인하고 로컬 블록 디렉터리에 다운로드합니다. 다운로드한 파일은 블록 디렉터리의 modules 폴더에 저장됩니다.
로컬 호스팅 모듈을 사용하도록 저장할 때 스크립트 파일을 다시 작성합니다:
import { h, render } from "./modules/preact/10.15.1.js";
import htm from "./modules/htm/10.15.1.js";
import confetti from "./modules/canvas-confetti/1.6.0.js";
편집기에서 블록을 미리 보고 작업할 때는 esm.sh를 사용하는 Blockstudio에서 CDN URL이 계속 사용됩니다.
유의 사항
버전
일반적으로 CDN 모듈은 버전 번호 없이 사용할 수 있으며, 이 경우 항상 최신 버전이 사용됩니다. Blockstudio는 데이터베이스에 정보를 저장하지 않으므로 모듈을 사용할 때 버전 번호가 필요합니다.
동일한 모듈
모듈은 각 블록에 한정됩니다. 여러 블록에서 같은 버전의 동일한 모듈을 사용하더라도 Blockstudio는 요청된 모듈을 각 블록에 다운로드합니다. 블록은 다른 설치 환경이나 사이트와 쉽게 공유할 수 있는 독립적인 단위여야 하기 때문입니다.
또한 두 블록이 한 페이지에 모두 있으면 동일한 모듈을 두 번 요청합니다. script.js 파일 대신 script-inline.js를 사용하면 이 문제를 해결할 수 있습니다. Blockstudio는 이름과 버전 번호가 같을 경우 각 가져오기를 모듈이 처음 나타난 위치로 다시 작성합니다.
CSS 로더
위와 같은 구문으로 CSS 파일도 가져올 수 있습니다.
import "npm:swiper@11.0.0/swiper.min.css";
CSS 파일은 modules 폴더에 다운로드되며, 블록을 사용할 때 자동으로 등록됩니다. 버전이 같으면 여러 블록에 CSS 파일이 있어도 한 버전만 등록됩니다.