본문으로 건너뛰기

Input

텍스트를 입력하기 위한 기본 입력 필드 컨트롤입니다.

Input 컨트롤

사용법​

{
    type: "input",
    key?: string | string[],
    wrap?: boolean, // 기본값은 false

    css?: string,
    disabled?: boolean, // 기본값은 false
    hidden?: boolean, // 기본값은 false
    height?: string | number | "content", // 기본값은 "content"
    width?: string | number | "content", // 기본값은 "content"
    padding?: string | number,

    icon?: string,
    inputType?: "text" | "password" | "number", // 기본값은 "text"
    max?: number | string,
    maxlength?: number | string,
    min?: number | string,
    minlength?: number | string,
    placeholder?: string,
    readOnly?: boolean, // 기본값은 false

    // `wrap:true`인 경우 Fieldset의 label 속성을 확인하세요
    label?: string,
    labelWidth?: string | number,
    labelPosition?: "left" | "top", // 기본값은 "top"

    // 서비스 속성 및 메서드
    $on?: { [eventName: string]: function },
    $handler?: function,
    $setValue?: function,
    $layout?: function
}

설명​

기본 속성​

  • type - (필수) 컨트롤의 유형입니다. "input"으로 설정합니다
  • key - (선택 사항) 지정되거나 수정되는 속성의 이름 또는 Diagram 항목 객체 내에서 해당 속성에 대한 경로입니다
  • wrap - (선택 사항) 외부 래핑 표시 여부를 지정합니다. false가 기본값입니다
  • css - (선택 사항) 컨트롤에 스타일 클래스를 추가합니다
  • disabled - (선택 사항) 컨트롤의 활성화(false) 또는 비활성화(true) 여부를 정의합니다. false가 기본값입니다
  • hidden - (선택 사항) 컨트롤의 숨김 여부를 정의합니다. false가 기본값입니다
  • height - (선택 사항) 컨트롤의 높이입니다. "content"가 기본값입니다
  • width - (선택 사항) 컨트롤의 너비입니다. "content"가 기본값입니다
  • padding - (선택 사항) input 컨트롤의 셀과 테두리 사이의 여백을 설정합니다
  • icon - (선택 사항) 사용 중인 아이콘 폰트에서 가져온 아이콘의 CSS 클래스입니다
  • inputType - (선택 사항) 입력의 유형을 설정합니다: "text" | "password" | "number". "text"가 기본값입니다 비밀번호를 입력하는 필드를 지정하려면 "password" 값을 사용하세요
  • max - (선택 사항) - 입력에 허용되는 최댓값입니다. 이 속성은 입력 유형이 *"number"*인 경우에만 작동합니다
  • maxlength - (선택 사항) 입력에 허용되는 최대 문자 수입니다. 이 속성은 다음 입력 유형에서 작동합니다: "text", "password"
  • min - (선택 사항) 입력에 허용되는 최솟값입니다. 이 속성은 입력 유형이 *"number"*인 경우에만 작동합니다
  • minlength - (선택 사항) 입력에 허용되는 최소 문자 수입니다. 이 속성은 다음 입력 유형에서 작동합니다: "text", "password"
  • placeholder - (선택 사항) 입력을 위한 힌트입니다
  • readOnly - (선택 사항) 입력이 읽기 전용인지 여부를 정의합니다. false가 기본값입니다
  • label - (선택 사항) 컨트롤의 레이블을 지정합니다
  • labelWidth - (선택 사항) 컨트롤의 레이블 너비를 설정합니다
  • labelPosition - (선택 사항) 레이블의 위치를 정의합니다: "left" | "top". "top"이 기본값입니다

서비스 속성 및 메서드​

경고

기본 유형의 컨트롤에 대해서는 서비스 속성 및 메서드를 재정의하지 않는 것을 강력히 권장합니다. 재정의할 경우 기능에 오류가 발생할 수 있습니다.

  • $on - (선택 사항) - 이벤트 리스너를 설정할 수 있습니다. 해당 객체는 다음 속성을 가집니다:
    • eventName - 다음 매개변수와 함께 호출되는 콜백 함수입니다:
      • object - 다음 속성을 가진 객체입니다:
        • control - Input Form 컨트롤
        • editor - Diagram Editor의 객체
        • id - Diagram 항목의 id
      • arguments - (선택 사항) - 원본 이벤트 인수
  • $handler - (선택 사항) - Input Form 컨트롤의 change 및 input 이벤트, 그리고 DataCollection의 change 이벤트 발생 시 동작을 처리할 수 있는 콜백 함수입니다. 다음 매개변수와 함께 호출됩니다:
    • object - 다음 속성을 가진 객체입니다:
      • id - Diagram 항목의 id
      • key - 지정되거나 수정되는 속성의 이름 또는 Diagram 항목 객체 내에서 해당 속성에 대한 경로
      • editor - Diagram Editor의 객체
      • control - 컴포넌트가 빌드된 Input Form 컨트롤의 객체
      • value - Input Form 컨트롤의 새로운 값
  • $setValue - (선택 사항) - 컨트롤 초기화 시 및 DataCollection의 값 변경 시 Input Form 컨트롤의 값을 설정할 수 있는 콜백 함수입니다. 다음 매개변수와 함께 호출됩니다:
    • object - 다음 속성을 가진 객체입니다:
      • editor - Diagram Editor의 객체
      • control - 컴포넌트가 빌드된 Input Form 컨트롤의 객체
      • value - Diagram 항목의 값
  • $layout - (선택 사항) - 컨트롤의 구조를 설정할 수 있는 콜백 함수입니다. Input Form 컨트롤의 설정을 반환합니다. 다음 매개변수와 함께 호출됩니다:
    • object - 서비스 속성을 제외한 컨트롤의 설정

예제​

const editor = new dhx.DiagramEditor("editor_container", {
    type: "default",
     view: {
        editbar: {
            properties: {
                $shape: [
                    {
                        type: "input",
                        inputType: "text",
                        key: "text",
                        label: "Input with a string value",
                        placeholder: "Enter a string value"
                    },
                    {
                        type: "input",
                        inputType: "number",
                        key: "x",
                        label: "Input with a number value",
                        placeholder: "Enter a number value",
                        min: 0,
                        max: 100,
                    }
                ]
            }
        }
    }
});

Need more help?Contact Support