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

تعتبر 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 بتصفية المخرجات النصية الشائعة تلقائيًا مثل الرسائل التي مرت عبر دردشة النصوص داخل اللعبة، لكن أنت مسؤول عن تصفية أي نص مُعرض لا تملك تحكمًا صريحًا عليه، بما في ذلك الأحرف/السلاسل التي يدخلها المستخدمون من خلال إدخالات النص.