@@ -24,8 +24,8 @@ DjangoStarter 是下一代 Django 项目快速开发模板,专为提升开发
2424- 模板引擎: Django Templates
2525- 交互框架: HTMX
2626- JavaScript框架: Alpine.js
27- - CSS框架: TailwindCSS
28- - 组件库: Flowbite
27+ - CSS框架: TailwindCSS v4
28+ - 组件库: DaisyUI v5 (Pure CSS)
2929- 图标: Font Awesome Free 6
3030- 动画: AOS (Animate On Scroll)
3131
@@ -245,7 +245,9 @@ def list_users(request):
245245
246246### Django View
247247
248- - 在 context 中传入 title 和 breadcrumbs,示例代码:
248+ - ** 页面元数据** : 每个返回独立页面的视图函数(View)必须在 context 中定义 ` title ` 和 ` breadcrumbs ` ,以保证统一的页面标题显示和导航体验。
249+
250+ 示例代码:
249251
250252 ``` python
251253 context = {
@@ -267,6 +269,7 @@ def list_users(request):
267269- 在各个 app 下创建 templates 目录编写前端页面代码,不要直接修改 src\templates 里的代码
268270- DjangoStarter 提供 page_header 组件用于渲染标准页面标题和面包屑导航,位于 ` django_starter/contrib/navbar/templatetags/page_tags.py ` 内,使用时在模板代码顶部引入: ` {% load page_tags %} `
269271- 根据具体情况选择合适的交互方式,DjangoStarter 默认已集成 HTMX / Alpine.js 相关依赖和配置
272+ - ** 页面布局** : 默认使用 DaisyUI Drawer 布局,主内容区在 ` block content ` 中。
270273
271274示例页面代码:
272275
@@ -284,6 +287,15 @@ def list_users(request):
284287{% block content %}
285288{% page_header title breadcrumbs %}
286289<!-- 页面主体内容,外部已有 container 容器,这里直接写页面内容元素 -->
290+ <div class =" card bg-base-100 shadow-xl" >
291+ <div class =" card-body" >
292+ <h2 class =" card-title" >Card Title</h2 >
293+ <p >Content goes here...</p >
294+ <div class =" card-actions justify-end" >
295+ <button class =" btn btn-primary" >Action</button >
296+ </div >
297+ </div >
298+ </div >
287299{% endblock %}
288300
289301<!-- Alpine.js 交互脚本 -->
@@ -300,11 +312,12 @@ def list_users(request):
300312
301313#### CSS/TailwindCSS规范
302314
303- - 优先使用 flowbite 组件库已有组件,保持界面设计风格统一
304- - 使用 TailwindCSS 工具类
305- - 避免直接使用 CSS
306- - 使用响应式设计原则
307- - 遵循移动优先的设计理念
315+ - ** 优先使用 DaisyUI 组件类** (如 ` btn btn-primary ` , ` card ` , ` input input-bordered ` ),减少冗长的 Utility Classes。
316+ - 使用daisyui MCP查询组件列表和组件的类名。
317+ - 使用 TailwindCSS 工具类处理布局和微调。
318+ - 避免直接使用 CSS,利用 DaisyUI 的 Design Tokens (如 ` bg-base-100 ` , ` text-primary ` ) 确保 Light/Dark 主题适配。
319+ - 使用响应式设计原则。
320+ - 遵循移动优先的设计理念。
308321
309322### 测试规范
310323
0 commit comments