自定义代码标签和布局

自定义代码标签和布局

---

1.代码布局：

• 某个app特有的：
• 自定的代码一般需放在app目录下的templatetags文件夹
• 再到templatetags文件夹下创建python模块
• 公用的：
• 创建一个新的app，将python模块定义到新的app中，在INSTALL_APPS注册，然后就可以使用。

2.自定义过滤器

• 过滤器的本质：
  • 函数：一个或两个参数
    • 第一个参数：传递进来的模板变量
    • 第二个参数：普通的参数（可能默认参数，非必须）
• 过滤器注册

  • from django.template import Library
    
    register = Library()
    
    def is_male(value, regular='en'):
        way = {
            'en': ['女','男',],
            'cn': ['female','male',],
        }
        return way[regular][value]
    
    register.filter(is_male)

  • 实例注册：先实例化一个注册的对象，再调用这个对象的filter方法，filter方法传入需要注册的装饰器函数的函数名。

    from django.template import Library
    
    register = Library()
    
    
    @register.filter()
    def is_male(value, regular='en'):
        way = {
            'en': ['女','男',],
            'cn': ['female','male',],
        }
        return way[regular][value]
    
    # register.filter(is_male)

  • 通过实例对象的装饰器来完成对过滤器函数的调用。
• 过滤器的使用
  • 现在html中导入过滤器模块{% load 模块 %}
  • 再像普通过滤器那样调用即可
  • 装饰器函数的第一个参数为所调用的时候传入的值。

3.自定义模板标签

• 简单标签
• 简单标签的定义和自定义过滤器的方式一样

from django.template import Library
from datetime import datetime

register = Library()

@register.simple_tag()
def current_time(format_str):
    return datetime.now().strftime(format_str)


# register.simple_tag(current_time)

• 调用的是实例对象的simple_tag方法
• 引用上下文参数：
  • 引用上下文的模板变量（views函数中render传递的context变量的值）
    • 在标签函数的注册方法中将take_tcontext=True。
    • 将标签函数的第一个参数设置为context

from django.template import Library
from datetime import datetime

register = Library()

@register.simple_tag(takes_context=True)
def current_time(context):
    return datetime.now().strftime(context['format_str'])


# register.simple_tag(current_time)

 4.包含标签（嵌套标签）

• 为避免某一样式重复使用，django提供了包含标签
• 首先定义样式

  <ul>
      {% for i in ls%}
          <li>{{ i }}</li>
      {% endfor %}
  </ul>

• 注册样式

  from django.template import Library
  
  register = Library()
  
  
  # register.simple_tag(current_time)
  @register.inclusion_tag('crm/show_list_as_ul.html')
  def show_list_as_ul(value):
      return {'ls': value}

  使用实例library的实例对象的inclusion_tag方法，该方法接收一个样式的路径的字符串，最后就可以像普通标签一样是使用该样式了。

• 接收上下文变量和上面一样，将take_context=True,函数的第一个变量设置为context即可！