situation

for now, the tag {% bootstrap_form %} create an horizontal OR inline form.

    <form role="form" method="post">
        {% csrf_token %}
        {% bootstrap_form form %}
        {% buttons submit='OK' reset="Cancel" %}{% endbuttons %}
    </form>

cons

But what if we want two field on the same line for readability purpose ? we then must stop use {% bootstrap_form %} and switch to a {% bootstrap_field %} for each fields and create our line with .row and .col-md-6.

    <form role="form" method="post">
        {% csrf_token %}
      <div class="row">
        <div class="col-md-6">
          {%  bootstrap_field form.subject %}
        </div>
        <div class="col-md-6">
          {%  bootstrap_field form.password %}
        </div>
      </div>
      {%  bootstrap_field form.message %}
      {% buttons submit='OK' reset="Cancel" %}{% endbuttons %}
    </form>

this is a probleme as soon as the form is a little dynamic and when some field can be missing (ie because of user perms). so you will soon need to add some {% if %} that should not be used if {% bootstrap_form %} was used

    <form role="form" method="post">
        {% csrf_token %}
      <div class="row">
        <div class="col-md-6">
          {%  bootstrap_field form.subject %}
        </div>
        <div class="col-md-6">
          {%  bootstrap_field form.password %}
        </div>
      </div>
      {%  bootstrap_field form.message %}
      {%  if form.maybemissing %}
        {%  bootstrap_field form.maybemissing %}
      {%  endif %}
      {% buttons submit='OK' reset="Cancel" %}{% endbuttons %}
    </form>

if you don't use {% if %} you will have the BootstrapError: Parameter "field" should contain a valid Django BoundField.

enhancement

it seem that the layout of {% bootstrap_form %} should be more powerfull and allow us to create a real layout, not just «horizontal» or «inline».

so, we can have in form.py

class MyLayoutForm(forms.Form):
    layout = [
        ("subject", "password"),
        "message",
        "maybemissing"
    ]
    subject = forms.CharField(
        max_length=100,
        help_text='my_help_text',
        required=True,
        widget=forms.TextInput(attrs={'placeholder': 'placeholdertest'}),
    )
    password = forms.CharField(widget=forms.PasswordInput)
    message = forms.CharField(required=False, help_text='<i>my_help_text</i>')
    maybemissing = forms.EmailField(
        label='Sender © unicode',
        help_text='E.g., "[email protected]"')

    def __init__(self, *args, **kwargs):
        super(MyLayoutForm, self).__init__(*args, **kwargs)
        if whatever:
            self.fields.pop("maybemissing")

and keep the simple {% bootstrap_form %} in our template, as desired :

    <form role="form" method="post">
        {% csrf_token %}
        {% bootstrap_form form %}
        {% buttons submit='OK' reset="Cancel" %}{% endbuttons %}
    </form>

by adding the "layout" attribute of the Form, the {% bootstrap_form %} will use it for the form rendering. if none layout is given, it will create one with all fields, which will render exactly the same way as before.

the layout will allow to create the .row and .col-md-x recursively. It will take 2 possible type

list and tuple

so, to get the following form, we can just add a list with tuples :

    class MyLayoutForm(forms.Form):
        layout = [
            ("subject", "password"),
            "message",
            "maybemissing"
        ]
        ...

Col and Row

the col and Row are the final step of the layout processing. all given layout will be computed in Col and Row. the {% bootstrap_form %} will use it to render the correct layout.

The Col class

Col(unicode: fieldname, unicode: class_="col-md-x", *rows)

the Col represent a <div class="col-md-xx">. it can contains other rows or a field of the form (by his name)

Col("message")

Col("message", class_="col-md-6 red")

Col(
    Row("message"),
    Row("password")
)

the Row class

Row(*cols_or_fields, **field_config)

a Row can contains many Col, or the name of the fields. the related Col will be created to give equal size of all fields. the desired class can be given with a dict like construction. where the name of the field is the key, and the class is the value

the followings lines are equivalent :

Row("message", "subject")

Row(message="col-md-6", subject="col-md-6")

Row(Col("message", class_="col-md-6"), Col("subject", class_="col-md-6"))

a Row should always contains Col and Col can contains Row or the field itself. a Row can be used as :

layout = [
    Row(subject="col-md-8 col-xs-6", password="col-md-4 col-xs-6"),
    Row("message"),
    Row(maybemissing="col-md-12"),
]

Col and Row mixed up with list and tuples

the list constuction is compiled in Row/Col construction. the 3 following initialization will be identical.

layout = (
    ("message", "subject"),
    ("mybemissing",)
) 
layout = Col(
    ("message", "subject"),
    ("mybemissing",)
)
layout = Col(
    Row("message", "subject"),
    Row("mybemissing",)
) 

Col and Row recursivity

you can add row into cols and cols into Row without deep limitation

layout = Row(
    Col(Row(Col("subject")), Row(Col("message"))),
    Col("password", "maybemissing"),
)

the last hope

with this logic, it can even be possible to add more layout class with Row and Col, like Tab, Fieldset or Accordion.

Of course, I can override css_url with hardcoded URL. But how to use static tag to get css file url without overriding whole bootstrap3.html template?

django-bootstrap3/bootstrap3/utils.py:142: RemovedInDjango110Warning: render() must be called with a dict, not a Context.
  return template.render(Context(context))

I have Python33 with Django 1.6.5, when I'm trying to run demo got error.

Installed c:\tmp\django-bootstrap3-4.7.0

Successfully installed django-bootstrap3 Cleaning up...

C:\tmp\django-bootstrap3-4.7.0\demo>python manage.py runserver Traceback (most recent call last): File "manage.py", line 10, in execute_from_command_line(sys.argv) File "C:\Program Files (x86)\Python33\lib\site-packages\django\core\management init.py", line 399, in execute_from_command_line utility.execute() File "C:\Program Files (x86)\Python33\lib\site-packages\django\core\management init.py", line 392, in execute self.fetch_command(subcommand).run_from_argv(self.argv) File "C:\Program Files (x86)\Python33\lib\site-packages\django\core\management init.py", line 261, in fetch_command commands = get_commands() File "C:\Program Files (x86)\Python33\lib\site-packages\django\core\management init.py", line 107, in get_commands apps = settings.INSTALLED_APPS File "C:\Program Files (x86)\Python33\lib\site-packages\django\conf__init__.p y", line 54, in getattr self.setup(name) File "C:\Program Files (x86)\Python33\lib\site-packages\django\conf__init_.p y", line 50, in setup self.configure_logging() File "C:\Program Files (x86)\Python33\lib\site-packages\django\conf__init.p y", line 72, in configure_logging from django.utils.log import DEFAULT_LOGGING File "C:\Program Files (x86)\Python33\lib\site-packages\django\utils\log.py", line 7, in from django.views.debug import ExceptionReporter, get_exception_reporter_fil ter File "C:\Program Files (x86)\Python33\lib\site-packages\django\views\debug.py" , line 10, in from django.http import (HttpResponse, HttpResponseServerError, File "C:\Program Files (x86)\Python33\lib\site-packages\django\http__init_.p y", line 2, in from django.http.request import (HttpRequest, QueryDict, UnreadablePostError , File "C:\Program Files (x86)\Python33\lib\site-packages\django\http\request.py ", line 14, in from django.http.multipartparser import MultiPartParser File "C:\Program Files (x86)\Python33\lib\site-packages\django\http\multipartp arser.py", line 10, in import cgi File "C:\Program Files (x86)\Python33\lib\cgi.py", line 40, in import html File "C:\tmp\django-bootstrap3-4.7.0\bootstrap3\html.py", line 4, in from django.forms.widgets import flatatt File "C:\Program Files (x86)\Python33\lib\site-packages\django\forms__init__. py", line 8, in from django.forms.fields import * File "C:\Program Files (x86)\Python33\lib\site-packages\django\forms\fields.py ", line 17, in from django.forms.util import ErrorList, from_current_timezone, to_current_t imezone File "C:\Program Files (x86)\Python33\lib\site-packages\django\forms\util.py", line 4, in from django.utils.html import format_html, format_html_join File "C:\Program Files (x86)\Python33\lib\site-packages\django\utils\html.py", line 12, in from django.utils.text import normalize_newlines File "C:\Program Files (x86)\Python33\lib\site-packages\django\utils\text.py", line 11, in from django.utils.six.moves import html_entities ImportError: cannot import name html_entities

Error during template rendering

In template C:...............\blog\index.html, error at line 21

<form action="/url/to/submit/" method="post" class="form">

20 {% csrf_token %} 21 {% bootstrap_form form %} 22 {% bootstrap_form_buttons %} 23 24 {% bootstrap_icon "star" %} Submit 25 26 {% end_bootstrap_form_buttons %}

Will be filling branch with more commits as I implement them.

Goals:

• extra css classes for li elements
• pills variant
• bootstrap_tabs_activate for corresponding js snippet
• docs (whistle)
• maybe: bootstrap_tabs_container block tag for the actual tab content

Edit: I know that Django 1.9 hasn't been released yet. :)

Django 1.9 tightens up some security around template tags: https://docs.djangoproject.com/en/dev/releases/1.9/#simple-tag-now-wraps-tag-output-in-conditional-escape

This change in Django is causing the bootstrap_form template tag to output the form markup as text instead of an actual form - ie. you see the html markup for the fields rather than the fields themselves.

Trying to migrate from bootstrap_toolkit to bootstrap3, both released by you. Bootstrap_toolkit works perfectly, however when I download bootstrap3, add to settings.py and include the appropriate tag { load bootstrap3 } I get a Django error that states bootstrap3 is not a valid tag library. Checked the directory /usr/local/lib/python2.7 /distpackage and bootstrap3 is in the correct spot, along with the old bootstrap_toolkit. Am I missing something?

Best, Greg

I tried to upgrade from 9.0.0 to 11.0.0 but I keep getting the following BootstrapError when I try to access my app. I can't figure out what the issue is, so I've gone back to 9.0.0 in the meantime. Any ideas?

Environment:


Request Method: GET
Request URL: http://example.com/login/

Django Version: 1.11.15
Python Version: 3.6.5
Installed Applications:
['harold.apps.HaroldConfig',
 'django.contrib.auth',
 'django.contrib.contenttypes',
 'django.contrib.sessions',
 'django.contrib.messages',
 'django.contrib.staticfiles',
 'bootstrap3']
Installed Middleware:
['django.middleware.security.SecurityMiddleware',
 'django.contrib.sessions.middleware.SessionMiddleware',
 'django.middleware.common.CommonMiddleware',
 'django.middleware.csrf.CsrfViewMiddleware',
 'django.contrib.auth.middleware.AuthenticationMiddleware',
 'harold.middleware.current_user.CurrentUserMiddleware',
 'django.contrib.messages.middleware.MessageMiddleware',
 'django.middleware.clickjacking.XFrameOptionsMiddleware']


Template error:
In template /opt/django/leasea/harold/templates/harold/login.html, error at line 22
   Function "url_to_attrs_dict" expects a string or a dict with key "url".   12 : 
   13 :     <meta charset="utf-8">
   14 :     <meta http-equiv="X-UA-Compatible" content="IE=edge">
   15 :     <meta name="viewport" content="width=device-width, initial-scale=1">
   16 :     <meta name="description" content="">
   17 :     <meta name="author" content="">
   18 : 
   19 :     <title>Login</title>
   20 : 
   21 :     <!-- Bootstrap Core CSS -->
   22 :      {% bootstrap_css %} 
   23 : 
   24 :     <!-- MetisMenu CSS -->
   25 :     <link href="{% static 'harold/vendor/metisMenu/metisMenu.min.css' %}" rel="stylesheet">
   26 : 
   27 :     <!-- Custom CSS -->
   28 :     <link href="{% static 'harold/dist/css/sb-admin-2.min.css' %}" rel="stylesheet">
   29 : 
   30 :     <!-- Morris Charts CSS -->
   31 :     <link href="{% static 'harold/vendor/morrisjs/morris.css' %}" rel="stylesheet">
   32 : 


Traceback:

File "/opt/django/leasea_venv/lib/python3.6/site-packages/bootstrap3/utils.py" in url_to_attrs_dict
  184.             url_value = url["url"]

During handling of the above exception ('NoneType' object is not subscriptable), another exception occurred:

File "/opt/django/leasea_venv/lib/python3.6/site-packages/django/core/handlers/exception.py" in inner
  41.             response = get_response(request)

File "/opt/django/leasea_venv/lib/python3.6/site-packages/django/core/handlers/base.py" in _get_response
  217.                 response = self.process_exception_by_middleware(e, request)

File "/opt/django/leasea_venv/lib/python3.6/site-packages/django/core/handlers/base.py" in _get_response
  215.                 response = response.render()

File "/opt/django/leasea_venv/lib/python3.6/site-packages/django/template/response.py" in render
  107.             self.content = self.rendered_content

File "/opt/django/leasea_venv/lib/python3.6/site-packages/django/template/response.py" in rendered_content
  84.         content = template.render(context, self._request)

File "/opt/django/leasea_venv/lib/python3.6/site-packages/django/template/backends/django.py" in render
  66.             return self.template.render(context)

File "/opt/django/leasea_venv/lib/python3.6/site-packages/django/template/base.py" in render
  207.                     return self._render(context)

File "/opt/django/leasea_venv/lib/python3.6/site-packages/django/template/base.py" in _render
  199.         return self.nodelist.render(context)

File "/opt/django/leasea_venv/lib/python3.6/site-packages/django/template/base.py" in render
  990.                 bit = node.render_annotated(context)

File "/opt/django/leasea_venv/lib/python3.6/site-packages/django/template/base.py" in render_annotated
  957.             return self.render(context)

File "/opt/django/leasea_venv/lib/python3.6/site-packages/django/template/library.py" in render
  203.         output = self.func(*resolved_args, **resolved_kwargs)

File "/opt/django/leasea_venv/lib/python3.6/site-packages/bootstrap3/templatetags/bootstrap3.py" in bootstrap_css
  207.     rendered_urls = [render_link_tag(bootstrap_css_url())]

File "/opt/django/leasea_venv/lib/python3.6/site-packages/bootstrap3/utils.py" in render_link_tag
  120.     url_dict = url_to_attrs_dict(url, url_attr="href")

File "/opt/django/leasea_venv/lib/python3.6/site-packages/bootstrap3/utils.py" in url_to_attrs_dict
  187.                 'Function "url_to_attrs_dict" expects a string or a dict with key "url".'

Exception Type: BootstrapError at /login/
Exception Value: Function "url_to_attrs_dict" expects a string or a dict with key "url".

about first param to template.render:

/home/jieter/.virtualenvs/bootstrap/local/lib/python2.7/site-packages/bootstrap3/utils.py:142: RemovedInDjango110Warning: render() must be called with a dict, not a Context.
  return template.render(Context(context))

Let's see if this works better than my try in #292.

about first param to template.render:

[...]bootstrap3/utils.py:142: RemovedInDjango110Warning: render() must be called with a dict, not a Context.
  return template.render(Context(context))

Fixes #279 and #290

Bumps tox from 3.27.1 to 4.2.1.