インストール
Reveal SDK の Web Component ラッパーは現在開発中です。最終リリースに向けて改善を重ねておりますので、ぜひご意見・ご要望をお寄せください。
ラッパーに関するドキュメントも現在作成中ですが、完成を待たずに皆さまに共有させていただいています。
Reveal SDK Web Component ラッパーをプロジェクトに統合するのは簡単です。シンプルなセットアップのために CDN を使用する場合でも、npm 経由でローカルにインストールする場合でも、ニーズに応じた方法をご用意しています。React、Vue、Angular など特定のフレームワークを使用している場合は、それぞれの統合ガイドをご参照ください。
前提条件
Reveal SDK Web Component ラッパーが正しく機能するには、Reveal SDK クライアント ライブラリをインストールする必要があります。Reveal SDK Web Component ラッパーは既存の jQuery ベースの RevealView を中心に構築されるため、これらの依存関係は不可欠です。
<script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/dayjs@1.8.21/dayjs.min.js"></script>
<script src="https://dl.revealbi.io/reveal/libs/1.7.5/infragistics.reveal.js"></script>
<script>
// Change to your Reveal SDK server URL
$.ig.RevealSdkSettings.setBaseUrl("https://samples.revealbi.io/upmedia-backend/reveal-api/");
</script>
Reveal SDK の設定の詳細については、イン ストール ドキュメントを参照してください。
CDN のインストール
もっとも簡単な導入方法として、CDN を使用することができます。Reveal SDK Web Component ラッパーを HTML に直接読み込むだけで利用可能です。
<script src="https://cdn.jsdelivr.net/npm/reveal-sdk-wrappers/index.umd.min.js"></script>
NPM のインストール
ローカルでのインストールやバージョン管理を行いたい場合は、npm 経由で Reveal SDK Web Component ラッパーを導入できます。
手順 1: パッケージのインストール
Web Component ラッパーをインストールするには、プロジェクト ディレクトリで次のコマンドを実行します。
- npm
- Yarn
- pnpm
npm install reveal-sdk-wrappers
yarn add reveal-sdk-wrappers
pnpm add reveal-sdk-wrappers
手順 2: コンポーネントの登録
インストール後、Web Components をアプリケーションに登録する必要があります。デフォルトでは、すべての Reveal SDK Web Component ラッパーがグローバルに登録され、個別のインポートなしに使用できま す。
import { defineRevealSdkWrappers } from "reveal-sdk-wrappers";
defineRevealSdkWrappers();
手順 3: バンドル サイズの最適化 (オプション)
特定のコンポーネントのみをインポートしてバンドル サイズを最適化したい場合は、必要に応じて個々のコンポーネントを登録できます。
import { defineRevealSdkWrappers, RvRevealView } from "reveal-sdk-wrappers";
defineRevealSdkWrappers(RvRevealView);
コンポーネントの追加
rv-reveal-view
コンポーネントの使用を開始するには、これを HTML に含めます。
<rv-reveal-view></rv-reveal-view>
以上の手順に従うことで、Reveal SDK Web Component ラッパーをプロジェクトに統合し、強力なデータ可視化やインタラクティブなダッシュボード機能をすぐに利用できるようになります。SDK の豊富なコンポーネントやカスタマイズ オプションを活用して、ユーザーにとって魅力的でシームレスな体験を提供しましょう。