django components

ドキュメント（進行中の作業）

Django-Componentsは、Djangoのサーバー側のレンダリングにコンポーネントベースのアーキテクチャを導入するパッケージです。 Djangoのテンプレートシステムと、モダンなフロントエンドフレームワークに見られるモジュール性を組み合わせることを目指しています。

特徴

1. ？再利用可能性：自己完結型の再利用可能なUI要素の作成が可能になります。
2. ？カプセル化：各コンポーネントには、独自のHTML、CSS、およびJavaScriptを含めることができます。
3. サーバー側のレンダリング：コンポーネントがサーバー上でレンダリングされ、初期負荷時間とSEOが改善されます。
4. ？ Django Integration：テンプレートタグなどのおなじみの概念を使用して、Djangoエコシステム内で動作します。
5. ⚡非同期負荷：コンポーネントは、HTMXやAlpinejsなどのJSフレームワークとの統合のために独立して開放することができます。

潜在的な利点：

• コードの複製の削減
• モジュラー設計により保守性が向上しました
• ？複雑なUIの管理が容易です
• ？フロントエンドとバックエンド開発者の間のコラボレーションを強化しました

Django-Componentsは、UI開発へのより構造化されたアプローチを必要とする大規模なDjangoプロジェクトに特に役立ちます。

クイックスタート

Django-Componentsを使用すると、最新のアプリに必要なフロントエンドコードを生成するために必要なコードの再利用可能なブロックを作成できます。

components/calendar/calendar.pyのコンポーネントを定義します。

 @ register ( "calendar" )
class Calendar ( Component ):
    template_name = "template.html"

    def get_context_data ( self , date ):
        return { "date" : date }

このtemplate.htmlファイルを使用して：

< div class = " calendar-component " >Today's date is < span >{{ date }}</ span ></ div >

次のようなコンポーネントを使用します。

 {% component "calendar" date = "2024-11-06" %}{% endcomponent %}

そして、これがレンダリングされるものです：

 < div class =" calendar-component " > Today's date is < span > 2024-11-06 </ span > </ div >

すべてのエキサイティングな詳細と構成の可能性について学ぶために読んでください！

（代わりにコードにすぐにジャンプしたい場合は、プロジェクトのサンプルをご覧ください）

ノートをリリースします

リリースノートを読んで、最新の機能と修正を確認してください。

コミュニティの例

django-componentsの目標の1つは、プロジェクト間でコンポーネントを簡単に共有できるようにすることです。他の人に役立つと思われるコンポーネントのセットがある場合は、以下のリストにそれらを追加するためのプルリクエストを開いてください。

• Django-HTMX-Components：HTMXで使用するコンポーネントのセット。ライブデモを試してみてください。

貢献と開発

このプロジェクトを参加または後援してください - こちらを参照してください

開発のためにローカルでDjango -Componentsを実行してください - こちらを参照してください