📖チュートリアル一覧▼

Vite & TypeScript スターター

Vite

Vite は、瞬時の開発サーバー起動、超高速なホットモジュール置換(HMR)、およびネイティブ ES モジュールバンドリングを提供します。Strelit UI Kit の組み込み TypeScript 型定義と組み合わせることで、レイアウト構成全体に対する即時の自動補完と型安全性が得られます。

1. Vite + TypeScript プロジェクトの作成

# プロジェクトの作成
npm create vite@latest my-docking-app -- --template vanilla-ts

# ディレクトリに移動して依存関係をインストール
cd my-docking-app
npm install strelit-ui-kit
npm run dev

2. src/main.ts でのレイアウト設定

パッケージから直接 StrelitLayout と構成型をインポートします:

import {
  StrelitLayout,
  LayoutConfig,
  ComponentContainer,
  ComponentItemConfig,
} from 'strelit-ui-kit';
import 'strelit-ui-kit/dist/css/strelit-base.css';
import 'strelit-ui-kit/dist/css/themes/strelit-dark-theme.css';
import './style.css';

// LayoutConfig に準拠した型安全なレイアウト構成
const config: LayoutConfig = {
  header: {
    show: 'top',
    popout: 'ポップアウトウィンドウで開く',
    maximise: 'タブを最大化',
    close: 'タブを閉じる',
  },
  dimensions: {
    borderWidth: 5,
    borderGrabWidth: 5,
    defaultMinItemHeight: '120px',
    defaultMinItemWidth: '180px',
    headerHeight: 32,
  },
  root: {
    type: 'row',
    content: [
      {
        type: 'component',
        componentType: 'editorPanel',
        title: 'ソースコード',
        size: '60%',
        componentState: { initialCode: 'console.log("Hello Strelit!");' },
      },
      {
        type: 'column',
        size: '40%',
        content: [
          {
            type: 'component',
            componentType: 'terminalPanel',
            title: '出力ターミナル',
          },
          {
            type: 'component',
            componentType: 'metricsPanel',
            title: 'テレメトリ',
          },
        ],
      },
    ],
  },
};

const appRoot = document.getElementById('app');
if (!appRoot) throw new Error('Missing #app mount target');

// 1. マウントターゲット上で StrelitLayout を初期化
const layout = new StrelitLayout(appRoot);

// 2. ネイティブ DOM アクセスを備えたコンポーネントを登録
layout.registerComponentFactoryFunction(
  'editorPanel',
  (container: ComponentContainer, itemConfig) => {
    const el = container.element;
    const state = (itemConfig.componentState as { initialCode?: string }) || {};
    el.innerHTML = `
    <div class="panel-inner">
      <h3>コードエディター</h3>
      <textarea class="code-area">${state.initialCode || ''}</textarea>
    </div>
  `;
  }
);

layout.registerComponentFactoryFunction('terminalPanel', (container: ComponentContainer) => {
  container.element.innerHTML = `<div class="panel-inner"><pre>[Ready] Vite HMR active.</pre></div>`;
});

layout.registerComponentFactoryFunction('metricsPanel', (container: ComponentContainer) => {
  container.element.innerHTML = `<div class="panel-inner"><p>メモリ: 42MB | FPS: 60</p></div>`;
});

// 3. レイアウトのロード
layout.loadLayout(config);

// 4. レスポンシブな自動リサイズ
window.addEventListener('resize', () => layout.updateRootSize());

3. フルスクリーンワークスペースのスタイリング (src/style.css)

ルートの HTML、body、およびマウントポイントがビューポートの 100% に拡張されるようにします:

* {
  box-sizing: border-box;
  margin: 0;
  padding: 0;
}

html,
body,
#app {
  width: 100%;
  height: 100%;
  overflow: hidden;
  background: #0b1220;
  color: #f0f4f8;
  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
}

.panel-inner {
  padding: 16px;
  height: 100%;
  display: flex;
  flex-direction: column;
  gap: 8px;
}

.code-area {
  flex: 1;
  width: 100%;
  background: #070c16;
  border: 1px solid rgba(255, 255, 255, 0.1);
  color: #38bdf8;
  padding: 12px;
  font-family: 'Fira Code', monospace;
  font-size: 14px;
  border-radius: 6px;
  resize: none;
}

4. 本番ビルド

デプロイの準備が整ったら、最適化されたバンドルをビルドします:

npm run build

マルチ画面トレーディング端末やエンタープライズ分析ダッシュボードの構築、レガシーレイアウトからの移行など、チームとコミュニティがサポートします。

GitHub で Issue を作成 →