Power Apps의 갤러리 컨트롤

다른 컨트롤을 포함하고 데이터 집합을 보여주는 컨트롤입니다.

설명

갤러리 컨트롤에서는 데이터 원본의 여러 레코드를 표시할 수 있으며 각 레코드에는 다양한 유형의 데이터가 포함될 수 있습니다. 예를 들어, 갤러리 컨트롤을 사용하여 여러 연락처를 보여줄 수 있으며, 각 항목은 각 연락처에 대한 이름, 주소, 전화 번호를 포함한 연락처 정보를 보여줍니다.

각 데이터 필드는 갤러리 컨트롤 내의 개별 컨트롤에 나타납니다. 템플릿에서 해당 컨트롤을 구성할 수 있습니다. 템플릿은 갤러리 내에서 첫 번째 항목으로 나타납니다.

  • 세로/가로 방향에서 갤러리 컨트롤의 왼쪽 가장자리.
  • 그리고 세로/가로 방향에서 상단에 갤러리 컨트롤의 위.

템플릿에 적용한 변경 사항은 갤러리 컨트롤 전체에서 반영됩니다.

가변 높이 항목이 포함된 갤러리 및 이미지, 텍스트를 보여주는 사전 정의된 템플릿을 사용 가능합니다.

제한 사항

  • 모든 항목이 로드되기 전에 사용자가 유연한 높이 갤러리 컨트롤을 스크롤하면, 로딩이 완료된 후 현재 보고 있는 항목이 아래로 밀리고 보이지 않을 수 있습니다. 이 문제를 피하려면 유연한 높이 변수 대신 일반 갤러리 컨트롤을 사용합니다.
  • 다음 컨트롤은 갤러리 내에서 지원되지 않습니다.
  • 다른 갤러리 안에 하나의 갤러리만 추가할 수 있습니다.
  • 최소 TemplateSize는 1입니다. 이로 인해 템플릿 크기를 고려하지 않을 때 갤러리의 컨트롤이 예상 X 또는 Y 값에서 벗어날 수 있습니다.

키 속성

Default – 앱이 시작하면 갤러리에서 선택할 데이터 원본의 항목 또는 레코드입니다.

Items – 갤러리, 목록 또는 차트 등의 컨트롤에서 나타나는 데이터 원본입니다.

Selected – 선택한 항목입니다.

추가 속성

AccessibleLabel – 스크린 리더용 갤러리(항목 미포함) 레이블입니다. 항목 목록의 개념을 설명해야 합니다.

AllItems – 갤러리에 로드된 항목입니다. 이것은 데이터 원본의 실제 항목 수보다 적을 수 있습니다. 갤러리를 스크롤하면 더 많은 항목이 로드될 수 있습니다. AllItems에는 각 갤러리 항목에 사용되는 컨트롤도 포함되어 있습니다.

AllItemsCount - 갤러리에 로드된 항목 수입니다. 이것은 데이터 원본의 실제 항목 수보다 적을 수 있습니다. 갤러리를 스크롤하면 더 많은 항목이 로드될 수 있습니다.

BorderColor – 컨트롤의 테두리 색입니다.

BorderStyle – 컨트롤의 테두리는 Solid, Dashed, Dotted, None입니다.

BorderThickness – 컨트롤의 테두리 굵기입니다.

DelayItemLoading - 화면이 처음 로드될 때까지 항목(행)의 로딩을 지연시킵니다.

DisplayMode – 컨트롤이 사용자 입력을 허용(편집)하거나, 데이터만 표시(보기)하거나 사용 안 하도록(사용 안 함) 설정할지 선택합니다.

Fill – 컨트롤의 배경색입니다.

Height – 컨트롤의 위쪽 및 아래쪽 가장자리 사이의 간격입니다.

ItemAccessibleLabel – 스크린 리더를위 한 각 갤러리 항목의 레이블입니다. 각 항목이 무엇인지 설명해야 합니다.

LoadingSpinner (없음, 컨트롤 또는 데이터 )- 없음인 경우 스피너가 표시되지 않습니다. 컨트롤 | 보이는 빈 행을 발생시키는 렌더링 패스가 나타날 때 데이터, 스피너가 보여집니다.

LoadingSpinnerColor - 로딩 스피너의 채우기 색상입니다. 기본값은 BorderColor로 설정됩니다.

NavigationStepShowNavigation 속성이 true로 설정되어 있고 사용자가 해당 갤러리 한쪽 끝에서 탐색 화살표를 선택할 경우 갤러리를 스크롤하는 정도입니다.

Selectable – 갤러리 항목을 선택할 수 있는지 여부입니다. true로 설정하면 화면 판독기는 갤러리를 선택 가능한 목록으로 식별합니다. 그러면 항목을 선택할 수 있습니다. false로 설정하면 화면 판독기는 갤러리를 일반 목록으로 식별하며 항목을 선택해도 선택되지 않습니다.

ShowNavigation – 사용자가 화살표를 선택하여 갤러리에서 항목을 스크롤할 수 있도록 갤러리의 각 끝에 화살표를 나타낼지 여부를 선택합니다.

ShowScrollbar – 사용자가 갤러리를 마우스로 가리킬 때 스크롤바를 나타낼지 여부를 선택합니다.

TemplateFill – 갤러리의 배경색입니다.

TemplatePadding – 갤러리에서 항목 사이의 거리입니다.

TemplateSize – 세로/세로 방향에서 갤러리의 템플릿 높이입니다. 또는 가로/landscape 방향에서 갤러리의 템플릿 너비입니다. 최소 크기는 1입니다.

Transition – 사용자가 갤러리의 항목을 가리킬 때 나타나는 시각 효과입니다(, 푸시 또는 없음).

Visible – 컨트롤을 표시하거나 숨길지 여부를 선택합니다.

Width – 컨트롤의 왼쪽 및 오른쪽 가장자리 사이의 간격입니다.

WrapCount – 가로 또는 세로 레이아웃에 따라 각 행 또는 열당 표시되는 항목 수입니다.

X – 컨트롤의 왼쪽 가장자리와 부모 컨테이너 또는 화면의 왼쪽 가장자리 사이의 거리입니다.

Y – 컨트롤의 위쪽 가장자리와 부모 컨테이너 또는 화면의 위쪽 가장자리 사이의 거리입니다.

Filter( DataSource, Formula )

Reset( Control ) - 갤러리를 초기 상태로 다시 설정합니다. 초기 상태는 첫 번째 항목으로 스크롤하고 첫 번째 항목을 선택하거나 존재하는 경우 기본값을 포함합니다.

참고

Reset 컨트롤은 갤러리의 모든 자식을 재귀적으로 초기화하지 않습니다.

예제

데이터 표시 및 필터링

사용자로부터 데이터 가져오기

접근성 지침

색 대비

갤러리 항목의 아무 곳이나 클릭하면 선택되어야 하는 경우 다음 사이에 적절한 색 대비가 있어야 합니다.

  • BorderColor 및 갤러리 외부 색(테두리가 있는 경우).
  • Fill 및 갤러리 외부 색(테두리가 없는 경우).

스크린 리더 지원

  • AccessibleLabel이 있어야 합니다.

    참고

    갤러리의 항목이 변경되면 화면 읽기 프로그램이 이를 알립니다. AccessibleLabel도 언급됩니다. 이 언급은 알림에 대한 컨텍스트를 제공하고 동일한 화면에 여러 개의 갤러리가 있는 경우 더욱 중요합니다.

  • 갤러리 항목에 여러 컨트롤이 포함된 경우 ItemAccessibleLabel을 사용해 갤러리 항목의 내용을 표시합니다.

  • 사용자가 갤러리 항목을 선택하기 원한다면 Selectable의 값을 true로 설정합니다. 그렇지 않으면 해당 값을 false로 설정합니다.

  • 갤러리 항목에 여러 컨트롤이 포함된 경우 ItemAccessibleLabel을 사용해 갤러리 항목의 콘텐츠 요약을 제공합니다.

  • Selectable은 사용자가 갤러리 항목을 선택해야 하는지 여부에 따라 적절하게 설정해야 합니다.

키보드 지원

  • ShowScrollbartrue로 설정하는 것이 좋습니다. 대부분의 터치 스크린 디바이스에서 스크롤 막대는 스크롤이 시작될 때까지 표시되지 않습니다.

  • 갤러리 항목의 아무 곳이나 클릭하면 선택되어야 하는 경우에는 키보드 사용자가 갤러리 항목을 선택할 수 있는 방법도 있어야 합니다. 예를 들어 OnSelect 속성이 Select(Parent) 로 설정된 버튼를 추가합니다.

    참고

    갤러리 외부의 컨트롤은 갤러리 내의 키보드 탐색 순서에서 고려되지 않습니다. 갤러리 내부 컨트롤의 TabIndex는 범위가 지정됩니다. 자세한 내용은 접근성 속성을 참조하십시오.

참조

DelayItemLoading 및 Loading 회전자를 사용하여 갤러리의 성능 향상

참고

귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)

이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).