Update docs about validations #143
Open
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Nasutya
reviewed
Nov 9, 2023
| summary: Описание валидации и её настройки в приложениях ember-flexberry | ||
| --- | ||
|
|
||
| Практически неотъемлемой частью любого приложения, работающего с пользовательским вводом данных, является валидация этих данных. Валидация служит не только для предотвращения ошибок в приложении, но и для облегчения работы пользователя с приложением, предоставляя ему подсказки по ожидаемым форматам и ограничениям вводимых данных. |
There was a problem hiding this comment.
Второе предложение лучше начать с "Она"
|
|
||
| Практически неотъемлемой частью любого приложения, работающего с пользовательским вводом данных, является валидация этих данных. Валидация служит не только для предотвращения ошибок в приложении, но и для облегчения работы пользователя с приложением, предоставляя ему подсказки по ожидаемым форматам и ограничениям вводимых данных. | ||
|
|
||
| Валидация данных в приложениях на основе `Flexberry Ember` дополняет серверную валидацию, обычно реализуемую с помощью [бизнес-сервера объектов данных Flexberry ORM](fo_business-server.html). |
There was a problem hiding this comment.
после "серверную" не надо второй раз про валидацию
|
|
||
| ## Описание правил валидации | ||
|
|
||
| Способ описания правил валидации зависит от используемого в приложении аддона для валидации, это может быть [`ember-cp-validations`](#ember-cp-validations) или [`ember-validations`](#ember-validations). При генерации модели по её метаданным, также генерируется набор правил для её валидации, который зависит от различных параметров, указанных для атрибутов модели. |
There was a problem hiding this comment.
после "правил" убрать "валидации" достаточно второго упоминания
|
|
||
| ### ember-cp-validations | ||
|
|
||
| Аддон [`ember-cp-validations`](https://github.com/offirgolan/ember-cp-validations) имеет большой набор встроенных валидаторов гибко настраиваемых с помощью параметров, что позволяет описывать сложные правила валидации модели. |
|
|
||
| Аддон [`ember-cp-validations`](https://github.com/offirgolan/ember-cp-validations) имеет большой набор встроенных валидаторов гибко настраиваемых с помощью параметров, что позволяет описывать сложные правила валидации модели. | ||
|
|
||
| Чтобы реализвать валидацию модели с использованием аддона `ember-cp-validations`, необходимо использовать функцию `buildValidations`, предоставляемую этим аддоном, функция создаёт миксин, который нужно добавить к классу модели. |
| }); | ||
| ``` | ||
|
|
||
| Чтобы отключить валидацию в какой либо форме, необходимо установить `null` в значение свойства `validationModel` контроллера этой формы. |
There was a problem hiding this comment.
Для отключения валидации, какой-либо
|
|
||
| При необходимости можно установить в приложении оба аддона для валидации, и `ember-cp-validations`, и `ember-validations`, генерация моделей при этом будет выполнятся для аддона `ember-cp-validations`. | ||
|
|
||
| Если в приложении стауновен аддон `ember-validations`, и вы хотите дополнительно установить `ember-cp-validations`, выполните команду: |
There was a problem hiding this comment.
Если в приложении установлен... и требуется дополнительно ember-cp-validations, следует выполнить
| ember generate use-ember-cp-validations | ||
| ``` | ||
|
|
||
| При выполнении этой команды, в приложение будет установлен аддон `ember-cp-validations`, и добавлен сервис `validations` для совместимости аддонов. |
|
|
||
| При выполнении этой команды, в приложение будет установлен аддон `ember-cp-validations`, и добавлен сервис `validations` для совместимости аддонов. | ||
|
|
||
| Если в приложении стауновен аддон `ember-cp-validations`, и вы хотите дополнительно установить `ember-validations`, выполните команду: |
There was a problem hiding this comment.
Аналогично подобной фразе выше
| ember generate use-ember-validations | ||
| ``` | ||
|
|
||
| При выполнении этой команды, в приложение будет установлен аддон `ember-validations`, и добавлен сервис `validations` для совместимости аддонов. |
|
Я бы в первую очередь проверил актуальность этой документации, давно это было всё таки. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
https://kollegoff.github.io/flexberry.github.io/ru/efd3_validations.html