Improve this DocForms

From Get docs
< Improve this DocGuide to AngularJS DocumentationAngularjs/docs/1.8/guide/forms


Improve this DocForms

Controls (input, select, textarea) are ways for a user to enter data. A Form is a collection of controls for the purpose of grouping related controls together.

Form and controls provide validation services, so that the user can be notified of invalid input before submitting a form. This provides a better user experience than server-side validation alone because the user gets instant feedback on how to correct the error. Keep in mind that while client-side validation plays an important role in providing good user experience, it can easily be circumvented and thus can not be trusted. Server-side validation is still necessary for a secure application.

Simple form

The key directive in understanding two-way data-binding is ngModel. The ngModel directive provides the two-way data-binding by synchronizing the model to the view, as well as view to the model. In addition it provides an API for other directives to augment its behavior.

Note that novalidate is used to disable browser's native form validation.

The value of ngModel won't be set unless it passes validation for the input field. For example: inputs of type email must have a value in the form of [email protected].

Using CSS classes

To allow styling of form as well as controls, ngModel adds these CSS classes:

  • ng-valid: the model is valid
  • ng-invalid: the model is invalid
  • ng-valid-[key]: for each valid key added by $setValidity
  • ng-invalid-[key]: for each invalid key added by $setValidity
  • ng-pristine: the control hasn't been interacted with yet
  • ng-dirty: the control has been interacted with
  • ng-touched: the control has been blurred
  • ng-untouched: the control hasn't been blurred
  • ng-pending: any $asyncValidators are unfulfilled

The following example uses the CSS to display validity of each form control. In the example both user.name and user.email are required, but are rendered with red background only after the input is blurred (loses focus). This ensures that the user is not distracted with an error until after interacting with the control, and failing to satisfy its validity.

Binding to form and control state

A form is an instance of FormController. The form instance can optionally be published into the scope using the name attribute.

Similarly, an input control that has the ngModel directive holds an instance of NgModelController. Such a control instance can be published as a property of the form instance using the name attribute on the input control. The name attribute specifies the name of the property on the form instance.

This implies that the internal state of both the form and the control is available for binding in the view using the standard binding primitives.

This allows us to extend the above example with these features:

  • Custom error message displayed after the user interacted with a control (i.e. when $touched is set)
  • Custom error message displayed upon submitting the form ($submitted is set), even if the user didn't interact with a control

Custom model update triggers

By default, any change to the content will trigger a model update and form validation. You can override this behavior using the ngModelOptions directive to bind only to specified list of events. I.e. ng-model-options="{ updateOn: 'blur' }" will update and validate only after the control loses focus. You can set several events using a space delimited list. I.e. ng-model-options="{ updateOn: 'mousedown blur' }"

[[../File:data:image/gif;base64,R0lGODlhQAK6APULANjY/7S0//z8/9jYqrS0qvz8qmxsVSQkAEhIACQkVUhIVQAAAJCQVZCQqmxsqgAAVWy0qtj8/5C0qtj8qkiQqmyQqkhsqmyQ/5C0/2y0/7TY/7TYqrS0VUhIqpDY//zY/yRIVQAkVSRIAJDYqkhsVQAkAGyQVWxIVZCQ/wAAqgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH/C05FVFNDQVBFMi4wAwEAAAAh+QQEAwD/ACwAAAAAQAK6AAAF/2AhjKQgluOJqiVLuikay7Ap2/Rd73qf/ytfENgSFokvYxI5GzqPz2W0Ca1KrdSrNsvFTb1Y8Fbc5THJaPNXHWaP3be4fE6v2+/4vH7P7/v/gIGCg4SFhoeIiYqLjI2Oj5CRkpOUlZaXmJmam5ydnp+goaKjlXBpSmWop2emraqurK+ysbRrs7a1bbe6uW+7vr2pwau4xbzGwMiky8zNzs/Q0dLT1NXW19jZ2tvc3d7f4OGLsMrEx+fJ6MLl5Orm6fDr7u3x7/L19Pf69vz5/b/7/PkTR7CgwYMIEypcyLChw4cQI0qcSLGgQID/hl3UiHEju44gOYr8OHJeSJIoTf+WxHdSZcWXMGPKnEmzps2bOHPq3MnTpkeXQFmuDNhSaEqjQYkOzXhUaVOmSaEinerUXc+rWLNq3cq1q9evYMOKHavnJ1WpVc+aTcsWrdu1b4u2hUtXbtyldYeR3cu3r9+/gAMLHky4sMS8TxFHVazWLuO5jiPjlZyY8mLLZw1r3sy5s+fPoEOLHs3z8d3Kk1OjXn1ZdWvWjV3Hhg1ZdlvSuHPr3s27N18AvoMLz2O6OObatE+/Xj6bOXLnyptLfz4dzfDr2LOHKgCAQADvA7SL124ggQLz5hXU0ESg/IEF7w88QGAgPAnglAigP4+gAR0ADOxnXgDjGRLgeQgSAJr/cSI1gMACEEJ4AH5p2YfRCAMoEGECDBBAgAMRPmAAfiqYJgAB70W4gAFCFOBAihEqSN2M0dHIIEkNwAihjNXdCB1c1BCg4gIW/jFAAjz6AaCKDqBAwIMSJkkJABpGyGIdQqooZYGBoBjhAf5xeQkAMB5AYCAJLHDmHwYweUMAOoZpCYhW2lFAmjGKScidKnKgpyUD6FhkH1UOugcDQxoKXAMqHrBlJG3WOQdwAEAJ36N/7lGpinIa5mNmZH5JoTJ0qmnSAA+oeGUQfEaIwKg2ylDqisDgucADj34aq2019rqDrQsoqKuvx7mFDaohGprHrMriUWWEncoQaZ6VTEtr/x2hUpvpH5tCqx133A0AgIXhAhDuC+aOO+4I3TXgYbPsekgApWWuWUK78sI6wqzBgitDdx4GoKiOCcArAKMqJiBCueKqMIC88D48Lx6zsljAd+7q2+qO7IrrsbkdpyvufR83HC8BBoeTbrknAKysxB7qW4LE7gYAg7oNU6huuS0A66cMMIN3Q8kgC+ByXwYgkIDSSod3JNPo2ecgekp7+CyEDMj84pcOBKrioAQooOMCCtRXAr/wmdfk2QRnXQLCrsqM3wBDOiqA2AKKa+0CbrM7QpYLIICptKrqp2J/9xldpozlIWief1QKqICMDDzA39IKbg1hmDKD08DSVDeZo/+3931++NpO7n1AAga0rkDWje+nYAOXI7hmt5uj0MDeC7CuIH6VOy64AJovEK1Pqvx9dbBGhz3kmQPwK/aQEK6awvIQAjthCZFO3t2zSJJgKfWrZgghAgJXqQCJy6snRctjMyCA+ZyOL6kNyLo6BgmlJpBiqpyaAbBkFIDl+acAzlOR/Iy2Nwbwq2BeGJZiALA3A/DrAfbpFpIoCCH3kQBuG7QWAAcQAPsp6GH2I9cAz1Y9gT3pS7dr4APDI8FiDYQPiSIB3b5WguXhalxDWuAIrLW+g43NQnDj0Q6zh4IVGo0EeAIThiK0wGzdLw5W7CAUyUe7HJLASxu6QwUXVSb/OWWRR7gz3n3iVAL7Uc9MDJnW2PJEJWrBSYsjgJsaFfel1tFLSyS4o7ZwJ8U8kk4AgiTbqNxYN3uNRUe3gyT3EsYjRCVrBAFoFIX0CMcRgM9ClurkCCT5tg1lEEY0BNYCUIfFsa3qarhiFyn/NqRX2WFWCGBh3FLgRBNcTYgbYx4J2ke/3qUMHNJLIITCY0n4sC9CZ6oX/0xZgl4eiYe87BMJ5EihqyWJmJ/sizWBVaSrWS+RqxxBM8k2M0Ft80s88qbf3HkfS9nSkxFqUhav5TcZqFIBw1RgCQDIsXq6qZ9xsJb1llhQK9qNXVczYyjNeLUDQPQ9xzvI3uxTpQVe/22SWJsfjBJQgnWi7oxPJOTtxge5u2FTAHKkaKMgmrsnzsQfOkKjjkZ1NYC+AFhXApYQ+SghCvXPQtYKE3dmeSIV+XSIEQJoMNMpBPutKqklYCMOKuU/B8ChYvcaUgNOYKtYXg+QW6TiC8y5VXLZ8K0/wCW67JPIXE5Ti4ncniHVmk1tXTNCKgSkCJo5oROU6gE/w+cV18WrGuoFEDn96UtdutieErWmGCprkVwno+70UgCf5aQDGGCAAIVxn9a7wT6f+susovVfeVBoE1Uly9fW8ZC3xSxMDyoRIsYBcFgrrQNCOS6CkpQE61wVSms7SJbehwFlU6qDAvjOqBImi/+RVJG9fLvWwzX1tZcVpZOmJ1bXaksA66SeqEA7pKe2ckhX5W0WM7oHsLbRqX0tqGJDml9h7pefEZHrDfSo3uyJoExGFWha9fvXZUo2QolFQQDKQ71v0pYw45wsW+9jLZKCUb8inWweq8QhJwKHnLosqtEAkC6b7q2IsJ0f9eTUWhIQdI+dE+OFA2qlP0bpPhE1qIRkekWIdPi3iaIUd1J6MLQSUqe2DeVKA6gz/bwHAcUr5H9T2xNyRJa5EOIpfnFwtVwC17/hHRUHbLU2rS5VuyVN2MKucGYI/iCTCaPhbvNp3pqWKHn72vF/vTqCXhZAngtGbHeL7NjkwEDAYAD/rl7jSs11diqYwjKBZh/MsRO8sHonDlFiDy1oR8M1OX34sqY1LOjcshPP582fg2lp3UKD97OzEu8NtDe4Jgu6xqME771iW+oNL9doQabpIfdcPYpwVwZnPuanAxdVKR372hP9IIyuRMhOPVsws8QuSPF4VrUydAERdij0Nh3sZTOVADce6g3SK28UVHRU1jqpVjn8AC3Xwb4kcLOhEb3q825YIpCW8JBY+ds0lbYBHVIWpnWI4v7+TN39tXCRAfPZim+5BHklUBpZeW6pNWpNJhYAPVGWRYWNt2VHhi06GQ5sAdyYc0Yb30nnIFsdNgp+8AQyfHKHn2wru9nDbkjM/3etSd2NiIFI/09kKSVlIddUSKgU35c6dfCd4JS6vo6QmDekgnU+lZMJXi96VaTo75Luzd4iU5OkV/bA3et/eyRchDrgAqwGnLoigPfhNCYrQevRYraGkFl9eSv+nujGo2Zro3/kg4QnIb0wLgCjXD4t+a2H0/5twI0DSy0Ch0nwio9w14nV2GIFoqLu4t3T/0s2cUW7mqoCjgHKtKJFUc+BXORoo4ZLJBO8kQFd1PWTZWB2pvN1BOX9IsE+P+7eCb2DFEJnp9LrrvTWHj86ci9ErnZc1S7vAA4wXfGDuToERXdk1Y1Re4ZupSV7jc9uHzLvJify8BfmzFE1Np3EO//UJmwNljZk80bjokodhD2Mo15CdIAnp1oxRVcxBW3Lwzrzk4F9I2vsdEvnkyodoDdRRSHTNmRARz1KMyS4MmHU4wC9ZhAUdGNk0zcokEaUBGYFdivnNEeBo0oYVEJ141X7dD4O6ILwFYNjcWZgck0c4i40piqjIyF2hgLFBCFdkyasA4WZ1Sj+kVdmtDedlQJoYwC3AzTPMh/+Q0VnqFjxIXYI84aztnY/Zgdt4h/ms4Y7ojMa8obxYYL20wCbQh/INy9ylGcPwSh+CFhYhChlogBFwoASAl8l8GGrMy8PUjaFyEFyCB8EMm0YBUSAdIjUdBX5EADIl0HzUgOWdSL/NfNnN7iJf1M0K0AAqVhlGQM0r3gF7RJxTsAC7aIAwjhajvSL7zMGA5CLwPAd6EIAEFeMsBhBX7SLiCRxx7grpjYS1PcCqKiMMSCBBfYAc/Y31CgwLSIFzugdDkON0oiNlNd6l7B625IbSMg6ZSOM5OVM8wgpvLWPuJEthDZn3BEpGOSPj2BskCA3qmWQEIEw5XcDf2hTNzgcN/Jt7tgjp/aO2biRGtmR+0MnD8V8unWRJMl6HLk/k3B/y8aQoPFXBwCJIrM78MFwLHkI3pc9SliTguEiq/NGA6KTi+AhUJiO7pKTQBkY4yKU6diGExljwWEieDB5GAmPJ1mSUmmV/4B2B1dpkh5Zkkf5lWAZlmI5lmRZlmaplRk5lVXJlWrZlWyJlVTplls5l2l5lnZ5l3iZl3q5l3zZGXQZl20ZmHC5ln9JmHX5lohZmGHQl4zZmI75mJAZmZJ5DYopmIl5mJU5mHKJmZwJmJppmZMZmqI5mqRZmqZ5msTRmYbpmZfJmpnZmqsZm5vpmoeJmrZ5m7iZm7q5mwXymr6pmrMpm5b5m7RZnMLplbyZnMq5nMzZnM4pFsR5nLAZnNQ5nMBpncZZnZ95G8/Znd75nctJKUYTAZRCnuNZnuh5nuoJAObJnunpnuvZnvL5nvMZn/R5n/aZn/C5n/XJn/jpn/rZn/8CKp7g2RftwGIAsAEaAAAaoKAMOgALqgEQ+qAROqESWqEYSqEaeqEbaqEemqEcGqIf2qEgOqIiWqIoSqIqeqIraqIW6qANeqETGgFxEJ3aOZ3YKZ02mhl8wJ4YoAEYsAE/GqRDKqRAaqREeqRFuqRK2qRJ+qRIGqVMCqVTKqVOaqVUeqVVuqVa2qVZ+qVYGqZDqgEaYJ4F6hksFgASgAFr2qZsmgFuGqdsOqdyWqd0eqd2mqd4uqd62qd8+qd+GqiAOqiC2qZweqcKOgGksaPbiaPR4KMSQAEQQAEVUAGTWqmXaqmUqqmYuqmZ+qmeGqqdOqqcWqqgSqqnaqqiqqr/qLqqqfqqrhqrrTqrrFqrl/qjZaoZRLmrQ9mrvPqrvhqswDqswlqsxHqsxpqsyLqsytqszDoxkeAGEaABa1oBFyAB15qtEgCn2nqtbNqtbQqu34qt5Dqu2mqu5Uqu56qu6Squ7Oqt7xqu7Iqu8Oqu9jqv8Uqv8rqu96qt3IqtFUABawp/jOqoUBEw8vIdCLuw3pGwDsuwCtuwEPuwEluxEXuxFIuxE7uxFpuxHsuxGtuxIPuxImuxHYKcdbCgbFoBayqmTRoARgqzPyqzGkCzNhuzODuzOVuzO3uzOvuzPAu0Phu0RDu0RtuzSCu0SVu0O5ukNJuklXoBHpCrhuGM/0azZC2WtVi7tUrWtVfrtVoLtlz7tWQbtmU7tmabtmi7tmLbtmfrtmoLt0vmjZ0AodUapDiTt+IyAerCt3vbt4D7t4ILAH5LuIFruINbuIp7uIubuIz7uI4buYg7uY1LuZBruZK7uAxarhuQY34RM/vIHR6yjZWgshJQARsQADQqAKuLAq0rHCyGAdZas687GB4ikdviLo/gCtO6rRWAAfC3mKLxeb3LsnibnTnqliciJQXbvHZxu6imB6b7uxowj7FrrVNbu4IBvf4Iup9gt7ILvNpbIL3rrZ2rq0apHaMLCtObungwvvB7A/ErA/PruvJ7v/SLv/abv/y7v/5bAv/1ewfjIrsZQLvoi7uZwr2QoAYi0LvhS7DX2ag7WrwtW70G67y5cLsYrKOqCb1QmbIAsLI/ar0hjK3ZqxkPw5De6wng+7sDML7jUb4t67l9wYwGqY6aACvta8F6QqOES8AGXLW/073pCwi8S60Z4MKEh7wSHMGnQJ6cu8QczMTGosHJe8VNvBQKTCN7ML0jvC2xa8JUWxgpfMPQysLU+sAwLB4yfLyGYcNETLqSABztq7p/4sMDAMR2LMQI/Cdb7AgMzLpprMRZPMWGbAUUHKQWvME3ygZWTMWMnKMe7Hp24MU8/CdhLLVjTBhlTMQ0XAmbq8bb0sbn+8ZFjB04nAn/OlzCqHvJevLDFVDAe0zGQ7yPf5wIR3y3wYvFF+zEvAsAUQzJvmwXiJRphdzIw3wGfwwk0svKU0vC33rChtHJtrzLnBDKLrzG2jEB1Gq+n7wXcGzLNuMJNDq9ZBoBPsy6T5TO7LzO7gwc7QzP76zO8lzP9HzP8YzP85zP/LzP/mzP/QzQ/6zPAl3QRjMBeqzNfZHC35wdt8wIbrC5SQy8EjouFQ2hHnPRGp3RHG3RHY3RHh3SID3SGy3SJU3SH33SKp3SLG3SLY3SLh3TMC0uiVzKkXzMV8CMN93LxjnJvHIHXjyzNTvUAQCkRD3UQl3URZ3USH3US+3URq3UTS3V/09N1VF91Exd1VgN1Vl91VLd1WDN1WJt1V1t1U99AbO7yYNBzYnjlEnXlHD91nLd1nFN13ONUHfdx3qtkG5t136N13QNHCwHCtMqpNZ62Gid2Ii92Ird2Iz92I4d2ZA92ZJd2ZR92Zad2Zi92Zrd2Yi9piymGRErL6Rd2qZ92qid2qq92qzd2q792rAd27LN2sVYCbWLzt8Brrodr7vd27z9274d3MA93MJd3MR93Mad3L+NAQzKGeMiMM/tMdBNQtJd3dF93dSN3dO93dad3d7N3drd3eD93eJd3uF93uSN3uO93ub93Qs8CxZdqIQ63/Jd3/R93/ad3/i93366t//JfMjVoZPMrCnTCgABYOBQbdYJvuAK3uAM/uAOHuEQPuESXuEU/uBkGuHTis5nChoRQDQsBuJ6i6AiXuJ5G+InPuIo/jErri4tLi4vTuIpbuIsruI2TuMufuMzvuNEUwAK3eGDEdBMJp5EPuRGXuRIfuRKnuRMvuRO3uRQ/uRSHuVRns4EShp8XdeAveV7vZB9zeVZntdh/tdd/uVlruV63QimQJY73eb/jczC/NNAPud0Xud2fud4HpVvzstuHucAjtOAztN/jph5XuiGfuiInujL2eeDzuhw3uh7HuiOzqOKXumWfumYnuk1OemSHumC/uigzueezumaXuqmfurhqJ7qvEHqrD7qru7nod7psB7gql7rtn7ruJ7rOdHqsy7rkN7rny7qwF6wul7sxn7syJ7sFvHqv97ssR7svv7svC6dyl7t1n7t2J7tkjDt0s7s3T7s3i7szg6a2l7u5n7u6J7udcDt4v7t4x7t7R7v8B7o6l7v9n7v+I7q7D7v0N7v++7v4c7va57vBF/wBn/wd/7vCh/wAA/uDv/u/Y7wEj/xFF/xo7nwD+/uGi/vDQ/x/27xIB/yIj/yd4nxHs/wJr/xAo/yxEzyLv/yMB/zFMnyGc/xKW/zNH/yNS/zpx4CACH5BAUDAAQALCQALQD3AVEAAAT/kMhJ6ao46827/2AojmRpnmiqrmzrvnAsz3Rt33iu73zv/8CgcEgsGo/IpHLJbDqf0Kh0Sq1ar9isdsvter/gsHhMLpvP6PSpoW673/C4fE6v2+/4vH7P7/v/agWAg4SFVA4DAooCAIaOj5A9FxWTkZaXmCWVmZydnp+goaKjpKWmp6ipqqusra6vsLGys7S1tre4ubq7vL2+v8DBwsPExcbHyMnKy8zNzs/Q0dLT1NXW19jZ2tvc3d7f4OHi4+Tl5ufo6err7O3u7/Dx8vP09fb3+Pn6+/z9/v8AAwocSLCgwYMIEypcyLCVgIYQaQQgMBFDxYgYRTzMyFHFxo4gPkOKHEmyyMeSKCsEOJmypcuXMGPKnEmzps2bOHPq3MmzWaOeQIMKHUq0qNGjSJMCYakUINOm/QZAHXhxqtMIACH5BAUGAAAALIwBOAABAAEAAAICVAEAIfkEBQMAAQAsIgA7APkBPQAABf9gII5kaZ5oqq5s675wLM90bd94rs/A7v/AoHBILBqPyKRyyWw6n9CodEqtWq/YrHbL7Xq/4LB4TC6bz+i0es1uu9/wuHxOr9vv+Lx+z+/7/4CBgoOEhYaHiImKi4yNjo+QkZKTlJWWl5iZmpucnZ6foKGio6SlpqeoqaqrrK2ur7CxsrO0tba3uLm6u7y9vr/AwcLDxMXGx8jJysvMzc7P0NHS09TV1tfY2drb3N3e3+Dh4uPk5ebn6OnqchQkFRbr8fLz9PX29/j5+vv8/f7/AAMKHEiwoMGDCBMqXMiwocOHECNKnEix4kQBFjNq3NikR4ABGDmKhBFypEkVIEMBAAAh+QQFAwADACwkAGAA9wEgAAAFz+AgjuJGnmiqrmzrvnAsz3Rt33iu73zv/8CgcEgsGo/IpHLJbDqf0Kh0Sq1ar1hhJcvter/gsBgHGJvP6LR6nWykAuy4fE6vg8uDSUpv7/v/gIE1BQKChoeIiYF4io2Oj5CRkpOUlY2Mlpmam5wjBAUkhZ2jpKWmp6ipqqusra6vsLGys7S1tre4ubq7vL2+v8DBwsPExcaAmMfKy8zNzs8jogTJ0NXWXKDX2ttUBNzf4OHi4+Tl5ufo6bXeA5h41Orx8vP09fb3+Pn6wwACIQAh+QQFAwAGACwpAGMA8gEgAAADsmi63P4wykmrvTjrzbv/YCiOZGmehoCubOu+cCzPdG0rxK3vfO//wKBwoRoaj8ikcskkFZvQqHRKra6e1qx2y+16v+CweExmYMvotHo9DZzZ8Lh8Tq/b7/i8fs/v+/+AgYKDhIWGh4iJiouMjY6PkJGSk5SVlpeYmZqbnJ2en6ChoqOkpaanqKmqq6yMAK2wsTYFsrW2Lq+3ursfOby/wBm5wcTFxsfIycrLzM23A87RqgkAIfkEBQMAAAAsJgBkAPcBIAAABbMgII5kaZ5oqq5s675wLM90bd94ru987/8mAXBILBqPyKRyyWw6U4OndEqtWq/YrHbL7Xq/4LB4TC6bz+i0es1uu9/wuHxOr9vv+Lx+z+/7/4CBgoOEhYaHiImKi4yNjo+QkZKTlJWWl5iZmpucnZ6foKGio6SlpqeoqaqrrK2ur7CxsrO0tba3uDRCuby9V7u+wcLDxMVvAcbJyjrAy87P0NHS09TV1tfY2drVESfd2+CyIQAh+QQFAwAEACwkAGAA+QEjAAAF2+BGjOJonmiqrmzrvnAsz3Rt33iu73zv/8CgcEgsGo/IpHLJbDqftYxKCq1ar9isdsvlUiAUQnj07ZrP6LR6zT5SUe+2fE6v2+/FQgqD7/v/gIGCg4SFhoeIPxECjIuNiZCRkpOHepSXmJmam5ydnp+goaKjpKWmp6ipqqusra6vsLGys7S1tre4ubq7vL2+v8DBwsPExcapAcfKy8zNzs/Q0dKpANPW19jZ2rvV297f4OHigt3j5ufo6epWAzAR6/Dx8vP09fb0fPf62AL7/usl/gmM1m6gwWkhAAAh+QQFAwAFACwXAGAABgIkAAAF9GAxFGRpnii5lavKpnAsz3Rt33iu73zv/8CgcEgsGo/IpHLJbDqf0Kh0Sq3iMtasdsvter/gcIpSIVFKZ7F6zW6733AjBIWN2+/4vH5vDfD/gIGCg4MThIeIiYqLShEljiSQBZKMlZaXmJmam5ydnp+goaKjpKWmp6ioAimrqa6vsLGys7S1RX62ubq7vL2+v6mUwMPExcbHyMlJuMrNzs/Q0dKuBCYa09jZp63a3d6jzN/i44fc5OfolsLp7O1v5u7x8vP09anw9vn6+/z9qCP+AgrEgSFFwYEIEypcyLChw4cQI0qcSLGixYvJAJTQiLHjtxAAIfkEBQMAAQAsGABkAAMCHgAABacgFIxkaZ5oqq5s675wLM90bd94ru987//AoHBILBqPyKRyyWw6n9CodEqtWq/YrHbL7Xq/4LB4TC6bz+i0es1uu9/wuHxOr9vv+Lx+z+/7/4CBgoOEhYaHiImKi4yNjo+QkZKTlJWWl5iZmpucnZ6foI8AoaSlpqeoqaqrrK2ur7CxsrO0tba3uLm6u7y9vr8jG8DDxMXGx8jJysvMzc7P0JQa0dTNIQAh+QQFAwACACwXAG0AEAAVAAAFGyAmjGRpnmiqrqnIvnD8unJt33iux8HumwBYCAAh+QQFAwADACwYAGMABQIfAAAG/8CBcEgsGo/HCnLJbDqf0Kh0Sq1ar9isdsvter/gsHhMLpvP6LR6zW673/C4fE6v2+/4fDGi7/v/gIGCg2kCDQQChIqLjI2Oj24RBwmQlZaXmJmXCQqanp+goaJnAgiUo6ipqqusAwkIRB+ts7S1tngRpom3vL2+v2OcwMPExcZMpsfKy8y0AQKvzdLT1Jm5p9XZ2tt/wtzf4OFuyeLl5udYAUPP0eju7/BN17vx9fbu3vf6+80ASOT8Agpcxg7WwIMIffm7lrChw1rtHkqcWMmfkVIgKGrceMkix48gKw7hE7KkSTcYhGxAktKIupMwY8qcSbOmzZs4c+oMp2GnzwSfTYIAACH5BAUDAAkALAwAJgARAl4AAAX/YCKOZGmeaKqubJsUbizPdG3feK7vfO//wKBwSCwaj8ikcslsOp/QqHRKrVqv2Kx2y+16v+CweEwum8/oHizNbrvf8DgKIa/b7/i8fs/v+/+AgU0PgoWGh4iJiouMjY5LAo+Sk5RJA5WYmTcGmoKcR5crAJ2kpaYqkWOpp6ytIp+uWauxtGmhtTa3dQ24vb6/f7PAw8RwwsXIfrDJkMzOKnQ0a8/U1dbX2Nna1Afb3mnHKLzfguHk5+jp6uvs7e7v8PFb5vL19vf4+fr7/P3+/+7C0QNIsKDBgwgTKlzIsKHDhxAjSpxIsaLFixgzatzIsaPHjyBDihxJsqTJkyhT/6pcybKly5cwY8qcSbOmzZs4c+rcybOnz59AgwodSrSo0aNIkypd6mLDCKcioCaQSvWp1ahXp2atirWrVq9cv4oNS3ZrVhJhmapdaxBDjgwn4JqQW4IuCbsj8IrQm4Cv37iA5wauyxZdBQsmKrigMIKC4gSMRTiW3PhxZMiWK1OWnJnzZsyfJ0PWPNpzadCnRV9WTbrE48LMLkAwcSGGbNqzS9zWnZvEbt+9R/wWHlzEcOPFExxXnny58+Sw8QU4Md1E9RLXSWQfsV1E9wTfw1Mfb508dvPawUcHNiFHexPvS8QnMX9EfRH3E+Tff4I//P4A/iegfDPost4pqyQ4wqtA1mgwQgQHIjMNCROOUKEIF75wQoYcbuihCR2C+GEJGdYwCgkORqjiiiw+YSA23wkl0AkzmlBjCTeSkOOCNPZoo484tijkkERa8VqRSCap5JJMNunkk1BGeQYBUhbJYJVYZsnTlVqux2WXSX0J5phkoiRmRS+WqZQEagoCwIknJvDmObWJkGKbXFzApkNseoDnn4AGKig/Ug2qU4xAGnpHmuicqShMcT46RQgAIfkEBQMAAQAsDAAqAA4CWwAABv/AgHBILBqPyKRyyWw6n9CodEpVFqrYrHbL7Xq/4LB4TJY2yui0es1uu9/wuHxOr9vv+Lx+z+/7/4CBgmMAg4aHiImKi4yNjo+QkZKTlHQGlZiZmphXm56foKGio3EOpKeoqaqrrK2ur7CxsrOvDLS3uLmyC7q9owK+wcLDmrzEt4XHysvMQsDN0NHS09TV1tfQxtjb3N3e3+Dh4uPk5ebn6Onq6+zt7u/w8fLz9PX29/j5+vv8/f7/AAMKHEiwoMGDCBMqXMiwocOHECNKnEixosWLGDNq3Mixo8ePIEOKHEmypMmTKFOqXMmypcuXMGPKnEmzps2bOHPq3Mmzp8+Zn0CDCh1K9OeGotQiCEmGtKnLDEegOg3GlB+FIVeFZA2wdeqtTmguQLAm1ohUr2jTql1LUakQt0RGsJ37BywRu9Pw0t3Lt6/fenDh/h2M5Szhwx8lIF7MOFTgxpAjS55MuXLlx5YnG87MubPnzzUFgx5NurTp06hTq17Nmh2G1rBjy57dqyrtz0eN5L7Nu7dC0b6Dj9Ir/EsQACH5BAUDAAEALCQAJACxAWEAAAP/GLrc/jDKSesjNuvNu/9gKI5kaZ5oOgpq675wLM90bd94ru987//AoHBILBqPyKRyyWw6n9CodEqtWq/YrHbL7Xq/4LB4TC6bz2cWes1uu9/wuJyjntvveEY9z+/7/4CBgoOEhYaHiImKi4yNjh0Aj5KTlJWWl5iZmpucnZ6fTAego6SlpqeoqaqrrK2ur7CxsrO0tba3uLm6u7y9vr/AwcLDxMXGx8jJysvMzc7P0NHS09TV1tfY2drb3N3e3+Dh4uPk5ebn6Onq6+zt7u/w8fLz9PX29/j5+vv8/f7/AAMKHEiwoJk9BhMqXMiwocOHECNKnEixosWLGDNq3MixI6PHjyBDihxJsqTJkyhTqlzJsqXLlzBjypxJs6bNm1gQXkwAACH5BAUDAAEALCQAKwD3AVUAAAX/YCCOZGmeaKqubOu+cCzPJRLYdK7vfO//wKBwSCwaj8ikcslsOp/QqHRKrVqv2CIgy+16v+CweEwum3OJs3rN1rbf8Lh8Tq/b7/i8fs8HK/qAgYKDhIWGh4iJiouMjY6PkJGSk5SVlpeYmZqbnJ2en6ChoqOkpaanqD4LnKupnlstDK6ztLW2t7i5uru8vb6/wMHCw8TFxsfIycrLzM3Oz9DR0tPU1dbX2Nna29zd3t/g4eLj5OXm5+jp6uvs7e7v8PHy8/T19vf4+fr7/P3+/wADChxIsKDBgwgTKlzIsKHDhxAjSpxIsaLFixgzatzIsaPHbBU+iuxxYaTJkyhTVTKLoLJlOg0uY8qcSbMmC5YmcNrcybOnz59AgwodSrSoURSwjipdyrSp06dQo04SILWq1atYcSXNCrEA14gERgyoBvMrl7AqMBhTa3bM1rYRJcBNGAIAIfkEBQMAHwAsDAAiABECYwAABf/gJ45kaZ5oqq5s677oAM90bd94ru987//AoHBInAGKyKRyyWw6n9CoVFqYWq/YrHbL7Xqxh694TC6bz+i0es1uu99wneA9Ly3i+Lx+z8/f+4CBgoNEYYSHiImKi4yNUjIqBCgBXJI1RyNVjlsJRAgOWAhcdZtYoCMMmDMNJn8fDAYrlgpInaVaD06aNaR6vbdvp8DDU7vEx3qqLaJGRb/ITa7QltDVJsolsSfG1ljYZc+B4T3S3VzlNuMr6jC2H+4i7OZJtPMqhiIO8vZp2kH+8VZw45ckVxBIZ1iZGKgGIME4AqixcPiwIpd6Fs1JzMiGmQiDPBA+gaeHIscT32D/UEqC7uQXkzlI7esz06WSmk5w2tzJ0x4+Eh5f9hyq4g9DJxyIKo0DkkdKQXM2tjshTycUmEtRCFvCqmVWMVJfdHjh1Q2Dr0usog1UdgRWF03HKOyh9sZTjkF91L27lkbcuCpILntztkXbFxj7PgGs2MpbHj+H9IrsgvKOwzk6WS6Cb3Pjda1OzBXhynNllC4fLznaY1csrKxHfX4RGw3f2bhzr1GQWLfv3xVHkygMXFzx4zpuI7/Re7lzK8KfOzEtvToUWpita9/uBRJj7uDDt4leV7z581Bqo1/Pvr379/Djy59Pv779+/jz69/Pv7///wAGKOCABBZo4IEIJqjg/4IMNujggxBGKOGEFFZo4YUYZqjhhhx26OGHIIYo4ogklmjiiSimqOKKLLbo4oswxhhEBDLWGMgG9ilnIzRzaEDjjkDCgcELQwZpZBEWfEBBBSIsmeQHFSTJJAlSckfBCEuKcMGR9mSQwgUQnCABd2GWACYJU+LI5UOUtCmfm2s+5CUJP07wgZ3x4fmBSNKtJKCfMo0wZwo/llCedB7EqeiE6i1qU6GOzjNopJT+EM6k9B1a6aac9pVogFOKAGmneAwwjo6kpkpVQCZgeuCoqsbaQqiy1koDrbbCYeqEfOa6RgB1XCqCBr7qWuxXqPblJ4SfAjglJbAeW8auJ/RKoI+10qZBSqGu6hctndmegS0J3YabLbHmbqqKpveNqma6Z8z0bn8INQvvtISqoEqyLOyLCb/27DsCAADfm8WyKVRQJAkL+9DwCA/vhLDBdFBsMX8Rf5DxxWLUwVdY/aH7LcdpzDuCyTygPJTKI6BLMhusjYuDtTLbNK6eL6sxaqEj4xBtz4/m3EU4+zQq9I4hAAAh+QQFAwAGACw3ACQA5gFcAAAF/6AhjmRpnmiKCmrbBirrznRt33iu73zv/7kCcEgsGo/IpNIAWzqf0Kh0Sq1ar9isdsvter/gcEuBO4jP6LR6zW6nHu64fE6v2+/4vH6/a3iFA3yCg4SFhi0Igokki4eOOwCPkpM0QpSXUZaYm5ydnp+goaKjTmSkXZGnJwQzZqqvJKkuCzqysLe4uU6aur2sJjK9wsPExcbHyG5wyczNzmy8z9LT1NXW11qmc9HY3d6ctN/i4+Dk5udQv+hg2uvuNctn8e/0OeH1+Pn67SXBatz6AgocSLCgwYMIEypcyLChw4cQI0qcSLGixYsYM2rcyLGjx48gQ4ocSbKkyZMoU4GqXMmypcuXMGPKnEmzps2bOHPq3Mmzp8+fQIMKHUq0qNGjSJMqXcq0qdOnUKNKnUq1qtWrWLNq3cq1q9evYMOKHUu2rNmzaNOqXcu2rdu3cOPKnUu3rt27ePMqtKW3r9+/gAMLHky4sOHDiBMrXsy4sePHkDVqiEy5suXLmOcICAEAIfkEBQMABAAsPgAjAN8BWgAABf8gIY5kaZ6oKaRs65brK890bd94ru987//AoJClGBqPyKRyyWw6n9CodEqtWq/YrHbLFXW64LB4TC6bz+i0es1uu9/wuHzeXtDv+Lx+z+/7/4CBgoOEhWAJhkYxiYyNjo+QkZKTlJWWl5hyBpmcnZ6foKEEdqKlpqeoqaqrrK2ur7CxsrO0tba3uLm2i7pIvL3AwcLDxMXGx8gsAcnMzc7P0FW/0SUF1NfY2drb3N3eLADf4uPk5ebn6Onq6+zt7u/w8fLz9PX29/j5+vv8/f7/AAMKHEiwoMGDCBMqXMiwocOHECNKnEixosWLGDNq3Mixo8ePIEOKHEmypMmTKFNKqlzJsqXLlzBjypxJs6bNmzhz6tzJs6fPn0CDClU3bajRo0iTKl3K9FbRplCjSp1KtarVq1izauUXY8DWr2DDih1LtiyncGbDhAAAIfkEBQMAAQAsPAAjALQASQAABbRgII4kQJ5oqq5s6wbLK890bd94rrvF7v/AoHBILIoIxqRyyWw6n1BoLEqtWlXTq3bL7Xq/4LB4PEKQz+i0es1uu99wYzZOj87r5AZ+z+/TE36BgoOEhYZwDIeKOj2Ljo9Wel0GkFV3V5eVmpucnZ6foKGio6SlpqeoqaqrrK2ur7CxsrO0tba3uLm6u7y9vr/AwcLDxMXGx8jJysvMzc7P0NHS09TV1tfY2drb3N3e37sRTyEAIfkEBQMAEwAsDAAfAA0CZQAABf+gII5kaZ5oqqpT675wLM90bd94ru987//AoHBILBqPyKRyyWw6n9CodEqtWq/YrHbL7Xq/4LB4TC6bz+i0eo0TsGePd8wgr9vv+LyeWNj7/4CBVgOChYaGC4eKUAQrjgIMC5ILCouWl5iZmnl0m56foKGio6SlpqeoqapphGgENg2ar1B9qm5Rs6tdlbo3tzUICbw5v1aJMcMvybG9T7kuBy6dMsnNfsfRdcVG2zm1L3HWeN/iqMfl6Onq6zXd3VEBTh3sdw5H7/SA+DPZP/t2CJBUc5EgX41+Vf69QGhQWUMp5JRweOiEgZQRAylq3LjIYg9mHL9M26KQVMAgE0P/qsTTamWbLOeCZHxY0uUoe1wiJqkZQ+fLHj5t2gi6BQCMmEKTUhmpVMhJp0ZmapzHw6MYoljCETHatKspAALixeDKZh9ZP0/53fNKRqpGnmx/TGL64tlKtzSwurDaxG7cvznOxuBLka6StC0EAwaD1xRiHAWHAGC4eGtlJY3fwJ3xj/ISxUU8x0D6kHQSrVhargN5hDWQzTJgZ1F9+ZPY2rhzVzGsGwnV3sCLBl/yqPgj0JyNK1/OvLnz59CjS59OHfrw69izo4usvbv37+DDix9Pvrz588RIoF/Pvr379/Djy59Pv779+/jz69/Pv7///wAGKOCABBZo4IEIJqjg/4IMNujggxBGKOGEFFZo4YUYZqjhhhx26OGHIIYo4ogklmjiiSimqOKKLLbo4oswXhERbTHWaOONDWFQm44yDFDdj0AGKeSQRBZp5JHLRSADBTBUwIMFLlhQwZRQdiWlky1QiaMpt5yFZQYvSKCDmDGQ2ZSZN9C45ZpE8MimKTyq+eacOSgZhZ3AySkbnXQWIAJyfAZKjA0RIGnooT/KyZ+bgjYahAaORioDa3uaVwugkhrCaH0QZOrpp59UWl6XLVzgwQuiglqWqqzuh2erfqQK66y0UuFXfrKKdykMkF5263+93kdmsLW+gWmxc+ZKHlmnuqAssiVimduv/jWbH9aPr0LrBT5yclefotquKW24cmzaArFSAMAVWeom5kK7E7C77rvzJlZvvPfCK6+79vKLr7/60gtwvvfGW8O45L5xgQu3bWHuBA9HLIPEMVAMg8UvYOyCxi246XEMnbqQbcIJOQguyV5wheZ6K7fQMspsvEyfuj7CXMbIW2wgg84x8AyDzy8A7YLQLRA9gdFI76x0z0v/7MOxNnfxrBJqVt3j1TFYnTXWMGjdNdcveO0NomSXbfbZaKdtKAxQS4Hz2zLAHYPcMND9gt0ix6333O2p7fffRIYAACH5BAUDAAMALBgAJACzAVoAAAT/cMhJq7046827/2AodsJonmiqrmzrvnAsz3Rt33iu73zv/8CgcEgsGo/IpHLJbDqf0Kh0Sq1ar9isdsvter/gsHhMTiHK6HSrpG673/C4fE6v26GPOxXQ5evpB3+Cg4SFhoeIiYqLjI2Oj5CRkpOUlZaXmJmam5ydnp+goaKjpKWmp6ipqqusra6vsLGys7S1tre4ubomgbu+v8DBwsPExcbHyMnKy8zNzs/Q0dLT1NXW19jZ2tvc3d7f4OHi4+Tl5ufo6err7O3u7/Dx8vP09fb3+Pn6+/z9/v8AAwocSLCgwYMIEypcyLChw4cQI0qcSLGixYsYM2rcyLGjx48gK0OKHEmypMmTKFOqXMmy5bAALmPKnEmzpk2ZAnLq3Mmzp8+fQIMKHUq0ZwQAIfkEBQMAEAAsFwAsAPIAUgAABf8gJI5kaZ5oqq5s675wLM90rRZ2ru987//AoHBILBqPyKRyyWyqBM6odEqtWq/YrHbL7Xq/4LB4TC6bz+i0es1uu9/wuHxOr9vv+Lx+z+/7/4CBgoOEhYaHiImKi4yNjo+QkZKTlJWWl5iZmpucnZ6foKGio6SlpqeoqaqrrK2ur7CxsrO0tba3uLm6u7y9vr/AwcLDxMXGx8jJysADABMQAyQRUMtjAgIRI9QEDdViANcnCQfeXx4i4SYKCeVg09QlCQjtXRsQ7yTUCOwiH/Ra4ATgEDFw3L8t5yCkK7HuIJeABQAQIBANgjyHXAQMWMDxwAICEPZhBCgAgIEGAxxuLFBgkdzILAshHJjX8OWVdwMIMHBwgOVFm1amDUiw0sDKkPyAUgGnYEE3mewMKq0CwCKOjTSTTpWCoyjRBwx+bpWi8QHHnQsOHNA6lglEADhKtmxLFh6JmnSZ4DMhNm+SAPf8PhRcBYMIDYSjhAAAIfkEBQMAAAAsngEtAAEAAQAAAgJMAQAh+QQFAwAdACwMACIADgJiAAAG/8COcEgsGo/IpHLJbDqfSAJ0Sq1ar9isdsvter/gsHhMLpvPVQZ6zW67k4i3fE6vbwX2vH7P7/v/gH5xgYSFhoeIiYqLjI2Oj5CRkpMKk5aXmJmam0cFnJ+goaKjpKWmp2KeQwBrUqh1qlACA699DUqxtY8Hula8ir9FcQquQoO9U2pMt0+sR7wLQ8rCR8eVXXhCD8h521TXr87ZW7nc5kbF55ODDupn0e7xU/Dy9UrObwFF6WHt9oX06JT79yTBF3ygEL4ZtwhPQIKvGKrTt8eAH4V/JIKZBnGORTEcifgzopEbP0knC6Uc2LFlGYwum4D7NBNTzZh+vAG6WU+nrv+ST4BCCoblI84sRNkIPRqJpZmldxA9ZCrKJ9WrWEkZnDQVCs+WX5VwyHIsElQh8M4yUZu1bVa2iWAakaspIF23dOBuMYq3Lxu+T0L6PeN0MJekShBjFTxJca+wXhQo4Dvu7paRRcYacWwPMpWtXBg/smq4FOlAlktXSX0EYdcnrwOB3hJbiOi2nLvMVm3mNhbfawpDEs5bFEZmxZMrt1SJl+flbDBDn66I4hG91M1ez869u/fv4MOLH0++vPnzVnajX8++vfv352MRh0+/vv37+PPr38+/v///AAYo4IAEFmjggQgmqOCCDDbo4IMQRijhhBRWaOGFGGao4YYcduj/4YcghijiiCSWaOKJKKao4oostujiizCW+MERMxpRYxE3EpHjEDsK0WMHPwZJ45A2EomjkToiyaOSPjIJZIxQRinllFRWaeV92F2p5SEbdMAaLfiBuSVOEYxp5icZhIHBEWsa0WYRbxIR5xBzClFnB3fmyeaebvIJp59ynumWQhUcQcEXFnRQQQWJCpHooo128CijQ0waqaWVKkqpo5pe2mmmkIK6qaSfchqqqaNiiqqnp5K6qBCHRipEoYJCNJ8QaYYhwRG7GtFrEb8SEewQwwpRbAfHJsvrsr4yC6yzTBxbK07WCVjttC3l2uUES9AiphDf1tcltr2cVWYR56Jb8kW6RLA7hLtCwNuBvPQeUa8R96qLr7387uuvvvOSKzAg8g4sz50LZmkwJOESkevCEK+BD8JLKFzeBUKwFrEmnrBmsXnZaIDExxtPIjKDwZLsVkoWFmxgwyWrU5t954p5cszunDBgyEXcjPMrHjzYpso/+0F00Ug7MbEQ4yatCcwNdtwgz0SI8921Tqt2dNZcdy2KzwPWLMQFYHv9yq30bW32ImUzqPbaemgM99wdtL1Ka/pBQPcmzjycBMxQr2e3EG/vXUcFxWLdgeKKs5ey4ZPIXaDkkBvCcuWYHzh45olotHl/G1DM+eik/+Fyvu2WrmUQACH5BAUMABYALAwAIgALAmIAAAX/oCWOZGmeaKqubOu+6ADPdG3feK7vfO//wKBwSCwajzADcslsOlOKp3RKrVqv2Kx2y+16v7MDeEwum8/oNK2jbrvf8Lh8PlTS7/i8fr8SoP18gYKDhD5ihYiJim4FLzIjgIuJjzAAkl0EKpSXbQicN55oCymhI1GfQwwwkSWjh1ArpT8JnJtotJyAjTysqL6av3enwUyvxMc1xsjLKb0Wu0aWJAFFbMxlyteo1FS4Rc7aKNnhibjSxOfkY9Ak7Dkc6laqWO6otvFI4GkO+Hj6/SjsCPKWRxbALqNu1Psh8BpBTumCJcwx7CCOiU0iutBoMcs/IgsvPei4aAE8kijj/1RMCetXQ3zWYMy7MS7QyGc6OLLcyXNRpI+BgPa88bLS0KPHiiKNlUPoUhoYV0R9KmcqVRMIEqyEVKQBikwmrDJTSlXs1UBmuTg9u4LbjLUtbmojuzPtVjQ1yVX0ygcu279DwAIeTNiMkrSFEytGptNC48WQI4fzK7my5cuYM2vezLmz58+gQ4seTboM5dKoU6tezbq169ewY8ueTbu27du4c+vezbu379/AgwsfTry48ePIkytfzry58+fQo0ufTr269evYs2vfzr279+/gw4sfDxuc+RPnTaQvsZ5Ee67q0cuPT5/9fPv13d8nz7+///8ABijgVREMaGAiGxyo4PWCDDbooGgFkkDBCRU8aOERa11w4YZOYDCCh7tFyCEnIMpAyQQpoEiCiqjdMyIfIjbjwmkv1mjjjUx4MFyMOPboIz4iZiCckBbw+KM/RbYQEmq76LTkkXfo2BsEJBiZmItQZqklYICcI+WWitzVWpMlPAamHCD69uWZbpjJ5psjBCmCBnDGIdhvflh5G5kk0IkTZHfWiZKeghZq6I1dipDBmodCSWijcDC6m6SQmoFlpVsmmIKVj35WoZ+YotEpCRy5mdljT4baRZofnsBqq6RRGaeqZoBKa5YS3Kpra6buyiA3o/oq7LA1RMJjqSf0ilmwxDoRAgAh+QQFAwASACwQACYAmgFcAAAG/0CJcEgsGo/IpHLJbDqfEgV0Sq1ar9isdsvter/gsHhMLpvP6LR6zW673/C4fE6v2+/4vH7fLPD/gIGCg4SFhoeIiVRShAuIAoqRkpOUlZaXmJmagw6bnp+goWwAoqVjA6ZEkIerqa6vsLGys7S1tre2qLi7vL2+v8DBwsPExXStxsnKy8xpyM3Q0dLT1NXW19jSpLAH2a/d3uHEz+Ll5ufo6err7O3u7/Dx8vP09fb37n74+/z9/v8AAwocSLCgwYMIEypcyLChw4cQI0qcSLGixYsYM2rcyLGjx48gQ4ocSbKkyZMoU6pcybKly5cwY8qcSbOmzZs4A+nKybOnz/+fASEIqSCBAlCPGY4qXSoQlS4AEyRENUKOqUMBEY5gNaDPKkQBVSUEWBAgrFeEYJEMWLDzbEOwANoKGRvA7UMBABQYMLJWrl2DqwQMSLBXFd2/bwEcYESkL2KB24bUFSKYsIQBAXQdfmwQnAS8iw0sGG0gLlvOA0lQHbzggYEGCBYwoGsW9T/QD3QROJCAwGnbBysXllBAwQHfk4EXBM0YgGjffpUDFE7EOHLpyxUnGNJggQLH2AdWXpCAgYMDbDeHB8hWsd7RCwhc/r2+H6QCAgpsGwBAH+3604UFHoD+pHWEegQeFFmC70TnRFYM2pNchBRWSAiEFmaooSQYbtgCTxAAIfkEBQYAAAAsjwErAAEAAQAAAwJoCQAh+QQFAwAAACwcACoAZQE6AAAFyeAAjCQglmiqrmzrvnAsz3Rt33iu73xPH76gcEgs1hDGpHLJbDqf0Kh0Sq1ar9isdsvter/gsHhMLpvP6LR6zW673/C4fE6v2+/4vH7P7/v/gIGCg4SFhoeIiYqLjI2Oj5CRcQaSlZaXmJmam5gFnJ+goaKjpKWmp6ipqqusra6vsLGys7S1tre4ubq7vL2+v8DBwsPExcbHyMnKy8zNzs/Q0dLT1NXW19jZ2tvc3d7f4OHi4+Tl5ufo6err7O3u7/Dx8vNCFvS+IQAh+QQFAwABACwoACQAggEgAAAEqTDISau9OOvNu7/FJ45kaZ5oqq5s675wLM90bd94ru987//AoHBILBqPyKTyCFg6n9CodEqtWq/YrHbL7XqViq94TC6bz+i0es1uuzuCt3xON8br7hDeqt+zDX6Bgm8Mg4aHiImKi4yNjo+QkZKMYZOWlz9NYneYnZ6foKGio6Slpqd1C3gHqCgJOKodha20WZy1uLm6u7y9vnS3v8LDxMXGx8g7msnMbhEAIfkEBQMAAAAsgAArABEBEQAABFQQyEmrvTjrzbu3yieOZGmeaKqubOu+cCzPdG3feC4Leu//wKBwSCwaj8ikcskEMJrQqHRKrVqv2Kx2y+16v+CweEwum8/otHrNbrvf8Lh8Tl3QuxEAIfkEBQMAEAAsFwBgACIAHQAABcUgJAJiaZ5oqq5sm2JumaVzSlUitepxr8IxoE/Ym0CMroEqwhK0IoIoCsAg+VBRQeFEWBCIV0gWFfCGT2PuQikWMX1pU5ew2rIK8dLAfC7lRXNuXDFjAAQBSoEpC4RaCgsLB16KfQZRjwmHDIh8fQcCBJJsImV0JwE9CwIMCwZqo30CDQsOaqZ9C4YLCH4Qe7cin3AAksCUZwRRDgsPBg4GBL8QqHUrWQ6SkATHvY1OAAXgvp2xUqfkZ3/jsH1vJ1Z9JuwnIQAh+QQFDwAAACygACoAGQAGAAADDTiw3P4wykmrvThXkwAAIfkEBQMAAQAseQAwAFEBDQAABFowyEmrvTjrzbv/YCiOZGmeaGdgSuq+cCzPdG3feK7vfO//PgBwSCwaj8ikcslsOjuMp3RKrVpvwqt2y+16v+CwGBgdm8/otHrNbrvf8Lh8fnkAF/SLIM+3RgAAIfkEBQwAAAAsjAAsAAEAAQAAAwJYCQAh+QQFCQAAACwsAGMABAASAAAFEqAFjOQ1BuRErmzrvqQAvzIQAgAh+QQFAwABACwSACQAqAFhAAAF/2AgjmRpnmiqrmzrvq4Az3Rt33iu73zv/8CgcEgsGo/IpHLJbAYMzqh0Sq1ar9isSqHter/gsHhMLpvP6LR6zW67gYW3fE5HIep44T3vBowJfIGCg4SFhoeIiYqLjI2Oj5CRkpOUlYJQlpmam5ydnp+goaKjjZikp6gkMqmsrZQdrkl+sbS1treCcbi7vL2+v8BkD8HEiauuB8XKy8zNzs/Q0dLT1NXW19jZ2tvc3dnH3uHi4+Tl5ufo6err7O3u7/Dx8vP09fb3+Pn6+/z9/v8AAwocSLCgwYMIEypcyLChw4cQI0qcSLGixYsYM2rcyLGjx48gQ4oMAm6kyQAYTl2kPAmvAkuAF1LEfEmzps1PG27+m6Wzp8+f21YCHUq0qNGjSK0ASsq0qdOnUBcujUq1qtWrWLNq3cq1K8KpXsmBDUu2ioeyaKMJTcu2rdu3cLuu5Bm3rt279XT9DAEAIfkEBS0AAQAsNQAmAIcBVgAABf9gII5kaZ5oqq5swLRwLM90bd94ru987//AoHBILBqPyKRyyWw6n9CodEqtWq/YrHbL7Xq/4LB4TC6bz+i0es1uu9/wuHxOr9uJgLt+z+/7/0QvSw6AhYaHiImKi4yNjo+QkZKTlJWWl5iZmpucnZ6foKGio6SlpqeoqaqrrK2ur7CxsrO0tba3uLm6u7y9vr/AwcLDxMXGx8jJysvMzc7P0NHS09TV1tfY2drb3N3e3+Dh4uPk5ebn6Onq6+zt7u/w8fLz9PX29/j5+vv8/f7/AAMKHEiwoEFjeQ42E8BQITOGBRwuYyhAojKKFpNhzHhsI8diHj8OCykSWAOSJX8qQUw5siHLYChf7oopMxfNmrdu4qylc+esnj5jrQyqCyhRV0aPsoqgNFcIACH5BAUPAAIALDUAYgAIABoAAAU6oCBkYmkKVUWJ2OmakQswwEksxBngNm/eOdPAVwL2giKCUUgU7ZDJpmBZGkKnUuvxpDU9uYvBqXYKAQAh+QQFDAAAACw3AGIABgARAAAFFSAGjORIAdZVrmTEvvA4xHRtrzMZAgAh+QQFDAADACwzACsAiQFEAAAF8+AgjmRpnmiqrmzrvnAsp8ps33iu58Lu/8CgcEgsGo/IpHLJbDqf0Kh0Sq1ar9isdssd9rrgsHhMLpvP6DSrpm673/C4fE6v2+8oAH7P5zv6gIGCg4SFhoeIiYqLjI2OWXqPkpOUlZaXmJkxC5qdnp8qnKCODaOmp6ipqqusra6vsLGys7S1tre4ubq7vL2+v8DBwsPExcbHyMnKy8zNzs/Q0dLT1NXW19jZ2tvc3d7f4OHi4+Tl5ufo6err7O3u7/Dx8vP09fb3+Pn6+/z9/v8AAwocSLCgwYMIE0KZoLChw4cQI0qcSLGixYsYM14JoBFbCAAh+QQFJAAQACwMAF8AxwA2AAAF/6AgjmRpnmiqrmzrvnAszyNk3zhOFidv+iXgrkf8FYPHoXGJZCqb0Kd0JKQmadisdsvter/gsHhMLgsaBLQ6zV672/C3PE6f2+v4uz7P3/v7gA0NADU5ECMADAEEjIuNjASOkZCSlZSXj5mTmpacmJugnaGfoqWkp56po6qmDVUoBQ0DAAWEtLa1Are6ubu+vcC4wrzDv8XBxMnGysjLzs3Qx9LM08uMhCyJtGbc3d5jAAOuLq7Y3+fo6S8ABOaGhyLs2+/09ToCBfb6+/z9/v8AAwoUIY7HKxMN1ClcyBBRuxbaRAis17CiRRPiBpDLVWjijYsgLcrreE9XOx4e3/+RTMmypcuXA0cUbBFLF0wbIXMuHJmNA7abOoOim9mi3M2EQpNy4ylAZbyTTSEocCki382rWLO+JDjuYIlBAK4qHUuGqQqeQMmq/UKURbmoW9fK3cLUqcl5MFdq3cu3b0kBbVckDHvDasq5iLGYTYE2b+LHMAYQ8IqwlljImLM9lGjIId64hv2KHp2Vq0G3mVOfW4yCterXYCRT/qoLtu0wdTs/3Vb1Sm8nVoD/jhKc+PApx4sjx+ebuXDnxqGTkE2u9u3rXFybYAepu/fv4MOLH0++vPnz6NOrX49+NolwAWYNiA9fPv359vPX34+f//3/+vUnIID+BUjggAYmWOD/gggyeOCDCvbHmV3YVQiGexZmqOGGHFaFU4cZpgSEOAo8oNFzB6XYnIooruhiizBGlyJfBBiwwAIEgKhjFgAcsMCJOwYJAwAJ4LgOaUgmqSQ9VZkTj48D6APXklRWSVoDCCSgQAI5VlUkIwkcwGUJAyiQpQIOCFmhAws4UIuPXfa4wAEP0HkjAyMQ8AAC4RSpAIZqyiVnl2wqQFCRCWg0wAM3KrqAAtgQcCNhVlZqaUsKHBCACAw8+qSRIkjapgBsbhoPAn9equqqARFS440JeAmqCAgsYICcQAZqIQGZOmAjAp/mWuiiBzip63WdQnqGp7p8SUKnBgTQKKvUVtuPcp7FcsosriSw6WaRaZKwiLXkWsvmASMUKmuXutSqkQI3IiUAAQiweyxmnbYpjo+azgLnCNCKIO2NDjDg7b2qAVDrjQrYOGdCBvhoQAM24jlCAz7e+Gi5HFcLgAEF20BxAD4EYMDJDhBgyMe+qtzxy6SFAAAh+QQFAwABACxEALcABQADAAACBURup5EFACH5BAUDAAQALEIAqwATAA8AAARFUMgJpr2yTJ2xKJVUhd5WBUaJhcPCiAK5CsHibjgltfYblyCaraeKaXhD3+hyGiZzH5bz+TMJp0TmEUtdNrmLhy+6A3cjACH5BAUDAA4ALEIAmQAVACEAAAS7UEgBpr22VMz5pp1XBIZQTCeWbsPCSF+oCcHihhdwtvYL4pWa7ZYyYVhDWwPWmQmTvo5OwEvefjmadfiaGX/V7RJrCm6hx935sGCPP2ZrSVJcSXgKwnAAm1V0ZgonCEo0BAEDAHwUOwogem0SiH8TgCcEFQk2BFQbdn8DBHwNNgkgMV6JAwEabAcBZJWJGokCCjZzMXdTtAIEDwawUli6gDi7u7PHjIqilBdFsopTdECnscvZHtrVKtzLEQAh+QQFAwAQACxCAI8AFwApAAAE1lAIIGe9OBcqSu6fZwmExH0hlTBoOyILO7rSJihLDGoZ4OG5honWUeVyMiIHeJSdUrdjc4cR+aLS4BCayE5FPQnT69RQxl4DtXJFLxwMuIN9sXUXiHuJtlwoAAQ5CRMDBAMBABQcdgiKBwsHAQUBAwCVNSYeDRQBAgY5ajaKdScBJQMPCwkDAqwfpYU/WqNVipWVBYGQi2GJiokCqQeuT6QeG6wEDVavFqV0tHUVYJeWlFRgr5O4xUq4a0rOLtnT5ZhE6Onq6yjk51Xs8fLs7uDv8/j5HxEAIfkEBQMAEAAsRACLABUAIgAABccgIIziaJ6oUJRnkaon4BqEwL6tmBw3bpaKBULUe60EwQWvZZQhF9ChzafSQaFLKvAaJeKOSa7U5Pq5wlyFF3VMcLlZ1PZ9ld7A9MWjmztfD1ABUywlbXocDlAGVQNOZSUICzUDWDYEBAMBAERgHCaRCw02jY0jKy4iAzUNUGqDU1UjmQQybpIwciYBmQMCDK2vZESkMgBXhcKvmyIKB6IkKWWMuLExP9ckpXcvxI0u0j7Fm7BUfeW50OXgZEbn7u/wPuum7SYhACH5BAUDAA8ALEQAhwAVACEAAASxEIgpp71YFPC6/+BXWWOGbYIzaGH7IckqcG6oLHHt3nhF652FMMYCeoQ42Q+IzBk/TeXzES0+q7NpdOo5DElGmcZSaB0aBqFhtpT8EouGICA8AAaEwR1Q/hjkEjxyAx1LHm4EAgxCCgUCHRYgM3gzXguJbheHenopamQXbnobnEiEDxl7jqQCCgkMFC2ZEgEzEzWgE50CnIYmM6R5Jb8kvY7EjyKQkUDHY8lGyNLT1MQRACH5BAUDABAALEQAgwAVACIAAATIEIgpp71YlFpszx/VEVKVgZJinKxQIQtDtV66xJp3bp1y4y7aRpD4AWkVn1EW3NmMuGHOAuhBb40ZZli8HjFJ741p0jzFqxBPoDQ6GAaGgzrh3hBdAnLiUwAINwkuAwQDAUFVEgkIJQcLB4cBAwCTHWsNEocGN2klTVICAXoDDwsJAwKoYBaSBFYLWZ41g5QSDTcHHLMAvLQCpQeqZS5rG6gEDR/DJiaHFL1lIReTg5JVNCLWoNi0ltwzskI749/l5ucX0jogFxEAIfkEBQMACAAsRACBABUAHwAABLpQCCBnvfiWurOXFAV+mrARjtRha0URSzqS0iAMS6zSoQDnMgvJ9gPuMp1XbhkUZWy4pdH0UUoXh2aJeGUeL9aubla7ib1US3h5wGIbrnKRuaqPfoZG+9ADFHo3ZggUCjkMNwEDAIpJPgohPwkTimobNn8CiQJtC3CLIo0SiQQCDTkKZBU2k4s3CQsPpC19lK0GOQZCGJ+WFAEHCpegI32YToAkrayrGccTBaOYHB4bf4xpNMS62dzdJBEAIfkEBQMADgAsRAB7ABkAIwAABN9QSAEmcDjrvcvlYOgAniWeTREYwnCe7cIIxcuVwSJPfO+TMV1DUvEZcTrdrGD0aQZJJRFGq+SiMhuRCcUuhpSmRXD1zsRESde7Cx+t7CQjtA1iDws8uMhD6h46LBJMgz9qOgoESQMUFY4UGINwCkwIQioEAQMkGnUDChOKeVYAJHw8pkwEFQk6BC1AhKhhAAMEjA06CZAgkmqapngLASJbpaYfBoECdBMez7UCBA8GARK9YRljEzCRhWpFGJvYTaa2m25oPbXssuqzHy80R9cOzM3v+fr7YjYcPf7IvYsAACH5BAUMAAgALBwAagBBAC8AAATsEMlJq704I9aI+B/RMFppnliyLAogBMqaoHStAcZyNMfCALagkDJYLQbD5JDhUzpthIUHRKUantgiAcstBaTd8CWKFJsl0e3ZrF2bv2o3t5EzNOTc2EqB56b7XHBVg4SFhoeIg2SJjI2OhX+AQR9EYJI2ilICQJc0BJ8EAXUBnTYABQBRKwSnpSYgAAwPOz0/BY+4uSAqLAECAzkLCbrEjhxTICIkrhmMzM0gt1XPGo7UFonX2I/aEoTSVN3eude65cTPVODqg+e42uTU793f0+II8/SN+tYXApf/tn1Yd09gsYMIEyrMV7AahggAIfkEBSoABgAsDABfAMcAJgAABv9Ag3AojBgAxwgSoEwum8yn1EmNVqHYqXWbvWq73K/YSw6XwegxksgmFgDwjQagkdPt9Xn+rsf7+4B8gnuEf4OGhYGJh4qIjo2QjJKLiQMalkwCbUQaERgaGBufoaOioKakp6Wrqq2pr6ixrLCzsq62tLe1u7q9ub+4waManWubcAESGMrMy87N0M/S0dTT1tXY19rZ3Nve3eDf4spyA21GTMsUEBQV7e0VFRbu8vH17fPx8/j2+/X69PLd+zdQoD+DAfslBMiPIcGDChsWjPhw4USHCCVCBBiv3QViRs4BkHChQskLEjKQXImyJcuXLmPCnCmzJs2bNnPi3KmzJ8//nz5zxlM2wBgnAMsqkGMVwFTTABqafnoa1ekGqFKrYrW6derVql67agU7NitVs1/Rij3LlSzbsG7TtlUbd63cT/EueOgUkoglZRUwFC06AUDhwoQNK058GADjCIgVN2a8WHLlxpExO7ac2TLlzpM5b9b8ebRn0aVTo0atYWUoJH2FzFFZYUSAIbFxb8pd5AgDY7wNBB++u/g542yIH1+eHDkR5c2Zo0Nqcu/w1hkCF93EvTsRAgsIeB9Pvrz58+jTq1+vRILSUBo2zUn6ab33AOHt69/Pv79/73BgUB1fbfwloGDB6QeeOf816OCDED7XGkqCGSWcAbO5d5Vu/YEn/16EIIYoInnoDCBgBlFdl5J2FvI3QH4jxiijiAUIN9J7csiHlHt7PejhjEAG6WCAEOhFIBt0AIaggz8K6eST6kUwIVEtYggAbRs2SECTUHbpJXcBVheAitlVKAQJ/r344ZdsstkejlXO5159DuK3Zpt4PhmmkcEZqF1ft/G3YJ6EOimla9s9ZyVtKTIJY6GQiljiiY2egx2LBoDwn5qRdgpijW+SE18bclZADBGaCPqop6w2GCBJ1vGW5IEDJGgfp63m6t+hFCbKRoYVZKnlqroWq16YGXgw5m6XmtkgrsZGi16or+mYVI91Eivttt29yucmfi757AIMcmsud7xS2f9cqVdFgM6FsB0B77zvvrsEvfLWm6+8isbrL77/6hvwvgMXDPDBAiNMsMIGO3aismRqd8lmg8FB8WZwVFxUxhdzXLHHGG/2ocUak9zxxRujbPLHKoOccskurxwyzC3XTDPMreE46q87BjYMVFOBEpXQQA8d9NFGJ1300kRH0IABDSClNNFUI8201VVPjfXWWnd9tddZf/31BUXGaqkoJqV9ktpsr+1223C/LXfaGJwp4Nx4x6133nzv7XffgP+9tzJwXNgbE8kEBdTiOWFwAQbLCPEAM4pXzvjllmeO+U0Y0NGtgeGEPo41BGCApgEOlPAACaOL7nrrsL8uuzQZo5ujxBxYDb2W7mnxnvtWv5ele2wYRECAAkKEEAHwugvP/O+9P+9782dND33w1UuvvfPcZ6WHrbiVLL7K45dPvsqoH5FY+ueb73778L8vf/z0z19yjeMZYe/Cjh0u77/32h8AF9abd/Xrf/MKIAIHyMAE8u+BDRSgAyO4wAkeTD+pKk8GUbWJDQ7Bg0IAoQFESMIOmrANJUThCdmQQhaukIMqLE8QAAAh+QQFFQABACw1AGYABAAWAAAFGCAQiEJpCsWprmzZmEGZtnQZ2+vMRgIQAgAh+QQFFQAQACwdAGYAOQAeAAAF+yAkjmRpnmgkoGzrvqXUwHT9Cslh7zyJJL3gCzAQ4BDGpHKpFL4YCeOPSV06WwLFAnBECQrUq8uwkEarTDEKQAgIHFvcAW1VmxqLxeFxKGfPdEZ2JQELCW1aB1wJCC5GBYMkZARJZGaBVQRiBTlcRnCLSJgrkRAAfUqWAlOjpRCccUZkoY6CpQCTRgSoq4CBrhB4DwZaeotzo6SlcHkOqgq+v64CRJ5JjLVgyduBrNzf4EYKopjALgAuKujmQgNEJgHsMBoYGgEa8jwXFfsX+TASLgQcKNDfPxcSMCRcqPBgiw33ItqDaA+fQxPuBozI+M7EBIdc1o0IKSAEACH5BAUPAAEALDcAYgAWABoAAAWkYCCOYkaeaCpWahtgrgvH7SACNhpFbiQIqQYBqCr8UodE7IhKKJbEE0LpYp4SCFGBZBhZSdNo6jtyorZeAYBAyAWSqAVJQEAsDguGCBsDJDl1CwQBUzEMCw0iBAddZi4OCwkGDnZdcC4GCwgKnAaJfI+IUVthTyOJIwQLCgAjrY4tAgqaDQwGepexAIcLvQ4BoEVHBTgjhVViZaaxySLHPSmtASEAIfkEBQYAAAAsPQBiAAYACwAABRMgAGBiWVLiZQYmMLWiAM90q7QhACH5BAUMAAYALEoAZgAIABYAAAVa4AAYpBFFgoCmjZS+wpHAaYK8ARHIqXIsP4UgsFAMdjPCglBDFByLxkCASCgW2AXDSrg6GoCqgLGYCmwCaCAlJjPPN+ibRzaj1eyZuyYUFF48NGg0CAoRJYghACH5BAUDABAALEkAagAPABoAAAaMQAgEwGgMEYohwTEQQgaLBUSRMDQOUYITcnAgpJCFggDYCpuGqMFsLgAOT7ZZi5Bvtfa8fs/v+/cDDnAMZXIDBFFRTX+Megl9CQgCexEHCZN5AREJIhp6EhAlDxIodhgYJFEgGxkYbBUgDwoKCyAVECMQGhoSC6INGhOCUQ2FAVZbEwEMDhtbmGYRTkEAIfkEBQMADwAsSQBqABgAIAAABvPAx0MgCDwCh8SQKBA6n06B4vA4LBRMInQrvA6My0KTyyUME4gxeT0QIIbr+IPxUMjXjbt+C1j37whXYEcKC293DQYLCwYFDosGeXsDjwkLDgN7UIV2ZERvWlAEC2ZlRAlYak6jpZpPA6SuorFynVujG3IAAhFlsX98AwDAT6xrGBoBGhhbEQ0LDRGDTxUPFRfXTxIhiwsJElsSF+Lk40IYFYUgFcxQGBLv8eDgDxqj9U4byvvJ+sn/D5xBI/YAgLBXBg2uogWFoBCCxmQ5gdVK4jNJEh8EOiQLgKJABhzi6WAlpKIDHejcSXBAQSYhA6YkCAIAIfkEBQMACAAsVgBxABsAMAAABf+gII5kaZ5oqq5sWohILM90jbR4ntt8P/ZAmg4XLCIiAoAgYuwBAINmT4PRBKhSWuWy7WZnF0l4/J1hJGdMeba5XtezARQ+U9rpN8FLtB+WlCKAfnyDfwIxBAyBOH0iAwIEC4oFRShKkZKLQ48DC56Kg5een4FZj5ijkwBSoqOkSTicrqk4dpCztElFp7i0lEGtvZmwKbLCryrBowaCzTy8CwoEDwsJnFAAL40kogoiCp4OAgEDBHLEJqcKe5gHetjnJraA5wmeBIt3No+O5AIMnrzpKWJnADl8AA4sOICQRQF42AQ48GRAD4t5SWQZQNjkVwwoAqLIEFTrIR9ytjYPQUG5rYWdh0904QHkEUEIACH5BAUDABAALFwAgwAhACoAAAX/ICBEgmiOZSqS56qmQizPdG3feK7vfO/7BVuwNqQVf8ikcpk7ypwxqEAqZVqvNFFMm6RqC1/hDxAknLBTkcKAlmkRC8Z2R32qF/HpU6wjCxR4Cw1zTGACCYF5V1qAiXIwTUJ3iXmGej5+jZSPXEAiiJR4j0mMoYGDkJdGdn+mgWxFVTOZoQ4MBgwObj2GoAigBFalCgAEeAklAwQDAS97RJ8IJgcLB80BAwDZQbJuQQ0izQZ4sC28XAHBAw8LCQMC70joykGNg2dRfGnJ2mQNeAfC5OtTAoCJbALYHYjXiQcZP2DeEWgwpOEOLujcGEw1o04NhNqw+VlUQKQlLBEhCrYxp6+jvlhCQgAAIfkEBQMAEAAsaACPACUAKwAABOtQyEmrvViUu22vHxVmZGmeaKqmo9RqXLzOdG2zMpiLd+//v5dwN3kBj0gLQDX0FJ9O21IyTWqq1uWUQGUSC8sEA+YinqaIxViA9YEFioU6K4nL122ozvlOyO9kgTRof4Bsbkt2hWs+ABuKi11mglcCfoV/Yx9GJISYfw2SM2+QnwY3U6UHBgwOrROOkxt9cgiXXFEqhAoABHIJbAMEAwGHK30IWgcLB8UBAwDQnBmxDUvFBnKnh1o8uS5VAVwDDwsJAwLQZSvhwuh2oXlMWtDqvsyNwfRLv+jeewDVXUFHoMEsebq4GeP2RkAEACH5BAUDAAEALHgAnwAdABsAAARmUMhJq72iXG159VgojmRpnuCUSmt2vnAss1vdzXh+Am/r/TYSTzLMFYo53pBAxPgsvATDRYMNEYupANnjKRbZpOQL1nJVtaMgAS5T36Nr273tCshz7WuIzxOfFVFzfi0XcoNtDQIRACH5BAUMAAUALIQAqwAKAA8AAAMjKKrV7uJB+Za9IFIxWMlLFkhKR5BCdlYch6qo+Qpr1Q1znQAAIfkEBQMABAAsiACtAAsADQAABCJQSEKrvThnsQWQoFAIQ8Bphwmgn0Yg6nQdn5gh35rR5w1EACH5BAUDAAYALE8AZgBGAFQAAAW4oDEBRmmeaKqubOuWgvDOdE0Xsq3vdsz/wBUuSCQScsWkjTBAKp8vH3TKAkipWNQ1mw1sudgveCoeP8vmJDpNXLOB7jcvLtcN60o6nqbf+/+AgYKDhIWGh4iJiouMjY6PkJGSk5SVlpeYmZqbnJ2en6ChoqOkpaanqKmqq6ytrq+wsbBITpO1jrS2Bn2IViQyt4kFVjHBizJWR7+PAgBNCA5SxodWCQbRMLuLwzgIJQ3SxwbVJtglIQAh+QQFEgABACyIALMACQAHAAAEFlAEGaql5dq5ZxZC1ikDtR1JKW4JIEQAIfkEBSoAEAAsDABfAMcANgAABf+gII5kaZ5oqq5s675wLM8jZN84ThYnb/ol4K5H/BWDx6FxiWQqm9CndCSkJmnYrHbL7Xq/4LB4TC4LGgS0Os1eu9vwtzxOn9vr+Ls+z9/7+4ANDQA1ORAjAAwBBIyLjYwEjpGQkpWUl4+Zk5qWnJiboJ2hn6KlpKeeqaOqpg1VKAUNAwAFhLS2tQK3urm7vr3AuMK8w7/FwcTJxsrIy87N0MfSzNPLjIQsibRm3N3eYwADri6u2N/n6OkvAATmhoci7Nvv9PX29/j5+vv8/f7/70SI4/HKRAN1CBMqRNSuhTYRACNKnEixosV9AmWRy1XoosePIENSJCGvo4547Xj/iFzJsqXLkxkL/jgI4KXNmzgnojSnAgAHbDmDCh1qKObGmkSTKrW50+QNhvMgKFhKtapFozJJDEJqtavXf02zNRTwtazZe0ZblCN7tm1bkmPZ5oCq0q3dryQGktOFo8Ddv1TDrigpF7DhpAIJZC1R7rBjxLriBtxZ97Hlm1hZHFzIuTM3woPjeh5NessAxXt5ll7N2qHkopStOJEdhfYUEQVzX8G9W4Du2byB++79u3bixVp1tV7OHAXonpCiS59Ovbr169iza9/Ovbv3792RIxoQYBZ58+XDpT+vHr379vDZy19P//18+/Xj57+vH7///gDyJ+B+BL4HET3NJahg/wriLejggxBGKOEWfsGjxVMu2HCaahMqJFGF+RRXQiIKLLCZiA0ckMACCxhg3HDCiWjbjMG9KGONt/kG2AAKHLAAAS4QcIADAhjA4mVIulTiZiwYCWQsBCQppUhGMrnCig1MqeVHPnRgoj4+RrnlmBI1oEACCPS4AAckOHAmAkSKoECJCyQw5wBk5rmPAws4QB4CLJ7YIxorJjCAAGn4qIAgXOnp6DsNLKAAIj5u1mMAArEYpwBYPurpZGHisKQudZ4n5AIIYBPqp6zeQMACB/DkJKKw2okmmi6K0Gmrrb6agBAlYhrppiesyuunkcaqXJE/CsBAiypgydexjpLHImOQI5QIZKQP4IkDA9gaS62e5bE4abbNDmAuCQQYquuX43pqZIs8PCspkPMmEImRDMTjIwfxegrAvCwm4OMBkwJAJ4sL9ItovpEE/GgDDhjgZwMMmJNIxQ6ICQEDHIPsscQhhQAAIfkEBQMAAAAsTwBsAAEAAQAABAKwRQAh+QQFAwAEACyIALMACQAHAAAEFlDISYm9pOB9Af3CYFySFyyNgIXL4kQAIfkEBQMAAQAsigCsADMADgAABFswyEmrvViWzLv/YCiO5AhMZ6le6epSwGYQQfuSxZkc9m1KigXi1KsIfJZcILjg1SZHSRRZiS0XWAVROqUmdVis03jsUlPM8PBZFgg2XtQ1jF1H3e6A+WZN07URACH5BAUDAAgALLAAmQBpACEAAAT/UMhJq704680xmF8njmRpXmFxrmxrhiAiz3Rt33iu73yPfw2Cb0gsGo+IEGNBkMBc0Cir8HEsHk2VdMsVAVTLBdOJLJvPuapYLES730jlmu3s2u8SqsA6xwq0eIFRXwJhc2MCAHCLjDdqh1dtjZOMcpB0iYKaJ3p8l36Am6IchIZzB2tNiZSsZo9zDBMFrbRllgYNYgmZXx9Po8AVnQsOEqgLAQUBBAEDhMHQFKUGmXzUygC+ArXcPdoABAADD1cDAs550eqZTgME5gZixdrr6nri+AIEYge/9dC+0OVLwMbGtm4IHTlTQcXcEgO+ZvwL9o0XO4sTM6I7hy9UxlG/IHq522jBY8KTNPA5q/GxXsWWMFugnInjAiCaOGnE3BkBACH5BAUDAA8ALAYBfQBzADkAAAT/8MlJq7046817BUIIeGRpnmgnAESTvnAcB0Mo33iuAUUo9L6gcEgsGo/IpHIpBAkYjZWUSa1ar9gCyLEghIDYsHhs5T0Xh6hIx26ftgu09+eu2zFORhwdBTnJgIGAWgJcewdzYIKLjExment8PiN3lW5wkXJflpw5eZlxiFJ/jaWmX5igoj+nraWPoIdqK521Kamxq4quvGGfoXF9U8O9xVaEhlBxCD8AAzykxtJLsAwhe88DBAMBWrbfJVsGrJAKK9mU4Oo7qAJeAQdoAaPE0/ZGhD8BBCAKcda77gks8mcbDXdxEtBax3ADNHQ94i0QNrAiET+EoBU64MBJNIsgbXsAceYHVUCQFf9gFMFtYcOXG7SgezYBpc0mKzLWu8lTJM+fF5XAHKoCqNGjSJMqJRKQqNMKS6NKnUp1WtOnQ6tq3cq1a5KTirC+9Eq2rNmqYIOIBXe2rdu3A9OqXasOrt27RehiFaL3Kd5AEQAAIfkEBQMAEAAsZgFnAD8ANQAABfSgII5kaZ5oWgJMU5AA4RRQbd94ru98TiyLBEPUOAADqqRyaSo0FAsDNEEAMK/YpAHoyHq/KyOtRy6by4LE4cxutxEJsBysntuxcLd+r0sg+IB8cHeESn6FiE0ORgwAgY9lAUBABJCWPYOJmiN1m5t5l6F9f6KlNpmeiZ2phQBipqVbCw44rF5OUFJBVTcEvr/AwcLDxMW/DEAPBgEyRgsNVQMBA7BnBQQtA44QAswO2rbh4uPk5eUvI9V85uzt7oToJfEC6mzv9/j5S/Mj8/U9+gIKfMdPREF6/3gMXMjw3IkXCck0nGgrohuDJSxepMixY4oQACH5BAUPAA8ALJgBYwARAB0AAASS8MlJpq32DWfaCNLQGM6QIcuhDMCgHIuShc6RMMlRAkLv+wHYIfAr/H6OhWN29A0WhKZUEFgQp8fnAGsEWrHZxRbsvZIF2pnFx1DEGGqJL7GoJ85UKB4t5v6qZmRae4B7BGJxcj5JS4k+BEJRWBs2ODosTW4qWy4wCE0NDIECBAwNez8EqqusraoBLB8hsC0gExEAIfkEBRUABQAsnQFjAAsAGgAABFTwLOUIKUUt5FSahLMkSiMAg/YpAyC8r6bAtEAsRA0HS4D9wMIgSCwaj8gk8bMYKYOCwWIgOPqe2GdjYdIJNAYdwLCQGFw2hYQBYJRLq9yLoPLavREAIfkEBQ8ABAAsXAFfAMUAJgAABv9AgXAIEAAixWMSaWQqm8sodPqsOq9SaxZL5Wq72zB4/C17z0nicC0YAN4bDUATn9fpcrw9f+/z/3uBeoN+goWEgIiGiYeNjI+LkYqTbgSWl5cRAnIYGhgbnZ+hoJ6koqWjqairp62mpp6ssa6qtKyvtbi3uby7vrbAuq1zmmwCSJ4SGMrMy87N0M/S0dTT1tXY19rZ3Nve3eDf4spxxpsRGBAVFRTrFRbs7+7w7fDr9PL38fby9fP7/9o1SGDJgoQLEhxYEnEBoD5/D/P1k4iPX8WAFB1OtKjxYkSOEPtBaFcBAjwMTIQUiRBBw8EKCGMenCmzJs2bNnPi3CnTAoH/EAs6SOiw4AEBBzyT6lyqtCnTp06jxoSAMANNmBI0DChWQIgGDRnUaQiwIcBYUmTNku2U9izbsm7PqkULd63cuAEGkMVkKQAAu20B16U7923hu4IPByaMd7Dhxood37VVQdlXNhH0vsybZAIAN55DfwYg2jNo0qhPi1adGvVq1wAKXCoQ4XXp0bdZm4a9Ozdv3LB1A7cd/Lfw46kDUFW2dYgmOmErfAVgoKtzc8UwY99uLPuaCHzDY/J+vTt37ebTo1///Xx79e21luykwfsblwi1BlgQQID4/wAGKOCABBZo4IEIJqigJV3NgZUHlWDyVXRybLDAAAtmqOGGHHbo/yGBX1VGHxtvBHBQAxpMsF8AH7bo4oswujjHTBg0J8RzYIkFgIUYxujjj0AGeYkcIl52oxF/zZTiikI26eSTCzqIUI1FCGDdhDoOcCGUXHbppYQAVJaBkc4leQGKKvL35ZpsBjmABsvVmN1zG1C445Zt5qknh88NcAEEIx5ZopJp9rfnoYgiKCVzAPA1oQTS3dljopRWKl6IlmlAoplZFWrpp6DOEaeNx2ySY6Q8gqoqpXL8GWipg+bn6aq06rkolUJcCRakcmg5aa3AekmkBGNq+p2ZaDIZ7LJcvjnqnJvUqWOqzFYbZJ9TkqlJrJ2u6J+14Poo6pQRDrkrqniGq/+ui8O+qhKnS6q57rweakYuedDxqmka28Lqb78AG/GvwAGvRPDB/Jbar8EMD9xwwQ5HDPHECEtcMcUPV6yVq1/ZB68bIL8xWshvhOxGySOLbLLKKaNM8mhInAzzaC7TnLLMK9eMc8s3s/xyzj3r7LPNQK8cckujVqmrVRd4EMpYsZjFVtRUT2011FdLjfXWWnddNddfe5112GSPbTbYZ4uN9tpqP12ksWvM2NDcMNVN991254333nr3zffffgcO+OCCF0744YYnfndWpG6LjlSQQyV55JRPbnnlmF9+eQApkVhWOKCPI3ropI9ueumony7NG7Lx9VxLUM+lVux10T51u+yxI2Z77oHtfnvtuP9+u+7B+2588cgTr3zvyTPfcZXmqGR0z9NXT/311meP/fbad8/9996H/71n1kWfcRoNJ4y+v+oLnH7F7ccP//zv188+/ffbvzD+++vvPsIDKl/0BkjAAhrwgAhMoAIXyMAGMrB14QkCACH5BAUGAAAALBgCagABAAEAAAUDIBQCACH5BAUMAAAALBMCYwAGAAgAAAULYAWMZGmeaKoCUggAIfkEBQkAAAAsGAJqAAEAAQAABQMgFAIAIfkEBSEAAAAsZAFmAAUAFwAABSsgAEwiIJxidBbmKQyuoLkRvLanfc5nrQqsmE5G0wVdQ57AdxO6SpGSphQCACH5BAUVABAALGEBYQBIADQAAAb/QIhwSCwaj8iksrg5NpfQqHRKrVqrlooWUqFUslrLdUy+SMwXCPpMblubmsAGE4dPI+48ZAIYAPhUAAwAem4Ch3hUBAsEhWQFhwJIGkkBjI5kkVaLjZhXmkuSRJyen4dJiUYDl6VVkQVHlEikrVSgSgMBBIQQtLVSt0cAIgsHxQ29rL9QkadHAgMODAEMCwgQq53LS5DBQ5S8QgoJEJba20reRgAEDQwJ19nozM6zCgsKCgfkvvNI6kMiGFgwCIKCeMr8PTsEC8k9QgDGlUuosAhAIRHuKXBgbIGDfhWJXBRCgBi+BscohhQycogfIX7krRwioJs6WUfMzYTQrGe9iCWrBuxsRrMlkXA78YQjlGonFaGqnEqdSrWq1atYs2rdyrWr16NfowCAJSrsKHjwHJglUs1AnwQLkK01GJfkAgNzIRh40GlRgoZmeUUzpgBp2AAGEjBwgA9w2Ab7hK4qvBaAsU6W/q5ddIDXIspmF91lBzcBgQBr4S5YoHg1wbXRDDSAtfic1yAAIfkEBQYAAAAsEAJjAAkACAAABQwgBYxkaZ5oqq5sKYUAIfkEBQYAEAAsZAFiABcAMwAABf8gJI4klJVomlYVpb7YK8/0CAxqFMmCsKeSBk9Q6BmNiQPgyGwyEYnhYNlMIEiR5iBhcEIHx5IAcFCkrFSnYLDoNqE8skMQIKSTowNq/TAoFoAKPQpRKktkCwcODAkLDQJoL2uJAT0ECwgCcIZjikcHCQVWIgEpk249SQCEL4eePWShoxCFYmwKVJddmyoFiAcNjAuVeCJ6JAs3Dwp/iY+ataZEsFNICGlq2bzS2QpXLz+tNePk5ebn6DUx6ew24eQADArA2dkD8wsE9fWNQucACPIdATBOlCMB/wISIABFgQNyjR6AOgDoIQ2AmB4xBOQvhRkR/YwgMnBR4ZE/0XovhTTCIVFJgUYaLEhJ4qPBZz0YtHmpz8ifjjJWCpDZYZzOMg3mfaRhyYEfA5WahAAAIfkEBQ8AAAAsGAJqAAEAAQAABQMgFAIAIfkEBScAEAAsaQFiABwAMwAABf8gJI7YaGZmqq5UZaXVKkPXWs64eufylA4iAFAVicgEq4gAqWoQmDxIYbk6JJbYrHa7TSiiJu4SkQCPxIIEwiyimqZkaBTtzQFS2EGAEJha2RACAAYLhQsKaWtgDkuEBw0DTgJkZgoABQsHT1l1PHciAYdblGwECwZdimYAhypxbGkLDVgAaV+wDIUODAYMAn8pfWUmm0umhoxqbFNLBUIjcWjSXYjT1mPDbEYqn4De3+Dh4uPk5ebn6Ono3eTOWOGDagkM7FHMAQcKAwAICwj1UQBYwdKgULFsOQgRGFFAwT9vChYEIMdvwRBxBRIsKMYFIY5+1fIsNPMkoixaCUYZshmg8VADAw8MgCNwwNApgGYGODBgQOWIEAAh+QQFCQAQACx1AWIAGgAzAAAG/0AIBCMsGo/IJISSrCyVxgt0egxQr8IJdQBQRiJGQRIsEICRAFP3WlYSFgRsO/mOs8XFAqAAqcvxQg4IcX53fEIGCwN9in9GBgdWhVRlAwFxDA+LA3BybwcLBw8HhJ0QDVMDow0EDguNb4sQCFMKC6hCCpGMBIBTmkUMCYuTUwcHaxAOpLxYEMCIwLFYtgZCnLvFUG8LDokLwxCccbhQAg2vCwaQpXaUAnp8gNN3bqbvSuNYZ1DJzv8AAwocSLCgwYMAJ2goOKCBggcMChL4Vo4gggUcAvqDYKsilkNFbEUMSCCBggQGHtwq4gtKIgMABiR45Q7LG2vXXnmkMtOKEEQAIv+9SQCS40pnbxD4uygLC7oER2z5tPnKpwCgjYTsPAIAFMwiM2te+fYV3QIFAYpSsZUO1AGUydQmaWDAAQMADcoFAQAh+QQFBgABACyGAWYAkwAXAAAFSuAQjGRpnmiqrmzrvnAsz3Rt33iu73zv/8CgcEgsGn+So3LJbDqf0Kh0Sq1ar9isdsvter/gsHhMLpvP6LR6zW673/C4fE63AU4hACH5BAUGAAAALBgCagABAAEAAAUDIBQCACH5BAUJABAALIABYgAZADMAAAX/ICSOZJmVKFVZaFu1MIrFNDnX5FROwNAKIiAtIigSi4KIoYCDIFGBRQBJrVqpg4UPdy1GA82uILutFZBn5DfcJaMIBACpWAjE1VLUQpQYjRMLgQZFbiN7JA8iBYANBAoLDQJfSAYllSQOdAuDhTCJEAwLBwoGjwqSeTgOCwmlCgoMY1oxDCOhsWleqTgHCQBVnTQCqwkMDQaRa7YwRQ0HgQuxwRBluVi/ulNi24Ra3NzKTREtck1D5ujp6uvs7e7v8PHy70JN2FfzNAAMCQrF5egAIEhAwNkCBACbGPAmgMCzBuiyIAgwwE4gBUzmwGhwsV+CgZea3Hq36pSVhBAIKMAIdeBeM5Ul6pEI8MzAPWcAHdR4dBDOKojpAEE7oFPdAAcGkGoTEAIAIfkEBSQAAAAsiAFiAAsAFwAABSwgII4ARp4khQLXKgauOMWjQN947tp6/KAH0iKmGDVIA1Hi5NAZeqsftEYLAQAh+QQFBgABACyUAWYABQAXAAAFG+AEiFMknOhZpGy7tnAsvDGQ0nI+57YJDL9fCAAh+QQFDAAQACyUAWYADwAvAAAFuiAkjqIADWQ6OoCqBgvhpsOCzkROLMFsLIfF70Z7HAKEBs/VODRENSLpxwAUYL0UY8EVRl+IhaIxwDIXz5PNteWIzCpl+qvaMt7LOBq6ri/uEHAjLU1zfTN4WYhqUjOCi5CRkpOUlZAYlpEEZRAROAkID2KIBwYQSkdnaRJpKj+tiAp7ECYpAAwJQQcJCjIqBLhiDGSIP76LsrC2IsaRyZGvzrPIMZAFCdMuAz9AxCoFDQYODA4GBALoIQAh+QQFDAAAACwSAmoABwATAAAFESAgjtJonmiqrmzrvnAsDmgIACH5BAUVAAAALBgCagABAAEAAAUDIBQCACH5BAUDAAYALJQBYwAKABgAAAU3oCGOlUGNaKqu6MQakbAK9FyPgwjcKcGjAd5iRJOpiioFsrdMNVFP4o9YMDqnoqJVuuXaullaCAAh+QQFJwAAACyaAWMABQANAAAFDyAFWEBpnigwpWzrvsYZAgAh+QQFAwAAACwYAmoAAQABAAAFA6AUAgAh+QQFCQAHACyaAWMABQAYAAAFMGB1UEdpnqdwDEfhAGWwBOWwsAcxl8ZdNruV7yCjCVmDYm2oPMaCNlwz+jRSiTNBCAAh+QQFJAAAACwYAmoAAQABAAAFAyAUAgAh+QQFCQADACyYAWYABwAVAAAFKeAgDhMZiUIkjIPgsu46Au9I1GKAt3s8Kj7RrUeUoXoFI08ZPDKLsFgIACH5BAUSAAAALJgBYwAFAA0AAAURIABQgCWeaAoIauu+MGAIQggAIfkEBQMAAQAsKAArAPEBZwAABf9gII5kaZ5oqq5s67LHK890bd94ru987//AoHBILBqPyKRyyWw6n9CodEqtWq/YLK+g1Sm64LB4TC6bz+i0es1uKwXuONIgr9vv+Lx+z+/7/zYPgIOEhYaHiIlvioyNjo+QkWQxkpWWKXCXmpucnZ5hmZ9CoSl0oqeoqaqrrK12X5eCrrO0tUiwtnwJMLm9vr/AwcLDxMXGx8jJysvMzc7P0NHS09TVSwDW2drb3N3e3+Dh4uPk5ebn6Onq6+zt7u/w8fLz9PX29/j5+vv8/f7/AAMKHEiwoMGDCBMqXMiwocOHECNKnEixosWLGDNq3Mixo8ePIEOKHEmypMmTKFOCqlzJsqXLlzBjypxJs6bNmzhz6pwnYadPE1xMkPpJVMWAokiTKl2qZAFTjA6eSp1KtarVq1izat3KtavXryKCgh1LtqzZs2hXYEvLtq3bt3Djyp1Lt67du0Sd4t3Lt6/fGmv/Ch5MuLDhw4gLBU7MuHFGAo5dLF4BOTKzoR0pWXYWAgAh+QQFAwAAACwYAmoAAQABAAAFAyAUAgA7|animation showing debounced input]]

If you want to keep the default behavior and just add new events that may trigger the model update and validation, add "default" as one of the specified events.

I.e. ng-model-options="{ updateOn: 'default blur' }"

The following example shows how to override immediate updates. Changes on the inputs within the form will update the model only when the control loses focus (blur event).

Non-immediate (debounced) model updates

You can delay the model update/validation by using the debounce key with the ngModelOptions directive. This delay will also apply to parsers, validators and model flags like $dirty or $pristine.

[[../File:data:image/gif;base64,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|animation showing debounced input]]

I.e. ng-model-options="{ debounce: 500 }" will wait for half a second since the last content change before triggering the model update and form validation.

If custom triggers are used, custom debouncing timeouts can be set for each event using an object in debounce. This can be useful to force immediate updates on some specific circumstances (like blur events).

I.e. ng-model-options="{ updateOn: 'default blur', debounce: { default: 500, blur: 0 } }"

If those attributes are added to an element, they will be applied to all the child elements and controls that inherit from it unless they are overridden.

This example shows how to debounce model changes. Model will be updated only 250 milliseconds after last change.

Custom Validation

AngularJS provides basic implementation for most common HTML5 input types: ([[../../api/ng/input/input%5Btext%5D|text]], [[../../api/ng/input/input%5Bnumber%5D|number]], [[../../api/ng/input/input%5Burl%5D|url]], [[../../api/ng/input/input%5Bemail%5D|email]], [[../../api/ng/input/input%5Bdate%5D|date]], [[../../api/ng/input/input%5Bradio%5D|radio]], [[../../api/ng/input/input%5Bcheckbox%5D|checkbox]]), as well as some directives for validation (required, pattern, minlength, maxlength, min, max).

With a custom directive, you can add your own validation functions to the $validators object on the ngModelController. To get a hold of the controller, you require it in the directive as shown in the example below.

Each function in the $validators object receives the modelValue and the viewValue as parameters. AngularJS will then call $setValidity internally with the function's return value (true: valid, false: invalid). The validation functions are executed every time an input is changed ($setViewValue is called) or whenever the bound model changes. Validation happens after successfully running $parsers and $formatters, respectively. Failed validators are stored by key in ngModelController.$error.

Additionally, there is the $asyncValidators object which handles asynchronous validation, such as making an $http request to the backend. Functions added to the object must return a promise that must be resolved when valid or rejected when invalid. In-progress async validations are stored by key in ngModelController.$pending.

In the following example we create two directives:

  • An integer directive that validates whether the input is a valid integer. For example, 1.23 is an invalid value, since it contains a fraction. Note that we validate the viewValue (the string value of the control), and not the modelValue. This is because input[number] converts the viewValue to a number when running the $parsers.
  • A username directive that asynchronously checks if a user-entered value is already taken. We mock the server request with a $q deferred.

Modifying built-in validators

Since AngularJS itself uses $validators, you can easily replace or remove built-in validators, should you find it necessary. The following example shows you how to overwrite the email validator in input[email] from a custom directive so that it requires a specific top-level domain, example.com to be present. Note that you can alternatively use ng-pattern to further restrict the validation.

Implementing custom form controls (using ngModel)

AngularJS implements all of the basic HTML form controls (input, select, textarea), which should be sufficient for most cases. However, if you need more flexibility, you can write your own form control as a directive.

In order for custom control to work with ngModel and to achieve two-way data-binding it needs to:

  • implement $render method, which is responsible for rendering the data after it passed the NgModelController.$formatters,
  • call $setViewValue method, whenever the user interacts with the control and model needs to be updated. This is usually done inside a DOM Event listener.

See $compileProvider.directive for more info.

The following example shows how to add two-way data-binding to contentEditable elements.

© 2010–2020 Google, Inc.
Licensed under the Creative Commons Attribution License 3.0.
https://code.angularjs.org/1.8.2/docs/guide/forms