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以进行开发 - 请参阅此处