Skip to content

Commit fa40f2d

Browse files
ikatyangikatyang
authored
docs(blog): 1.15 release (#5296)
1 parent 4559a77 commit fa40f2d

8 files changed

Lines changed: 1949 additions & 32 deletions

File tree

‎.pre-commit-hooks.yaml‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@
55
files: "\\.(\
66
css|less|scss\
77
|graphql|gql\
8+
|html\
89
|js|jsx\
910
|json\
1011
|md|markdown|mdown|mkdn\

‎README.md‎

Lines changed: 27 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,33 @@
44

55
<p align="center">
66
<em>
7-
JavaScript
8-
· Flow
9-
· TypeScript
10-
· CSS
11-
· SCSS
12-
· Less
13-
· JSX
14-
· Vue
15-
· GraphQL
16-
· JSON
17-
· Markdown
18-
· YAML
19-
· <a href="https://prettier.io/docs/en/plugins.html">
7+
JavaScript
8+
· TypeScript
9+
· Flow
10+
· JSX
11+
· JSON
12+
</em>
13+
<br />
14+
<em>
15+
CSS
16+
· SCSS
17+
· Less
18+
</em>
19+
<br />
20+
<em>
21+
HTML
22+
· Vue
23+
· Angular
24+
</em>
25+
<br />
26+
<em>
27+
GraphQL
28+
· Markdown
29+
· YAML
30+
</em>
31+
<br />
32+
<em>
33+
<a href="https://prettier.io/docs/en/plugins.html">
2034
Your favorite language?
2135
</a>
2236
</em>

‎docs/ignore.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,25 @@ matrix(
5353
</div>
5454
```
5555

56+
## HTML
57+
58+
```html
59+
<!-- prettier-ignore -->
60+
<div class="x" >hello world</div >
61+
62+
<!-- prettier-ignore-attribute -->
63+
<div
64+
(mousedown)=" onStart ( ) "
65+
(mouseup)=" onEnd ( ) "
66+
></div>
67+
68+
<!-- prettier-ignore-attribute (mouseup) -->
69+
<div
70+
(mousedown)="onStart()"
71+
(mouseup)=" onEnd ( ) "
72+
></div>
73+
```
74+
5675
## CSS
5776

5877
```css

‎docs/options.md‎

Lines changed: 22 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -191,13 +191,12 @@ Valid options:
191191
- `"json-stringify"` (same parser as `"json"`, but outputs like `JSON.stringify`) _Since v1.13.0_
192192
- `"graphql"` (via [graphql/language](https://github.com/graphql/graphql-js/tree/master/src/language)) _Since v1.5.0_
193193
- `"markdown"` (via [remark-parse](https://github.com/wooorm/remark/tree/master/packages/remark-parse)) _Since v1.8.0_
194-
- `"vue"` (uses several parsers) _Since 1.10.0_
194+
- `"mdx"` (via [remark-parse](https://github.com/wooorm/remark/tree/master/packages/remark-parse) and [@mdx-js/mdx](https://github.com/mdx-js/mdx/tree/master/packages/mdx)) _Since v1.15.0_
195+
- `"html"` (via [angular-html-parser](https://github.com/ikatyang/angular-html-parser/tree/master/packages/angular-html-parser)) _Since 1.15.0_
196+
- `"vue"` (same parser as `"html"`, but also formats vue-specific syntax) _Since 1.10.0_
197+
- `"angular"` (same parser as `"html"`, but also formats angular-specific syntax via [angular-estree-parser](https://github.com/ikatyang/angular-estree-parser)) _Since 1.15.0_
195198
- `"yaml"` (via [yaml](https://github.com/eemeli/yaml) and [yaml-unist-parser](https://github.com/ikatyang/yaml-unist-parser)) _Since 1.14.0_
196199

197-
<!-- TODO: Uncomment and move below "markdown" above when 1.15.0 is released.
198-
- `"mdx"` (same parser as `"markdown"`, with some custom overrides) _Since 1.15.0_
199-
-->
200-
201200
[Custom parsers](api.md#custom-parser-api) are also supported. _Since v1.5.0_
202201

203202
| Default | CLI Override | API Override |
@@ -272,7 +271,23 @@ Valid options:
272271
| ------------ | ----------------------------------------------------------- | ----------------------------------------------------------- |
273272
| `"preserve"` | <code>--prose-wrap <always&#124;never&#124;preserve></code> | <code>proseWrap: "<always&#124;never&#124;preserve>"</code> |
274273

275-
<!--TODO(1.15)
274+
## HTML Whitespace Sensitivity
275+
276+
_available in v1.15.0+_
277+
278+
Specify the global whitespace sensitivity for HTML files, see [whitespace-sensitive formatting] for more info.
279+
280+
[whitespace-sensitive formatting]: https://prettier.io/blog/2018/11/07/1.15.0.html#whitespace-sensitive-formatting
281+
282+
Valid options:
283+
284+
- `"css"` - Respect the default value of CSS `display` property.
285+
- `"strict"` - Whitespaces are considered sensitive.
286+
- `"ignore"` - Whitespaces are considered insensitive.
287+
288+
| Default | CLI Override | API Override |
289+
| ------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
290+
| `"css"` | <code>--html-whitespace-sensitivity <css&#124;strict&#124;ignore></code> | <code>htmlWhitespaceSensitivity: "<css&#124;strict&#124;ignore>"</code> |
276291

277292
## End of Line
278293

@@ -310,6 +325,4 @@ Valid options:
310325

311326
| Default | CLI Override | API Override |
312327
| -------- | ----------------------------------------------------------- | ---------------------------------------------------------- |
313-
| `"auto"` | <code>--end-of-line <auto&#124;cr&#124;crlf&#124;lf></code> | <code>endOfLine: "<auto&#124;cr&#124;crlf&#124;lf>"</code> |
314-
315-
-->
328+
| `"auto"` | <code>--end-of-line <auto&#124;lf&#124;crlf&#124;cr></code> | <code>endOfLine: "<auto&#124;lf&#124;crlf&#124;cr>"</code> |

0 commit comments

Comments
 (0)