Deprecate TextInputConnection.setStyle

TextInputConnection.setStyle is deprecated in favor of TextInputConnection.updateStyle, which supports synchronizing letterSpacing, wordSpacing, and lineHeight to the engine.

The previous setStyle method did not support letterSpacing, wordSpacing, or lineHeight. This caused visual misalignment of the selection highlight and IME caret when these properties were used.

The replacement updateStyle method (via TextInputStyle) supports these properties, ensuring the system input is synchronized with the rendered text.

Authors of custom text input clients should replace calls to TextInputConnection.setStyle with TextInputConnection.updateStyle.

connection.setStyle(
  fontFamily: 'Roboto',
  fontSize: 14.0,
  fontWeight: FontWeight.normal,
  textDirection: TextDirection.ltr,
  textAlign: TextAlign.start,
);

connection.updateStyle(
  TextInputStyle(
    fontFamily: 'Roboto',
    fontSize: 14.0,
    fontWeight: FontWeight.normal,
    textDirection: TextDirection.ltr,
    textAlign: TextAlign.start,
    letterSpacing: 1.2,
    wordSpacing: 1.0,
    lineHeight: 1.5,
  ),
);

Landed in version: TBD
In stable release: Not yet

Relevant PR:

• PR 180436

Relevant issues:

• Issue 161592