在一个网页中,不仅仅只有一个 html 骨架,还需要 css 样式文件、 js 执行文件以及一些图片等,因此在 DTL 中加载静态文件是一个必须要解决的问题。在 DTL 中,使用 static 标签来加载静态文件。要使用 static 标签,首先需要 {% load static %} 。
加载静态文件的步骤如下:
1. 首先确保django.contrib.staticfiles已经添加到项目的settings.INSTALLED_APPS中,默认是添加的。
2. 确保在项目settings.py中设置了STATIC_URL ,默认是添加的STATIC_URL = '/static/',表示会从每个app的static目录下去寻找静态文件。
3.将各个app添加到项目的settings.py的installed_app中
4. 在已经安装的各个app下创建一个static文件夹,然后再在static 文件夹下创建一个与当前app相同名字的文件夹,再把静态文件放到这个文件夹下。例如你的app叫做book,有一个静态文件叫做zhiliao.jpg ,那么路径为book/static/book/zhiliao.jpg。(为什么在 app 下创建一个 static 文件夹,还需要在这个 static 下创建一个同 app 名字的文件夹呢?原因是如果直接把静态文件放在 static 文件夹下,那么在模版加载静态文件的时候就是使用 zhiliao.jpg ,如果在多个 app 之间有同名的静态文件,就可能产生混淆,而在 static 文件夹下加了一个同名 app 文件夹,在模版中加载的时候就是使用 app/zhiliao.jpg ,这样就可以避免产生混淆。)
5. 如果有一些静态文件是针对项目而不与任何 app 挂钩,那么可以在 settings.py 中添加 STATICFILES_DIRS,以后 DTL 就会在这个列表的路径中查找静态文件。比如可以设置为:
STATICFILES_DIRS = [os.path.join(BASE_DIR,"static")],即直接在项目下面建一个static文件夹存放静态文件。
6. 在模版中使用 load 标签加载 static 标签。比如要加载在项目的 static 文件夹下的 style.css 的文件。那么示例代码如下:
{% load static %}
<link rel="stylesheet" href="{% static 'style.css' %}">
7. 由于static不是内置标签,所以在模版中加载静态文件前都需要使用load进行加载,如果不想每次使用都加载,则可以在项目的settings.py中的TEMPLATES/OPTIONS 添加 'builtins':['django.templatetags.static'] ,这样以后在模版中就可以直接使用static标签,而不用手动load了。
8. 如果没有在 settings.INSTALLED_APPS 中添加 django.contrib.staticfiles 。那么我们就需要手动的将请求静态文件的 url 与静态文件的路径进行映射了。示例代码如下:
from django.conf import settings
from django.conf.urls.static import static
urlpatterns = [
# 其他的url映射
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
示例:
template_static_demo项目下创建两个app,cms和front,各有一个静态文件都名为logo.jpg,有一个项目的静态文件index.css,整个项目的目录结构如下。
首先,项目的settings.py文件中,默认INSTALLED_APPS中已经添加django.contrib.staticfiles,默认STATIC_URL = '/static/'中已设置,手动添加STATICFILES_DIRS = [os.path.join(BASE_DIR,"static")],并且将front和cms项目都添加到了installed_app中。
views.py
#front的views.py def index(request): return render(request,'index.html') #cms的views.py def cms(request): return render(request,'cms.html')
项目的urls.py
from front import views from cms import views as cms_views urlpatterns = [ path('',views.index,name='index'), path('cms',cms_views.cms,name='cms') ]
index.css
body{background:pink}
index.html
{% load static %} …… <head> <meta charset="UTF-8"> <title>Title</title> <link rel="stylesheet" href="{% static 'index.css' %}"><!--在head部分加载整个项目的css静态文件,即页面背景为粉红色--> </head> <body> <img src="{% static 'front/logo.jpg' %}" alt=""> <!--加载front app的logo.jpg图片--> </body> ……
cms.html
{% load static %} …… <body> <img src="{% static 'cms/logo.jpg' %}" alt=""> <!--加载cms app的logo.jpg图片--> </body> …… <!--由于没有加载css文件,这个页面的背景为默认的白色-->
上述操作在每个html模板中都要手动load static,如果在项目settings.py中的TEMPLATES/OPTIONS 添加 'builtins':['django.templatetags.static'],则每个html的{% load static %}这一行都可以删除。