Sets the value of a form input element such as text inputs, textareas, or range sliders.

Syntax

MaterialSB::SetValue(Element, Value.s)

Parameters

Element	The form input element to set the value for.
Value.s	The new value to set.

Return Value

None.

Remarks

This function works with elements that have a value property: text inputs, textareas, and range sliders.

For dropdowns, setting the value programmatically may require re-initializing the component.

Example

Global nameInput, messageTextarea

Procedure ClearForm()
  MaterialSB::SetValue(nameInput, "")
  MaterialSB::SetValue(messageTextarea, "")
  MaterialSB::Toast("Form cleared")
EndProcedure

Procedure FillSample()
  MaterialSB::SetValue(nameInput, "John Doe")
  MaterialSB::SetValue(messageTextarea, "This is a sample message.~\n~\nIt has multiple lines.")
  MaterialSB::Toast("Sample data filled")
EndProcedure

Procedure Main(Success)
  If Success
    MaterialSB::Row(MaterialSB::#Grid_Container)
      MaterialSB::Col(12, 6)
        MaterialSB::Card()
          MaterialSB::CardContent()
            MaterialSB::Append(MaterialSB::Header("Contact Form", 4))
            
            nameInput = MaterialSB::TextInput("Name")
            messageTextarea = MaterialSB::Textarea("", "Enter your message...")
            
          MaterialSB::CloseCurrentParent()
          MaterialSB::CardAction()
            MaterialSB::Button("Fill Sample", @FillSample(), MaterialSB::#Button_Outlined)
            MaterialSB::Button("Clear", @ClearForm(), MaterialSB::#Button_Text)
          MaterialSB::CloseCurrentParent()
        MaterialSB::CloseCurrentParent()
      MaterialSB::CloseCurrentParent()
    MaterialSB::CloseCurrentParent()
  EndIf
EndProcedure

MaterialSB::Download(@Main())

See Also

GetValue(), TextInput(), Textarea()