在一个网页中,不仅仅只有一个html骨架,还需要css样式文件,js执行文件以及一些图片等。因此在DTL中加载静态文件时一个必须要解决的问题。在DTL中,使用static标签来加载静态文件。要使用static标签,首先需要{{% load static %}},加载静态文件的步骤如下:
- 首先确保django.contrib.staticfiles,已经添加到settings.py中的INSTALLED_APPS中。
- 确保在settings.py中设置了STATIC_URL
# Static files (CSS, JavaScript, Images)
STATIC_URL = '/static/'
- 在已经安装的app下创建一个文件夹叫做static,然后再在这个static文件夹下创建一个当前app的名字的文件夹,再把静态文件放到这个文件夹下。例如你的app叫做book,有一个静态文件hello.jpg,那么路径为book/static/book/hello.jpg
- 为什么要在app下创建一个static文件夹,还需要在这个static下创建一个同app名字的文件夹?
原因是如果直接把静态文件放在static文件夹下,那么在模板加载静态文件的时候就是使用hello.jpg,词汇书如果在多个app中出现同名的静态文件hello.jpg,这个时候就会出现混淆,而在static文件夹下加了一个同名的app文件夹,在模板中加载的时候就是使用app/hello.jpg,这样就可以避免产生混淆。示例代码如下:
{# static并不是DTL模板中内置的标签,因此要想使用的的话,就先要进行加载load进来 #}
{% load static %}
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
<link rel="stylesheet" href=" {% static 'css/index.css' %} ">
</head>
<body>
# 可以采用第一种方式进行获取,但是此时获取图片的路径如果发生了变化,就要多处修改,比较麻烦,
{#<img src="/static/logo.jpg" alt="">#}
# 所以推荐使用第二种,使用static标签进行动态获取静态文件
<img src="{% static 'front/logo.jpg' %}" alt="">
</body>
</html>
- 如果一些静态文件不和任何app相关,那么可以在settings.py中添加STATICFILES_DIRS,以后DTL模板,如果不能在已经安装了的app下的static文件夹中找到静态文件,就会在这个列表的路径static文件夹中查找静态文件,比如在settings.py文件夹中可以配置为:
STATICFILES_DIRS = [
os.path.join(BASE_DIR,'static')
]
- 在模板中使用load标签加载static标签,比如要加载项目的static文件夹下的css文件夹下的index.css的文件,那么示例代码如下:
<link rel="stylesheet" href=" {% static 'css/index.css' %} ">
- 如果不想每次在模板中加载静态文件都使用load加载static标签,那么可以在settings.py中的TEMPLATES/OPTIONS添加“builtins”:['django.templatetags.static'],这样以后在模板中就可以直接使用static标签,而不用手动的load了。这种方法就可以将static变成django的一个内置的标签。示例代码如下:
'builtins':[
'django.templatetags.static'
],
- 如果没有在settings.INSTALLED_APPS中添加django.contrib.staticfiles。那么我们就需要手动的将请求静态文件的url与静态文件的路径进行映射了,示例代码如下:
from django.urls import path
from front import views
from book import views as book_views
# 将静态文件的url与静态文件的路径进行拼接
from django.conf import settings
from django.conf.urls.static import static
urlpatterns = [
path('', views.index, name = 'index'),
path('book/', book_views.book, name = 'book'),
] + static(settings.STATIC_URL,document_root = settings.STATICFILES_DIRS[0])
# 进行拼接的时候,static(url前缀(STATIC_URL),document_root(静态文件路径))
此时ctrl+shift+r刷新网页,同样可以加载静态文件(jpg图片、css文件):