Configuration

Components have a few features we haven't covered yet!

Predicate

You can add a predicate function to a component to determine if the component should be constructed for a provided instance.

This only affects Components created via CollectionService!

@Component({
    tag: "Example",
    predicate: ( instance ) => instance.FindFirstAncestorOfClass("PlayerGui") !== undefined,
})
export class ExampleComponent extends BaseComponent implements OnStart {}

Instance Guard

The instanceGuard is similar to predicate, but serves a slightly different purpose.

• On the server, an error will be thrown if a component is attempted to be created, but the instanceGuard fails.
• On the client, a connection will be created to wait for DescendantsAdded & DescendantsRemoving until the instanceGuard passes. This is because instances can be sent to the client in pieces and the whole thing might not have arrived yet.

Note: Using instanceGuard will override the automatically generated type guard, which is created when providing the BaseComponent with an Instance type!

@Component( {
    tag: "Example",
    instanceGuard: Flamework.createGuard<any>()
} )
export class ExampleComponent extends BaseComponent<{}, Model> implements OnStart {}

Defaults

You can use defaults to specify the value of the Component's attributes if they were not set before creating the Component.

Normally, you must assign all the attributes to a Component otherwise it will not be created. If you specify the defaults though, the Component can be created without specifying those attributes.

interface Attributes {
    amount: number
}

@Component( {
    tag: "Example",
    defaults: {
        "amount": 1
    }
} )
export class ExampleComponent extends BaseComponent<Attributes, Part> implements OnStart {}

Attributes

You can use attributes to specify custom type guards for attributes defined in your Component's attribute interface.

The example uses the t package to specify the value of the amount attribute, which should only ever be a number between 1 and 5.

interface Attributes {
    amount: number
}

@Component( {
    tag: "Example",
    attributes: {
        amount: t.numberConstrained( 1, 5 )
    }
} )
export class ExampleComponent extends BaseComponent<Attributes> implements OnStart {}

Refresh Attributes

(Default true)

Specifies if the Component should update its attributes when SetAttribute is called on the Component after it has been created.

If set to false, the Components attributes (this.attributes.example) will not be updated to the value set when using SetAttribute, after the Component has been created.

Note: Setting refreshAttributes to false will disable the onAttributeChanged handlers!

interface Attributes {
    amount: number
}

@Component( {
    tag: "Example",
    refreshAttributes: false
} )
export class ExampleComponent extends BaseComponent<Attributes, Part> implements OnStart {}