References
The References module makes it easy to store and retrive referenses to components or ui elements.
References.Add(name, component) -> void
TIP
Use Vuxel.SetRef
for more secure handling!
Parameters
- name
- Type:
string
- Required:
Yes
- Description: The unique name for the reference.
- Type:
- component
- Type:
Instance
- Required:
Yes
- Description: The component instance to store as a reference.
- Type:
Returns
- void
- Type:
nil
- Always:
Yes
- Description: No return value; adds the component to the references.
- Type:
Description
Add a reference by a unique name.
lua
Vuxel.References.Add(name, component)
References.Get(name) -> Instance
TIP
Use Vuxel.GetRef
for more secure handling!
Parameters
- name
- Type:
string
- Required:
Yes
- Description: The name of the reference to retrieve.
- Type:
Returns
- Instance
- Type:
Instance | nil
- Always:
No
- Description: The component instance associated with
name
, ornil
if not found.
- Type:
Description
Get a reference by a unique name.
lua
Vuxel.References.Get(name)
References.Remove(name) -> void
Parameters
- name
- Type:
string
- Required:
Yes
- Description: The name of the reference to remove.
- Type:
Returns
- void
- Type:
nil
- Always:
Yes
- Description: No return value; removes the specified reference.
- Type:
Description
Remove a reference by a unique name.
lua
Vuxel.References.Remove(name)
References.Clear() -> void
Parameters
- None
Returns
- void
- Type:
nil
- Always:
Yes
- Description: No return value; clears all references.
- Type:
Description
Removes all references for cleanup.
lua
Vuxel.References.Clear()
References.ListAll(printPrefix) -> void
Parameters
- printPrefix
- Type:
string
- Required:
No
- Description: Optional prefix to print before each reference, used for debugging.
- Type:
Returns
- void
- Type:
nil
- Always:
Yes
- Description: No return value; prints all references with an optional prefix.
- Type:
Description
Prints all references for debug.
lua
Vuxel.References.ListAll()