一个django应用程序,提供一些fontawesome/django相关的实用程序。
django-fontawesome的Python项目详细描述
django fontaweso是一个Django应用程序,它提供了几个fontaweso/django相关的实用程序,即:
- 一个IconField将FontAwesome图标与模型实例相关联
- 模板标记以呈现FontAwesome图标
还包括:
- 对IconField 的管理支持
- fr语言环境翻译
要求
- 皮亚姆
- 选择2(包含)
- jquery(在管理面板中使用django的jquery)
设置
默认情况下,Django Fontawesome会附带并使用最新的Fontawesome版本。 通过指定:
# default uses locally shipped version at 'fontawesome/css/font-awesome.min.css' FONTAWESOME_CSS_URL = '//cdn.example.com/fontawesome-min.css' # absolute url FONTAWESOME_CSS_URL = 'myapp/css/fontawesome.min.css' # relative url
您还可以使用:
FONTAWESOME_PREFIX = 'bg' # default is 'fa'
安装/使用
通过PIP安装:
pip install django-fontawesome
将“fontawesome”添加到已安装的应用程序设置中,如下所示:
INSTALLED_APPS = ( ... 'fontawesome', )
导入并使用IconField:
from fontawesome.fields import IconField class Category(models.Model): ... icon = IconField()
下面是管理面板中的小部件的外观:
然后,您可以在模板中按如下方式呈现图标:
{% for category in categories.all %} {% if category.icon %} {{ category.icon.as_html }} {% endif %} {% endfor %}
- django fontawesome带有两个模板标记,fontawesome_stylesheet和fontawesome_icon。
前者根据FONTAWESOME_CSS_URL设置插入带有预先配置的ref的样式表链接
后者呈现图标,并接受以下可选关键字参数:large、spin、fixed、li、border:(true/false)、rotate:(90/180/270)、title:(string)
还可以使用color='red'关键字参数将图标着色到fontawesome_icon模板标记
示例用法:
{% load fontawesome %} <head> {% fontawesome_stylesheet %} ... </head> {% fontawesome_icon 'user' color='red' %} {% fontawesome_icon 'star' large=True spin=True %} <ul class="fa-ul"> <li> {% fontawesome_icon 'home' rotate=90 li=True %} One</li> </ul>
利润!!!
更改日志
1.0-2018年5月10日
- Django 1.11兼容性
- 使用yaml的安全负载而不是不安全的负载
- 新的pypi版本(1.0),现在被认为是一个稳定的版本
0.3.1-2016年12月19日
- 为图标标题属性使用非ascii字符的情况添加了unicode文本导入
2016年11月28日
- 现在支持django 1.8+
- python3支持,假定
- 已修复相关导入问题
- 更新了Fontawesome4.7的图标映射
- 现在支持表格和堆叠的内联线
- 其他小修补程序
- 新的PYPI版本(0.3)
2016年1月28日
- 更新了FontAwesome4.5.0的图标映射文件(icons.yml)
- Fontawesome图标模板标记的新关键字arg:title
2015年12月17日
- 将本地提供的FontAwesome更新为4.5.0
- Fontawesome图标的输出现在标记为安全
2015年9月11日
- 将本地提供的FontAwesome更新为4.4.0
2015年2月27日
- 在fontawesou图标模板标记、颜色和边框中添加了两个新的关键字参数
- 使用fontawesou图标模板标记渲染图标时,现在会考虑fontawesou前缀设置