attrs в виджетах django

В процессе написания мультивиджета, пришлось задуматься, а что такое attrs (атрибуты)? По началу было понятно, что это атрибуты поля формы:

view plainprint?

1. <select name="school_user-0-year_start_year" id="id_school_user-0-year_start">  
2. </select>  

Инициализация виджета (class Widget)

view plainprint?

1. def __init__(self, attrs=None):  
2.   
3.           if attrs is not None:  
4.   
5.             self.attrs = attrs.copy()  
6.   
7.           else:  
8.   
9.                 self.attrs = {}  

def __init__(self, attrs=None):

          if attrs is not None:

 	        self.attrs = attrs.copy()

          else:

                self.attrs = {}

Возьмем для примера следующий виджет:

view plainprint?

1. class Select(Widget):  
2.   
3.     def __init__(self, attrs=None, choices=()):  
4.   
5.         super(Select, self).__init__(attrs)  

 	class Select(Widget):

 	    def __init__(self, attrs=None, choices=()):

 	        super(Select, self).__init__(attrs)

В принципе понятно, что происходит. Далее, рассмотрим функцию рендеринга виджета:

view plainprint?

1. def render(self, name, value, attrs=None, choices=()):  
2.   
3.     if value is None: value = ''  
4.   
5.    final_attrs = self.build_attrs(attrs, name=name)  
6.   
7.     output = [u'<select%s>' % flatatt(final_attrs)]  
8.   
9.     options = self.render_options(choices, [value])  
10.   
11.     if options:  
12.   
13.         output.append(options)  
14.   
15.     output.append('')  
16.   
17.     return mark_safe(u'\n'.join(output))  
18.   
19. ct%s>  

 	    def render(self, name, value, attrs=None, choices=()):

 	        if value is None: value = ''

	        final_attrs = self.build_attrs(attrs, name=name)

 	        output = [u'' % flatatt(final_attrs)]

 	        options = self.render_options(choices, [value])

 	        if options:

 	            output.append(options)

 	        output.append('')

 	        return mark_safe(u'\n'.join(output))

Что делает функция build_attrs?

view plainprint?

1. def build_attrs(self, extra_attrs=None, **kwargs):  
2.   
3.      "Helper function for building an attribute dictionary."  
4.   
5.      attrs = dict(self.attrs, **kwargs)  
6.   
7.      if extra_attrs:  
8.   
9.          attrs.update(extra_attrs)  
10.   
11.      return attrs  

	    def build_attrs(self, extra_attrs=None, **kwargs):

 	        "Helper function for building an attribute dictionary."

 	        attrs = dict(self.attrs, **kwargs)

 	        if extra_attrs:

 	            attrs.update(extra_attrs)

 	        return attrs

Функция принимает **kwargs (keyworded аргументы, то есть аргументы с ключами), в нашем случае передается ключ name с названием данного виджета. В итоге мы получаем примерно следующее:

view plainprint?

1. <select name="school_user-0-year_start_year">  
2. </select>  

Но откуда берется id?
Оно приходит в атрибутах до рендеренга виджета, из далеких глубин класса class BoundField(StrAndUnicode), который описан в исходниках как "A Field plus data".
Функция класса as_widget собственно и инициирует вызов рендеринга виджета.

view plainprint?

1. def as_widget(self, widget=None, attrs=None, only_initial=False):  
2.   
3.       """ 
4.  
5.       Renders the field by rendering the passed widget, adding any HTML 
6.  
7.       attributes passed as attrs.  If no widget is specified, then the 
8.  
9.       field's default widget will be used. 
10.  
11.       """  
12.   
13.      if not widget:  
14.   
15.           widget = self.field.widget  
16.   
17.       attrs = attrs or {}  
18.   
19.       auto_id = self.auto_id  
20.   
21.       if auto_id and 'id' not in attrs and 'id' not in widget.attrs:  
22.   
23.           attrs['id'] = auto_id  
24.   
25.       if not self.form.is_bound:  
26.   
27.           data = self.form.initial.get(self.name, self.field.initial)  
28.   
29.           if callable(data):  
30.   
31.               data = data()  
32.   
33.       else:  
34.   
35.           data = self.data  
36.   
37.       if not only_initial:  
38.   
39.           name = self.html_name  
40.   
41.       else:  
42.   
43.           name = self.html_initial_name  
44.   
45.       return widget.render(name, data, attrs=attrs)  

    def as_widget(self, widget=None, attrs=None, only_initial=False):

 	        """

 	        Renders the field by rendering the passed widget, adding any HTML

 	        attributes passed as attrs.  If no widget is specified, then the

 	        field's default widget will be used.

 	        """

	        if not widget:

 	            widget = self.field.widget

 	        attrs = attrs or {}

 	        auto_id = self.auto_id

 	        if auto_id and 'id' not in attrs and 'id' not in widget.attrs:

 	            attrs['id'] = auto_id

 	        if not self.form.is_bound:

 	            data = self.form.initial.get(self.name, self.field.initial)

 	            if callable(data):

 	                data = data()

 	        else:

 	            data = self.data

 	        if not only_initial:

 	            name = self.html_name

 	        else:

 	            name = self.html_initial_name

 	        return widget.render(name, data, attrs=attrs)

Поэтому, добавить свои атрибуты или получить данные из словаря в процессе переопределения рендеринга не сложно.

view plainprint?

1. class MyWidget(forms.Select):  
2.   
3.     def render(self, name, value, attrs=None, choices=()):  
4.   
5.         id_ = attrs.get('id', None)  
6.   
7.         attrs.update({'onchange':'javascriptfunction(%s%s);' % id_,name})  
8.   
9.         return super(MyWidget, self).render(name, value, attrs)  

class MyWidget(forms.Select):

    def render(self, name, value, attrs=None, choices=()):

        id_ = attrs.get('id', None)

        attrs.update({'onchange':'javascriptfunction(%s%s);' % id_,name})

        return super(MyWidget, self).render(name, value, attrs)

Хотя можно передавать атрибуты и в определении самого виджета, функция self.build_attrs() просто обновит словарь новыми записями, но мне надо было именно переопределить атрибуты в виджете, для создания мультивиджета.
attrs.update() в мультивиджетах меняет атрибуты во всех подвиджетах.