diff --git a/_config.yml b/_config.yml index 9ec3c24b3..48f783119 100644 --- a/_config.yml +++ b/_config.yml @@ -54,6 +54,8 @@ feedback_subject_line: Flexberry documentation feedback_email: mail@flexberry.net # used as a contact email for the Feedback link in the top navigation bar +test_stand_3x_url: 'http://flexberry.github.io/ember-flexberry/dummy/dummy-test-2' + # Build settings encoding: utf-8 markdown: kramdown diff --git a/_data/sidebars/flexberry-ember-3_sidebar.yml b/_data/sidebars/flexberry-ember-3_sidebar.yml index a6ae6927c..047aca0cb 100644 --- a/_data/sidebars/flexberry-ember-3_sidebar.yml +++ b/_data/sidebars/flexberry-ember-3_sidebar.yml @@ -90,6 +90,10 @@ entries: output: web, pdf folderitems: + - title: Components for edit-forms + title_ru: Компоненты для работы с данными на форме редактирования + url: /ef3_edit-form-components.html + output: web, pdf - title: Services title_ru: Сервисы diff --git a/css/customstyles.css b/css/customstyles.css index 584893f44..1b06b5f61 100644 --- a/css/customstyles.css +++ b/css/customstyles.css @@ -76,7 +76,7 @@ h4[id], h5[id], h6[id], dt[id]{ -padding-top: 90px; +padding-top: 100px; margin-top: -90px } @@ -625,8 +625,8 @@ a.fa.fa-envelope-o.mailto { font-weight: 600; } -h3 {color: #ED1951; font-weight:normal; font-size:130%;} -h4 {color: #808080; font-weight:normal; font-size:120%;} +h3 {color: #ED1951; font-weight:normal;} +h4 {color: #333333; font-weight:normal; font-size:120%;} .alert, .callout { overflow: hidden; diff --git a/css/theme-flexberry.css b/css/theme-flexberry.css index b1fa187e2..a9269f464 100644 --- a/css/theme-flexberry.css +++ b/css/theme-flexberry.css @@ -56,11 +56,10 @@ h2 { } h4 { - color: #650f8b; font-size: 20px; /*line-height: 30px;*/ margin-bottom: 20px; - font-weight: 500; + font-weight: 400; } .flexberry-logo { @@ -224,6 +223,8 @@ li.sidebarTitle { /*Underline header*/ .item-head { + color: #650f8b; + font-weight: 500; text-decoration: none; border-bottom: 1px solid rgba(101, 15, 139, 0.3); } diff --git a/images/favicon.ico b/images/favicon.ico index 71ab5e7ef..61fd0148f 100644 Binary files a/images/favicon.ico and b/images/favicon.ico differ diff --git a/images/pages/products/flexberry-ember/3.x/components/flexberry-button.png b/images/pages/products/flexberry-ember/3.x/components/flexberry-button.png new file mode 100644 index 000000000..33eff50ae Binary files /dev/null and b/images/pages/products/flexberry-ember/3.x/components/flexberry-button.png differ diff --git a/images/pages/products/flexberry-ember/3.x/components/flexberry-checkbox.png b/images/pages/products/flexberry-ember/3.x/components/flexberry-checkbox.png new file mode 100644 index 000000000..1b49159df Binary files /dev/null and b/images/pages/products/flexberry-ember/3.x/components/flexberry-checkbox.png differ diff --git a/images/pages/products/flexberry-ember/3.x/components/flexberry-ddau-slider.png b/images/pages/products/flexberry-ember/3.x/components/flexberry-ddau-slider.png new file mode 100644 index 000000000..2c3b25032 Binary files /dev/null and b/images/pages/products/flexberry-ember/3.x/components/flexberry-ddau-slider.png differ diff --git a/images/pages/products/flexberry-ember/3.x/components/flexberry-dropdown.png b/images/pages/products/flexberry-ember/3.x/components/flexberry-dropdown.png new file mode 100644 index 000000000..22fa8c794 Binary files /dev/null and b/images/pages/products/flexberry-ember/3.x/components/flexberry-dropdown.png differ diff --git a/images/pages/products/flexberry-ember/3.x/components/flexberry-edit-panel.png b/images/pages/products/flexberry-ember/3.x/components/flexberry-edit-panel.png new file mode 100644 index 000000000..fb74d0331 Binary files /dev/null and b/images/pages/products/flexberry-ember/3.x/components/flexberry-edit-panel.png differ diff --git a/images/pages/products/flexberry-ember/3.x/components/flexberry-field.png b/images/pages/products/flexberry-ember/3.x/components/flexberry-field.png new file mode 100644 index 000000000..6e1a6f59e Binary files /dev/null and b/images/pages/products/flexberry-ember/3.x/components/flexberry-field.png differ diff --git a/images/pages/products/flexberry-ember/3.x/components/flexberry-jsonarea.png b/images/pages/products/flexberry-ember/3.x/components/flexberry-jsonarea.png new file mode 100644 index 000000000..a4a169386 Binary files /dev/null and b/images/pages/products/flexberry-ember/3.x/components/flexberry-jsonarea.png differ diff --git a/images/pages/products/flexberry-ember/3.x/components/flexberry-simpledatetime.png b/images/pages/products/flexberry-ember/3.x/components/flexberry-simpledatetime.png new file mode 100644 index 000000000..c02d050c5 Binary files /dev/null and b/images/pages/products/flexberry-ember/3.x/components/flexberry-simpledatetime.png differ diff --git a/images/pages/products/flexberry-ember/3.x/components/flexberry-textarea.png b/images/pages/products/flexberry-ember/3.x/components/flexberry-textarea.png new file mode 100644 index 000000000..efe199d52 Binary files /dev/null and b/images/pages/products/flexberry-ember/3.x/components/flexberry-textarea.png differ diff --git a/images/pages/products/flexberry-ember/3.x/components/flexberry-textbox.png b/images/pages/products/flexberry-ember/3.x/components/flexberry-textbox.png new file mode 100644 index 000000000..45e4b2f67 Binary files /dev/null and b/images/pages/products/flexberry-ember/3.x/components/flexberry-textbox.png differ diff --git a/pages/products/flexberry-ember/3.x/components/ef3_edit-form-components.ru.md b/pages/products/flexberry-ember/3.x/components/ef3_edit-form-components.ru.md new file mode 100644 index 000000000..b908ecaae --- /dev/null +++ b/pages/products/flexberry-ember/3.x/components/ef3_edit-form-components.ru.md @@ -0,0 +1,411 @@ +--- +title: Компоненты для работы с данными на форме редактирования (edit-form) +sidebar: flexberry-ember-3_sidebar +keywords: Flexberry Ember +toc: true +permalink: ru/ef3_edit-form-components.html +lang: ru +summary: Перечень компонентов, используемых для отображения данных +--- + +## Компоненты для отображения текстовых полей + +### flexberry-field + +`flexberry-field` - компонент для отображения текстовых полей вместе с надписями. +Общий вид компонента, в случае, если текущая тема оформления [Ghost](ef2_supported_themes.html#ghost-theme): + +![flexberry-field](/images/pages/products/flexberry-ember/3.x/components/flexberry-field.png) + +Чтобы добавить `flexberry-field` на страницу, в шаблоне нужно указать: + +```hbs +{% raw %}{{flexberry-field + value=model.text + label=label + placeholder=placeholder + readonly=readonly + type=type + maxlength=maxlength +}}{% endraw %} +``` + +#### Свойства flexberry-field + +Свойство | Краткое описание +:--------|:---------------- +Свойства `componentName` и `readonly` | Свойства из [базового контрола](ef2_base-component.html). +`value` | Определяет значение, которое будет отображаться. +`placeholder` | Определяет placeholder. +`label` | Определяет заголовок поля. +`classNames` | Определяет css-class на компонент. +`type` | Определяет вид компонента. +`maxlength` | Определяет максимальное количество символов (в единицах кода UTF-16), которое может ввести пользователь. +`appConfigSettingsPath` | Определяет путь к настройкам компонента в конфигурации приложения. + +[Пример работы с настройками]({{site.test_stand_3x_url}}/#/components-examples/flexberry-field/settings-example) `flexberry-field` на тестовом стенде. + +### flexberry-textbox + +`flexberry-textbox` - компонент для отображения текстовых полей в виде одной строки. +Общий вид компонента, в случае, если текущая тема оформления [Ghost](ef2_supported_themes.html#ghost-theme): + +![flexberry-textbox](/images/pages/products/flexberry-ember/3.x/components/flexberry-textbox.png) + +Чтобы добавить `flexberry-textbox` на страницу, в шаблоне нужно указать: + +```hbs +{% raw %}{{flexberry-textbox + value=model.text + placeholder=placeholder + readonly=readonly + class=class + maxlength=maxlength +}}{% endraw %} +``` + +#### Свойства flexberry-textbox + +Свойство | Краткое описание +:--------|:---------------- +Свойства `componentName` и `readonly` | Свойства из [базового контрола](ef2_base-component.html). +`value` | Определяет значение, которое будет отображаться. +`placeholder` | Определяет placeholder. +`classNames` | Определяет css-class на компонент. +`type` | Определяет вид компонента. +`maxlength` | Определяет максимальное количество символов (в единицах кода UTF-16), которое может ввести пользователь. +`appConfigSettingsPath` | Определяет путь к настройкам компонента в конфигурации приложения. + +[Пример работы с настройками]({{site.test_stand_3x_url}}/#/components-examples/flexberry-textbox/settings-example) `flexberry-textbox` на тестовом стенде. + +### flexberry-textarea + +`flexberry-textarea` - компонент для отображения текстовых полей в виде области, в которую можно вводить несколько строк. +Общий вид компонента, в случае, если текущая тема оформления [Ghost](ef2_supported_themes.html#ghost-theme): + +![flexberry-textarea](/images/pages/products/flexberry-ember/3.x/components/flexberry-textarea.png) + +Чтобы добавить `flexberry-textarea` на страницу, в шаблоне нужно указать: + +```hbs +{% raw %}{{flexberry-textarea + value=model.text + placeholder=placeholder + readonly=readonly + class=class + rows=rows + cols=cols + maxlength=maxlength +}}{% endraw %} +``` + +#### Свойства flexberry-textarea + +Свойство | Краткое описание +:--------|:---------------- +Свойства `componentName` и `readonly` | Свойства из [базового контрола](ef2_base-component.html). +`value` | Определяет значение, которое будет отображаться. +`placeholder` | Определяет placeholder. +`classNames` | Определяет css-class на компонент. +`appConfigSettingsPath` | Определяет путь к настройкам компонента в конфигурации приложения. +`rows` | Определяет количество строк таблицы, связанных с текстовой областью. +`cols` | Определяет количество столбцов таблицы, связанных с текстовой областью. + +[Пример работы с настройками]({{site.test_stand_3x_url}}/#/components-examples/flexberry-textarea/settings-example) `flexberry-textarea` на тестовом стенде. + +## Компоненты для отображения даты + +### flexberry-simpledatetime + +`flexberry-simpledatetime` - компонент для отображения даты/даты и времени. + +![flexberry-simpledatetime](/images/pages/products/flexberry-ember/3.x/components/flexberry-simpledatetime.png) + +Чтобы добавить `flexberry-simpledatetime` на страницу, в шаблоне нужно указать: + +```hbs +{% raw %}{{flexberry-simpledatetime + type=type + removeButton=removeButton + value=model.date + min=min + max=max + readonly=readonly +}}{% endraw %} +``` + +#### Свойства flexberry-simpledatetime + +Свойство | Краткое описание +:--------|:---------------- +Свойства `componentName` и `readonly` | Свойства из [базового контрола](ef2_base-component.html). +`value` | Определяет значение, которое будет отображаться. +`placeholder` | Определяет placeholder. +`classNames` | Определяет css-class на компонент. +`defaultMinute` | Определяет значение минут по умолчанию. +`defaultHour` | Определяет значение часов по умолчанию. +`useBrowserInput` | Флаг, определяющий нужно ли использовать импут браузера +`min` | Определяет самую раннюю дату, которую пользователь может выбрать. +`max` | Определяет самую последнюю дату, которую пользователь может выбрать. +`type` | Определяет вид компонента. +`canClick` | Флаг, определяющий нужно ли onClick вызывать flatpickr.open() +`removeButton` | Флаг, определяющий, отображать ли кнопку удаления у flatpickr +`locale` | Определяет локали (Если значение не определено, используется языковой стандарт приложения). + +[Пример работы с настройками]({{site.test_stand_3x_url}}/#/components-examples/flexberry-simpledatetime/settings-example) `flexberry-simpledatetime` на тестовом стенде. + +## Компоненты для отображения логических полей + +### flexberry-checkbox + +`flexberry-checkbox` - компонент для отображения логических данных. + +![flexberry-checkbox](/images/pages/products/flexberry-ember/3.x/components/flexberry-checkbox.png) + +Чтобы добавить `flexberry-checkbox` на страницу, в шаблоне нужно указать: + +```hbs +{% raw %}{{flexberry-checkbox + value=model.flag + label=label + readonly=readonly + class=class +}}{% endraw %} +``` + +#### Свойства flexberry-checkbox + +Свойство | Краткое описание +:--------|:---------------- +Свойства `componentName` и `readonly` | Свойства из [базового контрола](ef2_base-component.html). +`value` | Определяет значение, которое будет отображаться. +`classNames` | Определяет css-class на компонент. +`label` | Определяет label. + +[Пример работы с настройками]({{site.test_stand_3x_url}}/#/components-examples/flexberry-checkbox/settings-example) `flexberry-checkbox` на тестовом стенде. + +### flexberry-ddau-checkbox + +`flexberry-ddau-checkbox` - компонент для отображения логических данных. + +![components/flexberry-checkbox](/images/pages/products/flexberry-ember/3.x/components/flexberry-checkbox.png) + +Чтобы добавить `flexberry-ddau-checkbox` на страницу, в шаблоне нужно указать: + +```hbs +{% raw %}{{flexberry-ddau-checkbox + class=class + value=model.flag + caption=caption + readonly=readonly + change=(action "onCheckboxChange" "model.flag") +}}{% endraw %} +``` + +#### Свойства flexberry-ddau-checkbox + +Свойство | Краткое описание +:--------|:---------------- +`readonly` | Определяет, доступен ли объект только для чтения. По умолчанию данное свойство имеет значение `false`. +`value` | Определяет значение, которое будет отображаться. +`classNames` | Определяет css-class на компонент. +`caption` | Определяет заголовок компонента. + +[Пример работы с настройками]({{site.test_stand_3x_url}}/#/components-examples/flexberry-ddau-checkbox/settings-example) `flexberry-ddau-checkbox` на тестовом стенде. + +## Компоненты для отображения перечисления + +### flexberry-dropdown + +`flexberry-dropdown` - компонент для отображения перечисления. + +![flexberry-dropdown](/images/pages/products/flexberry-ember/3.x/components/flexberry-dropdown.png) + +Чтобы добавить flexberry-dropdown на страницу, в шаблоне нужно указать: + +```hbs +{% raw %}{{flexberry-dropdown + items=(flexberry-enum "components-examples/flexberry-dropdown/settings-example/enumeration") + value=model.enumeration + placeholder=placeholder + readonly=readonly + class=class +}}{% endraw %} +``` + +#### Свойства flexberry-dropdown + +Свойство | Краткое описание +:--------|:---------------- +Свойства `componentName` и `readonly` | Свойства из [базового контрола](ef2_base-component.html). +`value` | Определяет значение, которое будет отображаться. +`class` | Определяет css-class на компонент. +`items` | Определяет перечисление. +`placeholder` | Определяет placeholder. +`appConfigSettingsPath` | Определяет путь к настройкам компонента в конфигурации приложения. +`isSearch` | Режим автокомплита в dropdown-е. + +[Пример работы с настройками]({{site.test_stand_3x_url}}/#/components-examples/flexberry-dropdown/settings-example) `flexberry-dropdown` на тестовом стенде. + +## Компоненты для отображения JSON + +### flexberry-jsonarea + +`flexberry-jsonarea` - компонент для отображения JSON. + +![flexberry-jsonarea](/images/pages/products/flexberry-ember/3.x/components/flexberry-jsonarea.png) + +Чтобы добавить `flexberry-jsonarea` на страницу, в шаблоне нужно указать: + +```hbs +{% raw %}{{flexberry-jsonarea + value=model.json + placeholder=placeholder + readonly=readonly + classNames=classNames +}}{% endraw %} +``` + +#### Свойства flexberry-jsonarea + +Свойство | Краткое описание +:--------|:---------------- +`readonly` | Определяет, доступен ли объект только для чтения. По умолчанию данное свойство имеет значение `false`. +`value` | Определяет значение, которое будет отображаться. +`classNames` | Определяет css-class на компонент. +`placeholder` | Определяет placeholder. + +## Компоненты для управления формой + +### flexberry-edit-panel + +`flexberry-edit-panel` - компонент для адаптивного отображения кнопок в тулбаре формы редактирования. + +![flexberry-edit-panel](/images/pages/products/flexberry-ember/3.x/components/flexberry-edit-panel.png) + +Чтобы добавить `flexberry-edit-panel` на страницу, в шаблоне нужно указать: + +```hbs +{% raw %}{{flexberry-edit-panel + showCloseButton=true + deepMount=true + buttons=(array + (hash + type="submit" + class="save-button" + disabled=(readonly) + text=(t "forms.edit-form.save-button-text") + action="save") + (hash + type="submit" + class="save-close-button" + disabled=(readonly) + text=(t "forms.edit-form.saveAndClose-button-text") + action="saveAndClose" + ) + (hash + type="submit" + class="save-del-button" + disabled=(and model.isNew readonly) + text=(t "forms.edit-form.delete-button-text") + action="delete" + )) +}}{% endraw %} +``` + +#### Свойства flexberry-edit-panel + +Свойство | Краткое описание +:--------|:---------------- +`showCloseButton` | Определяет, показывать ли кнопку Закрыть в тулбаре. По умолчанию данное свойство имеет значение `false`. +`deepMount` | Определяет вычитку действий кнопок. По умолчанию данное свойство имеет значение `false`. +`buttons` | Задает список кнопок для отображения в компоненте. + +[Пример использования]({{site.test_stand_3x_url}}/#/ember-flexberry-dummy-suggestion-list) `flexberry-edit-panel` на форме редактирования на тестовом стенде. + +### flexberry-button + +`flexberry-button` - компонент для создания на веб-странице кнопки. + +![flexberry-button](/images/pages/products/flexberry-ember/3.x/components/flexberry-button.png) + +Чтобы добавить `flexberry-button` на страницу, в шаблоне нужно указать: + +```hbs +{% raw %}{{flexberry-button + class=class + iconClass=class + caption=caption + tooltip=tooltip + readonly=readonly + click=(action "onButtonClick") +}}{% endraw %} +``` + +#### Свойства flexberry-button + +Свойство | Краткое описание +:--------|:---------------- +`readonly` | Определяет, доступен ли объект только для чтения. По умолчанию данное свойство имеет значение `false`. +`classNames` | Определяет css-class на компонент. +`caption` | Определяет заголовок компонента. +`tooltip` | Определяет текст подсказки компонента. +`iconClass` |Определяет css-class для иконки компонент. + +[Пример работы с настройками]({{site.test_stand_3x_url}}/#/components-examples/flexberry-button/settings-example) `flexberry-button` на на тестовом стенде. + +### flexberry-ddau-slider + +`flexberry-ddau-slider` - компонент для создания на веб-странице ползунка. + +![flexberry-ddau-slider](/images/pages/products/flexberry-ember/components/flexberry-ddau-slider.png) + +Чтобы добавить `flexberry-ddau-slider` на страницу, в шаблоне нужно указать: + +```hbs +{% raw %}{{flexberry-ddau-slider + classNames=classNames + value=model.opacity + min=min + max=max + defaultValue=defaultValue + step=step + readonly=readonly + change=(action "onOpacitySliderChange") +}}{% endraw %} +``` + +#### Свойства flexberry-ddau-slider + +Свойство | Краткое описание +:--------|:---------------- +`readonly` | Определяет, доступен ли объект только для чтения. По умолчанию данное свойство имеет значение `false`. +`classNames` | Определяет css-class на компонент. +`value` | Определяет значение, которое будет отображаться. +`min` | Определяет минимальное значение компонента. +`max` | Определяет максимальное значение компонента. +`step` | Определяет шаг диапазона компонента. +`defaultValue` | Определяет начальное значение компонента. + +### flexberry-colorpicker + +`flexberry-colorpicker` - компонент для выбора цветов на веб-странице. + +![components/flexberry-colorpicker](/images/pages/products/flexberry-ember/3.x/components/flexberry-colorpicker.png) + +Чтобы добавить `flexberry-colorpicker` на страницу, в шаблоне нужно указать: + +```hbs +{% raw %}{{flexberry-colorpicker + value=value + class=class + change=(action "onGradientColorEndChange") +}}{% endraw %} +``` + +#### Свойства flexberry-colorpicker + +Свойство | Краткое описание +:--------|:---------------- +`classNames` | Определяет css-class на компонент. +`value` | Определяет значение, которое будет отображаться.