Django Searchable Select 使用教程

Django Searchable Select 使用教程

django-searchable-selectA better and faster multiple selection widget with suggestions项目地址:https://gitcode.com/gh_mirrors/dj/django-searchable-select

1. 项目的目录结构及介绍

django-searchable-select/
├── django_searchable_select/
│   ├── __init__.py
│   ├── forms.py
│   ├── models.py
│   ├── urls.py
│   ├── views.py
│   ├── widgets.py
│   ├── static/
│   │   └── django_searchable_select/
│   │       ├── css/
│   │       │   └── searchable_select.css
│   │       └── js/
│   │           └── searchable_select.js
│   └── templates/
│       └── django_searchable_select/
│           └── searchable_select.html
├── manage.py
├── README.md
└── setup.py

• django_searchable_select/: 项目的主目录，包含了所有的Python模块和静态文件。
  • __init__.py: 初始化文件，使目录成为一个Python包。
  • forms.py: 包含表单相关的代码。
  • models.py: 包含模型相关的代码。
  • urls.py: 包含URL配置。
  • views.py: 包含视图相关的代码。
  • widgets.py: 包含自定义的搜索选择小部件。
  • static/: 静态文件目录，包含CSS和JavaScript文件。
  • templates/: 模板文件目录，包含HTML模板。
• manage.py: Django项目的管理脚本。
• README.md: 项目的说明文档。
• setup.py: 项目的安装脚本。

2. 项目的启动文件介绍

manage.py 是 Django 项目的管理脚本，用于启动开发服务器、运行迁移、创建超级用户等。

python manage.py runserver

这条命令会启动 Django 的开发服务器，默认运行在 http://127.0.0.1:8000/。

3. 项目的配置文件介绍

在 Django 项目中，主要的配置文件是 settings.py，通常位于项目的 settings 目录下。以下是一些关键的配置项：

# settings.py

INSTALLED_APPS = [
    ...
    'django_searchable_select',
    ...
]

# 添加 URL 模式
from django.conf.urls import include, url

urlpatterns = [
    ...
    url(r'^searchableselect/', include('django_searchable_select.urls')),
    ...
]

• INSTALLED_APPS: 添加 django_searchable_select 到已安装的应用列表中。
• urlpatterns: 添加 django_searchable_select 的 URL 模式。

通过这些配置，项目就可以使用 django-searchable-select 提供的功能了。

django-searchable-selectA better and faster multiple selection widget with suggestions项目地址:https://gitcode.com/gh_mirrors/dj/django-searchable-select