다중 선택

사용자가 항목의 목록에서 한 번에 여러 항목을 선택하도록 허용합니다.

데이터 바인딩

구성 특성에서 보기의 데이터 바인딩을 설정하거나 수정하십시오. 보기는 ANY (List) 유형에 바인드될 수 있습니다.

구성 특성

구성에서 보기의 모양 및 동작 특성을 설정하거나 수정하십시오.

화면 크기: 특성 이름 옆에 화면 크기 아이콘 이 있는 구성 특성은 각 화면 크기에 대해 다른 값을 가질 수 있습니다. 값을 설정하지 않을 경우 화면 크기는 다음으로 큰 화면 크기 값을 기본값으로 상속합니다.

테마 정의: 테마 정의는 보기를 위해 색상 및 스타일을 지정하고 보기의 모양을 결정합니다. 테마 편집기에서 보기의 룩앤필을 미리볼 수 있습니다. 테마를 참조하십시오.

다중 선택 보기의 모양 구성 특성은 다음 테이블에 나와 있습니다.

표 1. 다중 선택의 모양 구성 특성
모양 구성 특성	설명	데이터 유형
너비	뷰의 너비. 너비(px, 픽셀) 또는 em 단위를 지정할 수 있습니다. 예를 들면, 50px, 20% 또는 0.4em입니다. 단위 유형이 지정되지 않으면 px를 사용합니다.	`String`
크기	보기의 텍스트 크기, 레이블 텍스트의 크기, 텍스트 주위의 채우기 양입니다. 예를 들어, 스마트폰에서 텍스트 및 레이블을 더 쉽게 읽을 수 있도록 하기 위해 이 구성 옵션을 `Large` 로 설정하여 작은 화면 크기를 보완할 수 있습니다.	`String`
레이블 배치	보기의 레이블 배치 위치입니다.	`String`
레이블 너비	레이블의 너비입니다. 너비(px, 픽셀) 또는 em 단위를 지정할 수 있습니다. 예를 들면, 50px, 20% 또는 0.4em입니다. 단위 유형이 지정되지 않으면 px를 사용합니다.	`String`
유효성 검증 마커 표시	보기가 올바르지 않은 경우 유효성 검증 아이콘 및 테두리를 표시합니다.	`Boolean`

다중 선택 보기의 동작 구성 특성은 다음 테이블에 나와 있습니다.

표 2. 다중 선택의 동작 구성 특성
동작 구성 특성	설명	데이터 유형
탭 색인	탭 지정 순서 색인입니다. 탭 색인은 1부터 시작하며 최소로 설정할 수 있습니다. 예를 들어, 1, 5, 10을 사용할 수 있습니다.	`Integer`

다중 선택 보기의 항목 구성 특성은 다음 테이블에 나와 있습니다.

표 3. 다중 선택의 항목 구성 특성
항목 구성 특성	설명	데이터 유형
항목 검색 모드	사용자가 선택할 수 있는 항목 목록을 채우는 데 사용되는 메소드입니다. 참고: 올바른 옵션이 선택되어 있는지 확인하십시오. 그렇지 않으면 목록은 올바르게 채워지지 않습니다. 빈 상태 시작 다음을 사용하여 선택 목록을 프로그래밍 방식으로 채우십시오.`appendItem(value, displayText)`method. 서비스의 항목 선택사항 목록은 목록 항목 서비스 옵션을 지정하는 서비스에서 채워집니다. 정적 목록의 항목 선택사항 목록은 정적 목록 옵션에 입력하는 특성으로 채워집니다. 구성 옵션의 항목 선택사항 목록은 항목 입력 데이터 옵션을 지정하는 비즈니스 오브젝트 목록에서 채워집니다.	`String`
목록 항목 서비스	선택 목록에 표시되는 항목 목록을 채우는 데 사용되는 서비스입니다. 서비스는 항목 검색 모드가 서비스의 항목인 경우 사용됩니다. 서비스는 서비스 입력 데이터 비즈니스 오브젝트로 제공되는 데이터를 기반으로 선택사항 목록을 제공하는 적절한 Ajax 액세스를 사용한 서비스 플로우입니다. 보기를 목록 오브젝트에 바인드하는 대신 이 옵션을 사용할 수 있습니다. 팁: 목록 항목 서비스는 두 개의 변수를 사용합니다. 하나는 이름이 `data`인 `string` 유형의 입력 변수이고, 다른 하나는 이름이 `results`인 `list` 유형의 출력 변수입니다. 이는 결과를 보기에 바인드된 데이터로 출력합니다. 출력 변수 이름이 목록 항목 서비스의 `results`가 아닌 경우, 사용할 수 있는 값이 없습니다.	서비스 플로우
서비스 입력 데이터	선택 목록을 채우는 서비스 플로우에 전달되는 입력 데이터를 제공하는 비즈니스 오브젝트입니다. 이 옵션은 항목 검색 모드가 서비스의 항목인 경우 사용됩니다.	전체
입력 데이터 변경 무시	서비스 입력 데이터가 변경될 때 자동 서비스 호출을 사용 불가능하게 합니다. 이 옵션은 항목 검색 모드가 서비스의 항목으로 설정된 경우에만 사용됩니다.	`Boolean`
항목 입력 데이터	선택 목록을 채우는 비즈니스 오브젝트 목록입니다. 이 특성은 항목 검색 모드가 구성 옵션의 항목인 경우에만 사용됩니다.	ANY []
항목 선택 데이터	표시 특성 필드에서 선택 목록에 표시할 비즈니스 오브젝트 특성을 설정하십시오. 데이터 맵핑 특성에 값이 지정되지 않은 경우 기본값은 값 특성의 경우 `name` 이고 표시 특성의 경우 `value` 입니다.	`SelectDataMapping`
출력 비즈니스 데이터	보기가 복합 유형에 바인드된 경우 사용자가 선택하는 특성은 표시 특성에 지정된 특성 및 보기에 바인드된 특성으로 전달됩니다.	`SelectDataMapping`
정적 목록	선택사항 목록을 채울 항목의 정적 목록입니다. 정적 목록에만 이 옵션을 사용하십시오. 이 옵션에 변수를 지정하지 마십시오. 변수 목록으로 구성 옵션의 항목 검색 모드를 사용하십시오.	NameValuePair[]

예: 정적 목록의 항목

레이블이 Grocery list 인 다중 선택 보기가 있고 선택한 항목 검색 모드 가 정적 목록의 항목입니다. 정적 목록에서 다음 이름 값 쌍을 정의했습니다.

표 4. 정적 목록
이름	값
1	우유
2	빵
3	Bananas
4	라이스

다음 결과가 표시됩니다.

예제: 비즈니스 오브젝트를 사용하여 항목 채우기

이 예제에서는 선택 목록에서 이름 목록을 채우기 위해 고객 비즈니스 오브젝트를 사용합니다. 사용자가 여러 이름을 선택하면 대응하는 레코드가 테이블에 표시됩니다.

고객 비즈니스 오브젝트의 구조는 다음과 같습니다.

문자열 유형의 매개변수입니다.
문자열 유형의 매개변수입니다.
문자열 유형의 매개변수입니다.

고객 비즈니스 오브젝트의 기본값은 다음과 같습니다.

var autoObject = [];
autoObject[0] = {};
autoObject[0].ID = "000";
autoObject[0].firstName = "Pierre";
autoObject[0].lastName = "de Fermat";
autoObject[1] = {};
autoObject[1].ID = "001";
autoObject[1].firstName = "Isaac";
autoObject[1].lastName = "Newton";
autoObject[2] = {};
autoObject[2].ID = "002";
autoObject[2].firstName = "John";
autoObject[2].lastName = "Venn";
autoObject

클라이언트 측 사용자 서비스에는 유형의 개인용 변수 outputList 가 있습니다. Output 유형에는 와 라는 두 개의 문자열 매개변수가 있다. 다중 선택 보기는 보기의 데이터 출력을 포함하는 outputList에 바인드됩니다.

페이지에는 다음과 같은 특성이 포함된 다중 선택 보기가 있습니다.

일반에서 바인딩 을 outputList로 설정하십시오.
구성 > 항목아래에서 항목 검색 모드 를 로 설정하십시오.
구성 > 항목아래에서 항목 입력 데이터 를 로 설정하십시오.
구성 > 항목 > 항목 선택 데이터아래에서 다음을 수행하십시오.
- 값 특성에 대해 다음을 지정하십시오.
- 표시 특성에 대해 다음을 지정하십시오.
구성 > 항목 > 출력 비즈니스 데이터아래에서 다음을 수행하십시오.
- 값 특성에 대해 다음을 지정하십시오.
- 표시 특성에 대해 다음을 지정하십시오.

테이블 보기는 다음과 같은 특성을 갖습니다.

두 개의 열 제목 및
일반아래에서 레이블 은 로 설정됩니다.
일반아래에서 바인딩 은 로 설정됩니다.

팁: 테이블을 빠르게 작성하려면 outputList 변수를 페이지로 끌어오십시오.

다음은 런타임 시 결과입니다.

다음은 여러 항목을 선택한 후의 결과입니다.

선택하는 값은 Value2 열에 표시되며, 이 열은 출력 비즈니스 데이터아래의 표시 특성 옵션에 지정된 특성입니다. 특성은 값에 의해 전달됩니다. 표시 특성으로 입력하면 선택한 이름이 Value1 열에 표시됩니다.

이벤트

이벤트 특성에서 보기에 대한 이벤트 핸들러를 설정하거나 수정하십시오. 사용자가 보기로 상호작용할 때 또는 프로그래밍 방식으로 트리거되도록 이벤트를 설정할 수 있습니다. 이벤트를 정의하고 코딩하는 방법에 대한 정보는 사용자 정의 이벤트를 참조하십시오.

다중 선택 보기에는 다음과 같은 유형의 이벤트 핸들러가 있습니다.

: 페이지가 로드될 때 활성화됩니다. 예를 들어,
: 바인드된 데이터가 변경될 때 활성화됩니다. 예를 들어,
: 서비스 플로우가 항목 목록을 리턴할 때 활성화됩니다. 항목 검색 모드가 서비스의 항목으로 설정되는 경우에만 활성화됩니다.
: 서비스 플로우가 서비스 오류를 리턴할 때 활성화됩니다. 항목 검색 모드가 서비스의 항목으로 설정되는 경우에만 활성화됩니다.

특정 이벤트에 따라 JavaScript 로직을 사용하여 보기의 효과를 수정할 수 있습니다. 보기에서 이벤트 사용에 대한 자세한 정보는 사용자 정의 이벤트주제에 있습니다.

메소드

다중 선택의 사용 가능한 메소드에 대한 자세한 정보는 다중 선택 JavaScript API 를 참조하십시오.

추가 자원

Coach 또는 페이지를 작성하는 방법에 대한 정보는 Coach 빌드를 참조하십시오.
표준 특성 (일반, 구성, 위치 지정, 가시성및 HTML 속성) 에 대한 정보는 특성 보기를 참조하십시오.