odoo-owl

Odoo OWL

Odoo アドオンまたは単独の Owl アプリケーションで OWL フロントエンドを扱う場合は、このスキルを使用してください。

最初に行うこと

OWL 3 だと決めつけないでください。まず、ローカルのソースとプロジェクトのコードから、実際の OWL／Odoo フロントエンドのバージョンを特定してください。

• ブランチ、マニフェスト、ドキュメント、設定から Odoo のバージョンを確認します。
• $ODOO_SOURCE が設定されている場合は、その配下のローカル OWL ソースを確認します。特に addons/web/static/lib/owl または同等の場所を確認してください。
• @odoo/owl、owl、@web/* からの既存のインポートと、ローカルのフロントエンド規約を確認します。
• __manifest__.py のアセット宣言と、既存の static/src/js、static/src/xml、static/src/scss のパターンを確認します。

ターゲットのプロジェクトが実際に OWL 3 を使用している場合に限り、OWL 3 のリファレンスを使用してください。古い Odoo バージョンでは、このスキルにある OWL 3 の説明よりも、ローカルのソースと既存のプロジェクト規約を優先してください。

タスクに応じた参照先

• OWL コンポーネントの構築や変更には、OWL3-CORE.md、OWL3-TEMPLATES.md、OWL3-STATE-LIFECYCLE.md を使用します。
• Odoo のアセット／ウェブクライアントとの統合には、OWL3-ODOO-INTEGRATION.md と ASSETS.md を使用します。
• フィールドウィジェットの構築やレビューには、FIELD-WIDGETS.md を使用します。
• OWL 1／2 のコードを OWL 3 に移行するには、OWL3-MIGRATION.md を使用します。ただし、事前にローカルでの互換性を確認してください。
• フロントエンドのガイドラインやスタイルの確認には、odoo-code-review を併用します。
• Odoo フロントエンドの動作不良のデバッグには、OWL-DEBUGGING.md を使用し、odoo のデバッグワークフローを併用して、ブラウザー／アセット／テストの境界を確認します。
• OWL コンポーネント、ウィジェット、サービス、レジストリのテストには、odoo-web-testing と OWL-TESTING.md を併用します。

常に適用すること

UI の状態は明示的かつリアクティブに保ってください。明確な props とイベントを備えた小さなコンポーネントを優先してください。props の変更は避けてください。ライフサイクルフックを使って、リスナーや外部リソースをクリーンアップしてください。安全でない HTML はセキュリティ境界として扱ってください。OWL の動作を疑う前に、アセットバンドルへの登録とテンプレートの読み込みを確認してください。