TextButton

Hiển Thị Bản Đã Lỗi Thời

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

Một TextButton hành vi tương tự như TextLabel về khía cạnh hiển thị, với thêm hành vi của một GuiButton .

Bạn có thể vô hiệu hóa hiển thị văn bản bằng cách đặt TextTransparency đến 1 . Điều này sẽ dẫn đến một đường vuông trống có thể được sử dụng như một nút.

Tóm Tắt

Thuộc Tính

Thuộc Tính kế thừa từ GuiButtonThuộc Tính kế thừa từ GuiObjectThuộc Tính kế thừa từ GuiBase2d

Phương Pháp

Phương Pháp kế thừa từ GuiObject

Sự Kiện

Sự Kiện kế thừa từ GuiButtonSự Kiện kế thừa từ GuiObjectSự Kiện kế thừa từ GuiBase2d

Thuộc Tính

ContentText

Chỉ Đọc
Không Sao Chép
Đọc Song Song

Tính năng này cung cấp một bản sao của Text chứa chính xác những gì đang được hiển thị bởi TextButton .Điều này hữu ích để loại bỏ các thẻ phong cách được sử dụng cho định dạng văn bản giàu; ví dụ, khi RichText được bật, thuộc tính ContentText hiển thị văn bản như nó xuất hiện với người dùng.


<th>Văn bản</th>
<th>Văn bản nội dung</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>giả mạo</code></td>
<td><b>Xin chào,<br/> thế giới!</b></td>
<td><b>Xin chào,<br/> thế giới!</b></td>
</tr>
<tr>
<td><code>đúng</code></td>
<td><b>Xin chào,<br/> thế giới!</b></td>
<td>Xin chào, thế giới!</td>
</tr>
</tbody>
Văn bản giàu
Ẩn
Không Sao Chép
Đọc Song Song

Tính năng này chọn một trong nhiều phông chữ được định sẵn với đó TextButton sẽ hiển thị văn bản của nó.Một số phông chữ có in đậm, in đậm và/hoặc biến thể nhẹ.

Ngoại trừ phông chữ Enum.Font.Legacy, mỗi phông chữ sẽ hiển thị văn bản với độ cao dòng bằng với thuộc tính TextSize.

Phông chữ Enum.Font.Code là phông chữ duy nhất có một khoảng trống.Nó có chức năng độc đáo mà mỗi nhân vật có tỷ lệ chiều rộng và chiều cao tương tự chính xác là 1:2, nơi chiều rộng của mỗi nhân vật khoảng một nửa tỷ lệ TextSize tài sản.

Thuộc tính này được giữ đồng bộ với thuộc tính FontFace .

Mẫu mã

This code sample renders a list of all the available fonts.

Show All Fonts

local frame = script.Parent
-- Create a TextLabel displaying each font
for _, font in pairs(Enum.Font:GetEnumItems()) do
local textLabel = Instance.new("TextLabel")
textLabel.Name = font.Name
-- Set the text properties
textLabel.Text = font.Name
textLabel.Font = font
-- Some rendering properties
textLabel.TextSize = 24
textLabel.TextXAlignment = Enum.TextXAlignment.Left
-- Size the frame equal to the height of the text
textLabel.Size = UDim2.new(1, 0, 0, textLabel.TextSize)
-- Add to the parent frame
textLabel.Parent = frame
end
-- Layout the frames in a list (if they aren't already)
if not frame:FindFirstChildOfClass("UIListLayout") then
local uiListLayout = Instance.new("UIListLayout")
uiListLayout.Parent = frame
end

FontFace

Đọc Song Song

Tính chất này tương tự với tính chất Font nhưng cho phép cài đặt phông chữ không tồn tại trong Enum.Font .

Thuộc tính này được giữ nhịp với thuộc tính Font , như vậy khi đặt FontFace , phông chữ được đặt vào giá trị tương ứng Enum.Font hoặc Enum.Font.Unknown nếu không có trùng lặp.

LineHeight

Đọc Song Song

Kiểm soát chiều cao của các dòng như một nhân của kích thước vuông của phông chữ bằng cách thay đổi khoảng cách giữa các dòng văn bản trong .Các giá trị hợp lệ dao động từ 1.0 đến 3.0 , mặc định là 1.0 .

LocalizedText

Ẩn
Chỉ Đọc
Không Sao Chép
Đọc Song Song

Thuộc tính này xác định liệu một TextButton có nên coi GuiBase2d.Localize hay không.

MaxVisibleGraphemes

Đọc Song Song

Tính năng này kiểm soát số lượng tối đa của các grapheme (hoặc đơn vị văn bản) được hiển thị trên TextButton .Nó chủ yếu được cung cấp như một cách dễ dàng để tạo ra một hiệu ứng máy đánh chữ nơi các nhân vật xuất hiện một lúc.

Thay đổi thuộc tính không thay đổi vị trí hoặc kích thước của các grapheme có thể nhìn thấy; bố trí sẽ được tính toán như thể tất cả các grapheme đều có thể nhìn thấy.

Đặt thuộc tính thành -1 vô hiệu hóa giới hạn và hiển thị toàn bộ của Text .

OpenTypeFeatures

Đọc Song Song

OpenTypeFeaturesError

Chỉ Đọc
Không Sao Chép
Đọc Song Song

RichText

Đọc Song Song

Thuộc tính này xác định xem liệu TextButton có hiển thị văn bản của nó bằng cách sử dụng rich text định dạng cho các phần phong cách của chuỗi in đậm, in đậm, màu cụ thể và nhiều hơn nữa không.

Để sử dụng văn bản giàu, chỉ cần bao gồm các thẻ định dạng văn bản giàu trong Text chuỗi.

Text

Đọc Song Song

Thuộc tính này xác định nội dung văn bản được hiển thị bởi TextButton .Các thuộc tính hình ảnh của chuỗi được hiển thị trên màn hình được xác định bởi , >, , , và .

Có thể hiển thị các biểu tượng cảm xúc như 🔒 và các biểu tượng khác không bị ảnh hưởng bởi thuộc tính TextColor3.Chúng có thể được dán vào ScriptLocalScript đối tượng, cũng như lĩnh vực bên trong cửa sổ Tính năng.

Tính chất này có thể chứa các ký tự dòng mới. Tương tự, tính chất này có thể chứa một ký tự tab, nhưng nó sẽ hiển thị như một khoảng trống thay vào đó.

Mẫu mã

This code sample creates a fading banner for a TextLabel. It fades text out, chooses a random string (avoiding repetition), and fades back in.

Fading Banner

local TweenService = game:GetService("TweenService")
local textLabel = script.Parent
local content = {
"Welcome to my game!",
"Be sure to have fun!",
"Please give suggestions!",
"Be nice to other players!",
"Don't grief other players!",
"Check out the shop!",
"Tip: Don't die!",
}
local tweenInfo = TweenInfo.new(1, Enum.EasingStyle.Sine, Enum.EasingDirection.InOut)
local RNG = Random.new()
local fadeIn = TweenService:Create(textLabel, tweenInfo, {
TextTransparency = 0,
})
local fadeOut = TweenService:Create(textLabel, tweenInfo, {
TextTransparency = 1,
})
local lastIndex
while true do
-- Step 0: Fade out before doing anything
fadeOut:Play()
task.wait(tweenInfo.Time)
-- Step 1: pick content that wasn't the last displayed
local index
repeat
index = RNG:NextInteger(1, #content)
until lastIndex ~= index
-- Make sure we don't show the same thing next time
lastIndex = index
-- Step 2: show the content
textLabel.Text = content[index]
fadeIn:Play()
task.wait(tweenInfo.Time + 1)
end

This code sample demonstrates emoji rendering using the Text property.

Emoji in Text

local textLabel = script.Parent
local moods = {
["happy"] = "😃",
["sad"] = "😢",
["neutral"] = "😐",
["tired"] = "😫",
}
while true do
for mood, face in pairs(moods) do
textLabel.Text = "I am feeling " .. mood .. "! " .. face
task.wait(1)
end
end

TextBounds

Chỉ Đọc
Không Sao Chép
Đọc Song Song

Tính chất đọc chỉ của thuộc tính này phản ánh kích thước tuyệt đối của văn bản được hiển thị trong khấu trừ, có nghĩa là nếu bạn cố gắng để phù hợp văn bản vào một hình chữ nhật, thuộc tính này sẽ phản ánh kích thước tối thiểu của hình chữ nhật bạn cần để phù hợp với văn bản.

Sử dụng TextService:GetTextSize() , bạn có thể dự đoán những gì TextBounds sẽ được cung cấp một chuỗi, Font , TextSize , và kích thước khung.

TextColor3

Đọc Song Song

Tính chất này xác định màu của tất cả văn bản được hiển thị bởi thành phần TextButton .

Mẫu mã

This code sample makes a TextLabel or TextButton count backwards from 10, setting the text color as it does so.

Countdown Text

-- Place this code in a LocalScript within a TextLabel/TextButton
local textLabel = script.Parent
-- Some colors we'll use with TextColor3
local colorNormal = Color3.new(0, 0, 0) -- black
local colorSoon = Color3.new(1, 0.5, 0.5) -- red
local colorDone = Color3.new(0.5, 1, 0.5) -- green
-- Loop infinitely
while true do
-- Count backwards from 10 to 1
for i = 10, 1, -1 do
-- Set the text
textLabel.Text = "Time: " .. i
-- Set the color based on how much time is left
if i > 3 then
textLabel.TextColor3 = colorNormal
else
textLabel.TextColor3 = colorSoon
end
task.wait(1)
end
textLabel.Text = "GO!"
textLabel.TextColor3 = colorDone
task.wait(2)
end

TextDirection

Đọc Song Song

Enum.TextDirection trong đó văn bản được hiển thị.

TextFits

Chỉ Đọc
Không Sao Chép
Đọc Song Song

Một đại diện boolean xem liệu văn bản của nút có phù hợp với kích thước của nó hay không.

TextScaled

Đọc Song Song

Tính chất này xác định xem văn bản có bị phóng to hay không để lấp đầy toàn bộ không gian của nút.Khi bật, TextSize bị bỏ qua và TextWrapped được bật tự động.Tính chất này hữu ích để hiển thị các thành phần văn bản bên trong BillboardGuis .Khi thuộc tính này được sử dụng cho UI trên màn hình, có thể hữu ích khi sử dụng UITextSizeConstraint để giới hạn phạm vi các kích thước văn bản có thể.

Tự động thay đổi kích cỡ

Khuyến nghị bạn tránh sử dụng TextScaled và điều chỉnh giao diện người dùng để tận dụng tính năng AutomaticSize thay thế.Dưới đây là sự khác biệt chính giữa hai thuộc tính:

  • TextScaled tăng quy mô nội dung (văn bản) để phù hợp với giao diện người dùng. Nếu không xem xét cẩn thận, một số văn bản có thể trở nên khó đọc nếu thu nhỏ quá mức.

  • AutomaticSize thay đổi kích thước UI để chứa nội dung trong khi duy trì kích thước phông chữ nhất quán. Để biết thêm thông tin, xem ở đây .

Ngoài ra, được khuyến khích bạn tránh áp dụng cả AutomaticSizeTextScaled và cho cùng TextButton . AutomaticSize xác định số lượng tối đa không gian có sẵn mà GuiObject có thể sử dụng (trong trường hợp này, văn bản), trong khi TextScaled sử dụng không gian có sẵn được xác định bởi AutomaticSize để tăng kích thước phông chữ lên đến kích thước phông chữ tối đa (100) nếu không có giới hạn kích thước.

TextSize

Đọc Song Song

Tính chất này xác định chiều cao của một dòng văn bản được hiển thị.Các đơn vị ở trong khấu trừ, không phải điểm (được sử dụng trong hầu hết các chương trình chỉnh sửa tài liệu).Phông chữ Enum.Font.Legacy không có chức năng này.

TextStrokeColor3

Đọc Song Song

Tính chất này đặt màu của đường viền hoặc khung của văn bản được hiển thị.Cùng với TextStrokeTransparency, nó xác định cái nhìn cuối cùng của đường viền văn bản.

Là một lựa chọn mạnh mẽ hỗ trợ độ mờ màu, xem UIStroke .

TextStrokeTransparency

Đọc Song Song

Tính chất này đặt độ trong suốt của đường nét, hoặc khung của văn bản được hiển thị.Cùng với TextStrokeColor3, nó xác định cái nhìn cuối cùng của đường viền văn bản.

Lưu ý rằng đường viền văn bản là nhiều bản hiển thị của cùng một độ trong suốt, vì vậy tính chất này về cơ bản là nhân với chính nó bốn lần.Do đó, được khuyến khích đặt TextStrokeTransparency đến một giá trị trong phạm vi 0.75 đến 1 để có được hiệu ứng tinh tế hơn.

Là một lựa chọn mạnh mẽ hỗ trợ độ mờ màu, xem UIStroke .

TextTransparency

Đọc Song Song

Tính chất này xác định độ trong suốt của tất cả văn bản được hiển thị bởi TextButton .

TextTruncate

Đọc Song Song

Kiểm soát việc cắt bỏ văn bản được hiển thị trong TextButton .

TextWrapped

Đọc Song Song

Khi bật, thuộc tính này sẽ hiển thị văn bản trên nhiều dòng trong không gian của thành phần TextButton nên TextBounds sẽ không bao giờ vượt quá GuiBase2d.AbsoluteSize của thành phần.Điều này được thực hiện bằng cách phá vỡ các dòng văn bản dài thành nhiều dòng.

Các dòng phá vỡ sẽ ưu tiên không gian trống; nếu một từ dài không bị phá vỡ vượt quá chiều rộng của thành phần, từ đó sẽ bị phá vỡ thành nhiều dòng.

Nếu việc phá vỡ dòng tiếp theo sẽ gây ra chiều cao ngang của văn bản (thành phần Y của TextBounds) vượt quá chiều cao ngang của thành phần (thành phần Y của GuiBase2d.AbsoluteSize) thì dòng đó sẽ không được hiển thị.

TextXAlignment

Đọc Song Song

Tính chất này xác định sự xếp hàng ngang của văn bản được hiển thị trong không gian của đối tượng.Nó được sử dụng cùng với TextYAlignment để xác định hoàn toàn vị trí dịch chuyển văn bản trên cả hai trục.

Lưu ý rằng thuộc tính này sẽ không ảnh hưởng đến các thuộc tính chỉ đọc TextBoundsTextFits .

TextYAlignment

Đọc Song Song

Tính chất này xác định sự căn chỉnh dọc của văn bản được hiển thị trong không gian của đối tượng.Nó được sử dụng cùng với TextXAlignment để xác định hoàn toàn vị trí dịch chuyển văn bản trên cả hai trục.

Lưu ý rằng thuộc tính này sẽ không ảnh hưởng đến các thuộc tính chỉ đọc TextBoundsTextFits .

Phương Pháp

Sự Kiện