FormState를 화면으로 옮기다 Lit이 필요해지는 순간
작성일:2026.10.24|수정일:2026.11.03|조회수:6

<ilokesto-form-devtools>의 DOM과 스타일 경계까지 정해도 화면은 아직 움직이지 않는다. 폼에서 새 상태를 읽었을 때 어느 노드를 만들고 지울지, 탭을 바꿨을 때 어떤 버튼과 내용을 고칠지, 패널을 닫았을 때 무엇을 감출지를 계속 DOM 명령으로 적어야 한다.
표준 DOM API만으로도 구현할 수는 있다. 하지만 상태가 늘어나면 코드는 곧 “무엇을 보여줄 것인가”보다 “어느 노드를 찾아 어떤 순서로 고칠 것인가”를 더 많이 설명한다. Form Devtools에서 Lit을 사용한 이유는 새로운 경계를 만들기 위해서가 아니라, 이미 정한 경계 안에서 상태를 화면으로 옮기는 갱신 규칙을 맡기기 위해서다.
LitElement가 더하는 것은 업데이트 주기다
Form Devtools의 요소 클래스는 LitElement를 상속한다. 여기서 Lit이 더하는 일은 비교적 분명하다. 반응형 값이 바뀌면 업데이트를 예약하고, 업데이트 직전 훅을 호출한 뒤, render()가 반환한 템플릿을 기존 DOM에 반영한다.
앞에서 정한 Custom Element와 Shadow DOM의 책임을 Lit이 가져가는 것이 아니다. Lit은 그 경계 안에서 상태와 DOM을 반복해서 맞추는 구현 도구에 가깝다.
export class IlokestoFormDevtoolsElement extends LitElement { // reactive properties, lifecycle, render...}이 구분은 외부 자원과 연결할 때 중요하다. Lit은 form 프로퍼티가 바뀌었다는 사실은 알 수 있지만, 이전 폼의 구독을 해제하고 새 폼을 구독해야 한다는 사정까지 알지는 못한다. 업데이트 시점은 Lit이 제공하고, 그 시점에 무엇을 연결할지는 요소가 정한다.
공개 프로퍼티와 내부 상태를 나눈다
Lit이 변경을 추적할 값은 static properties에 선언한다. 현재 구현에는 외부 소비자가 설정하는 값과 렌더링을 위해 요소 안에서만 쓰는 값이 함께 있다.
export class IlokestoFormDevtoolsElement extends LitElement { public static override properties = { form: { attribute: false }, open: { type: Boolean, reflect: true }, position: { type: String, reflect: true }, maskPaths: { attribute: false }, activeTab: { state: true }, snapshot: { state: true }, }; public form?: FormDevtoolsSource; public open = false; public position: FormDevtoolsPosition = 'bottom-right'; public maskPaths: readonly FieldPathInput[] = []; private activeTab: FormDevtoolsTab = 'overview'; private snapshot?: FormSnapshot; private unsubscribe?: () => void;}form, open, position, maskPaths는 공개 프로퍼티다. 반면 activeTab과 snapshot은 화면을 그리기 위한 내부 상태다. state: true는 값을 비공개로 만드는 TypeScript 문법이 아니다. Attribute로 노출하지 않으면서도 값이 바뀌면 Lit 업데이트를 요청하도록 만드는 선언이다. 소스 수준의 접근 범위는 private가, 렌더링 주기 참여 여부는 Lit의 상태 선언이 각각 맡는다.
attribute: false도 접근 제한이 아니라 변환 경계를 뜻한다. form은 메서드를 가진 객체이고 maskPaths는 경로 목록이므로 문자열인 HTML Attribute로 왕복시키지 않는다. 둘은 자바스크립트 프로퍼티로만 전달한다.
반대로 open과 position에는 reflect: true가 있다. 프로퍼티 값이 바뀌면 호스트의 Attribute에도 반영된다. 다만 **Attribute가 실제 화면에 쓰이는 방식은 두 프로퍼티가 다르다.** position은 반영된 Attribute를 CSS가 직접 읽는다.
:host([position='bottom-right']) { right: 16px; bottom: 16px; }:host([position='bottom-left']) { left: 16px; bottom: 16px; }:host([position='top-right']) { right: 16px; top: 16px; }:host([position='top-left']) { left: 16px; top: 16px; }open의 실제 패널 표시 여부는 [open] 선택자가 정하지 않는다. render()가 this.open 프로퍼티를 읽어 패널 템플릿을 넣거나 빼는 방식이다. 즉 reflect: true라는 공통 설정만 보고 두 값의 시각적 효과까지 같은 경로로 적용된다고 생각하면 안 된다. position은 프로퍼티 → Attribute → CSS, open은 프로퍼티 → render() → DOM 경로를 탄다.
willUpdate에서 폼 교체를 감지한다
반응형 form 프로퍼티는 외부 상태를 자동으로 가져오지 않는다. Form Devtools는 폼의 변경 알림을 구독하고, 알림이 올 때마다 최신 스냅숏을 내부 snapshot에 대입한다. 이때 connectForm()은 DOM을 건드리지 않는다. 외부 상태를 Lit의 내부 반응형 상태로 옮기는 데서 멈춘다.
private connectForm(): void { this.disconnectForm(); if (!this.isConnected || !this.form) { this.snapshot = undefined; return; } const form = this.form; const readSnapshot = (): void => { this.snapshot = form.getState(); }; readSnapshot(); this.unsubscribe = form.subscribe(readSnapshot);}snapshot에 무엇이 들어 있고 각 필드가 어떤 진단 의미를 갖는지는 화면 정보 설계의 문제다. 여기서 중요한 것은 구독 콜백이 새 값을 snapshot에 대입하면 Lit이 업데이트를 예약한다는 흐름이다. Lit의 기본 변경 판단은 객체 내부를 재귀적으로 감시하지 않으므로, 같은 객체를 제자리에서 고치는 방식보다 새 스냅숏 참조를 대입하는 계약이 이 구조에 맞는다.
폼 인스턴스 자체가 바뀌면 willUpdate()가 변경 목록에서 이를 감지한다.
protected override willUpdate( changedProperties: PropertyValues<this>,): void { if (changedProperties.has('form')) { this.connectForm(); }}connectForm()은 먼저 기존 구독을 끊고 새 폼의 현재 스냅숏을 읽은 뒤 다시 구독한다. 그래서 이전 폼과 새 폼의 알림이 섞이지 않고, 이어지는 render()도 새 폼에서 읽은 상태를 사용할 수 있다. willUpdate()는 “업데이트 직전”이라는 자리를 제공할 뿐이고, 구독 교체의 세부 정책은 여전히 connectForm()에 있다.
DOM 연결 수명과 구독 수명을 함께 맞춘다
willUpdate()만으로는 폼 구독의 모든 경우를 다룰 수 없다. 한 번 렌더링한 요소를 문서에서 떼었다가 같은 form 프로퍼티를 유지한 채 다시 붙이면, form 참조는 바뀌지 않았다. 변경 목록만 기다리면 구독이 복구되지 않는다.
현재 구현은 hasUpdated로 첫 연결과 재연결을 구분한다.
public override connectedCallback(): void { super.connectedCallback(); if (this.hasUpdated) { this.connectForm(); }}public override disconnectedCallback(): void { this.disconnectForm(); super.disconnectedCallback();}첫 연결에서는 초기 업데이트의 willUpdate()가 form을 보고 구독한다. 이미 업데이트를 마친 요소가 다시 연결되면 connectedCallback()이 hasUpdated를 확인하고 구독을 복구한다. 문서에서 떨어질 때는 disconnectedCallback()이 구독을 끊는다. 실제 테스트도 form을 교체했을 때 첫 구독이 해제되고, 요소를 제거했을 때 두 번째 구독이 해제되는지를 확인한다.
여기서 핵심은 수명 훅 자체를 다시 설명하는 것이 아니다. Lit의 프로퍼티 변경 수명과 요소의 DOM 연결 수명이 서로 다른 신호이므로, 외부 구독을 안전하게 유지하려면 둘을 connectForm() 한곳으로 모아야 한다는 점이다.
html과 render()로 상태의 결과를 적는다
Lit의 html은 완성된 문자열을 innerHTML에 넣는 함수가 아니다. 고정된 템플릿 구조와 ${...}의 동적 값을 나누어 표현하고, 다음 렌더링에서 바뀐 부분을 DOM에 반영한다. 덕분에 구현은 노드 수정 순서보다 현재 상태에서 나와야 할 구조를 적을 수 있다.
최상위 render()는 open을 읽어 패널을 조건부로 렌더링한다.
protected override render(): TemplateResult { return html` ${this.open ? this.renderPanel() : nothing} <button class="launcher" type="button" aria-label=${this.open ? 'Close ilokesto Form Devtools' : 'Open ilokesto Form Devtools'} @click=${this.toggleOpen} > iF </button> `;}open이 false이면 nothing이 패널 위치에 아무 노드도 렌더링하지 않게 한다. 같은 값이 런처 버튼의 aria-label도 결정한다. 패널을 찾아 감춘 다음 버튼의 이름을 따로 고치는 명령이 필요하지 않다. open 하나가 화면의 두 결과를 결정하고, DOM을 별도의 상태 저장소처럼 관리하지 않는다.
내부 탭도 같은 흐름을 따른다.
${(['overview', 'fields', 'values'] as const).map(tab => html` <button class="tab" type="button" aria-pressed=${this.activeTab === tab} @click=${() => { this.activeTab = tab; }} >${tab}</button>`)}Lit의 @click은 브라우저 click 이벤트에 함수를 연결하는 템플릿 문법이다. 클릭 처리기는 activeTab만 바꾸고, 어떤 버튼의 aria-pressed가 바뀌며 어떤 내용이 렌더링될지는 다음 템플릿 평가가 결정한다.
이 내부 바인딩과 요소 밖으로 내보내는 이벤트 계약은 구분해야 한다. @click은 Lit 템플릿 안의 구현 문법이고, open-change는 표준 CustomEvent로 전달하는 외부 DOM 계약이다. Lit 전용 이벤트 계층이 하나 더 생기는 것은 아니다. 이벤트가 Shadow DOM 경계를 지나는 세부 규칙은 앞에서 정한 내용을 그대로 사용하면 충분하다.
물론 선언형 템플릿이 화면 정책까지 대신 정해 주지는 않는다. 어떤 상태에서 패널을 만들지, 어떤 접근성 속성을 쓸지, 스냅숏을 어떤 화면으로 나눌지는 여전히 구현의 판단이다. Lit이 줄여 주는 것은 그 판단을 반복적인 DOM 명령으로 번역하는 일이다.
상태 변경과 렌더링 완료는 같은 순간이 아니다
반응형 프로퍼티에 값을 대입했다고 그 줄에서 DOM 갱신까지 끝나는 것은 아니다. Lit은 업데이트를 비동기로 예약하고 같은 작업 차례의 변경을 묶을 수 있다. 따라서 “snapshot이 바뀌었다”와 “그 스냅숏을 반영한 DOM을 읽을 수 있다”는 서로 다른 시점이다.
updateComplete는 예약된 업데이트가 끝날 때 해결되는 Promise다. 테스트에서 프로퍼티를 바꾸거나 내부 버튼을 클릭한 뒤 DOM을 확인하려면 이 경계를 기다려야 한다.
element.open = true;await element.updateComplete;const panel = element.shadowRoot?.querySelector('.panel');expect(panel).not.toBeNull();탭 클릭이나 폼 변경 알림 뒤에도 원리는 같다. updateComplete 없이 곧바로 DOM을 읽으면 이전 렌더링 결과를 보고 구독이나 템플릿이 잘못됐다고 오해할 수 있다. 반대로 이 Promise를 기다렸다는 사실은 폼 상태의 의미가 옳다는 보장이 아니다. Lit의 업데이트가 DOM에 반영됐다는 시간 경계만 확인한다.
Lit이 맡을 만큼만 맡긴다
정적인 문구와 버튼 하나라면 HTMLElement와 DOM API만으로도 충분할 수 있다. Form Devtools처럼 외부 구독에서 들어오는 스냅숏, 공개 프로퍼티, 내부 탭 상태, 조건부 패널이 함께 움직이면 상태와 DOM 사이의 갱신 규칙이 화면 크기보다 먼저 복잡해진다. 직접 쓴 코드가 화면의 의미보다 노드를 고치는 순서를 더 많이 말하기 시작한다면 Lit을 검토할 이유가 생긴다.
그래도 Lit은 폼 상태를 어떻게 해석할지 정하지 않고, 외부 구독의 수명 정책도 대신 만들지 않는다. 이 구현에서 Lit의 책임은 반응형 값을 추적하고, 적절한 업데이트 시점을 제공하며, 그 값에서 나온 템플릿을 DOM에 반영하는 데까지다. 결국 중요한 것은 Lit을 썼다는 사실이 아니라, 외부 상태를 내부 반응형 상태로 옮긴 뒤 render()라는 한 방향으로 화면을 만들도록 책임을 좁힌 데 있다.
댓글
댓글을 불러오는 중...