Text

Hiển thị cách đọc, đơn vị hoặc văn bản mô tả. Có thể đặt phông chữ, cỡ chữ, căn chỉnh, ngắt dòng và cắt bớt; nội dung được chuyển đổi thống nhất thành một chuỗi và các giá trị trống được hiển thị dưới dạng trống.

Ví dụ

function main() {
  return (
    <Text fontSize={32} font="rounded" lineLimit={2} truncationMode="tail">
      Hello, CapDrive
    </Text>
  );
}

Cách sử dụng

Nội dung dùng toString(); null/undefined để trống. Ghép biểu tượng với HStack, không lồng View trong Text. Giới hạn width trước lineLimit/truncationMode. minimumScaleFactor=1 không thu nhỏ.
Kích thước số dùng điểm. auto đo nội dung; fill dùng phần cha cấp. Đặt kích thước khung trước; fill và chữ dài không mở rộng khung cha cố định.

Thuộc tính

children?TextContent | TextContent[]

Nội dung vẽ con.

fontSize?number

Cỡ chữ tính bằng point.

Ví dụ14

Độ đậm chữ từ ultraLight đến black; regular là thường.

Ví dụ"regular"

font?"default" | "rounded" | "monospaced" | "serif"

Kiểu phông: default, rounded, monospaced hoặc serif.

Ví dụ"default"

color?Paint

Màu vẽ, bao gồm màu HDR.

Ví dụHDR($env.foreground)

alignment?"leading" | "center" | "trailing"

Căn chữ trong chiều rộng có sẵn: leading, center hoặc trailing.

Ví dụ"leading"

lineLimit?number | null

Số dòng tối đa; null hoặc bỏ qua cho phép xuống dòng không giới hạn số dòng.

Ví dụ1

truncationMode?"head" | "middle" | "tail"

Vị trí lược bỏ chữ khi không vừa: head, middle hoặc tail.

Ví dụ"tail"

minimumScaleFactor?number

Tỷ lệ chữ nhỏ nhất khi thiếu chỗ: 0.01–1; 1 không thu nhỏ.

Ví dụ0.5

monospacedDigits?boolean

Chữ số rộng bằng nhau để tránh nhảy ngang khi giá trị đổi.

Ví dụtrue

letterSpacing?number

Khoảng cách ký tự tăng thêm theo điểm.

Ví dụ0

contentAnimation?ContentAnimation

Chuyển tiếp khi nội dung đổi. Chọn type được hỗ trợ; duration/delay theo giây.

Ví dụ{type: "numericText"}

Thuộc tính chung

width?number | "auto" | "fill"

Chiều rộng tính bằng point, tự động hoặc lấp đầy khung cha.

Ví dụ100

height?number | "auto" | "fill"

Chiều cao tính bằng point, tự động hoặc lấp đầy khung cha.

Ví dụ80

padding?number

Khoảng đệm nội dung tính bằng point.

Ví dụ0

x?number

Dịch chuyển hiển thị theo điểm: x sang phải, y xuống dưới; không đổi chỗ trong bố cục.

Ví dụ0

y?number

Dịch chuyển hiển thị theo điểm: x sang phải, y xuống dưới; không đổi chỗ trong bố cục.

Ví dụ0

transform?ViewTransform

Biến đổi toàn View không đổi bố cục. Dịch chuyển theo điểm, xoay/nghiêng theo độ, tỷ lệ 1 giữ nguyên, điểm neo 0–1.

Ví dụ{rotation: 0}

background?Paint

Màu hoặc chuyển màu nền; clear là trong suốt.

Ví dụ"clear"

opacity?number

Độ đục toàn bộ View: 0 trong suốt, 1 đục hoàn toàn.

Ví dụ1

cornerRadius?number

Bán kính bo góc theo điểm.

Ví dụ0

clipped?boolean

Cắt phần vẽ vượt ra ngoài View.

Ví dụfalse

clip?"rectangle" | "ellipse"

Hình cắt rectangle hoặc ellipse; Material còn nhận false để tắt.

Ví dụ"rectangle"

mask?View | null

View mặt nạ alpha. Căn giữa mà không ảnh hưởng bố cục; null tắt mặt nạ.

Ví dụ<Circle width="fill" height="fill" background="white"/>

zIndex?number

Thứ tự vẽ giữa các phần tử cùng cấp; giá trị lớn nằm trước.

Ví dụ0

blur?number

Bán kính làm mờ theo điểm; 0 là tắt.

Ví dụ4

innerShadow?DrawingEffect

Màu, độ đục, bán kính mờ và độ lệch x/y của hiệu ứng; khoảng cách theo điểm.

Ví dụ{color: HDR("black"), opacity: 0.5, radius: 4, x: 0, y: 2}

glow?DrawingEffect

Màu, độ đục, bán kính mờ và độ lệch x/y của hiệu ứng; khoảng cách theo điểm.

Ví dụ{color: HDR("cyan"), radius: 8, opacity: 0.8}

shadowColor?Color

Màu bóng đổ bên ngoài.

Ví dụHDR("black")

shadowOpacity?number

Độ đục bóng 0–1; 0 ẩn bóng.

Ví dụ0

shadowRadius?number

Bán kính làm mờ bóng ngoài theo điểm.

Ví dụ4

shadowX?number

Độ lệch bóng theo điểm: x sang phải, y xuống.

Ví dụ0

shadowY?number

Độ lệch bóng theo điểm: x sang phải, y xuống.

Ví dụ2

animations?Animation[]

Hoạt ảnh khi thuộc tính đổi. duration/delay theo giây; from/to là đầu cuối; repeat/autoreverse điều khiển lặp, wrap là chu kỳ.

Ví dụ[{property: "opacity", duration: 0.25, curve: "easeInOut"}]

key?string | number

Định danh ổn định giữa các phần tử cùng cấp.

Ví dụ kết hợp

function main() {
  return (
    <VStack width={180} spacing={12}>
      <Text width="fill" fontSize={20} lineLimit={2} truncationMode="tail">
        CapDrive — a longer instrument title
      </Text>
      <HStack alignment="firstTextBaseline" spacing={4}>
        <Text fontSize={48} monospacedDigits={true}>
          78
        </Text>
        <Text fontSize={14}>km/h</Text>
      </HStack>
    </VStack>
  );
}

Hoạt ảnh

widthheightpaddingxyopacitybackgroundcornerRadiusblurshadowColorshadowOpacityshadowRadiusshadowXshadowYfontSizeletterSpacingminimumScaleFactorcolortransform.translateXtransform.translateYtransform.scaleXtransform.scaleYtransform.rotationtransform.skewXtransform.skewYtransform.anchorXtransform.anchorY

Khi bỏ qua

Bảng ghi hành vi bỏ qua đã kiểm tra từ triển khai; ví dụ không phải mặc định. Muốn kết quả cố định hãy truyền giá trị rõ, kích thước và màu theo ngữ cảnh không phải hằng số.

Thuộc tính	Khi bỏ qua
`fontSize`	`14`
`fontWeight`	`"regular"`
`font`	`"default"`
`monospacedDigits`	`true`
`minimumScaleFactor`	`1`
`lineLimit`	`null`
`alignment`	`"center"`
`truncationMode`	`"tail"`
`color`	`HDR($env.foreground)`

Ví dụ

Cách sử dụng

Thuộc tính

Ví dụ kết hợp

Hoạt ảnh

Khi bỏ qua

HStack

Symbol

Color / Gradient

Trên trang này

Text

Ví dụ

Cách sử dụng

Thuộc tính

Ví dụ kết hợp

Hoạt ảnh

Khi bỏ qua

API liên quan

HStack

Symbol

Color / Gradient

Trên trang này