<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Maksym Zhytlov on Medium]]></title>
        <description><![CDATA[Stories by Maksym Zhytlov on Medium]]></description>
        <link>https://medium.com/@maksym.zhytlov?source=rss-a887fdfe4110------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*BwUIjw9GUP9pTdEf6c_MJA.jpeg</url>
            <title>Stories by Maksym Zhytlov on Medium</title>
            <link>https://medium.com/@maksym.zhytlov?source=rss-a887fdfe4110------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Fri, 20 Nov 2026 10:22:36 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@maksym.zhytlov/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Кастомные элементы форм в Angular]]></title>
            <link>https://medium.com/@maksym.zhytlov/custom-form-controls-in-angular-4c69a94d5de6?source=rss-a887fdfe4110------2</link>
            <guid isPermaLink="false">https://medium.com/p/4c69a94d5de6</guid>
            <category><![CDATA[angular2]]></category>
            <category><![CDATA[rxjs]]></category>
            <category><![CDATA[reactive-programming]]></category>
            <category><![CDATA[angular]]></category>
            <category><![CDATA[forms]]></category>
            <dc:creator><![CDATA[Maksym Zhytlov]]></dc:creator>
            <pubDate>Sat, 10 Mar 2018 20:51:59 GMT</pubDate>
            <atom:updated>2018-03-13T06:12:12.834Z</atom:updated>
            <content:encoded><![CDATA[<p>По-моему мнению, реактивные формы — это одна из лучших вещей в Angular. Поскольку они упрощают работу с большими и действительно динамичными формами. Базовое API реактивных форм рассматривалось в <a href="https://medium.com/@maks.zhitlov/reactive-forms-in-angular-2f8abe884f79">прошлой статье</a>, а в этой мы рассмотрим создание кастомного элемента формы. <a href="https://maks-zhitlov.github.io/angular-reactive-forms/dist/">Демо</a> и <a href="https://github.com/Maks-Zhitlov/angular-reactive-forms/tree/custom-form-control/src/app">исходный код</a> того, что получилось в итоге.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8E0DugGaw0Gj_p08BJ-ajg.jpeg" /><figcaption>Custom form controls in angular</figcaption></figure><p>Могут быть разные причины для создания собственных элементов управления формой. Например, если мы посмотрим на форму регистрации из <a href="https://medium.com/@maks.zhitlov/reactive-forms-in-angular-2f8abe884f79">предыдущей статьи</a>, мы можем увидеть, что:</p><ul><li>можно сделать кастомный селект, который будет использоваться для выбора типа контакта и страны;</li><li>можно сделать собственный элемент для ввода пароля и его подтверждения, который будет содержать собственный валидатор и возвращать в форму всего одно значение;</li><li>или же, если бы у нас была необходимость в элементе ‘agree terms &amp; conditions’ — мы бы могли создать для этой цели кастомный formControl, который использовали бы во многих компонентах приложения.</li></ul><p>Но, прежде чем мы начнем создавать пользовательский элемент управления формой, давайте определим какими свойствами и поведением он должен обладать:</p><ul><li>корректно отображать значение в UI;</li><li>корректно передавать введенное пользователем значение из UI в модель;</li><li>передавать состояние валидации в DOM, что бы к компоненту можно было применить необходимые стили;</li><li>в случае необходимости — иметь собственные валидаторы;</li><li>работать с модель-ориентированными формами;</li><li>работать с шаблон-ориентированными формами;</li></ul><h4>Создание собственного select’a</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*edCRtf0YqesIARuEhC2jfg.png" /></figure><p>В этом примере мы рассмотрим создание достаточно простого компонента для выбора одного значения из списка возможных.</p><p>Для этих целей мы могли бы использовать элемент select. И, в большинстве случаев, я советовал бы Вам использовать именно его. Но мы хотим рассмотреть как можно создавать собственные элементы форм и такой компонент отлично подходит для этой тривиальной задачи. Кроме того, может быть достаточно много причин, почему нам необходим кастомный элемент для выбора значения.</p><p>Итак, давайте начнем с создания компонента CustomSelectComponent , который принимает из родительского компонента массив options и отображает его в шаблоне. Также у нас есть метод OptionsSelect , который сохранят выбранное пользователем значение в свойство innerValue.</p><p>Этот компонент работает хорошо и мы уже можем использовать его в шаблоне формы, как только задекларируем его в модуле нашего приложения.</p><p>Однако, этот компонент никак не связан с нашей формой, а нам необходимо, чтобы он умел работать с реактивными (и не только) формами, передавал выбранное значение в модель и т.д.</p><p>Иными словами — нам нужна возможность использовать form api директивы, например formControl:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0Hc1q8k3tpiWl0dqnPwfnw.png" /></figure><p>Хорошо, но как мы можем сделать из обычного компонента компонент типа formControl? Для этого нам нужно узнать что такое ControlValueAccessor, потому что это именно то, что использует Angular для построения коммуникаций между моделью формы и DOM элементом.</p><h4>Реализация ControlValueAccessor в пользовательском элементе</h4><p>Компонент может опционально реализовывать интерфейс ControlValueAccessor, который позволяет записывать значение в компонент и прослушивать его изменения. Этот интерфейс используется в директивах NgModel и FormControlName.</p><p>В кастомных элементах формы мы должны добавить собственную реализацию этого интерфейса.</p><p>Интерфейс ControlValueAccessor выглядит следующим образом:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*webjCTDs0vEx_qUcxcPNLw.png" /></figure><p>Итак, давайте перепишем наш компонент и реализуем в нем методы описанные выше:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*6W6HFbLhPXl8nsr6EUYGoQ.png" /></figure><p>Здесь мы регистрируем обработчики событий, а также в методе writeValue:</p><ul><li>проверяем что новое значение является необходимым для нас типом данных;</li><li>удостоверяемся что в нашем списке опций есть элемент с необходимым значением;</li><li>записываем новое значение в локальную модель selectedOption</li><li>вызываем метод onChange, который информирует другие компоненты о том, что значение было изменено</li></ul><p>Вызов же метода writeValue происходит в методе optionSelect , который используется в качестве обработчика клика на элементе списка. Также в этом методе вызывается функция onTouched и изменяется свойство open для того, чтобы убрать выпадающий список.</p><p>CustomSelectComponent почти готов к использованию. Но , хотя мы и реализовали все необходимые методы интерфейса ControlValueAccessor, Angular все еще не воспринимает его как таковой, потому что его необходимо зарегистрировать.</p><h4>Регистрация ControlValueAccessor</h4><p>Для регистрации аксессора используется мультипровайдер с токеном NG_VALUE_ACCESSOR. Его следует добавить в список провайдеров нашего компонента:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/950/1*X5laGAX4iND-DrYW06YdqQ.png" /></figure><p>Здесь мы сообщаем этому токену о нашем компоненте. Также, следует обратить внимание на использование forwardRef. Это необходимо, поскольку класс нашего компонента еще не будет определен, когда провайдер будет зарегистрирован и нам нужно сообщить конструктору провайдера о том, что необходимо дождаться определения класса.</p><h4>Использование кастомного элемента в реактивной форме</h4><p>После того, как мы создали нашу модель формы , мы можем связать наш кастомный form control с моделью с помощью директивы formControlName или formControl.</p><p>Мы же хотим модифицировать форму из <a href="https://medium.com/@maks.zhitlov/reactive-forms-in-angular-2f8abe884f79">предыдущей статьи</a> и изменить элемент для выбора типа контакта, поэтому в нашем случае мы просто заменили тег select на custom-select.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RxrURDLhFcpjka7nUpBWAw.png" /></figure><p>Однако, использование кастомного элемента формы не ограничено только модель-ориентированными формами. Его также можно использовать и в шаблон-ориентированных формах — просто использовать синтаксис двухсторонней привязки данных:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XsSUX66EweRXLGbPqbO2Hg.png" /></figure><p>На этом все. Надеюсь этот материал был полезен для Вас. Если уВас есть замечания / дополнения — буду рад увидеть их в комментариях.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4c69a94d5de6" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Реактивные формы в Angular (Reactive Forms)]]></title>
            <link>https://medium.com/@maksym.zhytlov/reactive-forms-in-angular-2f8abe884f79?source=rss-a887fdfe4110------2</link>
            <guid isPermaLink="false">https://medium.com/p/2f8abe884f79</guid>
            <category><![CDATA[angular]]></category>
            <category><![CDATA[angular2]]></category>
            <category><![CDATA[reactive-programming]]></category>
            <category><![CDATA[front-end-development]]></category>
            <category><![CDATA[rxjs]]></category>
            <dc:creator><![CDATA[Maksym Zhytlov]]></dc:creator>
            <pubDate>Tue, 09 May 2017 19:57:35 GMT</pubDate>
            <atom:updated>2018-03-10T20:52:26.191Z</atom:updated>
            <content:encoded><![CDATA[<h3>Реактивные формы (Reactive Forms) в Angular 2+</h3><p>В этой статье мы рассмотрим использование и базовое API реактивных форм в Angular на примере создания простой формы регистрации. <a href="https://maks-zhitlov.github.io/angular-reactive-forms/dist/">Демо</a> и <a href="https://github.com/Maks-Zhitlov/angular-reactive-forms">исходный ко</a>д того, что получилось в итоге.</p><p>Использование реактивных форм предполагает создание модели формы в классе компонента, связывание (two way data binding) этой модели с DOM элементами в шаблоне компонента используя ряд доступных директив.</p><h4>Достоинства модель-ориентированных форм :</h4><ul><li>Вся логика работы с формой содержится в компоненте а не в шаблоне, что более предпочтительно при сложных формах</li><li>Классы FormGroup и FormControl имеют хорошее API, которое позволяет строить пользовательский интерфейс используя реактивный стиль программирования</li><li>Обновление данных всегда являются синхронными и находятся под вашим контролем</li><li>Возможность юнит тестирования.</li></ul><h4>Реактивное программирование в Angular 2</h4><p>Главная идея состоит в том, что элементы форм и сами формы обеспечивают Observable-based API. Вы можете думать о источниках данных (observables) как о коллекции значений изменяющихся в течение времени.<br>Т.е. реактивные формы и их отдельные элементы могут рассматриваться как постоянный источник данных на изменение которых можно подписаться и обрабатывать используя определенный набор <a href="https://github.com/Reactive-Extensions/RxJS/blob/master/doc/api/core/observable.md#observable-instance-methods">методов</a>.</p><h4>Form API</h4><p>Реактивные формы в Angular представлены тремя разными элементами формы.</p><ul><li>FormControl — элемент ввода, может быть связан с input, textarea, select и прочими html элементами форм.</li><li>FormGroup— состоит из FormControl и FormGroup/FormArray, каждый элемент содержит строковый идентификатор. Может быть целой формой или же частью формы (вложенной формой).</li><li>FormArray — похож на FormGroup, но действует как массив (вы можете использовать методы push, insert, или removeAt), используется для форм с динамическим набором элементов (например: список IP адресов, список контактных данных);</li></ul><p>Каждый этот элемент наследует от AbstractControl. Если мы посмотрим на этот абстрактный класс, то увидим что все они получили <a href="https://github.com/angular/angular/blob/5.2.2/packages/forms/src/model.ts#L95-L635">следующие</a> свойства.</p><h3>FormControl и FormGroup</h3><p>FormControl — это класс, который позволяет напрямую создавать отдельные элементы ввода и управлять ими. Конструктор new FormControl() принимает три необязательных параметра:</p><ul><li>изначальное значение данных</li><li>массив валидаторов</li><li>массив асинхронных валидаторов</li></ul><p>Пример создания простого элемента ввода:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uEGXA9H6pqdWrX5WboPKFg.png" /></figure><p>FormGroup объединяет в себеFromContro\FormArray. По сути, Ваша форма это всегда FormGroup. Например:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Xuh31isP50XSCUX_Jj--Wg.png" /></figure><p>Другая приятная вещь это то, что FormGroup могут быть вложенными, а так же иметь собственный валидатор для всей группы. Например, поле address - это вложенный набор элементов ввода.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7PdG58pHh7HoIOBkaGyQhg.png" /></figure><h3>Связывание форм шаблона с помощью formGroup, formGroupName и formControlName</h3><p>В данный момент в нашем коде нет ничего что говорит о том, что модель формы имеет отношение к форме в шаблоне компонента. Нам нужно связать модель с нашей формой и мы можем это сделать, используя директиву formGroup, которая принимает ссылку на экземпляр FormGroup.</p><p>Чтобы использовать эту директиву нам нужно импортировать модуль ReactiveFormsModule в модуль нашего приложения.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*G1D52kNALHXWWzc6fcPNuA.png" /></figure><p>Теперь мы можем пойти дальше и использовать formGroup для связывания модели с шаблоном формы:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NJ2742K66C7CT5WH6lqyNQ.png" /></figure><p>Следующее, что нам нужно сделать, это связать отдельные элементы формы с полями ввода в шаблоне. Для этого мы будем использовать директиву formControlName, которая в качестве значения принимает название (ключ) элемента ввода из модели формы.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_UpOAnFvnlH4cdCuEKBmmA.png" /></figure><p>Так как адрес у нас тоже является форм-группой, мы можем связать группу элементов управления формой с DOM элементами, используя formGroupName. Для этого нам нужен окружающий тег, иначе мы не сможем использовать эту директиву. Поэтому, обернем поля ввода в тег fieldset, к которому и применим эту директиву.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Lbfe6l9I5wtqeHrU4p9KrQ.png" /></figure><p>Теперь модель FormGroup соответствуют структуре DOM элементов.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uNdljXNb0kF7jaNgG58NxA.png" /></figure><h3>FormArray и formArrayName</h3><p>В нашем случае мы хотим, чтобы пользователь имел возможность добавлять неограниченное количество контактных данных. Именно для этих целей отлично подходит FormArray. Итак, объявим поле contacts как FormArray:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8-wjwguqMtABpxWOTr-8aA.png" /></figure><p>Чтобы иметь возможность динамически добавлять новые контакты мы в классе компонента определим метод addContact:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Rajigdco3IGFYJ-5RSek2A.png" /></figure><p>В коде приведенном выше мы через метод формы get получаем доступ к полю contacts и далее, как в обычный массив, добавляем в него новый объект FormGroup, который состоит из двух полей type и value.</p><p>Так же нам нужно дать пользователю возможность удалять контакты из массива. Для этого определим метод removeContact:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*P_L43CbwK3RzzxgP7SPIvg.png" /></figure><p>Здесь, как и выше, обращаемся к полю contacts и удаляем контакт, используя метод removeAt объекта FormArray, он принимает в качестве параметра индекс элемента, который нужно удалить.</p><p>Связывание FormArray с шаблоном формы:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*34dcMYqdjtEqi27fjKBApA.png" /></figure><p>Для этого я воспользовался директивой formArrayName, которая ссылается на наш объект FormArray, затем проитерировал все элементы массива с помощью директивы ngFor и связал вложенные элементы формы используя директиву [<a href="https://angular.io/docs/ts/latest/api/forms/index/FormControl-class.html">formControl</a>].</p><h3>Валидация реактивных форм</h3><p>Теперь, когда модель формы связана с шаблоном, мы можем приступить к добавлению валидаторов для элементов управления формой. Чтобы использовать стандартные валидаторы нам нужно импортировать класс Validators из @angular/forms в нашем компоненте и передать их в качестве второго параметра конструкторам FormControl. Если нужно указать несколько валидаторов - они заключаются в массив. Пример:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IjrvLd4QQExScQfP86q8MQ.png" /></figure><p>К сожалению, в <a href="https://angular.io/docs/ts/latest/api/forms/index/Validators-class.html">документации</a> не отображен список всех стандартных валидаторов, но мы можем посмотреть его в <a href="https://github.com/angular/angular/blob/4.0.0/packages/forms/src/validators.ts#L64-L166">исходном коде</a>.</p><h3>Добавление кастомных валидаторов</h3><p>Кроме использования стандартных валидаторов, мы так же можем определять свои валидаторы. Например, создадим в классе компонента валидатор для поля user_name.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5Tj4mzRS8pSIJNfBzXbUbg.png" /></figure><p>Валидатор для поля contacts:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MApZRcrxZnwDg_joOeWNLQ.png" /></figure><p>Так же для валидации телефона:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*98h7iCCXVVO-AbnYvjXqbA.png" /></figure><p>И для проверки на совпадение паролей:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wj6G_RklovRXFVYE0LCffA.png" /></figure><p>Теперь мы можем добавить их к нашей модели формы:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*tpnEzLfCmWMSCxQbWSPSbw.png" /></figure><h3>Вывод сообщений об ошибках валидации</h3><p>Для того, чтобы показывать пользователю сообщения о том, что он ввел не корректные данные мы создадим простой компонент в который будем передавать элемент управления формой FormControl и который будет показывать ошибки для этого элемента.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*KkJHQWfRiXHRfk-1oo1ysA.png" /></figure><p>В этом компоненте мы обращаемся к свойствам invalid и touched , чтобы узнать что пользователь уже ввел значение и являются ли они не корректными. А так же к полю errors объекта FormControl для того, чтобы узнать какие именно ошибки содержит поле. Теперь мы можем использовать validator-message компонент в шаблоне формы, например:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2V-Vq7Yc0A9f5_cghKMYNQ.png" /></figure><h3>Динамичная валидация</h3><p>Как уже упоминалось выше, в нашем случае каждый контакт — это форм-группа из двух элементов: type и value Элемент value должен валидироваться по разному в зависимости от выбранного type (e-mail, phone, skype).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CWZuPXq5x8kldDGJiJ_4Nw.png" /></figure><p>В коде приведенном выше мы дописали в метод добавления нового контакта следующее:</p><ul><li>подписались на изменение поля type в только что добавленной форм-группе с помощью valueChanges.subscribe;</li><li>установили новые валидоры используя метод setValidators;</li><li>вызвали метод updateValueAndValidity который пересчитывает значение и статус элемента;</li></ul><h3>Упрощение с помощью FormBuilder</h3><p>В данный момент создание модели формы выглядит следующим образом:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GlilP4qHv7ZxofsV9uV_bA.png" /></figure><p>Однако, данный код выглядит достаточно многословным, из-за многократного вызова new FormControl() и new FormGroup(). Но мы можем использовать API более высокого уровня, чтобы сделать определение формы немного лаконичнее.</p><p>FormBuilder — это синтаксический сахар, который создает экземпляры FormGrouop, FormControl, и FormArray вместо нас.</p><p>Теперь создание нашей формы с помощью FormBuilder выглядит более кратко:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xG7R3vYRtUw9o-SqV47XYA.png" /></figure><p>На этом все, надеюсь этот материал был полезен для Вас. Я не претендую на звание гуру, поэтому если у Вас есть замечания / дополнения буду рад их увидеть в комментариях. А в <a href="https://medium.com/@maks.zhitlov/custom-form-controls-in-angular-4c69a94d5de6">следующей статье</a> я рассмотрю создание кастомных компонентов элементов форм.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=2f8abe884f79" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>