HStack
가로로 쌓이는 레이아웃을 구성합니다. 디자인 토큰을 JSX에서 사용할 수 있도록 도와줍니다.
Usage
Props
Prop
Type
margin?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Margin on all four sides.
Cannot be combined with any bleed* prop.
m?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for margin.
Cannot be combined with any bleed* prop.
marginX?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Horizontal margin (left + right).
Cannot be combined with any bleed* prop.
mx?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for marginX.
Cannot be combined with any bleed* prop.
marginY?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Vertical margin (top + bottom).
Cannot be combined with any bleed* prop.
my?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for marginY.
Cannot be combined with any bleed* prop.
marginTop?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Top margin.
Cannot be combined with any bleed* prop.
mt?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for marginTop.
Cannot be combined with any bleed* prop.
marginRight?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Right margin.
Cannot be combined with any bleed* prop.
mr?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for marginRight.
Cannot be combined with any bleed* prop.
marginBottom?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Bottom margin.
Cannot be combined with any bleed* prop.
mb?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for marginBottom.
Cannot be combined with any bleed* prop.
marginLeft?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Left margin.
Cannot be combined with any bleed* prop.
ml?ResponsiveValue<"auto" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for marginLeft.
Cannot be combined with any bleed* prop.
bleed?ResponsiveValue<"asPadding" | "safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Negative margin on all four sides to extend the element outside its parent. If set to "asPadding", it will use the padding value in the same direction. If set to "safeArea", it will use the safe area inset in the same direction.
Cannot be combined with any margin* prop.
bleedX?ResponsiveValue<"asPadding" | "safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Negative x-axis margin to extend the element outside its parent. If set to "asPadding", it will use the padding value in the same direction. If set to "safeArea", it will use the safe area inset in the same direction.
Cannot be combined with any margin* prop.
bleedY?ResponsiveValue<"asPadding" | "safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Negative y-axis margin to extend the element outside its parent. If set to "asPadding", it will use the padding value in the same direction. If set to "safeArea", it will use the safe area inset in the same direction.
Cannot be combined with any margin* prop.
bleedTop?ResponsiveValue<"asPadding" | "safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Negative top margin to extend the element outside its parent. If set to "asPadding", it will use the padding value in the same direction. If set to "safeArea", it will use the safe area inset in the same direction.
Cannot be combined with any margin* prop.
bleedRight?ResponsiveValue<"asPadding" | "safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Negative right margin to extend the element outside its parent. If set to "asPadding", it will use the padding value in the same direction. If set to "safeArea", it will use the safe area inset in the same direction.
Cannot be combined with any margin* prop.
bleedBottom?ResponsiveValue<"asPadding" | "safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Negative bottom margin to extend the element outside its parent. If set to "asPadding", it will use the padding value in the same direction. If set to "safeArea", it will use the safe area inset in the same direction.
Cannot be combined with any margin* prop.
bleedLeft?ResponsiveValue<"asPadding" | "safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Negative left margin to extend the element outside its parent. If set to "asPadding", it will use the padding value in the same direction. If set to "safeArea", it will use the safe area inset in the same direction.
Cannot be combined with any margin* prop.
bg?ScopedColorBanner | ScopedColorBg | ScopedColorPalette | (string & {}) | undefined
Shorthand for background.
background?ScopedColorBanner | ScopedColorBg | ScopedColorPalette | (string & {}) | undefinedbgGradient?"fadeMask" | "glowMagic" | "glowMagicPressed" | "highlightMagic" | "highlightMagicPressed" | "shimmerMagic" | "shimmerNeutral" | undefined
Shorthand for backgroundGradient.
backgroundGradient?"fadeMask" | "glowMagic" | "glowMagicPressed" | "highlightMagic" | "highlightMagicPressed" | "shimmerMagic" | "shimmerNeutral" | undefinedbgGradientDirection?"to bottom" | "to bottom left" | "to bottom right" | "to left" | "to right" | "to top" | "to top left" | "to top right" | (string & {}) | undefined
Shorthand for backgroundGradientDirection.
e.g. 43deg
backgroundGradientDirection?"to bottom" | "to bottom left" | "to bottom right" | "to left" | "to right" | "to top" | "to top left" | "to top right" | (string & {}) | undefined
e.g. 43deg
color?ScopedColorFg | ScopedColorPalette | (string & {}) | undefinedborderColor?ScopedColorPalette | ScopedColorStroke | (string & {}) | undefinedborderWidth?0 | 1 | (string & {}) | undefinedborderTopWidth?0 | 1 | (string & {}) | undefinedborderRightWidth?0 | 1 | (string & {}) | undefinedborderBottomWidth?0 | 1 | (string & {}) | undefinedborderLeftWidth?0 | 1 | (string & {}) | undefinedborderRadius?"full" | "r0_5" | "r1" | "r1_5" | "r2" | "r2_5" | "r3" | "r3_5" | "r4" | "r5" | "r6" | 0 | (string & {}) | undefinedborderTopLeftRadius?"full" | "r0_5" | "r1" | "r1_5" | "r2" | "r2_5" | "r3" | "r3_5" | "r4" | "r5" | "r6" | 0 | (string & {}) | undefinedborderTopRightRadius?"full" | "r0_5" | "r1" | "r1_5" | "r2" | "r2_5" | "r3" | "r3_5" | "r4" | "r5" | "r6" | 0 | (string & {}) | undefinedborderBottomRightRadius?"full" | "r0_5" | "r1" | "r1_5" | "r2" | "r2_5" | "r3" | "r3_5" | "r4" | "r5" | "r6" | 0 | (string & {}) | undefinedborderBottomLeftRadius?"full" | "r0_5" | "r1" | "r1_5" | "r2" | "r2_5" | "r3" | "r3_5" | "r4" | "r5" | "r6" | 0 | (string & {}) | undefinedboxShadow?"s1" | "s2" | "s3" | (string & {}) | undefinedwidth?ResponsiveValue<"full" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | Dimension | (string & {})> | undefinedminWidth?ResponsiveValue<"full" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | Dimension | (string & {})> | undefinedmaxWidth?ResponsiveValue<"full" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | Dimension | (string & {})> | undefinedheight?ResponsiveValue<"full" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | Dimension | (string & {})> | undefinedminHeight?ResponsiveValue<"full" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | Dimension | (string & {})> | undefinedmaxHeight?ResponsiveValue<"full" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | Dimension | (string & {})> | undefinedtop?0 | (string & {}) | undefinedleft?0 | (string & {}) | undefinedright?0 | (string & {}) | undefinedbottom?0 | (string & {}) | undefinedpadding?ResponsiveValue<"spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefinedp?ResponsiveValue<"spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for padding.
paddingX?ResponsiveValue<"spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefinedpx?ResponsiveValue<"spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for paddingX.
paddingY?ResponsiveValue<"spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefinedpy?ResponsiveValue<"spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for paddingY.
paddingTop?ResponsiveValue<"safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefinedpt?ResponsiveValue<"safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for paddingTop.
paddingRight?ResponsiveValue<"safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefinedpr?ResponsiveValue<"safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for paddingRight.
paddingBottom?ResponsiveValue<"safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefinedpb?ResponsiveValue<"safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for paddingBottom.
paddingLeft?ResponsiveValue<"safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefinedpl?ResponsiveValue<"safeArea" | "spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefined
Shorthand for paddingLeft.
position?"absolute" | "fixed" | "relative" | "sticky" | undefinedoverflowX?"auto" | "hidden" | "scroll" | "visible" | undefinedoverflowY?"auto" | "hidden" | "scroll" | "visible" | undefinedzIndex?number | (string & {}) | undefinedflexGrow?0 | 1 | true | (number & {}) | undefined
If true, flex-grow will be set to 1.
flexShrink?0 | true | (number & {}) | undefined
If true, flex-shrink will be set to 1.
flexWrap?"nowrap" | "wrap" | "wrap-reverse" | true | undefined
If true, flex-wrap will be set to wrap.
justifyContent?"center" | "flex-end" | "flex-start" | "space-around" | "space-between" | undefinedjustifySelf?"center" | "end" | "start" | "stretch" | undefined
In flexbox layout, this property is ignored.
alignItems?"center" | "flex-end" | "flex-start" | "stretch" | undefinedalignContent?"center" | "flex-end" | "flex-start" | "stretch" | undefinedalignSelf?"center" | "flex-end" | "flex-start" | "stretch" | undefinedgap?ResponsiveValue<"spacingX.betweenChips" | "spacingX.globalGutter" | "spacingY.betweenText" | "spacingY.componentDefault" | "spacingY.navToTitle" | "spacingY.screenBottom" | 0 | Dimension | (string & {})> | undefinedgridColumn?string | undefinedgridRow?string | undefinedunstable_transform?string | undefined_active?{ bg?: ScopedColorBg | ScopedColorPalette | (string & {}); background?: ScopedColorBg | ScopedColorPalette | (string & {}); } | undefinedas?React.ElementType<any, keyof React.JSX.IntrinsicElements> | undefinedasChild?boolean | undefinedhideFrom?BreakpointThreshold | undefineddisplay?ResponsiveValue<"flex" | "none"> | undefined
Default
"flex"
direction?ResponsiveValue<"column" | "column-reverse" | "row" | "row-reverse"> | undefined
Shorthand for flexDirection.
wrap?"nowrap" | "wrap" | "wrap-reverse" | true | undefined
Shorthand for flexWrap.
align?"center" | "flex-end" | "flex-start" | "stretch" | undefined
Shorthand for alignItems.
justify?"center" | "flex-end" | "flex-start" | "space-around" | "space-between" | undefined
Shorthand for justifyContent.
grow?0 | 1 | true | (number & {}) | undefined
Shorthand for flexGrow.
shrink?0 | true | (number & {}) | undefined
Shorthand for flexShrink.
Responsive Design
Responsive Design
HStack의 레이아웃 프로퍼티에 반응형 값을 전달하여 viewport 크기에 따라 스타일을 조정할 수 있습니다.
Last updated on 2026. 4. 3.