インポート
Astroは、ほとんどの静的アセットを設定不要でサポートしています。プロジェクトのJavaScript（Astro frontmatterスクリプトを含む）のどこでもimport文を使用でき、Astroは最終ビルドにその静的アセットのビルドされた最適化されたコピーを含めます。また、@importはCSSと<style>タグの中でもサポートされています。
対応するファイル形式
セクションタイトル： 対応するファイル形式Astroは、標準で以下のファイル形式をサポートしています。
- Astroコンポーネント（
.astro） - Markdown（
.md,.markdownなど） - JavaScript（
.js、.mjs） - TypeScript（
.ts、.tsx） - NPMパッケージ
- JSON（
.json） - JSX（
.jsx、.tsx） - CSS（
.css） - CSS Modules（
.module.css） - イメージとアセット（
.svg、.jpg、.pngなど）
さらに、Astroを拡張して、React、Svelte、Vueコンポーネントなど、さまざまなUIフレームワークのサポートを追加できます。また、Astro MDXインテグレーションをインストールし、プロジェクトで.mdxファイルを使用することもできます。
public/内のファイル
セクションタイトル： public/内のファイルプロジェクトのpublic/ディレクトリには、任意の静的アセットを置けます。Astroはそれをそのまま最終ビルドとして直接コピーします。HTMLテンプレートの中では、public/内のファイルをURLパスで直接参照できます。
Import構文
セクションタイトル： Import構文Astroは、ESMを使います。これは、ブラウザでサポートされているのと同じimportおよびexport構文です。
JavaScript
セクションタイトル： JavaScriptimport { getUser } from './user.js';JavaScriptは、通常のESMのimportとexportの構文でインポートできます。
TypeScript
セクションタイトル： TypeScriptimport { getUser } from './user';import type { UserType } from './user';Astroには、TypeScriptのサポートが組み込まれています。Astroプロジェクトで.tsや .tsxファイルを直接インポートしたり、Astroのコンポーネントスクリプトや 巻き上げられたscriptタグの中で直接TypeScriptコードを書けます。
Astroは、型チェックを自ら行うことはありません。型チェックは、IDEや別のスクリプトなど、Astroの外部で行う必要があります。Astroファイルの型チェックには、astro checkコマンドが用意されています。
JSX / TSX
セクションタイトル： JSX / TSXimport { MyComponent } from './MyComponent.jsx';Astroには、プロジェクトにJSX（*.jsxと*.tsx）ファイルのサポートが組み込まれています。JSXの構文は、自動的にJavaScriptにトランスパイルされます。
AstroはJSX構文を標準で理解できますが、React、Preact、Solidなどのフレームワークを適切にレンダリングするには、フレームワークのインテグレーションをインストールする必要があります。詳しくは、インテグレーションガイドをご覧ください。
npmパッケージ
セクションタイトル： npmパッケージnpmパッケージをインストールした場合、Astroでインポートできます。
---import { Icon } from 'astro-icon';---パッケージがレガシーフォーマットを使用して公開されていた場合、Astroはimport文が機能するように、パッケージをESMに変換します。場合によっては、動作させるためにvite configを調整する必要があるかもしれません。
JSON
セクションタイトル： JSON// デフォルトのエクスポートでJSONオブジェクトを読み込むimport json from './data.json';Astroは、JSONファイルをアプリケーションへ直接インポートできます。インポートされたファイルは、デフォルトのインポートで完全なJSONオブジェクトを返します。
// 'style.css'を読み込んで、ページに注入します。import './style.css';Astroは、CSSファイルをアプリケーションに直接インポートできます。インポートされたスタイルはエクスポートされませんが、インポートすることで自動的にそれらのスタイルがページに追加されます。これはデフォルトですべてのCSSファイルに対して機能し、プラグインによってSassやLessのようなコンパイル可能なCSS言語もサポートします。
CSSモジュール
セクションタイトル： CSSモジュール// 1. './style.module.css'のクラス名をユニークでスコープされた値に変換します。// 2. 元のクラス名と、最終的にスコープされた値をマッピングしたオブジェクトを返します。import styles from './style.module.css';
// この例ではJSXを使っていますが、CSSモジュールはどんなフレームワークでも使えます。return <div className={styles.error}>Your Error Message</div>;Astroは、[name].module.cssという命名規則でCSSモジュールをサポートしています。他のCSSファイルと同様に、インポートすると自動的にそのCSSがページに適用されます。しかし、CSSモジュールは、オリジナルのクラス名を一意の識別子にマップする特別なデフォルトの styles オブジェクトをエクスポートします。
CSSモジュールは、スタイルシートのために一意に生成されたクラス名によって、フロントエンドでコンポーネントのスコープと分離を強制するのに役立ちます。
その他のアセット
セクションタイトル： その他のアセットimport imgReference from './image.png'; // img === '/src/image.png'import svgReference from './image.svg'; // svg === '/src/image.svg'import txtReference from './words.txt'; // txt === '/src/words.txt'
// この例ではJSXを使用していますが、どのようなフレームワークでもインポート参照を使用できます。<img src={imgReference.src} alt="画像の説明" />;上記で明示されていないその他のアセットは、ESMの import を使ってインポートすることができ、最終的にビルドされたアセットへのURLリファレンスを返します。これは、JS以外のアセットをURLで参照する場合に便利です。たとえば、画像要素を作成して、その画像を指すsrc属性を指定できます。
また、ディレクトリ構造で説明されているように、画像はpublic/フォルダに配置するのも便利です。
Astro.glob()
セクションタイトル： Astro.glob()Astro.glob()は、多数のファイルを一度にインポートするための方法です。
Astro.glob()は、インポートしたいローカルファイルと一致する相対globパターンを1つのパラメータとして受け取るだけです。これは非同期で、マッチした各ファイルのエクスポートを配列で返します。
---// `./src/pages/post/`の`.md`で終わるすべてのファイルをインポートconst posts = await Astro.glob('../pages/post/*.md');---<!-- ブログ投稿の最初の5つの<article>をレンダリング --><div>{posts.slice(0, 4).map((post) => ( <article> <h2>{post.frontmatter.title}</h2> <p>{post.frontmatter.description}</p> <a href={post.url}>もっと読む</a> </article>))}</div>Astro.globを使用してインポートされたAstroコンポーネントは、AstroInstance型です。各コンポーネントのインスタンスは、そのdefaultプロパティを使用してレンダリングできます。
---// `./src/components/`の`.astro`で終わるすべてのファイルをインポートconst components = await Astro.glob('../components/*.astro');---<!-- すべてのコンポーネントを表示 -->{components.map((component) => ( <div> <component.default size={24} /> </div>))}globパターン
セクションタイトル： globパターンglobパターンは、特殊なワイルドカード文字をサポートするファイルパスです。プロジェクト内の複数のファイルを一度に参照する場合に使用します。
たとえば、globパターン./pages/**/*.{md,mdx}は、pagesサブディレクトリで始まり、そのサブディレクトリをすべて調べ（/**）、 ファイル名（/*）が.mdまたは.mdxで終わる（.{md,mdx})ファイルにマッチします。
Astroのglobパターン
セクションタイトル： AstroのglobパターンAstro.glob()で使用する場合、globパターンは文字列リテラルである必要があり、変数を含むことはできません。回避策については、トラブルシューティングガイドを参照してください。
また、グロブパターンは、以下のいずれかで始まる必要があります。
./（カレントディレクトリで起動する）../（親ディレクトリから開始する場合）/（プロジェクトのルートから開始する場合）
globパターンの構文について、詳しくはこちらをご覧ください。
Astro.glob()とgetCollection()
セクションタイトル： Astro.glob()とgetCollection()コンテンツコレクションは、Astro.glob()の代わりに複数のファイルを読み込むためのgetCollection() APIを提供します。コンテンツファイル（Markdown、MDX、Markdocなど）がsrc/content/ディレクトリ内のコレクションに配置されている場合、getCollection()を使用してコレクションのクエリを行い、コンテンツのエントリーを返します。
WASM
セクションタイトル： WASM// 要求されたWASMファイルをロードして初期化するconst wasm = await WebAssembly.instantiateStreaming(fetch('/example.wasm'));Astroは、ブラウザのWebAssembly APIを使用して、WASMファイルをアプリケーションに直接読み込むことをサポートしています。
Nodeビルトイン
セクションタイトル： NodeビルトインAstroのユーザーには、可能な限りNode.jsのビルトイン（fs、pathなど）を避けることをおすすめします。Astroは、アダプターを使用して複数のランタイムと互換性があります。これには、fsなどのNodeビルトインモジュールをサポートしないDenoやCloudflare Workersが含まれます。
私たちの目的は、一般的なNode.jsのビルトインに対するAstroの代替機能を提供することです。しかし、今のところそのような代替機能は存在しません。ですから、もし本当にこれらのビルトインモジュールを使う必要があるのなら、それを止めたいとは思いません。AstroはNode.jsのビルトインを、Nodeの新しいプレフィックスであるnode:を使ってサポートしています。たとえば、ファイルを読み込む場合、次のようにします。
---// 例: Node.js から "fs/promises" ビルトインをインポートします。import fs from 'node:fs/promises';
const url = new URL('../../package.json', import.meta.url);const json = await fs.readFile(url, 'utf-8');const data = JSON.parse(json);---
<span>Version: {data.version}</span>ファイル形式のサポートを拡張
セクションタイトル： ファイル形式のサポートを拡張Viteと互換性のあるRollupプラグインを使用すると、Astroがネイティブでサポートしていないファイル形式をインポートできます。必要なプラグインがどこにあるかは、Viteドキュメントのプラグインの検索セクションを参照してください。
関連レシピ：
ViteまたはRollupプラグインをインストールする