Dart Public Setter

A public setter in Dart is a specialized method that provides write access to an object’s property. By default, any setter defined without a leading underscore (_) is public, meaning it is accessible from anywhere the object’s library is imported. Setters are invoked using the assignment operator (=) rather than standard method invocation syntax.

Dart implements setters in two ways: implicitly and explicitly.

Implicit Public Setters

Whenever you declare a mutable, non-final public instance variable, the Dart compiler automatically generates an implicit public setter for it.

class DataModel {
  // Generates an implicit public setter: set value(int x)
  int value = 0; 
}

Explicit Public Setters

An explicit public setter is defined using the set keyword. It is typically used to intercept the assignment operation to execute logic before mutating a private backing field.

Syntax

set propertyName(Type parameterName) {
  // Assignment logic
}

Technical Constraints and Characteristics

• Return Type: Setters do not return a value. While explicitly declaring a void return type (e.g., void set propertyName(...)) is valid syntax and will compile, omitting the return type entirely is the recommended Dart style convention and is enforced by the avoid_return_types_on_setters lint rule.
• Parameters: A setter must accept exactly one required positional parameter. It cannot accept optional, named, or multiple parameters.
• Naming: A setter cannot share a name with a method, variable, or getter in the same class, except for its corresponding getter. It is conventionally named after the logical property it mutates, while the actual data is stored in a private backing variable (prefixed with _).
• Invocation: Setters are called via property access syntax, not method syntax.

Implementation Example

class Measurement {
  // Private backing field
  double _magnitude = 0.0;

  // Explicit public setter
  set magnitude(double value) {
    _magnitude = value;
  }
}

void main() {
  var measure = Measurement();
  
  // Invokes the public setter using the assignment operator
  measure.magnitude = 42.5; 
  
  // INVALID: measure.magnitude(42.5);
}

Arrow Syntax

For setters containing a single expression, Dart supports the concise arrow (=>) syntax.

class Measurement {
  double _magnitude = 0.0;

  // Public setter using arrow syntax
  set magnitude(double value) => _magnitude = value;
}

Tired of Poor Dart Skills? Fix That With Deep Grasping!

Learn More