@View
Configures how a field is displayed as a column in the list table, including the column title, width, display type, sorting, and more.
Attributes
| Attribute | Description |
|---|---|
title | Column header title |
desc | Column description |
type | Data display type, defaults to AUTO, see the type table below |
show | Whether to display the column, defaults to true |
sortable | Whether clicking the column header sorts the table, defaults to false |
export | Whether to include in Excel exports, defaults to true |
width | Column width with unit, e.g. 200px, 20% |
column | When the field is an object type, specifies the property name to display (commonly used with @ManyToOne) |
className | CSS class name applied to the column |
tpl | Opens a custom template in a popup; the row variable is available inside the template to access current row data |
ifRender | Dynamically controls whether the column is rendered (ExprBool), see ifRender Dynamic Rendering |
template | Column value formatting template (a JS expression evaluated by eval on the frontend); available variables: value (current cell value), item (full row data), item.xxx (specific column value) |
Display Types (ViewType)
Text & Number10
✨
AUTOAutomatically inferred from the @Edit type or field typeAa
TEXTPlain text🛡️
SAFE_TEXT1.12.11+Text containing scripts or tags is not rendered, preventing XSS42
NUMBERNumeric display✓
BOOLEANBoolean value display■
COLORRenders a hex color value as a color swatch; inferred automatically when the edit type is COLOR••••
PASSWORD2.0.4+Password mask; the actual value is replaced with a placeholder and never sent to the client📅
DATEDate formatted display🕐
DATE_TIMEDate-time formatted displayPROGRESS2.0.4+Progress bar; when the edit type is SLIDER the max value comes from SliderType.max, otherwise 100Image & Media5
🖼️
IMAGEImage🖼️
IMAGE_BASE64Base64-encoded image▦
QR_CODEQR code📍
MAPMap display⚡
SWFFlash animationLink & Attachment5
🔗
LINKOpens a link in a new window🔗
LINK_DIALOGOpens a link in a dialog⬇️
DOWNLOADDirect download📎
ATTACHMENTOpens an attachment in a new window📎
ATTACHMENT_DIALOGOpens an attachment in a dialogRich Content5
</>
HTMLRenders an HTML fragment📱
MOBILE_HTMLRenders HTML at mobile screen dimensions{ }
CODESyntax-highlighted code displayM↓
MARKDOWNRendered Markdown display▤
TAB_VIEWOne-to-many / many-to-many sub-table displayContributors
YuePeng
Claude Opus 5 (1M context)