eslint-plugin-kepler) は、Vegaアプリ用の自動リンティングルールを提供して、パフォーマンスと互換性に関する問題の検出と修正を支援します。
前提条件
プラグインとその依存関係をインストールします。プラグインの構成
-
.eslintrc構成ファイルのextends、plugins、overridesセクションを更新します。kepler構成にはすべてのVegaルールが含まれています。ルールのサブセットを使用する場合は、すべてのルールを導入せずに、以下の1つ以上の構成 (拡張機能) を導入してください。performance- パフォーマンス関連ルールのみsystem-distributed-libs- システム分散ライブラリチェックのみ(package.jsonの検証とインポートの情報フラグ)accessibility- アクセシビリティルールのみ
アクセシビリティルールのみを使用するには:ファイルを保存します。これにより、次回リンターを実行したときにESLintがVegaのルールを読み込むようになります。 - (任意)Lintルールをカスタマイズする手順については、ESLintのConfigure Rulesガイドを参照してください。 この手順をスキップする場合は、すべてのルールがデフォルトの重大度で実行されます。 Vega ESLintプラグインに備わっているルールについては、 Understand the performance rules(英語のみ)、Understand the system distributed library rules(英語のみ)、Understand the accessibility rules(英語のみ)を参照してください。
-
package.jsonファイルのlintスクリプトでカスタムフォーマッターを指定します。これで、lintスクリプトはVegaカスタムフォーマッターを使用するようになりました。 -
リンターを実行します。
package.json警告が表示されない場合は、必ず、jsonc-eslint-parserをインストールするとともにeslintコマンドにpackage.jsonを渡します。 結果はコンソールで確認できます。
リンターはHTMLレポートも生成します。
VS Codeでコードにカーソルを合わせると、これらのリンターの警告を確認できます。
パフォーマンスのルールについて
次のルールを使用すると、Vegaアプリの一般的なパフォーマンス問題を特定し、最適なランタイムパフォーマンスを実現するためのベストプラクティスを実施できます。 このページにあるルールテーブルにおいて、重大度Errorのルールでは、問題にフラグが付けられ、ビルドが不合格とされます。重大度Warnのルールでは、問題にフラグが付けられますが、ビルドは不合格とはされません。
システム分散ライブラリのルールについて
次のルールは、システム分散ライブラリの使用状況を検出し、適切な実装のためのガイドを提供します。(任意)セマンティックバージョンのガイダンスの構成
システム分散ライブラリのルールでは、package.jsonの依存関係のセマンティックバージョニングを確認します。デフォルトでは、プラグインは自動モードを使用してプロジェクトのバージョニング設定を検出します。
デフォルトをオーバーライドするには、semverGuidanceオプションを設定します。
- パッチ専用モード (
semverGuidance: "patch"):~プレフィックスを使用するパッチのみにアップデートを制限します。 - マイナーおよびパッチモード (
semverGuidance: "minor"): マイナーアップデートを許可するには、^プレフィックスを使用します。 - 自動モード (
semverGuidance: "auto"): プロジェクトリポジトリ内のプロジェクト署名に基づいて設定を検出します。これがデフォルトです。
アクセシビリティルールの概要
以下のルールは、スクリーンリーダーなどの支援技術では記述できない、または正しく動作できないコンポーネントにフラグを付けます。これらのルールがチェックするアクセシビリティプロパティに関するガイダンスについては、React Native 0.83またはReact Native 0.72の「Accessibility」(英語のみ)を参照してください。
アクセシビリティルールの重大度を変更するには、ESLint構成の
rulesセクションでそれをオーバーライドします。
(任意)JSON検証用のVS Codeの構成
VS Codeのpackage.jsonにあるエラーと警告を確認するには、以下のようにこれらのsettings.jsonエントリにjsonを追加してください。

