Please give example code for preserve_breaking_attribute_list formatting option

[trymeouteh]

Please give example code for preserve_breaking_attribute_list formatting option. I do not understand what this option does for formatting PHP attributes.

[azjezz]

Hi!

The preserve_* options control wheather or not mago formatter will keep elements broken into multiple lines or not when formatting.

Given:

#[
   Route('/user')
]
class UserController
{
  // ...
}

Mago will format this as:

#[Route('/user')]
class UserController
{
  // ...
}

As the attribute list can fit into a single line.

However, with preserve_breaking_attribute_list option enabled. Mago will keep the attribute list broken into multiple lines, such as:

#[
   Route('/user'),
]
class UserController
{
  // ...
}

The preserve options are useful if you want to have more control over breaking things into multiple lines, by telling Mago that if something is already spanning multiple lines, keep it as is.

Options are avaialble for argument lists ( preserve_breaking_argument_list ), array-like, i.e array, list, and short array ( preserve_breaking_array_like ), parameter lists ( preserve_breaking_parameter_list ), member access chain ( preserve_breaking_member_access_chain ), attribute lists ( preserve_breaking_attribute_list ) and conditional expression ( preserve_breaking_conditional_expression ).

[trymeouteh]

Thank you. Please consider adding these examples to the documentation for preserve_breaking_attribute_list