@daracl/form 0.0.17 → 0.0.18

package/README.md

@@ -135,7 +135,7 @@ type: {
 | renderer | custom renderer |   |  |
 | conditional | 보이기 여부 조건 | show: 보이기 여부 <br/>  field: field name <br> eq: 비교 값 <br> custom: custom 체크 메소드   |  |
 | renderType |  render type  | text  | number, text, file, textarea, dropdown, radio, checkbox, date(dara-datetimepicker모듈 사용), group, custom |
-| customOptions |  date 타입등의 추가 module에서 사용하는 추가 옵션 |   |  |
+| rendererOptions |  date 타입등의 추가 module에서 사용하는 추가 옵션 |   |  |
 | style |  width: field 넓이<br> labelHide : label 숨김여부 <br> labelWidth : label 넓이<br>  customClass : custom class <br> valueWidth : value width <br> tabAlign : render type이 tab일 경우 정렬 <br> position : '"[label위치]"-[글자 정렬위치]' <br> -- ex) 'top-left','left-right' |  width: "100%" <br>  labelWidth: 3<br> valueWidth: 9<br> position: "left-right" | position : top,left,right - left,center,right <br> tabAlign:left, center, right|
 | rule |  유효성 규칙 | minLength: 최소 길이 <br>  maxLength: 최대길이<br> minimum: 최소값 <br>    exclusiveMinimum: 최소값 포함 여부 <br> maximum: 최대값 <br>exclusiveMaximum: 최대값 포함여부 |  |
 | different | field 값이 다른지 비교 | field: field name <br> message: 메시지   |  |

package/dist/DaraForm.d.ts

@@ -2,16 +2,25 @@ import { FormOptions } from "@t/FormOptions";
 import { FormField } from "@t/FormField";
 import { ValidResult } from "@t/ValidResult";
 import { Message } from "@t/Message";
-import FieldInfoMap from "src/FieldInfoMap";
+import FieldInfoMap from "@/FieldInfoMap";
 import FormTemplate from "./FormTemplate";
 import { FORM_MODE } from "./constants";
+export interface FormChangeEvent {
+    form: DaraForm;
+}
+export interface FormChangeListener {
+    (event: FormChangeEvent): void;
+}
+export interface Unsubscribe {
+    (): void;
+}
 /**
  * DaraForm class
  *
  * @class DaraForm
  * @typedef {DaraForm}
  */
-export default class DaraForm {
+export declare class DaraForm {
     static VERSION: string;
     private readonly options;
     private orginFormStyleClass;
@@ -20,9 +29,11 @@ export default class DaraForm {
     private fieldInfoMap;
     private formValue;
     formTemplate: FormTemplate;
+    private changeListeners;
     constructor(formElement: Element, options: FormOptions, message?: Message);
     static create(formElement: Element, options: FormOptions, message?: Message): DaraForm;
     static setMessage(message: Message): void;
+    static setDefaultOptions(options: FormOptions, message?: Message): void;
     private createForm;
     /**
      * change mode
@@ -81,6 +92,34 @@ export default class DaraForm {
      * @param {string} fieldName
      */
     removeField: (fieldName: string) => void;
+    /**
+     * 제거할 필드와 같은 fieldInfoMap에 등록된 하위 필드(group 하위 필드, tab 패널) 목록
+     * grid 컬럼, tab 패널 내부 필드는 별도 form에 등록되므로 제외됨.
+     *
+     * @param {FormField} fieldInfo
+     * @param {FormField[]} result
+     * @returns {FormField[]}
+     */
+    private getRemoveFields;
+    /**
+     * field element 제거
+     *
+     * @param {FormField} fieldInfo
+     */
+    private removeFieldElement;
+    /**
+     * 부모 children(최상위는 options.fields)에서 필드 제거
+     * tab 은 children 기준으로 값/유효성 체크를 하므로 제거해야 함.
+     *
+     * @param {FormField} fieldInfo
+     */
+    private removeParentChildField;
+    /**
+     * getValue() 시 formValue에 누적된 field 값 제거
+     *
+     * @param {FormField} fieldInfo
+     */
+    private removeFormValue;
     /**
      * 폼 유효성 검증 여부
      *
@@ -100,6 +139,16 @@ export default class DaraForm {
      */
     getOptions: () => FormOptions;
     conditionCheck(): void;
+    /**
+     * 폼 상태(값/보이기 여부 등) 변경을 감지하는 리스너 등록.
+     *
+     * value/setValue/resetForm/conditional 변경 체크
+     *
+     * @param listener 상태 변경시 호출되는 콜백
+     * @returns 등록 해제 함수
+     */
+    subscribe: (listener: FormChangeListener) => Unsubscribe;
+    private notifyChange;
     setFieldDisabled(fieldName: string, flag: boolean): void;
     /**
      * 설명 추가

package/dist/FieldInfoMap.d.ts

@@ -1,6 +1,6 @@
 import { FormField } from "./types/FormField";
 import { ValidResult } from "./types/ValidResult";
-import DaraForm from "./DaraForm";
+import { DaraForm } from "./DaraForm";
 interface NumberFieldMap {
     [key: string]: FormField;
 }
@@ -57,6 +57,13 @@ export default class FieldInfoMap {
      * @param {string} fieldName
      */
     removeFieldInfo(fieldName: string): void;
+    /**
+     * 필드 키로 필드 정보 맵에서 지우기
+     *
+     * @public
+     * @param {string} fieldKey
+     */
+    removeFieldInfoByKey(fieldKey: string): void;
     /**
      * 모든 필드값 구하기
      *

package/dist/FormTemplate.d.ts

@@ -1,6 +1,6 @@
 import { FieldStyle, FormField } from "@t/FormField";
-import FieldInfoMap from "src/FieldInfoMap";
-import DaraForm from "./DaraForm";
+import FieldInfoMap from "@/FieldInfoMap";
+import { DaraForm } from "./DaraForm";
 /**
  * form template
  *

package/dist/constants.d.ts

@@ -27,7 +27,11 @@ export type RENDER_TYPE = "number" | "text" | "file" | "textarea" | "dropdown" |
 export type REGEXP_TYPE = "email" | "url" | "alpha" | "alpha-num";
 export type PASSWORD_TYPE = "number" | "upper" | "upper-special" | "upper-special-number";
 export type FIELD_POSITION = "top" | "left" | "left-left" | "left-right" | "right" | "right-left" | "right-right" | "bottom";
-export type ORIENTATION_TYPE = "horizontal" | "vertical";
+export declare const OrientationMap: {
+    readonly horizontal: "horizontal";
+    readonly vertical: "vertical";
+};
+export type OrientationType = (typeof OrientationMap)[keyof typeof OrientationMap];
 interface StringArrayMap {
     [key: string]: string[];
 }