注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
ウィジェットセットを使用すると、1つのコードリポジトリから複数のウィジェットを公開し、コードの共有やパフォーマンスの最適化を行えます。このページでは、ウィジェットセットにウィジェットを追加する方法を説明します。React、Vite、および @osdk/widget.vite-plugin ↗ を使用する、提供されているテンプレートを基にしたプロジェクト構造を前提としています。
ウィジェットセットには最大50個のウィジェットを含めることができます。
次のプロジェクト構造には2個のウィジェットが含まれています。
Copied!1 2 3 4 5 6 7 8 9 10 11repo/ ├── src/ │ ├── first.tsx │ ├── first.config.ts │ ├── second.tsx │ ├── second.config.ts │ └── ... │── first.html │── second.html │── vite.config.ts └─ ...
新しい TypeScript ファイルを作成し、型安全性を確保するために defineConfig を使用してウィジェットのメタデータを定義します。
Copied!1 2 3 4 5 6 7 8 9 10import { defineConfig } from "@osdk/widget.client"; export default defineConfig({ id: "secondWidgetId", name: "Second Widget", description: "A second widget", type: "workshop", parameters: {}, events: {}, });
ウィジェットをレンダリングするエントリーポイントとして新しい TypeScript ファイルを作成し、パラメーターとイベントのコンテキストを提供します。
Copied!1 2 3 4 5 6 7 8 9 10 11import { FoundryWidget } from "@osdk/widget.client-react"; import { createRoot } from "react-dom/client"; import Second from "./second.config.js"; const root = document.getElementById("root")!; createRoot(root).render( <FoundryWidget config={Second}> {/* Render something for the widget! */} </FoundryWidget>, );
エントリーポイントのスクリプトを読み込むための新しい HTML ファイルを作成します。
Copied!1 2 3 4 5 6 7 8 9 10 11<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Widget: Ontology SDK + React</title> </head> <body> <script type="module" src="/src/second.tsx"></script> </body> </html>
ビルド時に新しい HTML ファイルが含まれるように Vite を設定します。
Copied!1 2 3 4 5 6 7 8 9 10 11import foundryWidgetPlugin from "@osdk/widget.vite-plugin"; import { defineConfig } from "vite"; export default defineConfig({ plugins: [foundryWidgetPlugin()], build: { rollupOptions: { input: ["./first.html", "./second.html"], }, }, });
npm run build を実行します。本番ビルドで生成される .palantir/widgets.config.json マニフェストに、追加のウィジェットが含まれるようになります。
開発モードを使用して、カスタムウィジェットのプレイグラウンドまたは VS Code ワークスペースで未公開のウィジェットをプレビューします。開発を続ける前にウィジェットを公開する必要はありません。
Workshop で追加のウィジェットを選択できるようにするには、ウィジェットセットの新しいバージョンを公開する必要があります。初回リリース後は、開発モードを使用して、その後の未公開の変更を Workshop で直接プレビューできます。