The most important rule is to keep consistent, since nothing can be uglier than a heap of inconsistent components. Even if some rules are being broken, they should be broken consistently.
Generally, the styles are specified in the editorconfig
and prettier.
Please follow them to keep the styles of the project unified
and make following contributions easier. >_<
You should run prettier before every commit to icalingua, like this:
yarn prettier -m .However, in order to avoid ugly spaces before too deeply-nested code, or to align, the indent rules can sometimes be broken, but please be cautious before doing so. If you are not sure what will happen if you run prettier, you can preview it using the command follow:
yarn prettier -c .And please keep the lines within a moderate length and indent level. If some code are inevitably nested too deeply, please consider putting them into another file. And though splitting some elements (e.g. attributes of a HTML tag) do be a good style, putting them together in a single line may be increasing the readability --- and the latter is encouraged.
'can be put into a single line' means 'a single line of moderate length', i.e. don't put everything into a single line like an OIer or an uglier.
If an opening tag and its closing tag can be put into a single line, do so; otherwise, leave the tags alone in their lines.
Don't split the opening tag into multiple lines if it can be written in a single line, because in this case both styles are easy to read for the single tag, and in the ocean of tags, being compact can make the DOM tree's structure clearer.
An opening or self-closing tag split into multiple lines
should have its right angle bracket(>) written in a single line.
For single-lined opening tags, there should always be no spaces before >;
and for single-lined self-closing tags, there should always be exactly one space before />.
The closing bracket should be indented the same as the opening bracket.
Attribute values should always be surrounded by quotes.
If the value is wrapped, put the quote in a single line (i.e. NOT in the same line as > or />)
with one level indented than the attribute name if possible.
Opening curly braces do not have a line break prepended.
Add spaces around binary or trinary operators and arrows,
after commas and colons, and after semicolons in for statements.
When a line is so complex that it appears better not to add spaces, split the statement.