django components

Dokumen (pekerjaan sedang berlangsung)

Django-Components adalah paket yang memperkenalkan arsitektur berbasis komponen untuk rendering sisi server Django. Ini bertujuan untuk menggabungkan sistem templating Django dengan modularitas yang terlihat dalam kerangka kerja frontend modern.

Fitur

1. ? Reusability: Memungkinkan penciptaan elemen UI mandiri dan dapat digunakan kembali.
2. ? Encapsulation: Setiap komponen dapat menyertakan HTML, CSS, dan JavaScript sendiri.
3. Rendering sisi server: Komponen render di server, meningkatkan waktu pemuatan awal dan SEO.
4. ? Integrasi Django: Bekerja di dalam ekosistem Django, menggunakan konsep -konsep yang akrab seperti tag templat.
5. ⚡ Pemuatan asinkron: Komponen dapat membuat terbuka secara mandiri untuk integrasi dengan kerangka kerja JS seperti HTMX atau Alpinejs.

Manfaat potensial:

• Mengurangi duplikasi kode
• Peningkatan pemeliharaan melalui desain modular
• ? Manajemen UI kompleks yang lebih mudah
• ? Peningkatan kolaborasi antara pengembang Frontend dan Backend

Komponen Django dapat sangat berguna untuk proyek Django yang lebih besar yang membutuhkan pendekatan yang lebih terstruktur untuk pengembangan UI, tanpa memerlukan pergeseran ke kerangka kerja frontend yang terpisah.

QuickStart

Django-Components memungkinkan Anda membuat blok kode yang dapat digunakan kembali yang diperlukan untuk menghasilkan kode ujung depan yang Anda butuhkan untuk aplikasi modern.

Tentukan komponen dalam components/calendar/calendar.py seperti ini:

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

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

Dengan file template.html ini:

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

Gunakan komponen seperti ini:

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

Dan inilah yang diterjemahkan:

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

Baca terus untuk mempelajari semua detail menarik dan kemungkinan konfigurasi!

(Jika Anda lebih suka langsung masuk ke kode, lihat proyek contoh)

Catatan Rilis

Baca catatan rilis untuk melihat fitur dan perbaikan terbaru.

Contoh komunitas

Salah satu tujuan kami dengan django-components adalah memudahkan untuk berbagi komponen antar proyek. Jika Anda memiliki satu set komponen yang menurut Anda akan berguna bagi orang lain, silakan buka permintaan tarik untuk menambahkannya ke daftar di bawah ini.

• Django-htmx-komponen: satu set komponen untuk digunakan dengan htmx. Cobalah demo langsung.

Berkontribusi dan pengembangan

Terlibat atau mensponsori proyek ini - lihat di sini

Menjalankan Komponen Django secara lokal untuk pengembangan - lihat di sini