Django中static(静态)文件详解以及{% static %}标签的使用
在一个网页中,不仅仅只有一个html
骨架,还需要css
样式文件,js
执行文件以及一些图片等。因此在DTL
中加载静态文件是一个必须要解决的问题。在DTL
中,使用static
标签来加载静态文件。要使用static
标签,首先需要{% load static %}
。
加载静态文件的步骤如下:
1、首先确保django.contrib.staticfiles
已经添加到settings.INSTALLED_APPS
中。
2、确保在settings.py
中设置了STATIC_URL
。
注意: 上面两条都是在创建Django 项目的时候就自动给我们弄好了,只要我们没有去改动它,就不用管。
3、在已经安装了的app
下创建一个文件夹叫做static
,然后再在这个static
文件夹下创建一个当前app
的名字的文件夹,再把静态文件放到这个文件夹下。例如你的app
叫做book
,有一个静态文件叫做book.jpg
,那么路径为book/static/book/book.jpg
。(为什么在app
下创建一个static
文件夹,还需 要在这个static
下创建一个同app
名字的文件夹呢?原因是如果直接把静态文件放在static
文件夹下,那么在模版加载静态文件的时候就是使用book.jpg
,如果在多个app
之间有同名的静态文件,这时候可能就会产生混淆。而在static
文件夹下加了一个同名app
文件夹,在模版中加载的时候就是使 用app名/book.jpg
,这样就可以避免产生混淆。)
注意: 文件夹的名字必须为static
。
4、如果有一些静态文件是不和任何app
挂钩的。即不再任何一个app的目录下。那么可以在settings.py
中添加STATICFILES_DIRS
,以后DTL
就会在这个列表的路径中查找静态文件。例如我们在manage.py
的同级目录下新建一个static
的文件夹。然后在settings.py
:中添加STATICFILES_DIRS
STATICFILES_DIRS = [
os.path.join(BASE_DIR,"static")
]
注: 第三种和第四种方法都可以加载静态文件,我的个人习惯是在manage.py
的同级目录下新建一个static
文件夹,然后将所有的静态文件进行分类的在里面存储。而不去app中新建一个static
的文件夹。但这只是我的个人习惯。毕竟不管是黑猫白猫,能抓到老鼠的就是好猫,所以只要我们能把项目做出来能运行,并且代码结构有逻辑性、层次感就行了。
5、在模版中使用load
标签加载static
标签。比如要加载在项目的static
文件夹下的style.css
的文件。那么示例代码如下:
{% load static %} <link rel="stylesheet" href="{% static 'style.css' %}">
注意: {% load static %}
需要放在html的头部位置(至少在使用static
标签的上面),一般都是放在html的最上面。如果{% extend %}
标签和{% load static %}
同时存在,{% extend %}
需要放在最上面,然后再放{% load static %}
等标签。
6、如果不想每次在模版中加载静态文件都使用load
加载static
标签,那么可以在settings.py
中的TEMPLATES/OPTIONS
添加'builtins':['django.templatetags.static']
,这样以后在模版中就可以直接使用static
标签,而不用手动的load
了。
注意: 位置不要添加错误了
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [os.path.join(BASE_DIR, 'templates')]
,
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',
],
#添加在这个位置
'builtins' : [
'django.templatetags.static'
],
},
},
]
下面的不常用,但是可以了解一下。
7、如果没有在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)
但平时我们并不会用到这个,Django内置已经将django.contrib.staticfiles
添加进去了的,我们为什么要给他删除来自找麻烦呢?放在这里也只是提供一个参考,了解一下。
最后分享一个快捷键的使用:在我们写项目的时候,有时候修改了代码而没有效果,这是因为浏览器使用的缓存加载,这个时候我们就可以使用这个快捷键来不使用缓存加载一个文件,来达到查看修改代码之后的效果的目地。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步