В интерфейсе Flask разделяйте показ данных и проверку пользовательского ввода. Jinja собирает HTML из шаблона и контекста, фильтр преобразует представление значения, макрос помогает повторять разметку, WTForms задаёт поля и правила проверки. Красиво отображённая форма ещё не означает, что её данные допустимы для сохранения.
Выберите инструкцию под свою задачу. Ниже — подробный разбор выбора и проверки результата.
вводный маршрут от данных представления к HTML. Контекстный процессор рассмотрен как способ добавлять общие сведения шаблонам.
Читать материалполезен, когда нужно повторяемое преобразование представления значения. Не смешивайте его с изменением исходных данных.
Читать материалинструмент для сокращения повторяющейся разметки. Выделяйте общий элемент после того, как понятны его состояния и параметры.
Читать материалпереход к правилам допустимого ввода. Используйте вместе с проверкой поведения формы после ошибки.
Читать материал| Задача | Механизм | Что проверить |
|---|---|---|
| Передать сведения странице | Контекст шаблона | Шаблон получил нужные значения |
| Изменить вид одного значения | Фильтр Jinja | Представление соответствует требованию |
| Повторить структуру поля | Макрос | Одинаковые элементы оформлены согласованно |
| Принять ввод пользователя | Серверная валидация формы | Неверный ввод не принят как правильный |
Например, контактная форма может показывать имя пользователя, одинаково оформлять поля и проверять адрес электронной почты. Первые два результата относятся к отображению, последний — к допустимости данных. Перенос проверки в оформление не создаёт эквивалентной защиты: сервер должен отдельно решить, можно ли продолжать обработку.
Для первого упражнения возьмите одну форму с двумя полями. Запишите, какие данные она показывает при открытии и какие принимает после отправки. Затем подготовьте корректный ввод, пустое обязательное поле и значение неверного формата. Это даёт понятную основу проверки ещё до создания общих макросов и дополнительных фильтров.
Начните с явной разметки и одного понятного результата. Когда форма правильно отображает значения и ошибки, найдите повторяющиеся элементы: подпись, поле, сообщение. Их можно вынести в макрос с параметрами. Это надёжнее, чем сразу проектировать универсальный компонент, не зная, какие состояния он должен поддерживать.
Проверьте, что сообщение об ошибке связано с нужным полем и пользователь понимает, что исправить. Не ограничивайтесь техническим фактом отказа в обработке. Полезный интерфейс показывает контекст ошибки и сохраняет допустимую часть введённых сведений в соответствии с правилами формы, чтобы человек мог продолжить действие.
Фильтр оцените отдельно на обычном и пустом значениях. Если изменение нужно только для вида страницы, не позволяйте ему незаметно менять данные, которые будут сохраняться. Назовите назначение преобразования и ожидаемый результат простым примером. Это поможет решить, относится ли действие к фильтру или к обработке запроса.
Добавляйте общие механизмы ради конкретного повторения или понятной границы ответственности. Если макрос усложняет единственную простую форму, его можно отложить. Если серверная проверка отсутствует, оформление и повторное использование разметки эту часть работы не завершают.