@blackcube/aurelia-kit 1.0.0-rc7 → 1.0.0-rc8

package/README.md

@@ -748,6 +748,25 @@ loaded by ajaxify):
 
 When attached, the element is focused on the next frame; the browser brings it into view.
 
+### `bleet-first-error`
+
+A form whose first field in error takes the focus when the page says « refused » (a SPA validating its form before
+posting it):
+
+```html
+<form bleet-first-error="account" submit.trigger="onSubmit($event)" novalidate>
+    <input aria-invalid.bind="…" …>
+</form>
+```
+
+`Channels.Form` carries `IForm` (`{ action: FormAction.FirstError, id?: string }`): the form whose `id` is given,
+every form without id, focuses its first `[aria-invalid=true]` on the next frame — once the invalid marks of the fields
+are rendered. A form without a field in error does nothing.
+
+```typescript
+resolve(IEventAggregator).publish(Channels.Form, <IForm>{ action: FormAction.FirstError, id: 'account' });
+```
+
 ## Upload channel
 
 `Channels.Upload` carries `IUpload` (`{ action: UploadAction.Reset, id?: string }`) for the upload bridges