Framework для python Flask - Настройка Jinja

Старт:21.10.2024

Срок обучения:9 мес.

Python-разработчик

Практический онлайн-курс, на котором вы с нуля изучите самый универсальный и востребованный язык программирования — Python. Создадите свое портфолио разработчика, которое выгодно покажет вас на рынке труда, и сможете зарабатывать в IT через полгода.

136 000 ₽340 000 ₽

11 333₽/мес рассрочка

Подробнее

Для эффективной работы с шаблонами в Flask, используйте Jinja2. Эта библиотека предоставляет мощный инструмент для создания динамических веб-страниц. Ключевой момент: правильная настройка Jinja2 непосредственно влияет на производительность и удобочитаемость кода.

Настройте шаблонизатор Jinja2 в вашей Flask-приложении, используя расширение .html. Например, создайте файл templates/index.html для основной страницы:

templates/index.html:

Привет, мир! Сейчас {{ время }}

Далее, в вашем Flask-приложении импортируйте необходимый модуль из библиотеки и привяжите его к Flask-объекту. В файле приложения:

from flask import Flask, render_template
import datetime
app = Flask(__name__)
@app.route("/")
def index():
время = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
return render_template('index.html', время=время)
if __name__ == "__main__":
app.run(debug=True)

В этом примере, мы используем функцию render_template() для обработки шаблона и отображения текущего времени в HTML. Обратите внимание на синтаксис {{ время }} в шаблоне для обращения к переменной.

Framework для Python Flask - Настройка Jinja

Для настройки Jinja в Flask, начните с импорта необходимых модулей:

• from flask import Flask, render_template

Создайте экземпляр приложения Flask:

app = Flask(__name__)

Определите маршрут и функцию обработчик:

@app.route("/")
def index():
data = {"title": "Мой сайт", "message": "Привет, мир!"}
return render_template("index.html", data)

 templates/index.html 
{{ message }}

if __name__ == "__main__":
app.run(debug=True)

@app.route("/about")
def about():
return render_template("about.html")

Привет, {{ имя }}!
Ваш возраст: { возраст }

from flask import Flask, render_template
app = Flask(__name__)
@app.route("/")
def index():
data = {"имя": "Вася", "возраст": 30}
return render_template("template.html", data)
if __name__ == "__main__":
app.run(debug=True)

Обратите внимание на использование словаря data для передачи данных в шаблон.

Ключевые слова {{ }} обозначают переменные, а | - фильтры. Фильтр string преобразует число в строку.

Если нужно вывести список, используйте циклы:

Шаблон (template.html):

{{ item }}
{ item }} {{ item}

Код Python (app.py):

from flask import Flask, render_template
app = Flask(__name__)
@app.route("/")
def index():
items = ["яблоко", "груша", "банан"]
return render_template("template.html", items=items)
if __name__ == "__main__":
app.run(debug=True)

Здесь items - список, передаваемый в шаблон. Обратите внимание на использование фильтра upper для преобразования в верхний регистр.

Передача данных из Flask в Jinja шаблоны

Для передачи данных из Flask в Jinja шаблоны используйте контекстные переменные. Это самый прямой и удобный способ.

from flask import Flask, render_template
app = Flask(__name__)
@app.route("/")
def index():
data = {'name': 'John', 'age': 30, 'city': 'New York'}
return render_template('index.html', user=data)

Привет, {{ user['name'] }}!
Вам {{ user['age'] }} лет.
Вы из {{ user['city'] }}.

from flask import Flask, render_template_string
app = Flask(__name__)
@app.route("/")
def index():
name = "Alice"
data = f"Привет, {name}!"
return render_template_string(data)

Данные переданы из Flask в строковом виде : {data} 

@app.route('/users')
def users():
users_list = [
{'name': 'Иван', 'age': 30},
{'name': 'Мария', 'age': 25}
]
return render_template('users.html', users=users_list)

Имя: {{ user['name'] }}, Возраст: {{ user['age'] }}

Все переменные доступны в шаблонах Jinja через двойные фигурные скобки ({{ ... }}).

Проверьте правильность именования переменных в шаблоне Jinja и в функции `render_template`, чтобы избежать ошибок.

Использование фильтров Jinja2

Для преобразования данных в шаблонах используйте фильтры Jinja2. Ниже примеры.

• Фильтр `lower`: Приводит текст к нижнему регистру.

Пример: { 'HELLO WORLD' } выведет hello world.

• Фильтр `upper`: Приводит текст к верхнему регистру.

Пример: { 'hello world' } выведет HELLO WORLD.

• Фильтр `title`: Делает первую букву каждого слова заглавной.

Пример: { 'hello world' } выведет Hello World.

• Фильтр `capitalize`: Делает первую букву строки заглавной.

Пример: capitalize } выведет Hello world.

• Фильтр `trim`: Удаляет пробелы в начале и конце строки.

Пример: trim } выведет Hello world.

• Фильтр `length`: Возвращает длину строки или списка.

Пример для строки: length } выведет 11.
Пример для списка: length } выведет 3.

• Фильтр `date`: Форматирует дату.

Необходим импорт `datetime`:

from datetime import datetime
Пример: date('Y-m-d') } выведет дату в формате 'YYYY-MM-DD', предполагая, что my_date - это объект `datetime`.

Обратите внимание: Наименования фильтров чувствительны к регистру. Перед применением фильтра убедитесь в корректности называния.

Для более сложных задач вы можете создавать собственные фильтры Jinja2.

Работа с циклами и условными операторами в Jinja2

Циклы в Jinja2 позволяют итерировать по спискам, кортежам и другим итерируемым объектам. Ключевое слово {% for %} используется для итерации.

Пример:

{% for item in items %}
{{ item }}
{% endfor %}

В данном примере переменная items содержит список, и каждый элемент списка будет выведен в отдельном абзаце.

Дополнительные возможности: Для доступа к индексу элемента используется loop.index. Если нужен последний элемент, можно использовать loop.last.

Пример с индексами:

{% for item in items %}
Элемент {{ loop.index }}: {{ item }}
{% endfor %}

Условные операторы используются для выполнения определенного блока кода только при соблюдении определенного условия. Ключевое слово {% if %} обязательно.

Пример:

{% if user.is_active %}
Пользователь активен
{% else %}
Пользователь неактивен
{% endif %}

В примере, если атрибут user.is_active равен True, выведется сообщение "Пользователь активен". В противном случае - "Пользователь неактивен".

Вложенные циклы: Jinja2 позволяет вкладывать циклы.

{% for outer_item in outer_list %}
{{ outer_item }}
{% for inner_item in inner_list %}
{{ inner_item }}
{% endfor %}
{% endfor %}

Используйте эти инструменты для динамической генерации контента, основываясь на данных, передаваемых в шаблон.

Разница между render_template и render_string

render_template обрабатывает шаблоны Jinja2, находящиеся в файлах на диске. Это безопасный подход, т.к. Flask проверяет шаблоны на наличие потенциально опасных кодов. render_string принимает строку, содержащую шаблон. Этот метод удобен для динамических шаблонов, когда шаблон формируется кодом во время выполнения.

render_template:

• Работа с файлами шаблонов Jinja2;
• Безопасен, предотвращает внедрение вредоносного кода;
• Предпочтительный выбор для большинства случаев.

render_string:

• Принимает шаблон как строку;
• Необходимо вручную обрабатывать потенциальные уязвимости, если шаблон содержит пользовательский ввод;
• Используется, когда требуется формировать шаблон в коде на лету.

Пример использования render_template:

render_template('my_template.html', data=my_data) – обращается к файлу my_template.html и подставляет данные.

Пример использования render_string:

render_string('{{ data }}', data=my_data) – шаблон задан напрямую в строке. Следует позаботиться о безопасности, если data содержит потенциально опасный ввод!

Рекомендация: Используйте render_template, если это возможно. Если вам нужен динамический шаблон, формируемый напрямую в коде, используйте render_string, но тщательно проверяйте входные данные.

Вопрос-ответ:

Как правильно настроить Jinja2 для отображения данных из БД в Flask приложениях?

Для отображения данных из базы данных в шаблонах Jinja2 в Flask, нужно убедиться, что данные доступны в соответствующих переменных. В первую очередь, необходимо подключиться к базе данных (например, используя `sqlite3`, `psycopg2`, или другой драйвер). Затем, используя запросы SQL, получить необходимые записи. Ключевым моментом является передача этих данных в функцию представления (view function). Очень важно обработать полученные из базы данные и преобразовать их в удобный для шаблона формат. Например, если это список пользователей, нужно преобразовать каждый объект из базы в словарь или кортеж и собрать их в список. Этот список данных затем можно передать в шаблон Jinja2. Не забывайте о безопасности, экранируйте данные при выводе в шаблон. Пример: python from flask import Flask, render_template #... подключение к БД app = Flask(__name__) @app.route('/') def index(): users = get_users_from_db() return render_template('index.html', users=users) .В файле `index.html` вы уже можете использовать переменную `users` для цикличного вывода данных.

Какие есть общие ошибки при работе с фильтрами Jinja в Flask?

Частая ошибка – неправильное использование синтаксиса фильтров. Например, забыв колёны. Важно точно знать, какие фильтры поддерживает Jinja2 (например, `|safe`, `|capitalize`, `|date`) и использовать их с правильными аргументами. Ещё одна ошибка – попытка применить фильтр к несуществующему значению, например, обращение к списку, который ещё не заполнен. Проверка наличия и правильной структуры передаваемых данных - один из важнейших этапов. Проблемы могут возникнуть, если в передаваемой в шаблон переменной есть необработанные символы, особенно если данные получены из внешних источников; это может приводить к ошибкам (например, SQL-инъекциям). Регулярная проверка логики и данных перед использованием фильтров поможет избежать таких ошибок.

Нужно ли писать отдельные шаблоны для каждой страницы или можно обойтись одним?

Можно обойтись одним шаблоном, но это не всегда оптимальное решение. Если структура страниц достаточно развёрнутая, с большим разнообразием элементов, то лучше использовать отдельные шаблоны. Это помогает улучшить организацию кода, делает его более гибким и позволяет легко изменять отдельные части дизайна без влияния на остальные страницы. Такой подход делает код более понятным. При использовании многочисленных элементов, например, с циклами по длинным спискам данных, или с разной логикой на разных страницах, разработка с множеством файлов шаблонов может дать значимость, улучшая читаемость и поддерживаемость кода.

Как правильно передавать и использовать списки и словари в Jinja2 шаблонах? Примеры.

Списки и словари передаются в шаблоны так же, как и другие данные (переменные). Пример в коде: python from flask import Flask, render_template app = Flask(__name__) @app.route("/") def index(): items = [{'name': 'item1', 'price': 10}, {'name': 'item2', 'price': 20}] return render_template('index.html', items=items) В шаблоне `index.html`:

{% for item in items %}
• {{ item.name }} - ${{ item.price }}
{% endfor %}