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

package/README.md

@@ -228,6 +228,8 @@ resolve(IEventAggregator).publish(Channels.Modal, <IModal>{ action: ModalAction.
 
 - `Open` (or `Toggle` when closed) opens the dialog; Escape, any `[data-dialog="close"]`, `Close` and `Toggle` close it
   through the hide transition — a menu open inside (`aria-expanded`) is closed first.
+- `Open` on a dialog already open only renews its `title`: the page shown in it changed (a creation turned into its
+  edition), the dialog stays.
 - What the slot holds belongs to the page that projects it, its forms included.
 - `ModalStatus.Closed` with the `id` tells the page the dialog is closed (its route can be left).
 - `<bleet-dialog>` itself extends `AbstractDialog`, with the server HTML on top of it.
@@ -748,6 +750,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