Skip to content

Commit 631b353

Browse files
authored
Update article.md
1 parent 6e7a504 commit 631b353

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

1-js/03-code-quality/02-coding-style/article.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Mã của chúng ta phải rõ ràng và dễ đọc nhất có thể.
66

77
## Cú pháp
88

9-
Đây là một bảng gian lận với một số quy tắc được đề xuất (xem bên dưới để biết thêm chi tiết):
9+
Đây là một bảng hỗ trợ với một số quy tắc được đề xuất (xem bên dưới để biết thêm chi tiết):
1010

1111
![](code-style.svg)
1212
<!--
@@ -52,7 +52,7 @@ if (condition) {
5252
}
5353
```
5454

55-
Cấu trúc một dòng, chẳng hạn như `if (điều kiện) doSomething()`, là một trường hợp cạnh quan trọng. Có nên sử dụng dấu ngoặc nhọn không?
55+
Cấu trúc một dòng, chẳng hạn như `if (điều kiện) doSomething()`, là một trường hợp rìa quan trọng. Có nên sử dụng dấu ngoặc nhọn không?
5656
```js
5757
if (n < 0) *!*{*/!*alert(`Nguồn ${n} không được hỗ trợ`);*!*}*/!*
5858
```
@@ -72,7 +72,7 @@ Cấu trúc một dòng, chẳng hạn như `if (điều kiện) doSomething()`,
7272
}
7373
```
7474

75-
Đối với một mã rất ngắn gọn, một dòng được cho phép, ví dụ: `if (cond) return null`. Nhưng một khối mã (biến thể cuối cùng) thường dễ đọc hơn.
75+
Đối với một mã rất ngắn gọn, một dòng được cho phép, ví dụ: `if (cond) return null`. Nhưng một khối mã (biến thểbiến thể cuối cùng) thường dễ đọc hơn.
7676

7777
### Độ dài dòng
7878

@@ -108,9 +108,9 @@ Có hai loại thụt lề:
108108

109109
- **Thụt lề ngang: 2 hoặc 4 dấu cách.**
110110

111-
Thụt lề ngang được thực hiện bằng cách sử dụng 2 hoặc 4 dấu cách hoặc ký hiệu tab ngang (phím `key:Tab`). Chọn cái nào là thánh chiến xưa. Không gian ngày nay phổ biến hơn.
111+
Thụt lề ngang được thực hiện bằng cách sử dụng 2 hoặc 4 dấu cách hoặc ký hiệu tab ngang (phím `key:Tab`). Chọn cái nào là thánh chiến xưa. Dấu cách ngày nay phổ biến hơn.
112112

113-
Một lợi thế của khoảng trắng so với tab là khoảng trắng cho phép cấu hình thụt lề linh hoạt hơn so với biểu tượng tab.
113+
Một lợi thế của dấu cách so với tab là cho phép cấu hình thụt lề linh hoạt hơn so với tab.
114114

115115
Chẳng hạn, chúng ta có thể căn chỉnh các tham số với dấu ngoặc mở, như thế này:
116116

@@ -244,15 +244,15 @@ Nếu bạn đang viết một số hàm "trợ giúp" và mã sử dụng chún
244244
setHandler(elem);
245245
walkAround();
246246
```
247-
2. Code trước, sau đó chức năng
247+
2. Code trước, sau đó viết hàm
248248

249249
```js
250250
// *!*mã sử dụng các chức năng*/!*
251251
let elem = createElement();
252252
setHandler(elem);
253253
walkAround();
254254
255-
// --- *!*chức năng trợ giúp*/!* ---
255+
// --- *!*hàm trợ giúp*/!* ---
256256
function createElement() {
257257
...
258258
}
@@ -271,7 +271,7 @@ Hầu hết thời gian, biến thể thứ hai được ưa thích hơn.
271271

272272
Đó là bởi vì khi đọc mã, trước tiên chúng tôi muốn biết *nó làm gì*. Nếu mã đi trước, thì nó sẽ rõ ràng ngay từ đầu. Sau đó, có lẽ chúng ta sẽ không cần phải đọc các chức năng, đặc biệt nếu tên của chúng mô tả những gì chúng thực sự làm.
273273

274-
## Hướng dẫn Phong cách
274+
## Hướng dẫn phong cách
275275

276276
Hướng dẫn phong cách chứa các quy tắc chung về "cách viết" mã, ví dụ: nên sử dụng trích dẫn nào, thụt lề bao nhiêu khoảng trắng, độ dài dòng tối đa, v.v. Rất nhiều điều nhỏ nhặt.
277277

@@ -285,25 +285,25 @@ Một số lựa chọn phổ biến:
285285
- [Hướng dẫn về kiểu JavaScript của Airbnb](https://github.com/airbnb/javascript)
286286
- [Idiomatic.JS](https://github.com/rwaldron/idiomatic.js)
287287
- [StandardJS](https://standardjs.com/)
288-
- (cộng với nhiều hơn nữa)
288+
- (còn nhiều hơn nữa)
289289

290-
Nếu bạn là một nhà phát triển mới làm quen, hãy bắt đầu với cheat sheet ở đầu chương này. Sau đó, bạn có thể duyệt qua các hướng dẫn về phong cách khác để chọn thêm ý tưởng và quyết định xem bạn thích ý tưởng nào nhất.
290+
Nếu bạn là một nhà phát triển mới làm quen, hãy bắt đầu với bảng hỗ trợ ở đầu chương này. Sau đó, bạn có thể duyệt qua các hướng dẫn về phong cách khác để chọn thêm ý tưởng và quyết định xem bạn thích ý tưởng nào nhất.
291291

292292
## Linters tự động
293293

294294
Linters là công cụ có thể tự động kiểm tra kiểu mã của bạn và đưa ra các đề xuất cải tiến.
295295

296-
Điều tuyệt vời về chúng là kiểm tra kiểu cũng có thể tìm thấy một số lỗi, như lỗi chính tả trong tên biến hoặc hàm. Do tính năng này, nên sử dụng trình nói dối ngay cả khi bạn không muốn dính vào một "kiểu mã" cụ thể.
296+
Điều tuyệt vời về chúng là kiểm tra kiểu cũng có thể tìm thấy một số lỗi, như lỗi chính tả trong tên biến hoặc hàm. Do tính năng này, nên sử dụng linter ngay cả khi bạn không muốn dính vào một "kiểu mã" cụ thể.
297297

298298
Dưới đây là một số công cụ linting nổi tiếng:
299299

300300
- [JSLint](http://www.jslint.com/) -- một trong những công cụ đầu tiên.
301301
- [JSHint](http://www.jshint.com/) -- nhiều cài đặt hơn JSLint.
302302
- [ESLint](http://eslint.org/) -- có lẽ là cái mới nhất.
303303

304-
Tất cả trong số họ có thể làm công việc. Tác giả sử dụng [ESLint](http://eslint.org/).
304+
Tất cả trong số họ có thể làm công việc. Ở đây, tác giả sử dụng [ESLint](http://eslint.org/).
305305

306-
Hầu hết các linters đều được tích hợp với nhiều trình chỉnh sửa phổ biến: chỉ cần bật plugin trong trình chỉnh sửa và định cấu hình kiểu.
306+
Hầu hết các linters đều được tích hợp với nhiều trình chỉnh sửa phổ biến: chỉ cần bật plugin trong trình chỉnh sửa và tùy chỉnh kiểu.
307307

308308
Chẳng hạn, đối với ESLint, bạn nên làm như sau:
309309

@@ -335,9 +335,9 @@ Cũng có thể tải xuống các bộ quy tắc kiểu từ web và thay vào
335335

336336
Ngoài ra, một số IDE nhất định có linting tích hợp, thuận tiện nhưng không thể tùy chỉnh như ESLint.
337337

338-
## Bản tóm tắt
338+
## Tóm tắt
339339

340-
Tất cả các quy tắc cú pháp được mô tả trong chương này (và trong các hướng dẫn về phong cách được tham chiếu) nhằm mục đích tăng khả năng đọc mã của bạn. Tất cả chúng đều có thể tranh luận.
340+
Tất cả các quy tắc cú pháp được mô tả trong chương này (và trong các hướng dẫn về phong cách được tham chiếu) nhằm mục đích tăng khả năng đọc mã của bạn. Tất cả chúng đều gây tranh cãi.
341341

342342
Khi chúng ta nghĩ về việc viết mã "tốt hơn", các câu hỏi chúng ta nên tự hỏi mình là: "Điều gì làm cho mã dễ đọc hơn và dễ hiểu hơn?""Điều gì có thể giúp chúng ta tránh sai sót?" Đây là những điều chính cần lưu ý khi lựa chọn và tranh luận về kiểu mã.
343343

0 commit comments

Comments
 (0)