@smartbit4all/ng-client 7.3.40 → 7.3.42

package/WIDGETS.md

@@ -241,6 +241,24 @@ widget type `HTML` places server-sent html with client placeholders, toolbar slo
 triggers — `HTML-WIDGET.md` is its reference. The table in
 `src/lib/smart-component-layout/README.md` lists what each identifier means.
 
+The file widgets (`fileUploader`, `multiFileUploader`, in a `FORM` node) take their behaviour from
+the widget properties the server sends. `sources` (`FILE`, `CAMERA_PHOTO`, `CAMERA_VIDEO`,
+`MICROPHONE`, default `[FILE]`) is passed to the upload zone, which draws one capture button per
+source in a row at the top and hides the picker without `FILE`; a capture-only zone uploads a
+captured file at once. On a mobile device the photo and video buttons open the native camera; on a
+desktop they open the live camera (with record and stop for video), and the microphone button
+the recorder, in a Capture Dialog by default. The optional `capture` property (`mode` `DIALOG` /
+`INLINE`, `deviceStart` `AUTO` / `MANUAL`, `handover` `CONFIRM` / `IMMEDIATE`, `openDirection`
+`RIGHT` / `LEFT` for the inline recorder's strip; absent = `DIALOG`, `AUTO`, `CONFIRM`, `RIGHT`)
+is resolved in the upload zone only. A captured file is checked against
+`formats` and `maxSize` like a picked one. `thumbnail` `FULL` shows the stored file on the card
+(`<img>`, `<video controls>` or `<audio controls>` by mime type, in view mode too; a play tile that
+expands in a multi row): the editor fetches the file with the view's authenticated download of the
+preview key the server registered, never with an `<img src>` to the API. The zone's texts come from
+the upload descriptor's `texts`: a descriptor field (`title`, `description`, `uploadButtonTitle`)
+wins over `texts.addFile` / `browseOrDrag` / `upload`, then `texts[key]`, then the client's own
+text; a widget without an upload descriptor keeps the client's defaults.
+
 ## The executable version
 
 Two specs in the library are written to be read as examples, and they travel with the source: