# loadText (method)

> txt 또는 csv 파일의 내용을 시트로 `import`합니다.
> 사용 전 서버모듈 설치와 `/plugins/ibsheet-excel.js` 스크립트 로드가 필요합니다.
> 이 함수를 호출하면 파일 선택 창이 나타나고, 사용자가 선택한 txt/csv 파일이 `Cfg.Export` 속성에 지정한 `LoadText.jsp`(또는 `LoadText.aspx`)로 전달됩니다.
> 이 jsp 파일이 파일을 파싱해 JSON 형태로 시트에 반환합니다.
> 시트마다 반복 설정이 번거로우면 IBSheet.CommonOptions로 공통 적용할 수 있습니다.

### Syntax

    void loadText( param );

### Parameters

Name | Type | Required | Description
--- | --- | --- | ---
append | `boolean` | 선택 | 시트의 기존 데이터를 뒤에 text파일의 내용을 추가할지 여부 설정을 하지 않으면 기존데이터는 모두 삭제한 후 데이터가 추가됨. `0(false)`:기존 데이터 제거 후 엑셀 데이터 추가 (`default`) `1(true)`:기존 데이터에 엑셀 데이터 추가
fileExt | `string` | 선택 | 업로드 가능한 파일 확장자를 구분자("|")로 연결하여 설정합니다. (`defualt: "txt|csv"`)
mode | `string` | 선택 | `"HeaderMatch"`, `"NoHeader"`, `"HeaderSkip"` 중에 하나의 문자열을 입력합니다. 각 문자의 의미는 다음과 같습니다. `"HeaderMatch"` : 시트의 헤더행의 타이틀과 엑셀의 첫번째 행부터 타이틀을 비교해서 읽습니다. `"NoHeader"` : 헤더행이 없다고 가정하고 첫행부터 순서대로 각 열에 대입합니다. `"HeaderSkip"` : 헤더행은 있지만 열비교를 하지 않고 좌측부터 순서대로 읽습니다. 시트의 헤더행의 2개라면 엑셀의 위에서 두개행을 제외하고 그 아래부터 읽는다고 생각하시면 됩니다. (`default: "HeaderMatch"`)
colSeparator | `string` | 선택 | 열과 열 사이의 구분자 문자 (`default: '\t'(탭문자)`)
encoding | `string` | 선택 | 텍스트 파일의 인코딩 형식 지정 (`default: "utf-8"`)
sendParam | `object` | 선택 | 텍스트 로드시 서버로 전달할 파라미터를 설정합니다.
reqHeader | `object` | 선택 | 서버 전송 헤더에 사용자가 지정한 헤더 정보를 설정합니다.
useXhr | `boolean` | 선택 | xhr 통신을 이용해 파일을 로드합니다. `0(false)`:xhr 통신 사용 안함 (`default`) `1(true)`:xhr 통신 사용

### Return Value

none

### Example

    //text 파일 업로드
    var param = {mode:"NoHeader", append:1};
    sheet.loadText(param);

### Read More

- loadExcel method
- down2Text method
- importData method
- onSelectFile event
- onImportFinish event

### Since

product | version | desc
--- | --- | ---
excel | 0.0.0 | 기능 추가
excel | 0.0.8 | `reqHeader` 기능 추가