TextButton

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Sebuah TextButton berperilaku serupa dengan TextLabel dalam hal rendering, dengan perilaku tambahan dari sebuah GuiButton.

Anda dapat menonaktifkan rendering teks dengan mengatur TextTransparency ke 1. Ini akan menghasilkan bilangan persegi sederhana yang dapat digunakan sebagai tombol.

Rangkuman

Properti

Properti diwarisi dari GuiButtonProperti diwarisi dari GuiObjectProperti diwarisi dari GuiBase2d
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Metode

Metode diwarisi dari GuiObject
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Acara

Acara diwarisi dari GuiButtonAcara diwarisi dari GuiObjectAcara diwarisi dari GuiBase2d
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Properti

ContentText

string
Hanya Baca
Tidak Direplikasi
Baca Paralel

Properti ini menyediakan salinan Text yang berisi persis apa yang ditampilkan oleh TextButton .Ini berguna untuk menghilangkan tag gaya yang digunakan untuk markup teks kaya; misalnya, ketika RichText diaktifkan, properti ContentText menunjukkan teks seperti yang muncul kepada pengguna.

<th>Teks</th>



    <th>Teks Konten</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>salah</code></td>



    <td><b>Halo, dunia!</b></td>



    <td><b>Halo, dunia!</b></td>

  </tr>



  <tr>

    <td><code>benar</code></td>



    <td><b>Halo, dunia!</b></td>



    <td>Halo, dunia!</td>

  </tr>

</tbody>
Teks Kaya

Font

Enum.Font
Tersembunyi
Tidak Direplikasi
Baca Paralel

Properti ini memilih salah satu dari beberapa font yang sudah didefinisikan sebelumnya dengan mana TextButton akan menampilkan teksnya.Beberapa font memiliki bold, italik, dan/atau varian ringan.

Dengan pengecualian font Enum.Font.Legacy, setiap font akan menampilkan teks dengan ketinggian baris sama dengan properti TextSize.

Font Enum.Font.Code adalah satu-satunya font monospace.Ini memiliki properti unik bahwa setiap karakter memiliki rasio lebar dan tinggi yang sama persis dari 1:2, di mana lebar setiap karakter sekitar setengah dari properti TextSize.

Properti ini disinkronkan dengan properti FontFace .

Contoh Kode

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

Enum.Font
Baca Paralel

Properti ini mirip dengan properti Font tetapi memungkinkan pengaturan font yang tidak ada di Enum.Font .

Properti ini disinkronkan dengan properti Font , sehingga saat mengatur FontFace , font diatur ke nilai yang sesuai Enum.Font atau ke Enum.Font.Unknown jika tidak ada pertandingan.

LineHeight

number
Baca Paralel

Mengontrol ketinggian baris sebagai pengganda ukuran kotak huruf dengan menyesuaikan jarak antara baris teks di .Nilai yang valid berkisar dari 1.0 ke 3.0 , default ke 1.0 .

LocalizedText

string
Tersembunyi
Hanya Baca
Tidak Direplikasi
Baca Paralel

Properti ini menetapkan apakah TextButton harus menganggap GuiBase2d.Localize atau tidak.

MaxVisibleGraphemes

number
Baca Paralel

Properti ini mengontrol jumlah maksimum grafem (atau unit teks) yang ditampilkan pada TextButton.Ini terutama disediakan sebagai cara mudah untuk membuat efek mesin ketik di mana karakter muncul satu per satu.

Mengubah properti tidak mengubah posisi atau ukuran huruf yang terlihat; tata letak akan dihitung seolah-olah semua huruf terlihat.

Mengatur properti ke -1 menonaktifkan batas dan menunjukkan seluruhnya dari Text .

OpenTypeFeatures

string
Baca Paralel

OpenTypeFeaturesError

string
Hanya Baca
Tidak Direplikasi
Baca Paralel

RichText

boolean
Baca Paralel

Properti ini menentukan apakah TextButton menampilkan teks menggunakan markup teks kaya untuk bagian gaya string dalam huruf tebal, italik, warna spesifik, dan banyak lagi.

Untuk menggunakan teks kaya, cukup masukkan tag formatasi teks kaya dalam string Text.

Text

string
Baca Paralel

Properti ini menentukan konten teks yang ditampilkan oleh TextButton .Properti visual string yang ditampilkan di layar ditentukan oleh TextColor3 , TextTransparency , TextSize , Font , TextScaled , TextWrapped , TextXAlignment dan TextYAlignment.

Dimungkinkan untuk menampilkan emoji seperti 🔒 dan simbol lain yang tidak terpengaruh oleh properti TextColor3.Ini dapat disisipkan ke dalam Script dan LocalScript objek, serta bidang di dalam jendela Properti.

Properti ini dapat berisi karakter baris baru. Demikian pula, properti ini dapat berisi karakter tab, tetapi akan ditampilkan sebagai ruang alih-alih.

Contoh Kode

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

Vector2
Hanya Baca
Tidak Direplikasi
Baca Paralel

Properti baca hanya ini mencerminkan ukuran absolut teks yang disajikan dalam offset, artinya jika Anda mencoba untuk memasukkan teks ke dalam kotak, properti ini akan mencerminkan dimensi minimum kotak yang Anda butuhkan untuk memasukkan teks.

Menggunakan TextService:GetTextSize() , Anda dapat memprediksi apa yang TextBounds akan diberikan string, Font , TextSize , dan ukuran frame.

TextColor3

Color3
Baca Paralel

Properti ini menentukan warna semua teks yang ditampilkan oleh elemen TextButton.

Contoh Kode

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

Enum.TextDirection
Baca Paralel

Enum.TextDirection di mana teks ditampilkan.

TextFits

boolean
Hanya Baca
Tidak Direplikasi
Baca Paralel

Representasi boolean apakah teks tombol sesuai dengan ukurannya.

TextScaled

boolean
Baca Paralel

Properti ini menentukan apakah teks diukur sehingga mengisi seluruh ruang tombol.Saat diaktifkan, TextSize diabaikan dan TextWrapped diaktifkan secara otomatis.Properti ini berguna untuk menampilkan elemen teks dalam BillboardGuis .Ketika properti ini digunakan untuk UI di layar , mungkin berguna untuk menggunakan UITextSizeConstraint untuk membatasi rentang ukuran teks yang mungkin.

Ukuran Otomatis

Disarankan agar Anda menghindari penggunaan TextScaled dan menyesuaikan UI untuk memanfaatkan properti AutomaticSize sebagai gantinya.Berikut adalah perbedaan inti antara dua properti:

  • TextScaled skala konten (teks) untuk menampung UI. Tanpa pertimbangan hati-hati, beberapa teks mungkin menjadi tidak dapat dibaca jika diperkecil terlalu kecil.

  • AutomaticSize menyesuaikan UI untuk menampung konten sambil menjaga ukuran font yang konsisten. Untuk informasi lebih lanjut, lihat di sini .

Selain itu, disarankan agar Anda menghindari menerapkan kedua AutomaticSize dan TextScaled dan ke TextButton yang sama. AutomaticSize menentukan jumlah maksimum ruang yang tersedia yang dapat digunakan oleh GuiObject (dalam kasus ini, teks), sementara TextScaled menggunakan ruang yang tersedia yang ditentukan oleh AutomaticSize untuk menyesuaikan ukuran font hingga ukuran font maksimum (100) jika tidak ada batasan ukuran.

TextSize

number
Baca Paralel

Properti ini menentukan ketinggian satu baris teks yang diterjemahkan.Unit berada dalam offset, bukan titik (yang digunakan dalam sebagian besar program pengeditan dokumen).Font Enum.Font.Legacy tidak memiliki properti ini.

TextStrokeColor3

Color3
Baca Paralel

Properti ini mengatur warna stroke, atau garis, dari teks yang diterjemahkan.Bersama dengan TextStrokeTransparency, ia menentukan penampilan visual akhir dari garis teks.

Sebagai alternatif kuat yang mendukung gradien warna, lihat UIStroke .

TextStrokeTransparency

number
Baca Paralel

Properti ini mengatur transparansi stroke, atau garis besar, teks yang diterjemahkan.Bersama dengan TextStrokeColor3, ia menentukan penampilan visual akhir dari garis teks.

Perhatikan bahwa garis teks adalah beberapa representasi transparansi yang sama, jadi properti ini pada dasarnya adalah multiplikasi empat kali lipat pada dirinya sendiri.Oleh karena itu, disarankan untuk mengatur TextStrokeTransparency ke nilai dalam rentang 0.75 hingga 1 untuk efek yang lebih halus.

Sebagai alternatif kuat yang mendukung gradien warna, lihat UIStroke .

TextTransparency

number
Baca Paralel

Properti ini menentukan transparansi semua teks yang ditampilkan oleh TextButton .

TextTruncate

Enum.TextTruncate
Baca Paralel

Mengontrol pemotongan teks yang ditampilkan di TextButton .

TextWrapped

boolean
Baca Paralel

Saat diaktifkan, properti ini akan menampilkan teks di beberapa baris dalam ruang elemen TextButton sehingga TextBounds tidak akan pernah melebihi GuiBase2d.AbsoluteSize elemen.Ini dicapai dengan memecahkan baris teks panjang menjadi beberapa baris.

Pemutusan baris akan lebih memilih spasi kosong; jika kata panjang yang tidak diputus melebihi lebar elemen, kata itu akan dipatahkan menjadi beberapa baris.

Jika lini berikutnya rusak akan menyebabkan ketinggian vertikal teks (komponen Y dari 》) melebihi ketinggian vertikal elemen (komponen Y dari 》), maka baris itu tidak akan ditampilkan sama semua.

TextXAlignment

Enum.TextXAlignment
Baca Paralel

Properti ini menentukan alineasi horizontal teks yang ditampilkan dalam ruang objek.Ini digunakan bersama dengan TextYAlignment untuk sepenuhnya menentukan alineasi teks di kedua sumbu.

Perhatikan bahwa properti ini tidak akan memengaruhi properti hanya dibaca TextBounds dan TextFits .

TextYAlignment

Enum.TextYAlignment
Baca Paralel

Properti ini menentukan alineasi vertikal teks yang ditampilkan dalam ruang objek.Ini digunakan bersama dengan TextXAlignment untuk sepenuhnya menentukan alineasi teks di kedua sumbu.

Perhatikan bahwa properti ini tidak akan memengaruhi properti hanya dibaca TextBounds dan TextFits .

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Metode

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Acara

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object