Guidebook
ComponentsStorybook

SolidJS · SolidStart · Routing

SolidJS와 SolidStart 페이지 라우팅

기본 요소와 레이아웃 UI 페이지를 만들고 Solid Router 또는 SolidStart 파일 기반 라우팅으로 연결합니다.

만들 경로

text/components/basic   Button · Icon · Link · Typography
/components/layout  Container · Divider · Flex · Grid · Space

page는 component를 import해 업무 화면의 heading, navigation과 여러 상태를 조합하는 route 단위 UI입니다. 재사용 component source는 src/components 또는 @uxkm/solid/*에 두고 page 안에 복제하지 않습니다.

Solid Vite: Router 연결

Solid 자체는 route 설정을 제공하지 않습니다. @solidjs/router를 사용하는 경우 URL과 page component를 route 설정에 직접 연결합니다.

textapps/solid/src/
├── pages/
│   ├── BasicPage.jsx
│   └── LayoutPage.jsx
├── App.jsx
└── index.jsx
jsximport { Route, Router } from '@solidjs/router';
import BasicPage from './pages/BasicPage';
import LayoutPage from './pages/LayoutPage';

export default function App() {
  return (
    <Router>
      <Route path="/components/basic" component={BasicPage} />
      <Route path="/components/layout" component={LayoutPage} />
    </Router>
  );
}

내부 이동에는 <A href="/components/basic">를 사용하고 hosting server의 SPA fallback을 설정합니다.

SolidStart: 파일 기반 Route

SolidStart는 src/routes 아래 파일 경로를 기준으로 route를 생성합니다.

textapps/solidstart/src/routes/
└── components/
    ├── basic.tsx    → /components/basic
    └── layout.tsx   → /components/layout
tsx// src/routes/components/basic.tsx
import Button from '@uxkm/solid/button';

export default function BasicPage() {
  return <Button variant="filled">저장</Button>;
}

SSR 환경에서는 server render 결과와 hydration 뒤 DOM이 같은지 확인합니다.

확인 순서

  1. /components/basic과 /components/layout을 직접 열어 404가 아닌지 확인합니다.
  2. client navigation과 새로고침 결과가 같은지 확인합니다.
  3. navigation 현재 항목, document title과 route 이동 focus를 확인합니다.
  4. loading·error state가 route 전환 후에도 올바르게 정리되는지 확인합니다.

공식 문서

가이드북소개기초디자인 토큰기초접근성컴포넌트기본 요소컴포넌트레이아웃컴포넌트폼컴포넌트네비게이션컴포넌트데이터 표시컴포넌트피드백컴포넌트기타활용 가이드UI 패턴활용 가이드작성 지침프레임워크프레임워크 구현프레임워크Gulp프레임워크GulpGulp 시작프레임워크GulpGulp 기본 설정프레임워크GulpGulp 기본 API프레임워크GulpHTML 편집 (Gulp NJK)프레임워크GulpWeb Server & Watching Files프레임워크GulpAssets 세팅프레임워크Gulp배포 (Deploying)프레임워크Vue프레임워크Vue빠른 시작프레임워크Vue핵심 기초프레임워크Vue상태와 반응성프레임워크Vue컴포넌트 심화프레임워크Vue페이지와 라우팅프레임워크Vue재사용성프레임워크Vue내장 컴포넌트프레임워크Vue확장하기프레임워크Vue베스트 프랙티스프레임워크VueTypeScript프레임워크Vue추가 주제프레임워크React프레임워크React빠르게 시작하기프레임워크ReactUI 표현프레임워크React조건과 목록프레임워크React상호작용프레임워크React페이지와 라우팅프레임워크ReactState 관리프레임워크React탈출구프레임워크ReactReact로 사고하기프레임워크WebSquare프레임워크WebSquare스튜디오프레임워크WebSquare화면과 이벤트프레임워크WebSquare컴포넌트프레임워크WebSquareDataCollection프레임워크WebSquareSubmission프레임워크WebSquare사용하기프레임워크WebSquareSP5 설정프레임워크WebSquare심화 가이드프레임워크Svelte프레임워크Svelte빠른 시작프레임워크Svelte핵심 기초프레임워크Svelte상태와 반응성프레임워크Svelte컴포넌트 심화프레임워크Svelte페이지와 라우팅프레임워크SvelteTypeScript프레임워크Svelte베스트 프랙티스프레임워크SolidJS프레임워크SolidJS빠른 시작프레임워크SolidJSUI 표현프레임워크SolidJSSignals와 Effects프레임워크SolidJS컴포넌트 심화프레임워크SolidJS페이지와 라우팅프레임워크SolidJS베스트 프랙티스프레임워크Qwik프레임워크Qwik빠른 시작프레임워크Qwik컴포넌트프레임워크Qwik상태와 반응성프레임워크Qwik페이지와 라우팅프레임워크Qwik베스트 프랙티스프레임워크Remix프레임워크Remix빠른 시작프레임워크RemixUI 표현프레임워크Remix페이지와 라우팅프레임워크RemixLoader와 Action프레임워크Remix베스트 프랙티스프레임워크Angular프레임워크Angular빠른 시작프레임워크Angular핵심 기초프레임워크Angular상태와 반응성프레임워크Angular컴포넌트 심화프레임워크Angular페이지와 라우팅프레임워크AngularTypeScript프레임워크Angular베스트 프랙티스프레임워크Astro프레임워크Astro빠른 시작프레임워크Astro페이지와 라우팅프레임워크AstroIslands프레임워크Astro컴포넌트 통합프레임워크Astro베스트 프랙티스