Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion build/index.js
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@ Metalsmith(cwd)
moment,
localeMap: {
'en': 'English',
'ko': '한국어',
},
home(current) {
const locale = current.locale || this.defaultLocale;
Expand Down Expand Up @@ -110,7 +111,7 @@ Metalsmith(cwd)
})
.use(locales({
defaultLocale: 'en',
locales: ['en']
locales: ['en', 'ko']
}))
.use(order())
.use(categories())
Expand Down
50 changes: 50 additions & 0 deletions content/docs/ko/elements/action-bar/action-bar.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
title: 액션바 (ActionBar)
apiRef: https://docs.nativescript.org/api-reference/classes/_ui_action_bar_.actionbar
contributors: [rigor789, eddyverbruggen]
---

액션바 컴포넌트는 안드로이드 액션바와 iOS NavigationBar의 네이티브-스크립트 추상화 입니다.

---

#### 제목 사용

```html
<ActionBar title="MyApp" />
```

#### 커스텀 제목 view

```html
<ActionBar>
<StackLayout orientation="horizontal">
<Image src="res://icon" width="40" height="40" verticalAlignment="center" />
<Label text="ativeScript" fontSize="24" verticalAlignment="center" />
</StackLayout>
</ActionBar>
```

#### 안드로이드에서 앱 아이콘 설정

```html
<ActionBar title="My App" android.icon="res://icon" android.iconVisibility="always" />
```

#### 가장자리 경계(border) 없애기
iOS와 안드로이드에서 작은 보더가 액션바 바닥에 그려집니다.
추가로 iOS에서 액션바의 배경색은 iOS가 적용하는 필터때문에 지정한 값과 약간 달라집니다.
이 필터와 보더를 제거하려면 `flat` 을 `true` 로 설정하세요

```html
<ActionBar title="My App" flat="true" />
```

## Props

| 이름 | 타입 | 설명 |
|------|------|-------------|
| `title` | `String` | 액션바에 나타나는 제목.
| `android.icon` | `String` | 안드로이드에서 보여지는 아이콘.
| `android.iconVisibility` | `String` | 아이콘이 보여질지 지정.
| `flat` | `boolean` | 보더와 iOS 컬러 필터를 제거. 기본값은 `false`.
56 changes: 56 additions & 0 deletions content/docs/ko/elements/action-bar/action-item.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
title: 액션아이템 (ActionItem)
apiRef: https://docs.nativescript.org/api-reference/classes/_ui_action_bar_.actionitem
contributors: [rigor789]
---

ActionItem 컴포넌트는 액션바에 추가적인 액션 버턴을 추가하는데 쓰임

---

```html
<ActionBar title="My App">
<ActionItem @tap="onTapShare"
ios.systemIcon="9" ios.position="left"
android.systemIcon="ic_menu_share" android.position="actionBar" />
<ActionItem @tap="onTapDelete"
ios.systemIcon="16" ios.position="right"
text="delete" android.position="popup" />
</ActionBar>
```

#### 액션 아이템의 조건부 표시

ActionItems 은 `v-show` 디렉티브를 이용하여 조건부로 표시할 수 있습니다.

```html
<ActionBar title="My App">
<ActionItem @tap="onTapEdit"
v-show="!isEditing"
ios.systemIcon="2" ios.position="right"
android.systemIcon="ic_menu_edit" />
<ActionItem @tap="onTapSave"
v-show="isEditing"
ios.systemIcon="3" ios.position="right"
android.systemIcon="ic_menu_save" />
<ActionItem @tap="onTapCancel"
v-show="isEditing"
ios.systemIcon="1"
android.systemIcon="ic_menu_close_clear_cancel" />
</ActionBar>
```

## Props

| 이름 | 타입 | 설명 |
|------|------|------------|
| `ios.systemIcon` | `String` | iOS용 아이콘.
| `android.systemIcon` | `String` | 안드로이드용 아이콘.
| `ios.position` | `String` | iOS용 위치 설정.<br>가능한 값:<br>- `left` (기본값): 아이템을 액션바의 왼쪽에 위치.<br>- `right`: 아이템을 액션바의 오른쪽에 위치.
| `android.position` | `String` | 안드로이드용 위치설정.<br>가능한 값:<br>- `actionBar` (기본값): 아이템을 액션바 내에 위치.<br>- `popup`: 아이템을 옵션 메뉴에 위치. 아이템은 텍스트로 렌더링됨. .<br>- `actionBarIfRoom`: 공간이 있을 경우 아이템을 액션바 내에 위치. 아니면 옵션 메뉴에 둠.

## 이벤트

| 이름 | 설명 |
|------|-------------|
| `tap`| 액션 아이템이 탭(tap)되었을때 호출(Emit)
30 changes: 30 additions & 0 deletions content/docs/ko/elements/action-bar/navigation-button.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
title: 네비게이션 버튼 (NavigationButton)
apiRef: https://docs.nativescript.org/api-reference/classes/_ui_action_bar_.navigationbutton
contributors: [rigor789]
---

NavigationButton 컴포넌트는 안드로이드 네비게이션 버튼과 iOS 백버튼(back button)의 네이티브-스크립트 추상화입니다.

---

```html
<ActionBar title="My App">
<NavigationButton text="Go back" android.systemIcon="ic_menu_back" @tap="goBack" />
</ActionBar>
```

## Props

| 이름 | 타입 | 설명 |
|------|------|-------------|
| `text` | `String` | 텍스트를 iOS 에서 보여주도록 설정.
| `android.systemIcon` | `String` | 해당 아이콘이 안드로이드에서 보입니다.

*안드로이드의 아이콘 리스트는 다음 페이지에서 찾을 수 있습니다. <https://developer.android.com/reference/android/R.drawable.html>. 아이콘은 `ic_` 접두어와 함께 시작하는 것들입니다.*

## Events

| 이름 | 설명 |
|------|-------------|
| `tap`| 네비게이션 버튼을 탭(tab) 했을때 발생(Emit).
33 changes: 33 additions & 0 deletions content/docs/ko/elements/components/activity-indicator.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
title: ActivityIndicator
apiRef: https://docs.nativescript.org/api-reference/classes/_ui_activity_indicator_.activityindicator
contributors: [qgp9]
---

ActivityIndicator 컴포넌트는 백그라운드에서 동작하는 것을 표시하는 프로그레스 인디케이터를 추가하고 사용자가 일시중지(pause) 할수 있게 도와줍니다.

---

```html
<ActivityIndicator busy="true" @busyChange="onBusyChanged" />
```

[> screenshots for=ActivityIndicator <]

## Props

| 이름 | 타입 | 설명 |
|------|------|-------------|
| `busy` | `Boolean` | `true` 일때 인디케이터가 활성화됨.

## 이벤트

| 이름 | 설명 |
|------|-------------|
| `busyChange`| `busy` 프로퍼티가 바뀔때 발생(Emit)

## 네이티브 컴포넌트

| Android | iOS |
|---------|-----|
| android.widget.ProgressBar (indeterminate = true) | UIActivityIndicatorView
36 changes: 36 additions & 0 deletions content/docs/ko/elements/components/button.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
title: 버튼 (Button)
apiRef: https://docs.nativescript.org/api-reference/classes/_ui_button_.button
contributors: [qgp9]
---

버튼(Button) 컴포넌트는 탭(tab) 이벤트에 반응하는 버튼을 표시하는데 사용됩니다.

상호작용이 탭(tab) 이벤트로만 제한되는 것은 아닙니다.
[네이티브-스크립트에서 사용가능한 모든 제스쳐에대하여 공식 문서를 읽어보세요](https://docs.nativescript.org/ui/gestures).

---

```html
<Button text="Button" />
```

[> screenshots for=Button <]

## Props

| 이름 | 타입 | 설명 |
|------|------|-------------|
| `text` | `String` | 버튼에 보이는 텍스트.
| `textWrap` | `boolean` | 버튼의 텍스트가 래핑될지 결정. 기본값은 `false`.

## 이벤트

| 이름 | 설명 |
|------|-------------|
| `tap` | 버튼이 눌릴때 발생(Emit)

## 네이티브 컴포넌트
| Android | iOS |
|---------|-----|
| android.widget.Button | UIButton
44 changes: 44 additions & 0 deletions content/docs/ko/elements/components/date-picker.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
title: 날짜선택 (DatePicker)
apiRef: https://docs.nativescript.org/api-reference/classes/_ui_date_picker_.datepicker
contributors: [qgp9]
---

DatePicker 컴포넌트는 사용자가 날짜를 선택할 수 있도록 합니다.

---

```html
<DatePicker @loaded="onDatePickerLoaded" @dateChanged="onDateChanged" />
```

**노트**: 이 컴포넌트는 `v-model` 을 이용한 양방향(two-way) 바인딩을 지원합니다:

```html
<DatePicker v-model="selectedDate" />
```

[> screenshots for=DatePicker <]

## Props

| 이름 | 타입 | 설명 |
|------|------|-------------|
| `date` | `Date` | 현재 표시되는 날짜.
| `minDate` | `Date` | 최소 선택 가능 날짜.
| `maxDate` | `Date` | 최대 선택 가능 날짜.
| `day` | `Number` | 현재 선택된 날.
| `month` | `Number` | 현재 선택된 달.
| `year` | `Number` | 현재 선택된 년.

## 이벤트

| 이름 | 설명 |
|------|-------------|
| `dateChanged` | 선택된 날짜가 바뀔때 발생(Emit)

## 네이티브 컴포넌트

| Android | iOS |
|---------|-----|
| android.widget.DatePicker | UIDatePicker
27 changes: 27 additions & 0 deletions content/docs/ko/elements/components/html-view.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
title: HTML뷰 (HtmlView)
apiRef: https://docs.nativescript.org/api-reference/classes/_ui_html_view_.htmlview
contributors: [qgp9]
---

HtmlView 컴포넌트는 정적인 html 컨텐츠를 웹뷰(WebView) 없이 보여줄 수 있도록 해줍니다.

---

```html
<HtmlView html="<div><h1>HtmlView</h1></div>" />
```

[> screenshots for=HtmlView <]

## Props

| 이름 | 타입 | 설명 |
|------|------|-------------|
| `html` | `String` | 보여줄 html 컨텐츠.

## 네이티브 컴포넌트

| Android | iOS |
|---------|-----|
| android.widget.TextView | UILabel
47 changes: 47 additions & 0 deletions content/docs/ko/elements/components/image.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
---
title: 이미지 (Image)
apiRef: https://docs.nativescript.org/api-reference/classes/_ui_image_.image
contributors: [qgp9]
---

이미지(Image) 컴포넌트는 [ImageSource](https://docs.nativescript.org/api-reference/modules/_image_source_) 나 URL 로부터 이미지를 표시합니다.

---

#### `app` 디렉토리로부터 상대경로로 이미지 표시

```html
<Image src="~/logo.png" stretch="none" />
```

#### URL 로 부터 이미지 표시

```html
<Image src="https://art.nativescript-vue.org/NativeScript-Vue-White-Green.png" stretch="none" />
```

#### `App_Resources` 로 부터 이미지 표시

```html
<Image src="res://icon" stretch="none" />
```

#### `base64` 인코딩 이미지

```html
<Image src="data:Image/png;base64,iVBORw..." stretch="none" />
```

[> screenshots for=Image <]

## Props

| 이름 | 타입 | 설명 |
|------|------|-------------|
| `src` | `String`, [`ImageSource`](https://docs.nativescript.org/api-reference/modules/_image_source_) | 이미지 소스.

## 네이티브 컴포넌트

| Android | iOS |
|---------|-----|
| android.widget.ImageView | UIImageView
47 changes: 47 additions & 0 deletions content/docs/ko/elements/components/label.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
---
title: 레이블 (Label)
apiRef: https://docs.nativescript.org/api-reference/classes/_ui_label_.label
contributors: [qgp9]
---

레이블(Label) 컴포넌트는 읽기전용 텍스트를 표시하는데 사용됩니다.

**노트**: `<Label>` HTML의 `<Label>` 과 **다릅니다**.

---

```html
<Label text="Label" />
```

[> screenshots for=Label <]

### FormattedString

특정 부분의 텍스트를 다르게 스타일링해야 한다면 `FormattedString` `Span` 요소를 결합하여 사용할 수 있습니다.

예:
```html
<Label textWrap="true">
<FormattedString>
<Span text="This text has a " />
<Span text="red " style="color: red" />
<Span text="piece of text. " />
<Span text="Also, this bit is italic, " fontStyle="italic" />
<Span text="and this bit is bold." fontWeight="bold" />
</FormattedString>
</Label>
```

## Props

| 이름 | 타입 | 설명 |
|------|------|-------------|
| `text` | `String` | 레이블의 텍트스.
| `textWrap` | `boolean` | 레이블의 텍스트가 래핑될것 인지 지정. 기본값은 `false`.

## 네이티브 컴포넌트

| Android | iOS |
|---------|-----|
| android.widget.TextView | UILabel
Loading