Skip to content

Commit 38b7025

Browse files
ChangJoo-Parkkazupon
authored andcommitted
update docs in Korean [based on 2.2.0] (#1122)
* Update route-object * update router-link in Korean * Add Passing Props to Route Components link in Korean * Update navigation in Korean (2.2.0) * Update router-instance in Korean (2.2.0) * Update navigation-guard in Korean (2.2.0) * Update passing-props in Korean (2.2.0)
1 parent a6e3ddb commit 38b7025

File tree

7 files changed

+101
-6
lines changed

7 files changed

+101
-6
lines changed

โ€Ždocs/kr/SUMMARY.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@
1313
- [์ด๋ฆ„์„ ๊ฐ€์ง„ ๋ผ์šฐํŠธ](essentials/named-routes.md)
1414
- [์ด๋ฆ„์„ ๊ฐ€์ง„ ๋ทฐ](essentials/named-views.md)
1515
- [๋ฆฌ๋‹ค์ด๋ ‰ํŠธ์™€ ๋ณ„์นญ](essentials/redirect-and-alias.md)
16+
- [๋ผ์šฐํŠธ ์ปดํฌ๋„ŒํŠธ์— ์†์„ฑ ์ „๋‹ฌ](essentials/passing-props.md)
1617
- [HTML5 History ๋ชจ๋“œ](essentials/history-mode.md)
1718
- ๊ณ ๊ธ‰
1819
- [๋„ค๋น„๊ฒŒ์ด์…˜ ๊ฐ€๋“œ](advanced/navigation-guards.md)

โ€Ždocs/kr/advanced/navigation-guards.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,10 @@ const router = new VueRouter({
6666

6767
๋งˆ์ง€๋ง‰์œผ๋กœ `beforeRouteEnter` ์™€ `beforeRouteLeave`๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋ผ์šฐํŠธ ์ปดํฌ๋„ŒํŠธ(๋ผ์šฐํ„ฐ ์„ค์ •์œผ๋กœ ์ „๋‹ฌ๋˜๋Š” ์ปดํฌ๋„ŒํŠธ) ์•ˆ์— ๋ผ์šฐํŠธ ๋„ค๋น„๊ฒŒ์ด์…˜ ๊ฐ€๋“œ๋ฅผ ์ง์ ‘ ์ •์˜ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
6868

69+
- `beforeRouteEnter`
70+
- `beforeRouteUpdate` (2.2 ๋ฒ„์ „์— ์ถ”๊ฐ€)
71+
- `beforeRouteLeave`
72+
6973
``` js
7074
const Foo = {
7175
template: `...`,

โ€Ždocs/kr/api/route-object.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,11 @@
44

55
route ๊ฐ์ฒด๋Š” ๋ณ€๊ฒฝํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ๋ชจ๋“  ์„ฑ๊ณต์ ์ธ ๋„ค๋น„๊ฒŒ์ด์…˜์€ ์ƒˆ๋กœ์šด ๋ผ์šฐํŠธ ๊ฐ์ฒด๋ฅผ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.
66

7-
2๋ผ์šฐํŠธ ๊ฐ์ฒด๋Š” ์—ฌ๋Ÿฌ ์œ„์น˜์—์„œ ์ฐพ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
7+
๋ผ์šฐํŠธ ๊ฐ์ฒด๋Š” ์—ฌ๋Ÿฌ ์œ„์น˜์—์„œ ์ฐพ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
88

9-
- ๋‚ด๋ถ€์—์„œ๋Š” `this.$route`๋กœ, ๋‚ด๋ถ€์—์„œ๋Š” `$route` ์›Œ์ฒ˜ ์ฝœ๋ฐฑ์œผ๋กœ ๋ช…๋ฐฑํ•˜๊ฒŒ ๋‚˜ํƒ€๋‚ฉ๋‹ˆ๋‹ค.
9+
- ์ปดํฌ๋„ŒํŠธ ๋‚ด๋ถ€์—์„œ `this.$route`๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
10+
11+
- ๊ฐ์‹œ์ž ์ฝœ๋ฐฑ์—์„œ `$route`๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
1012

1113
- `router.match(location)` ํ˜ธ์ถœ์˜ ๋ฐ˜ํ™˜ ๊ฐ’์œผ๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
1214

โ€Ždocs/kr/api/router-instance.md

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,8 @@
2828
์ „์—ญ ๋„ค๋น„๊ฒŒ์ด์…˜ ๊ฐ€๋“œ ์ถ”๊ฐ€. [๋„ค๋น„๊ฒŒ์ด์…˜ ๊ฐ€๋“œ](../advanced/navigation-guards.md)๋ฅผ ๋ณด์‹ญ์‹œ์˜ค.
2929

3030

31-
- **router.push(location)**
32-
- **router.replace(location)**
31+
- **router.push(location, onComplete?, onAbort?)**
32+
- **router.replace(location, onComplete?, onAbort?)**
3333
- **router.go(n)**
3434
- **router.back()**
3535
- **router.forward()**
@@ -53,3 +53,17 @@
5353
href: string;
5454
}
5555
```
56+
57+
- **router.addRoute(routes)**
58+
59+
> 2.2.0+
60+
61+
๋ผ์šฐํ„ฐ์— ๋™์ ์œผ๋กœ ๋” ๋งŽ์€ ๋ผ์šฐํŠธ๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ „๋‹ฌ์ธ์ž๋Š” `routes` ์ƒ์„ฑ์ž ์˜ต์…˜๊ณผ ๋™์ผํ•œ ๊ฒฝ๋กœ ์„ค์ • ํฌ๋งท์„ ์‚ฌ์šฉํ•˜๋Š” ๋ฐฐ์—ด์ด์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
62+
63+
- **router.onReady(callback)**
64+
65+
> 2.2.0+
66+
67+
์ด ๋ฉ”์†Œ๋“œ๋Š” ๋ผ์šฐํ„ฐ๊ฐ€ ์ดˆ๊ธฐ ํƒ์ƒ‰์„ ์™„๋ฃŒํ•  ๋•Œ ํ˜ธ์ถœํ•˜๋Š” ์ฝœ๋ฐฑ์„ ๋Œ€๊ธฐ์‹œํ‚ต๋‹ˆ๋‹ค. ์ฆ‰, ์ดˆ๊ธฐ ๋ผ์šฐํŠธ์™€ ์—ฐ๊ฒฐ๋œ ๋ชจ๋“  ๋น„๋™๊ธฐ ์ž…๋ ฅ ํ›… ๋ฐ ๋น„๋™๊ธฐ ์ปดํฌ๋„ŒํŠธ๋ฅผ ํ•ด๊ฒฐํ•ฉ๋‹ˆ๋‹ค.
68+
69+
์ด๋Š” ์„œ๋ฒ„์™€ ํด๋ผ์ด์–ธํŠธ ๋ชจ๋‘ ์ผ๊ด€๋œ ์ถœ๋ ฅ์„ ๋ณด์žฅํ•˜๊ธฐ ์œ„ํ•ด ์„œ๋ฒ„์ธก ๋ Œ๋”๋ง์„ ์‚ฌ์šฉํ•  ๋•Œ ์œ ์šฉํ•ฉ๋‹ˆ๋‹ค.

โ€Ždocs/kr/api/router-link.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@
9494

9595
- ๊ธฐ๋ณธ๊ฐ’: `false`
9696

97-
๊ธฐ๋ณธ ํ™œ์„ฑ ํด๋ž˜์Šค ๋งค์น˜ ๋™์ž‘์€ **ํฌ๊ด„์ ์ธ ๋งค์นญ** ์ž…๋‹ˆ๋‹ค. ์˜ˆ๋ฅผ ๋“ค์–ด, `<router-link to="/a">`๋Š” ํ˜„์žฌ ๊ฒฝ๋กœ๊ฐ€ `/a`๋กœ ์‹œ์ž‘ํ•˜๋Š” ํ•œ ์ด ํด๋ž˜์Šค๋ฅผ ์ ์šฉํ•ฉ๋‹ˆ๋‹ค.
97+
๊ธฐ๋ณธ ํ™œ์„ฑ ํด๋ž˜์Šค ๋งค์น˜ ๋™์ž‘์€ **ํฌ๊ด„์ ์ธ ๋งค์นญ** ์ž…๋‹ˆ๋‹ค. ์˜ˆ๋ฅผ ๋“ค์–ด, `<router-link to="/a">`๋Š” ํ˜„์žฌ ๊ฒฝ๋กœ๊ฐ€ `/a` ๋˜๋Š” `/a/`๋กœ ์‹œ์ž‘ํ•˜๋Š” ํ•œ ์ด ํด๋ž˜์Šค๋ฅผ ์ ์šฉํ•ฉ๋‹ˆ๋‹ค.
9898

9999
์ด๊ฒƒ์˜ ๊ฒฐ๊ณผ๋Š” `<router-link to="/">`๊ฐ€ ๋ชจ๋“  ๋ผ์šฐํ„ฐ์— ๋Œ€ํ•ด ํ™œ์„ฑํ™” ๋  ๊ฒƒ์ž…๋‹ˆ๋‹ค! ๋งํฌ๋ฅผ "์™„์ „ ์ผ์น˜ ๋ชจ๋“œ"๋กœ ๊ฐ•์ œํ•˜๋ ค๋ฉด `exact` prop๋ฅผ ์‚ฌ์šฉํ•˜์‹ญ์‹œ์˜ค.
100100

โ€Ždocs/kr/essentials/navigation.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
`<router-link>`๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์„ ์–ธ์  ๋„ค๋น„๊ฒŒ์ด์…˜์šฉ anchor ํƒœ๊ทธ๋ฅผ ๋งŒ๋“œ๋Š” ๊ฒƒ ์™ธ์—๋„ ๋ผ์šฐํ„ฐ์˜ ์ธ์Šคํ„ด์Šค ๋ฉ”์†Œ๋“œ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ํ”„๋กœ๊ทธ๋ž˜๋ฐ์œผ๋กœ ์ด๋ฅผ ์ˆ˜ํ–‰ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
44

5-
#### `router.push(location)`
5+
#### `router.push(location, onComplete?, onAbort?)`
66

77
๋‹ค๋ฅธ URL๋กœ ์ด๋™ํ•˜๋ ค๋ฉด `router.push`๋ฅผ ์‚ฌ์šฉํ•˜์‹ญ์‹œ์˜ค. ์ด ๋ฉ”์†Œ๋“œ๋Š” ์ƒˆ๋กœ์šด ํ•ญ๋ชฉ์„ ํžˆ์Šคํ† ๋ฆฌ ์Šคํƒ์— ๋„ฃ๊ธฐ ๋•Œ๋ฌธ์— ์‚ฌ์šฉ์ž๊ฐ€ ๋ธŒ๋ผ์šฐ์ €์˜ ๋’ค๋กœ ๊ฐ€๊ธฐ ๋ฒ„ํŠผ์„ ํด๋ฆญํ•˜๋ฉด ์ด์ „ URL๋กœ ์ด๋™ํ•˜๊ฒŒ๋œ๋‹ค.
88

@@ -30,6 +30,9 @@ router.push({ name: 'user', params: { userId: 123 }})
3030
router.push({ path: 'register', query: { plan: 'private' }})
3131
```
3232

33+
2.2.0 ๋ฒ„์ „์ดํ›„๋กœ ์„ ํƒ์ ์œผ๋กœ `router.push` ๋˜๋Š” `router.replace`์— ๋‘๋ฒˆ์งธ์™€ ์„ธ๋ฒˆ์งธ ์ „๋‹ฌ์ธ์ž๋กœ `onComplete`์™€ `onAbort` ์ฝœ๋ฐฑ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
34+
์ด ์ฝœ๋ฐฑ์€ ํƒ์ƒ‰์ด ์„ฑ๊ณต์ ์œผ๋กœ ์™„๋ฃŒ๋˜๊ฑฐ๋‚˜(๋ชจ๋“  ๋น„๋™๊ธฐ ํ›…์ด ํ•ด๊ฒฐ๋œ ํ›„) ๋˜๋Š” ์ค‘๋‹จ(ํ˜„์žฌ ํƒ์ƒ‰์ด ์™„๋ฃŒ๋˜๊ธฐ ์ „์— ๋™์ผํ•œ ๊ฒฝ๋กœ๋กœ ์ด๋™ํ•˜๊ฑฐ๋‚˜ ๋‹ค๋ฅธ ๊ฒฝ๋กœ ์ด๋™)๋  ๋•Œ ํ˜ธ์ถœ ๋ฉ๋‹ˆ๋‹ค.
35+
3336
#### `router.replace(location)`
3437

3538
`router.push`์™€ ๊ฐ™์€ ์—ญํ• ์„ ํ•˜์ง€๋งŒ ์œ ์ผํ•œ ์ฐจ์ด๋Š” ์ƒˆ๋กœ์šด ํžˆ์Šคํ† ๋ฆฌ ํ•ญ๋ชฉ์— ์ถ”๊ฐ€ํ•˜์ง€ ์•Š๊ณ  ํƒ์ƒ‰ํ•œ๋‹ค๋Š” ๊ฒƒ์ž…๋‹ˆ๋‹ค. ์ด๋ฆ„์—์„œ ์•Œ ์ˆ˜ ์žˆ๋“ฏ์ด ํ˜„์žฌ ํ•ญ๋ชฉ์„ ๋Œ€์ฒดํ•ฉ๋‹ˆ๋‹ค.
Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
# ๋ผ์šฐํŠธ ์ปดํฌ๋„ŒํŠธ์— ์†์„ฑ ์ „๋‹ฌ
2+
3+
์ปดํฌ๋„ŒํŠธ์—์„œ `$route`๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ํŠน์ • URL์—์„œ๋งŒ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋Š” ์ปดํฌ๋„ŒํŠธ์˜ ์œ ์—ฐ์„ฑ์„ ์ œํ•œํ•˜๋Š” ๋ผ์šฐํŠธ์™€ ๊ฐ•ํ•œ ๊ฒฐํ•ฉ์„ ๋งŒ๋“ญ๋‹ˆ๋‹ค.
4+
5+
์ปดํฌ๋„ŒํŠธ์™€ ๋ผ์šฐํ„ฐ ์†์„ฑ์„ ๋ถ„๋ฆฌํ•˜๋ ค๋ฉด ๋‹ค์Œ๊ณผ ๊ฐ™์ด ํ•˜์‹ญ์‹œ์˜ค.
6+
7+
**โŒ $route์— ์˜์กด์„ฑ ์ถ”๊ฐ€**
8+
9+
``` js
10+
const User = {
11+
template: '<div>User {{ $route.params.id }}</div>'
12+
}
13+
const router = new VueRouter({
14+
routes: [
15+
{ path: '/user/:id', component: User }
16+
]
17+
})
18+
```
19+
20+
**๐Ÿ‘ ์†์„ฑ์— ์˜์กด์„ฑ ํ•ด์ œ**
21+
22+
``` js
23+
const User = {
24+
props: ['id'],
25+
template: '<div>User {{ id }}</div>'
26+
}
27+
const router = new VueRouter({
28+
routes: [
29+
{ path: '/user/:id', component: User, props: true }
30+
]
31+
})
32+
```
33+
34+
์ด๋ฅผ ํ†ตํ•ด ์–ด๋””์„œ๋‚˜ ์ปดํฌ๋„ŒํŠธ๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์œผ๋ฏ€๋กœ ์ปดํฌ๋„ŒํŠธ ์žฌ์‚ฌ์šฉ ๋ฐ ํ…Œ์ŠคํŠธํ•˜๊ธฐ๊ฐ€ ๋” ์‰ฝ์Šต๋‹ˆ๋‹ค.
35+
36+
### Boolean ๋ชจ๋“œ
37+
38+
props๋ฅผ true๋กœ ์„ค์ •ํ•˜๋ฉด route.params๊ฐ€ ์ปดํฌ๋„ŒํŠธ props๋กœ ์„ค์ •๋ฉ๋‹ˆ๋‹ค.
39+
40+
### ๊ฐ์ฒด ๋ชจ๋“œ
41+
42+
props๊ฐ€ ๊ฐ์ฒด์ผ๋•Œ ์ปดํฌ๋„ŒํŠธ props๊ฐ€ ์žˆ๋Š” ๊ทธ๋Œ€๋กœ ์„ค์ •๋ฉ๋‹ˆ๋‹ค.
43+
props๊ฐ€ ์ •์ ์ผ ๋•Œ ์œ ์šฉํ•ฉ๋‹ˆ๋‹ค.
44+
45+
``` js
46+
const router = new VueRouter({
47+
routes: [
48+
{ path: '/promotion/from-newsletter', component: Promotion, props: { newsletterPopup: false } }
49+
]
50+
})
51+
```
52+
53+
### ํ•จ์ˆ˜ ๋ชจ๋“œ
54+
55+
props๋ฅผ ๋ฐ˜ํ™˜ํ•˜๋Š” ํ•จ์ˆ˜๋ฅผ ๋งŒ๋“ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
56+
์ด๋ฅผ ํ†ตํ•ด ์ „๋‹ฌ์ธ์ž๋ฅผ ๋‹ค๋ฅธ ํƒ€์ž…์œผ๋กœ ์บ์ŠคํŒ…ํ•˜๊ณ  ์ ์ •์ธ ๊ฐ’์„ ๋ผ์šฐํŠธ ๊ธฐ๋ฐ˜ ๊ฐ’๊ณผ ๊ฒฐํ•ฉ๋ฉ๋‹ˆ๋‹ค.
57+
58+
``` js
59+
const router = new VueRouter({
60+
routes: [
61+
{ path: '/search', component: SearchUser, props: (route) => ({ query: route.query.q }) }
62+
]
63+
})
64+
```
65+
66+
`/search?q=vue`๋Š” `{query: "vue"}`๋ฅผ SearchUser ์ปดํฌ๋„ŒํŠธ์— ์ „๋‹ฌํ•ฉ๋‹ˆ๋‹ค.
67+
68+
๋ผ์šฐํŠธ ๋ณ€๊ฒฝ์‹œ์—๋งŒ ํ‰๊ฐ€๋˜๋ฏ€๋กœ props ํ•จ์ˆ˜๋Š” ์ƒํƒœ๋ฅผ ์ €์žฅํ•˜์ง€ ์•Š๋„๋ก ํ•ฉ๋‹ˆ๋‹ค.
69+
props๋ฅผ ์ •์˜ํ•  ์ƒํƒœ๊ฐ€ ํ•„์š”ํ•œ ๊ฒฝ์šฐ ๋ž˜ํผ ์ปดํฌ๋„ŒํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ์ƒํƒœ๊ฐ€ ๋ณ€๊ฒฝ๋  ๋•Œ๋งˆ๋‹ค ์‘๋‹ตํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
70+
71+
๊ณ ๊ธ‰ ์‚ฌ์šฉ์˜ˆ๋ฅผ ๋ณด๋ ค๋ฉด [์˜ˆ์ œ](https://github.com/vuejs/vue-router/blob/dev/examples/route-props/app.js)๋ฅผ ํ™•์ธํ•˜์„ธ์š”.

0 commit comments

Comments
ย (0)