always_put_control_body_on_new_line

Separate the control structure expression from its statement.

This rule is available as of Dart 2.0.

This rule has a quick fix available.

From the style guide for the flutter repo:

DO separate the control structure expression from its statement.

Don't put the statement part of an if, for, while, do on the same line as the expression, even if it is short. Doing so makes it unclear that there is relevant code there. This is especially important for early returns.

BAD:

if (notReady) return;

if (notReady)
  return;
else print('ok')

while (condition) i += 1;

GOOD:

if (notReady)
  return;

if (notReady)
  return;
else
  print('ok')

while (condition)
  i += 1;

Note that this rule can conflict with the Dart formatter, and should not be enabled when the Dart formatter is used.

To enable the always_put_control_body_on_new_line rule, add always_put_control_body_on_new_line under linter > rules in your analysis_options.yaml file:

linter:
  rules:
    - always_put_control_body_on_new_line

Unless stated otherwise, the documentation on this site reflects Dart 3.6.0. Page last updated on 2024-07-03. View source or report an issue.