1 #!/usr/bin/python2.5

     2 #

     3 # Copyright 2008 the Melange authors.

     4 #

     5 # Licensed under the Apache License, Version 2.0 (the "License");

     6 # you may not use this file except in compliance with the License.

     7 # You may obtain a copy of the License at

     8 #

     9 #   http://www.apache.org/licenses/LICENSE-2.0

    10 #

    11 # Unless required by applicable law or agreed to in writing, software

    12 # distributed under the License is distributed on an "AS IS" BASIS,

    13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    14 # See the License for the specific language governing permissions and

    15 # limitations under the License.

    16 

    17 """A Django template tag library containing forms helpers.

    18 """

    19 

    20 __authors__ = [

    21   '"Todd Larsen" <tlarsen@google.com>',

    22   ]

    23 

    24 

    25 from django import template

    26 register = template.Library()

    27 

    28 

    29 @register.inclusion_tag('soc/templatetags/_field_as_table_row.html')

    30 def field_as_table_row(field):

    31   """Prints a newforms field as a table row.

    32 

    33   This function actually does very little, simply passing the supplied

    34   form field instance in a simple context used by the _field_as_table_row.html

    35   template (which is actually doing all of the work).

    36 

    37   See soc/templates/soc/templatetags/_field_as_table_row.html for the CSS

    38   styles used by this template tag.

    39 

    40   Usage:

    41     {% load forms_helpers %}

    42     ...

    43     <table>

    44      {% field_as_table_row form.fieldname %}

    45      ...

    46     </table>

    47 

    48   Args:

    49     field: a Django newforms field instance

    50 

    51   Returns:

    52     a simple context containing the supplied newforms field instance:

    53       { 'field': field }

    54   """

    55   return {'field': field}