letterSpacingOverride property
The system-suggested amount of additional space (in logical pixels) to add between each letter.
A negative value can be used to bring the letters closer.
This value takes precedence over any text letter spacing specified at the application level. For example, at framework level, in the TextStyle for Text, SelectableText, and EditableText widgets, this value overrides the existing value of TextStyle.letterSpacing.
Returns null when no override has been set by the system.
Defaults to the value provided by PlatformDispatcher.letterSpacingOverride. This can only be set in a test environment to emulate different platform configurations. A standard PlatformDispatcher is not mutable from the framework.
Setting this value to null will force letterSpacingOverride to return
null. If you want to have the value default to the platform
letterSpacingOverride, use clearLetterSpacingOverrideTestValue.
See also:
- PlatformDispatcher.letterSpacingOverride for the standard implementation
- clearLetterSpacingOverrideTestValue to reset this value specifically
- clearAllTestValues to reset all test values for this view
Implementation
@override
double? get letterSpacingOverride => _forceLetterSpacingOverrideToBeNull
? null
: _letterSpacingOverrideTestValue ?? _platformDispatcher.letterSpacingOverride;