File
File display. Image, PDF preview, download link: this block takes a file from the file table — named directly or through a 4D expression — and decides how to present it. Title, caption, alternative text and copyright can be inherited from the file itself.
What it is
| Type | renderFile |
| Category | others |
| Children allowed | 0 |
| Styling targets | bspk |
| Events | none |
The settings
Only the settings specific to this block are listed here. The block name, HTML id, anchor, conditional display and repetition are shared by every block and described once, under Shared settings.
File
| Setting | How it is set | What it does | Specifics |
From a variable
vb_useEntity | toggle (boolean) | — | default: no |
Path to the file
vt_HowToGetFileUuid | text (text) | 4D expression pointing at the file to display — e.g. Entity.myFileField. Its result is used as the key to fetch the record from BSPK_FILE. Left empty, the block uses the file already picked in its settings. | |
From a variable
vt_UuidKey | imageSelector (text) | — | |
Image size
| Setting | How it is set | What it does | Specifics |
Image height
vl_Height | number (integer) | — | |
Image width
vl_Width | number (integer) | — | |
Behavior
| Setting | How it is set | What it does | Specifics |
Enlarge on click
useImageModal | toggle (boolean) | Makes the image clickable: on click it opens enlarged in a viewer above the page. | HTML attribute, default: no |
Display copyright
vb_DisplayCopyright | toggle (boolean) | — | default: yes |
Display a download link
vb_DisplayDownloadLink | toggle (boolean) | — | default: no |
Display caption
vb_DisplayLegend | toggle (boolean) | — | default: no |
Display title
vb_DisplayTitle | toggle (boolean) | — | default: no |
Show the preview of the file
vb_Preview | toggle (boolean) | — | default: no |
Use delayed loading
vb_UseLazyLoading | toggle (boolean) | — | default: no |
Display order
vt_DisplayOrder | displayOrder (text) | Vertical stacking order of the block elements. Use the arrows to move an element up or down. Only the elements enabled above are listed. The caption always stays attached under the image. | default: link,copyright,image,legend,title |
File information
| Setting | How it is set | What it does | Specifics |
Alt text
vt_Alt | text (text) | — | |
Copyright
vt_Copyright | text (text) | — | |
Legend
vt_Legend | text (text) | — | |
Title
vt_Title | text (text) | — | |
Download link
| Setting | How it is set | What it does | Specifics |
Display a button
vb_DisplayButton | toggle (boolean) | — | default: no |
Open in new tab
vb_LinkInNewTab | toggle (boolean) | — | default: no |
Icon
vt_Icon | iconSelector (text) | — | |
Link label
vt_LinkLabel | text (text) | — | |
Field type
vt_TypeButton | select (text) | — | |
The tables on this page are produced automatically from the block's schema. If this page and the panel disagree, the schema is right.
