Skip to content
Latestv1.0.63

Space ​

Set the spacing between components.

Basic Usage ​

Set the spacing between components. Default direction is horizontal, spacing size is small (8px).

Basic Usage

Vertical Layout ​

Set direction to vertical for vertical layout.

Vertical Layout

Different Sizes ​

Set spacing size via size prop. Supported values are mini (4px), small (8px), medium (16px), large (24px), a custom number (px), or an array [horizontal, vertical].

Different Sizes

Alignment ​

Set cross-axis alignment via align prop.

Alignment

Justify ​

Set main-axis alignment via justify prop. Works best with fill prop enabled.

Justify

Wrap ​

Set whether to wrap automatically via wrap prop.

Wrap

Fill Container ​

Use the fill prop to make the space component fill the parent container width.

Fill Container

Spacer ​

Pass separator text via spacer prop, or customize via #spacer slot.

Spacer

Use in Nuxt ​

The Space component fully supports Nuxt 3/4 SSR rendering. The spacing layout is calculated on the server, ensuring the correct spacing effect is presented on the first screen without waiting for client-side activation.

Use in Nuxt

SSR Notes:

  • ✅ Spacing direction (direction), size (size), and alignment (align) take effect on initial render
  • ✅ Auto wrap (wrap) and fill supported in SSR
  • ✅ Spacer content renders correctly on the server
  • 💡 Dynamic spacing changes will be automatically completed through the reactive system after client-side activation

Nuxt Auto Import

After installing the @yh-ui/nuxt module, the YhSpace component is auto-registered, no manual import needed.

API ​

Props ​

PropDescriptionTypeDefault
directionSpacing direction'horizontal' | 'vertical''horizontal'
sizeSpacing size'mini' | 'small' | 'medium' | 'large' | number | [SpaceSize, SpaceSize]'small'
alignCross-axis alignment'start' | 'end' | 'center' | 'baseline' | 'stretch''center'
justifyMain-axis alignment'start' | 'end' | 'center' | 'space-around' | 'space-between' | 'space-evenly''start'
wrapWhether to wrap (horizontal only)booleanfalse
fillWhether to fill parent containerbooleanfalse
spacerSpacer textstring | number—
theme-overridesTheme override variablesComponentThemeVars—

Slots ​

Slot NameDescription
defaultChild elements in the space
spacerCustom spacer content

Events ​

This component does not expose component events.

Expose ​

This component does not expose public instance methods or properties.

Theme Variables ​

VariableDescriptionDefault
--yh-space-spacer-paddingSpacer padding2px

Type Exports ​

NameDescription
YhSpacePropsComponent props type
YhSpaceSlotsComponent slots type
YhSpaceSizeSpacing size union
YhSpaceDirectionDirection union
YhSpaceAlignCross-axis alignment union
YhSpaceJustifyMain-axis alignment union
YhSpaceInstanceComponent instance type

Released under the MIT License.