사용자 정의 HTML

사용자 정의 HTML 항목을 사용하여 HTML 코드를 페이지 또는 보기에 추가할 수 있습니다.

사용자 정의 HTML 항목은 <div> 및 <label> 태그와 같은 하나 이상의 HTML 요소 세트를 포함할 수 있습니다. 관리 파일을 사용하거나 변수를 사용하여 HTML 코드를 텍스트로 직접 추가할 수 있습니다. 사용자 정의 HTML 항목은 페이지 또는 보기의 <div> 태그 내에 요소를 삽입합니다. 테이블, 탭, 가로 섹션 및 세로 섹션 보기와 같은 컨테이너의 사용자 정의 HTML 항목을 사용 중인 경우, HTML 코드를 <div> 태그로 랩핑하십시오. HTML 코드를 랩핑하면 컨테이너는 모든 HTML 코드를 하나의 엔티티로 간주합니다.

참고: 사용자 정의 HTML 블록을 사용하여 페이지를 빌드할 때 이러한 블록 내의 HTML 세그먼트가 너무 크지 않은지 확인하십시오. 사용자 정의 HTML 블록은 중소 크기의 HTML 세그먼트에 사용하도록 디자인되었습니다. 너무 큰 HTML 세그먼트를 제공할 경우 스택 오버플로우 예외가 표시될 수 있습니다. 이 경우에는 페이지 내에서 사용 중인 HTML 세그먼트의 크기를 줄여야 합니다. JVM 구성하기를 참조하세요 외부 링크가 새 창 또는 탭에서 열립니다

WebSphere® Application Server 을 참조하세요.

제한사항: 사용자 정의 HTML 항목이 테이블 또는 섹션과 같은 반복 보기 내에 있는 경우 목록 항목 내의 특성인 변수에 바인드하지 마십시오. 일반적으로 코드 생성기는 페이지를 작성할 때 사용자 정의 HTML 컨텐츠를 HTML 코드로 삽입합니다. 하지만 반복 보기는 목록으로 바인딩됩니다. 목록 컨텐츠가 런타임까지 설정되지 않으므로 코드 생성기는 페이지를 작성할 때 목록의 변수 색인을 판별할 수 없습니다. 동적으로 변경되는 텍스트를 원하는 경우, 변수로 바인딩되는 출력 텍스트와 같은 보기를 사용할 것을 고려하십시오.

중요: 다음 이름은 예약된 이름이므로 HTML 소스 코드에서 CSS 클래스 이름으로 사용하지 마십시오.

CoachView
ContentBox

사용자 정의 HTML 항목은 단순 유형에 JavaScript 변수를 사용하도록 지원합니다. 서버는 클라이언트에 대한 HTML 페이지를 생성할 때 변수 이름을 값으로 바꿉니다. 하지만 서버가 페이지를 생성한 후 값이 변경되면 HTML을 업데이트하지 않습니다. 서버는 전체 HTML 페이지를 재생성할 때에만 변수를 업데이트합니다. 서버가 변수를 분석할 수 없는 경우 사용자는 값이 아닌 변수 이름을 봅니다.

코드에서 변수를 이중 중괄호로 랩핑합니다. 페이지의 경우 변수는 tw.local 네임스페이스의 데이터만 참조할 수 있습니다. 즉, 로컬 노드 아래 사용자 서비스의 변수 페이지에 정의된 데이터를 참조할 수 있습니다. 예를 들어, 페이지는 사용자 이름을 포함한 name 매개변수가 있는 user 비즈니스 오브젝트 변수를 보유합니다. 페이지가 HTML 항목의 다음 코드로 이름을 표시하게 할 수 있습니다.

<div>Hello, {{tw.local.user.name}}.</div>

보기의 경우에는 변수가 tw.businessData 또는 tw.options 네임스페이스의 데이터를 참조할 수 있습니다. 즉, 비즈니스 데이터 또는 구성 옵션 노드 아래에 있는 보기의 변수 페이지에 정의된 데이터를 변수가 참조할 수 있습니다. 예를 들어, 보기에 거리 이름을 표시하려면 street란 매개변수로 address 비즈니스 오브젝트에 보기를 바인딩합니다. HTML 항목에서 다음 코드를 추가합니다.

{{tw.businessData.address.street}}

보기의 인스턴스를 페이지에 두면 사용자가 보기에서 street 매개변수의 값을 봅니다. 하지만 사용자가 street 매개변수를 업데이트할 경우, 서버가 전체 페이지를 재생성할 때까지 HTML 항목의 컨텐츠가 업데이트되지 않습니다.

팁: 스크립트를 삽입하려면 보기의 동작 페이지에서 인라인 스크립트를 사용하여 스크립트를 추가하십시오. 사용자 정의 HTML 항목을 사용하여 스크립트를 추가하지 마십시오.