You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 1-js/03-code-quality/02-coding-style/article.md
+15-15Lines changed: 15 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ Mã của chúng ta phải rõ ràng và dễ đọc nhất có thể.
6
6
7
7
## Cú pháp
8
8
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):
10
10
11
11

12
12
<!--
@@ -52,7 +52,7 @@ if (condition) {
52
52
}
53
53
```
54
54
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?
56
56
```js
57
57
if (n < 0) *!*{*/!*alert(`Nguồn ${n} không được hỗ trợ`);*!*}*/!*
58
58
```
@@ -72,7 +72,7 @@ Cấu trúc một dòng, chẳng hạn như `if (điều kiện) doSomething()`,
72
72
}
73
73
```
74
74
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.
76
76
77
77
### Độ dài dòng
78
78
@@ -108,9 +108,9 @@ Có hai loại thụt lề:
108
108
109
109
-**Thụt lề ngang: 2 hoặc 4 dấu cách.**
110
110
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.
112
112
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à nó cho phép cấu hình thụt lề linh hoạt hơn so với tab.
114
114
115
115
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:
116
116
@@ -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
244
244
setHandler(elem);
245
245
walkAround();
246
246
```
247
-
2. Code trước, sau đó chức năng
247
+
2. Code trước, sau đó viết hàm
248
248
249
249
```js
250
250
// *!*mã sử dụng các chức năng*/!*
251
251
let elem = createElement();
252
252
setHandler(elem);
253
253
walkAround();
254
254
255
-
// --- *!*chức năng trợ giúp*/!* ---
255
+
// --- *!*hàm trợ giúp*/!* ---
256
256
function createElement() {
257
257
...
258
258
}
@@ -271,7 +271,7 @@ Hầu hết thời gian, biến thể thứ hai được ưa thích hơn.
271
271
272
272
Đó 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.
273
273
274
-
## Hướng dẫn Phong cách
274
+
## Hướng dẫn phong cách
275
275
276
276
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.
277
277
@@ -285,25 +285,25 @@ Một số lựa chọn phổ biến:
285
285
- [Hướng dẫn về kiểu JavaScript của Airbnb](https://github.com/airbnb/javascript)
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.
291
291
292
292
## Linters tự động
293
293
294
294
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.
295
295
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ể.
297
297
298
298
Dưới đây là một số công cụ linting nổi tiếng:
299
299
300
300
- [JSLint](http://www.jslint.com/) -- một trong những công cụ đầu tiên.
301
301
- [JSHint](http://www.jshint.com/) -- nhiều cài đặt hơn JSLint.
302
302
- [ESLint](http://eslint.org/) -- có lẽ là cái mới nhất.
303
303
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/).
305
305
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.
307
307
308
308
Chẳng hạn, đối với ESLint, bạn nên làm như sau:
309
309
@@ -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
335
335
336
336
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.
337
337
338
-
## Bản tóm tắt
338
+
## Tóm tắt
339
339
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.
341
341
342
342
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?" và "Đ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ã.
0 commit comments