mirror of
https://github.com/CharaChorder/DeviceManager.git
synced 2026-01-20 08:52:59 +00:00
154 lines
3.4 KiB
Markdown
154 lines
3.4 KiB
Markdown
# max-line-length
|
|
|
|
> **Warning** This rule is deprecated and will be removed in the future. See [the migration guide](../../../docs/migration-guide/to-15.md).
|
|
|
|
Limit the length of a line.
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
a { color: red }
|
|
/** ↑
|
|
* The end */
|
|
```
|
|
|
|
Lines that exceed the maximum length but contain no whitespace (other than at the beginning of the line) are ignored.
|
|
|
|
When evaluating the line length, the arguments of any `url(...)` functions are excluded from the calculation, because typically you have no control over the length of these arguments. This means that long `url()` functions should not contribute to problems.
|
|
|
|
## Options
|
|
|
|
`int`: Maximum number of characters allowed.
|
|
|
|
For example, with `20`:
|
|
|
|
The following patterns are considered problems:
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
a { color: 0; top: 0; }
|
|
```
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
a {
|
|
background: linear-gradient(red, blue);
|
|
}
|
|
```
|
|
|
|
The following patterns are _not_ considered problems:
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
a {
|
|
color: 0;
|
|
top: 0;
|
|
}
|
|
```
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
a {
|
|
background: url(a-url-that-is-over-20-characters-long);
|
|
}
|
|
```
|
|
|
|
## Optional secondary options
|
|
|
|
### `ignore: ["non-comments"]`
|
|
|
|
Only enforce the line-length limit for lines within comments.
|
|
|
|
This does not apply to comments that are stuck in between other stuff, only to lines that begin at the beginning or in the middle of a comment.
|
|
|
|
For example, with a maximum length of `30`.
|
|
|
|
The following patterns are considered problems:
|
|
|
|
Each have only one problem.
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
/* This line is too long for my rule */
|
|
a { color: pink; background: orange; }
|
|
a { color: pink; /* this comment is also long but not on its own line */ }
|
|
```
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
a { color: pink; background: orange; }
|
|
/**
|
|
* This line is short,
|
|
* but this line is too long for my liking,
|
|
* though this one is fine
|
|
*/
|
|
a { color: pink; /* this comment is also long but not on its own line */ }
|
|
```
|
|
|
|
### `ignore: ["comments"]`
|
|
|
|
Only enforce the line-length limit for lines that are not comments.
|
|
|
|
This also applies to comments that are between code on the same line.
|
|
|
|
For example, with a maximum length of `30`.
|
|
|
|
The following patterns are considered problems:
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
a { color: pink; } /* comment that is too long */
|
|
```
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
a { /* this comment is too long for the max length */ }
|
|
```
|
|
|
|
The following patterns are _not_ considered problems:
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
/* comment that is too long for my rule*/
|
|
a { color: pink; }
|
|
```
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
/*
|
|
* comment that is too long the max length
|
|
* comment that is too long the max length
|
|
*
|
|
*/
|
|
a { color: pink; }
|
|
```
|
|
|
|
### `ignorePattern: "/regex/"`
|
|
|
|
Ignore any line that matches the given regex pattern, regardless of whether it is comment or not. The regex may be passed as a string (for JSON configuration) by enclosing in forward-slashes, or an ordinary JavaScript RegExp may be used.
|
|
|
|
Given:
|
|
|
|
```json
|
|
"/^@import\\s+/"
|
|
```
|
|
|
|
The following pattern is _not_ considered a problem:
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
@import "../../../../another/css/or/scss/file/or/something.css";
|
|
```
|
|
|
|
Given the following, with a maximum length of `20`.
|
|
|
|
```js
|
|
["/https?://[0-9,a-z]*.*/"];
|
|
```
|
|
|
|
The following pattern is _not_ considered a problem:
|
|
|
|
<!-- prettier-ignore -->
|
|
```css
|
|
/* ignore urls https://www.example.com */
|
|
```
|