Рекомендации по кодированию HTML
Мы используем шаблоны Django для создания HTML.
Проверка HTML на ошибки
Мы используем jinjalint для проверки шаблонов на ошибки. Если вы установили зависимости для тестирования Wagtail (pip install -e .[testing]), вы можете проверить свой код, выполнив make lint.
Принципы
- Создавайте валидный HTML. Мы используем доктайп HTML5.
- Создавайте семантический HTML.
- Используйте Практические рекомендации по ARIA, в частности Нет ARIA лучше, чем плохое ARIA.
- Присоединяйте поведение JavaScript с помощью
data-атрибутов, а не классов или идентификаторов. - Для комментариев используйте синтаксис шаблонов Django вместо HTML.
© 2014-present Torchbox Ltd and individual contributors.
All rights are reserved.
Licensed under the BSD License.
https://docs.wagtail.org/en/v2.16.3/contributing/html_guidelines.html