From 4bf59d7b344eac9cfc6e1370c797d46c2546047d Mon Sep 17 00:00:00 2001 From: Mikhail Chechnev Date: Sun, 26 May 2024 22:49:12 +0300 Subject: [PATCH] =?UTF-8?q?=D0=98=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BA?= =?UTF-8?q?=D1=86=D0=B8=D0=B8:=20=D0=BA=D1=80=D0=B0=D1=82=D0=BA=D0=B8?= =?UTF-8?q?=D0=B5=20=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB=D0=B0=20=D1=80?= =?UTF-8?q?=D0=B0=D0=B7=D1=80=D0=B0=D0=B1=D0=BE=D1=82=D0=BA=D0=B8=20UI?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index 1a62919..4e41d86 100644 --- a/README.md +++ b/README.md @@ -2241,3 +2241,14 @@ const Svg = ({ title }) => { ``` Полные актуальные исходные коды примера можно увидеть в "app/panels/samples/svg.js" данного репозитория соответственно. + +### Ограничения дизайна пользовательского интерфейса + +Фреймворк позволяет реализовать любые пользовательские интерфейсы, вёрстка которых не противоречит возможностям современного HTML. Тем не менее, при разработке пользовательских интерфейсов панелей важно придерживаться предложенных ниже правил. Это позволит создавать их в едином ключе и упростит работу конечного пользователя при их освоении. + +- Избегайте нестандартных реакций элементов пользовательского интерфейса на действия пользователя. Например, выпадающий список при активации должен отобразить состав своих элементов, а не вызывать бизнес-функцию отработки документа. +- Избегайте прямого применения HTML-тэгов. В библиотеке [MUI](https://mui.com/), включенной во фреймворк, есть всё необходимое для сборки интерфейса. +- Старайтесь не применять `
` для всёрстки - для этого в [MUI](https://mui.com/) есть группа компонентов разметки ("Layout"), используйте их (`Grid`, `Box`, `Container`, `Stack`, `Paper` и пр.). +- Старайтесь не использовать без острой необходимости атрибуты `sx` и `style` - всё необходимое для стилизации как правило есть в атрибутах компонента [MUI](https://mui.com/), изучите его документацию. Если применение собственного стиля неизбежно - старайтесь выносить стили в единое место в коде, переиспользовать их, и импортировать там, где это необходимо. +- Придерживайтесь единой цветовой гаммы при реализации всех панелей (в идеале) или, если не удаётся, панелей, отнесённых к одному прикладному участку (ПУДП, УЗСР, БУ, ПУП и т.п.). +- Изучите и применяйте `ThemeProvider` из состава инструментов стилизации библиотеки [MUI](https://mui.com/) для придания индивидуальности панелям и их компонентам.