Skip to content

Общие атрибуты SFC-компонентов

Эти атрибуты доступны visual primitives. Structural tags могут поддерживать только явно описанную часть контракта.

События

Все visual primitives поддерживают простые @event reactions и условную аннотацию :on. Комбинации клавиш, modifiers, последовательные Actions и ограничения структурных тегов описаны в разделе «Сложные события через :on».

Flow и data binding

АтрибутТипНазначение
ifexpressionРендерит узел при истинном условии.
else-ifexpressionПродолжает соседнюю conditional chain.
elsebooleanПоследняя ветвь conditional chain.
forexpressionПовторяет элемент, например for="item in items".
:keyexpressionСтабильный ключ элемента внутри for.
:attrexpressionПередаёт вычисленное значение атрибута.
expressionВыводит вычисленное текстовое значение.

Identity и metadata

АтрибутТипНазначение
idstringЛокальный id template-узла.
classstringСемантический class для EndgeCSS и adapter-а.
tooltip / :tooltipstring / expressionLazy text tooltip; подробности на странице Tooltip.
visible / :visibleboolean / expressionМягкая видимость; для удаления узла используйте if.

Размеры и spacing

АтрибутыТипНазначение
width / w, height / hnumber/stringРазмер элемента.
minWidth / minW, maxWidth / maxWnumber/stringОграничения ширины.
minHeight / minH, maxHeight / maxHnumber/stringОграничения высоты.
p, px, py, pt, pr, pb, plnumber/stringPadding.
m, mx, my, mt, mr, mb, mlnumber/stringMargin.

Numeric spacing в стандартных DOM adapters использует шаг 4px. Явные CSS-like строки (10px, 1rem, min(100%, 40rem)) передаются как renderer value.

Цвет, border и typography

АтрибутыТипНазначение
color, bg, borderColortoken/stringЦвет текста, фона и рамки.
tonetokenneutral, muted, info, success, warning, danger.
borderWidthnumber/stringТолщина рамки.
radius / rnumber/stringСкругление.
size, lineHeightnumber/stringРазмер и высота строки.
weightnumber/stringТолщина текста.
align, valignstringГоризонтальное и вертикальное выравнивание.
truncate, wrapboolean/stringОбрезка и перенос текста.

Placement внутри Grid

Placement attributes читаются только в контексте прямого родителя Grid.

АтрибутТипНазначение
colStartpositive integerНачальная колонка.
colSpanpositive integerКоличество колонок.
rowStartpositive integerНачальная строка.
rowSpanpositive integerКоличество строк.
vue
<Grid columns="12">
  <Box colStart="2" colSpan="5" rowStart="1" rowSpan="2" />
</Grid>