Spacer

在 Stack 中分配剩餘空間,用於把兩側內容推開或為內容預留彈性距離。minLength 設定最小長度,顯式 width 或 height 可固定對應方向的大小。

範例

function main() {
  return (
    <HStack>
      <Text>A</Text>
      <Spacer minLength={16} />
      <Text>B</Text>
    </HStack>
  );
}

使用說明

  • Spacer 不繪製內容,在 HStack 分配橫向、VStack 分配縱向剩餘空間。minLength 是下限,明確 width/height 固定對應軸;不支援背景、透明度或特效。
  • 數字尺寸用點;auto 按內容測量,fill 使用父級分配的空間。先設定容器尺寸,再調整子 View;fill 不會創造額外空間,長文字也不能撐開固定父級。

屬性

minLength?number

父級 Stack 主軸上的最小彈性空間,單位為點。

範例0
通用屬性
width?number | "auto" | "fill"

寬度:點數、自動測量或填滿父區域。

範例"auto"
height?number | "auto" | "fill"

高度:點數、自動測量或填滿父區域。

範例"auto"
animations?SpacerAnimation[]

屬性改變時播放動畫。duration/delay 用秒,from/to 設端點,repeat/autoreverse 控制重複,wrap 設週期。

範例[{property: "minLength", duration: 0.25, curve: "easeInOut"}]
key?string | number

兄弟節點中的穩定識別碼。

範例""

組合範例

function main() {
  return (
    <VStack spacing={16}>
      <HStack width={240}>
        <Text>A</Text>
        <Spacer minLength={20} />
        <Text>B</Text>
      </HStack>
      <HStack width={240}>
        <Text>A</Text>
        <Spacer width={20} />
        <Text>B</Text>
      </HStack>
    </VStack>
  );
}

動畫

動畫

widthheightminLength

省略時的行為

下表是經實作核對的省略行為;屬性範例不是預設值。固定效果應明確傳值,尺寸和主題色等依環境變動,不能視為常數。

屬性省略時的行為
minLength0