حقول إدخال النص

تعتبر TextBox مستطيلًا يسمح للمستخدم بتقديم إدخال نصي أثناء تركيزه. عند برمجة TextBox، يمكنك استخدامه كحقل بحث أو حقل إدخال في نموذج. لمساعدة المستخدمين على معرفة نوع النص الذي يجب عليهم إدخاله، يمكنك أيضًا تقديم تلميح من خلال خاصية PlaceholderText.

نظرًا لأن هذه الكائنات هي GuiObjects، يمكنك تخصيص خصائص مثل BackgroundColor3, BorderMode, Transparency، و Rotation لتناسب جمالية لعبتك.

إنشاء إدخالات نصية على الشاشة

تعتبر TextBox على الشاشة مفيدة لـ أشياء مثل حقل إدخال لنموذج.

لإضافة TextBox إلى الشاشة:

1. في نافذة Explorer، حدد StarterGui وأضف ScreenGui.

   1. مرر فوق StarterGui وانقر على زر ⊕ . تظهر قائمة سياقية.

   2. أدخل ScreenGui.

2. حدد ScreenGui الجديدة وأضف TextBox.

   1. مرر فوق ScreenGui وانقر على زر ⊕ . تظهر قائمة سياقية.

   2. أدخل TextBox.

إنشاء إدخالات نصية على وجوه الأجزاء

لإضافة TextBox إلى وجه جزء:

1. في نافذة Explorer، حدد StarterGui وأضف SurfaceGui.

   1. مرر فوق StarterGui وانقر على زر ⊕ . تظهر قائمة سياقية.

   2. أدخل ScreenGui.

2. حدد SurfaceGui الجديدة وأضف TextBox.

   1. مرر فوق SurfaceGui وانقر على زر ⊕ . تظهر قائمة سياقية.

   2. أدخل TextBox.

3. زين SurfaceGui إلى الجزء الذي تريد عرض TextBox عليه.

   1. في نافذة Properties، حدد خاصية Adornee. يتغير المؤشر الخاص بك.

   2. في نافذة Explorer، حدد الجزء.

برمجة إدخالات النص

مثل الأزرار، يمكنك برمجة أي إجراء لكائن TextBox عندما يتفاعل المستخدم معه. على سبيل المثال، يربط البرنامج النصي التالي حدث FocusLost الذي يتم تشغيله عندما يضغط المستخدم على زر Enter أو ينقر خارج المربع. إذا كانت enterPressed تساوي true، مما يعني أن المستخدم قدم الإدخال بدلاً من مجرد النقر خارج المربع، يقوم البرنامج النصي بطباعة محتويات الإدخال إلى نافذة Output.

local textBox = script.Parent

local function onFocusLost(enterPressed, inputObject)
	if enterPressed then
		print(textBox.Text)
	end
end

textBox.FocusLost:Connect(onFocusLost)

كمثال آخر، قد ترغب في السماح بالأرقام فقط في TextBox. يستخدم الكود التالي حدث TextBox.GetPropertyChangedSignal لاكتشاف متى يتغير TextBox.Text، مثل عندما يبدأ المستخدم في الكتابة، ثم يستخدم دالة string.gsub() لمنع غير الأرقام.

local textBox = script.Parent

local function allowOnlyNumbers()
	textBox.Text = string.gsub(textBox.Text, "%D", "")
end

textBox:GetPropertyChangedSignal("Text"):Connect(allowOnlyNumbers)

تصفية النص

تم تطبيقه على مصادر ومدخلات متنوعة، يمنع تصفية النصوص المستخدمين من رؤية لغة غير ملائمة ومعلومات شخصية قابلة للتحديد مثل أرقام الهواتف. تقوم Roblox بتصفية المخرجات النصية الشائعة تلقائيًا مثل الرسائل التي مرت عبر دردشة النصوص داخل اللعبة، لكن أنت مسؤول عن تصفية أي نص مُعرض لا تملك تحكمًا صريحًا عليه، بما في ذلك الحروف/السلاسل التي يدخلها المستخدمون من خلال إدخالات النص.