ChatInputBarConfiguration
Configures properties of the default text chat input bar. It is parented to TextChatService.
Summary
Properties
Actual screen position of the default chat input bar in pixels.
Actual screen size of the default chat input bar in pixels.
Whether to enable autocomplete for the chat input bar.
Background color of the default chat input bar.
Background transparency of the default chat input bar.
Whether to show the default chat input bar.
Font used to render text in the default chat input bar.
Whether the default chat input bar is focused or not.
Additional key users can press to trigger focusing on the default chat input bar.
Color of the text of the placeholder text in the default chat input bar.
A reference to the target TextChannel.
Reference to a designated TextBox instance that sends messages on behalf of the user.
Color of the text in default chat input bar.
Size of the text in default chat input bar.
Color of the text stroke for text in default chat input bar.
Transparency of the text stroke for text in default chat input bar.
Properties
AbsolutePosition
Read-only property that provides the screen position of the default chat input bar in pixels. Behaves similarly to GuiBase2d.AbsolutePosition.
AbsoluteSize
Read-only property that provides the screen size of the default chat input bar in pixels. Behaves similarly to GuiBase2d.AbsoluteSize.
AutocompleteEnabled
Whether to enable autocomplete for the chat input bar. Set to false to disable autocomplete.
BackgroundColor3
Background color of the default chat input bar. Default value is Color3.new(25, 27, 29).
BackgroundTransparency
Background transparency of the default chat input bar as a number between 0 and 1. This value is multiplied with the user's GuiService.PreferredTransparency to create the effective background transparency used by the chat input bar, which may be more opaque than this value set here. Default value is 0.2.
FontFace
Font used to render text in the default chat input bar. Default is Enum.Font.BuilderSansMedium.
IsFocused
Indicates whether the default chat input bar is focused or not. Useful for firing property changed events so you can implement callback functions that respond to changes in the input bar's focus state.
Code Samples
local Players = game:GetService("Players")
local TextChatService = game:GetService("TextChatService")
local ChatInputBarConfiguration = TextChatService:FindFirstChildOfClass("ChatInputBarConfiguration")
local BubbleChatConfiguration = TextChatService:FindFirstChildOfClass("BubbleChatConfiguration")
local LocalPlayer = Players.LocalPlayer
local Character = LocalPlayer.Character or LocalPlayer.CharacterAdded:Wait()
-- Set up TextLabel
local textLabel = Instance.new("TextLabel")
textLabel.Size = UDim2.fromScale(1, 1)
textLabel.Text = ". . ."
textLabel.BackgroundColor3 = BubbleChatConfiguration.BackgroundColor3
textLabel.BorderColor3 = BubbleChatConfiguration.BackgroundColor3
textLabel.BackgroundTransparency = BubbleChatConfiguration.BackgroundTransparency
textLabel.TextColor3 = BubbleChatConfiguration.TextColor3
textLabel.FontFace = BubbleChatConfiguration.FontFace
textLabel.TextSize = BubbleChatConfiguration.TextSize
-- Parent a UICorner to the TextLabel to have rounded corners
local uiCorner = Instance.new("UICorner")
uiCorner.CornerRadius = UDim.new(0,12)
uiCorner.Parent = textLabel
-- Set up Billboard
local typingIndicatorBillboard = Instance.new("BillboardGui")
typingIndicatorBillboard.Enabled = false
typingIndicatorBillboard.Size = UDim2.fromScale(1, 1)
typingIndicatorBillboard.StudsOffsetWorldSpace = Vector3.new(-0,4,0)
typingIndicatorBillboard.Adornee = Character
textLabel.Parent = typingIndicatorBillboard
typingIndicatorBillboard.Parent = LocalPlayer:FindFirstChildOfClass("PlayerGui")
ChatInputBarConfiguration:GetPropertyChangedSignal("IsFocused"):Connect(function()
-- Enable the typing indicator when the input bar is focused and disable otherwise
typingIndicatorBillboard.Enabled = ChatInputBarConfiguration.IsFocused
end)
KeyboardKeyCode
Additional key users can press to trigger focusing on the default chat input bar. Useful when you want to have an extra hotkey for focusing in addition to the / key.
PlaceholderColor3
Color of the text of the placeholder text in the default chat input bar. Default value is Color3.new(178, 178, 178).
TargetTextChannel
Determines which TextChannel to use when the user sends a message with the default chat input bar.
TextBox
Reference to a designated TextBox instance that sends messages on behalf of the user. You can use it to further integrate your custom chat input bar UI into your experience by freely manipulating appearance, location, and layout. When opting to set this property to a custom TextBox, you don't need to write any code for the following behavior:
- When a user types a message and presses Enum.KeyCode.Return, the message will be sent to ChatInputBarConfiguration.TargetTextChannel.
- When a message is sent, TextBox.Text will automatically clear.
For security, some limitations are imposed on the TextBox when it is promoted to ChatInputBarConfiguration.TextBox. Lua code will not be able to:
- Change the TextBox.Text property.
- Use the TextBox:CaptureFocus() or TextBox:ReleaseFocus() methods.
TextStrokeColor3
Color of the text stroke for text in default chat input bar. Default value is Color3.new(0, 0, 0).
TextStrokeTransparency
Transparency of the text stroke for text in default chat input bar. Default value is 0.5.