django components

文檔（正在進行的工作）

Django-Components是一個包裝，將基於組件的體系結構引入Django的服務器端渲染。它旨在將Django的模板系統與現代前端框架中看到的模塊化結合在一起。

特徵

1. ？可重複性：允許創建獨立的，可重複使用的UI元素。
2. ？封裝：每個組件都可以包括其自己的HTML，CSS和JavaScript。
3. 服務器端渲染：在服務器上渲染的組件，改善初始加載時間和SEO。
4. ？ Django集成：使用諸如模板標籤之類的熟悉概念在Django生態系統中起作用。
5. ⚡異步加載：組件可以獨立地與HTMX或Alpinejs這樣的JS框架集成。

潛在好處：

• 減少了代碼重複
• 通過模塊化設計提高可維護性
• ？複雜UI的更容易管理
• ？前端和後端開發人員之間的合作增強

Django組件對於需要更結構化的UI開發方法的大型Django項目特別有用，而無需轉移到單獨的前端框架。

Quickstart

Django組件使您可以創建可重複使用的代碼塊，以生成現代應用所需的前端代碼。

在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目標之一是使在項目之間共享組件變得容易。如果您認為您認為對他人有用的組件集，請打開拉動請求，將它們添加到下面的列表中。

• DJANGO-HTMX-COMPONENT：一組用於HTMX的組件。嘗試現場演示。

貢獻和發展

參與或贊助此項目 - 請參閱此處

在本地運行Django -Components以進行開發 - 請參閱此處