معرفی شرکت ها
django-bootstrap-input-group-1.0.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Render Django form fields as bootstrap input groups.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django-bootstrap-input-group-1.0.1 |
| نام | django-bootstrap-input-group |
| نسخه کتابخانه | 1.0.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | - |
| ایمیل نویسنده | Actionb <yummytea1@gmail.com> |
| آدرس صفحه اصلی | - |
| آدرس اینترنتی | https://pypi.org/project/django-bootstrap-input-group/ |
| مجوز | MIT License Copyright (c) 2023 Actionb Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
# django-bootstrap-input-group
This is an add-on for [django-bootstrap5](https://pypi.org/project/django-bootstrap5/) for rendering multiple
django form fields as a [Bootstrap input group](https://getbootstrap.com/docs/5.2/forms/input-group/).
## Requirements
Django 3.2 or newer and django-bootstrap5.
## Installation
1. Install using pip:
```bash
pip install django-bootstrap-input-group
```
2. Add to `INSTALLED_APPS` in your `settings.py`:
```python
INSTALLED_APPS = [
# ...
"django_bootstrap_input_group"
# ...
]
```
## Preview
Check out the little demo:
```
git clone https://github.com/Actionb/django-bootstrap-input-group.git
cd django-bootstrap-input-group/demo
pip install -r requirements.txt
python manage.py runserver
```
Then visit the demo forms on http://127.0.0.1:8000/.
## Usage
In your templates, load the template tag set `django_bootstrap_input_group`. Then you can render an input group of fields either by:
* declaring the groups in a `field_groups` attribute on your form and using the `bootstrap_grouped_form`
template tag to render that form
* using the `bootstrap_input_group` template tag to render a single group
### Using `field_groups` form attribute:
Declare `field_groups` on your form:
```python
from django import forms
class ContactForm(forms.Form):
first_name = forms.CharField()
last_name = forms.CharField()
notes = forms.CharField()
field_groups = [('Name', ('first_name', 'last_name')), 'notes']
```
Then in your templates:
```html
{% load django_bootstrap_input_group %}
{# Load CSS and JavaScript #}
{% bootstrap_css %}
{% bootstrap_javascript %}
<form>
{# Render a form as a grouped form #}
{% bootstrap_grouped_form form %}
{# Or for formsets #}
{% bootstrap_grouped_formset formset %}
</form>
```
`field_groups` contains the names of form fields in the order that they should be rendered in, with nested lists
(or tuples) of names representing a group. The nested list can be either a flat list, or a two-item list, where
the first item is the label for the group and the second is the list of field names:
```python
# No groups - just field names:
field_groups = ['first_name', 'last_name', 'notes']
# first_name and last_name make up a group, but no group label is specified:
field_groups = [('first_name', 'last_name'), 'notes']
# first_name and last_name make up a group, with the group label "Name":
field_groups = [('Name', ('first_name', 'last_name')), 'notes']
```
If no label is provided, the label of the first field in a group is used as the label for the group.
### Using the input group template tag:
Or you can just render a group of fields directly, using the `bootstrap_input_group` template tag:
```html
{% load django_bootstrap5 django_bootstrap_input_group %}
<form>
{% bootstrap_input_group form.first_name form.last_name label="Name" %}
{% bootstrap_field form.notes %}
</form>
```
## Template tag arguments
The `bootstrap_input_group` tag takes (bound) form fields as positional arguments.
It also takes an optional keyword argument `label` which specifies the label for the group
(if no label is provided, it defaults to the label of the first field in a group).
Other than that, the `django_bootstrap_input_group` template tags take the same arguments as their
`django_bootstrap5` counterparts
(see here for a [list of the template tags and their parameters](https://django-bootstrap5.readthedocs.io/en/latest/templatetags.html)).
## CSS
This package ships with an additional css file `django_bootstrap_input_group/css/bootstrap_input_group.css`
which includes rules that tweak the look of `RadioSelectButtonGroup` widgets when rendered inside an input group.
The rules:
* vertically align the label text of the options
* remove rounded corners of label elements (where necessary)
Simply include the css file in your [form's media](https://docs.djangoproject.com/en/4.1/topics/forms/media/#media-on-forms)
(also: [How to manage static files](https://docs.djangoproject.com/en/4.1/howto/static-files/)).
نحوه نصب
نصب پکیج whl django-bootstrap-input-group-1.0.1:
pip install django-bootstrap-input-group-1.0.1.whl
نصب پکیج tar.gz django-bootstrap-input-group-1.0.1:
pip install django-bootstrap-input-group-1.0.1.tar.gz