Galleri kontroll i appar för arbets ytorGallery control in canvas apps

En kontroll som innehåller andra kontroller och visar en datauppsättning.A control that contains other controls and shows a set of data.

BeskrivningDescription

En gallerikontroll kan visa flera poster från en datakälla och varje post kan innehålla flera typer av data.A Gallery control can show multiple records from a data source, and each record can contain multiple types of data. Till exempel en gallerietkontroll kan visa flera kontakter med varje objekt som visar kontaktinformation som innehåller ett namn, en adress och ett telefonnummer för varje kontakt.For example, a Gallery control can show multiple contacts with each item showing contact information that includes a name, an address, and a phone number for each contact. Varje fält som visas i en separat kontroll i den gallerikontrollen så kan du konfigurera dessa kontroller i mallen.Each data field appears in a separate control within the Gallery control, and you can configure those controls in its template. Mallen visas som det första objektet i galleriet på vänster sida av en vågrät/liggande gallerikontroll och längst upp i en lodrät/stående gallerikontroll .The template appears as the first item inside the gallery, on the left edge of a Gallery control in horizontal/landscape orientation and at the top of a Gallery control in vertical/portrait orientation. Alla ändringar du gör i mallen visas i hela gallerikontrollen.Any changes that you make in the template are reflected throughout the Gallery control.

Fördefinierade mallar för att visa bilder och text i ett galleri är tillgängliga, samt ett galleri för objekt med varierande höjd.Predefined templates for showing images and text in a gallery are available, as well as a gallery for variable-height items.

BegränsningarLimitations

Om en användare rullar den flexibla höjd Galleri kontrollen innan alla objekt läses in, kan det objekt som för närvarande är i vyn flyttas ned och ut ur vyn när data inläsningen är färdig.If a user scrolls the Flexible height gallery control before all items are loaded, the item that's currently in view may be pushed down and out of view when the data loading is finished. Undvik det här problemet genom att använda en standard Galleri kontroll i stället för den flexibla höjden .To avoid this issue, use a standard Gallery control instead of the Flexible height variant.

NyckelegenskaperKey properties

Default – Den artikel eller post i datakällan som ska väljas i galleriet när appen startas.Default – The item or record from the data source to be selected in the gallery when the app starts up.

Items – Datakällan som visas i en kontroll, t.ex ett galleri, en lista eller ett diagram.Items – The source of data that appears in a control such as a gallery, a list, or a chart.

Selected – Det markerade objektet.Selected – The selected item.

Ytterligare egenskaperAdditional properties

AccessibleLabel – etikett för galleriet (inte objekten det innehåller) för skärm läsare.AccessibleLabel – Label of the gallery (not the items it contains) for screen readers. Bör beskriva vad listan med objekt är.Should describe what the list of items are.

AllItems – Alla objekt i ett galleri, inklusive ytterligare kontrollvärden som är en del av galleriets mall.AllItems – All items in a gallery, including additional control values that are a part of the gallery's template.

BorderColor – En kontrolls kantlinjefärg.BorderColor – The color of a control's border.

BorderStyle – Om en kontrolls kantlinje är solid, streckad, prickad eller ingen.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – Tjockleken på en kontrolls kantlinje.BorderThickness – The thickness of a control's border.

DisplayMode – Om kontrollen tillåter indata från användaren (Redigera), bara visar data (Visa) eller är inaktiverad (Inaktiverad).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

Fill – Bakgrundsfärgen i en kontroll.Fill – The background color of a control.

Height – Avståndet mellan kontrollens övre och nedre kanter.Height – The distance between a control's top and bottom edges.

ItemAccessibleLabel – etikett för varje Galleri objekt för skärm läsare.ItemAccessibleLabel – Label of each gallery item for screen readers. Bör beskriva vad varje objekt är.Should describe what each item is.

NavigationStep – hur långt ett galleri rullar om egenskapen ShowNavigation är inställd på sant och användaren väljer en navigationspil i början eller slutet av galleriet.NavigationStep – How far a gallery scrolls if its ShowNavigation property is set to true and the user selects a navigation arrow at either end of that gallery.

Kan väljas – om Galleri objekt kan väljas.Selectable – Whether gallery items can be selected. När det är inställt på Trueidentifierar skärm läsaren galleriet som en valbar lista och du väljer ett objekt genom att klicka eller trycka på det.When set to true, screen readers identify the gallery as a selectable list, and you select an item by clicking or tapping it. Om det är inställt på falsktidentifierar skärm läsare galleriet som en vanlig lista, och om du klickar eller trycker på ett objekt markeras det inte.When set to false, screen readers identify the gallery as a regular list, and clicking or tapping an item doesn't select it.

ShowNavigation – om en pil visas i slutet av ett galleri så att en användare kan bläddra igenom objekten i galleriet genom att klicka eller trycka på en pil.ShowNavigation – Whether an arrow appears at each end of a gallery so that a user can scroll through the items in the gallery by clicking or tapping an arrow.

ShowScrollbar – en rullningslist visas när användaren håller muspekaren över ett galleri.ShowScrollbar – Whether a scrollbar appears when the user hovers over a gallery.

Snap – om, när användaren rullar genom ett galleri, det fästs automatiskt så att nästa objekt visas i sin helhet.Snap – Whether, when a user scrolls through a gallery, it automatically snaps so that the next item appears in full.

TemplateFill – Bakgrundsfärgen i ett galleri.TemplateFill – The background color of a gallery.

TemplatePadding – avståndet mellan objekten i ett galleri.TemplatePadding – The distance between items in a gallery.

TemplateSize – höjden på mallen för ett galleri i lodrätt/stående läge eller bredden på mallen för ett vågrätt/liggande galleri.TemplateSize – The height of the template for a gallery in vertical/portrait orientation or the width of the template for a gallery in horizontal/landscape orientation.

Transition – den visuella effekt (Pop, Push eller None) när användaren håller muspekaren över ett objekt i ett galleri.Transition – The visual effect (Pop, Push, or None) when the user hovers over an item in a gallery.

Visible – Om en kontroll visas eller är dold.Visible – Whether a control appears or is hidden.

Width – Avståndet mellan kontrollens högra och vänstra kanter.Width – The distance between a control's left and right edges.

WrapCount – antal objekt som visas per rad eller kolumn baseras på vågrät eller lodrät layout.WrapCount – Number of items shown per row or column based on horizontal or vertical layout.

X – Avståndet mellan kontrollens vänstra kant och den överordnade containerns vänstra kant (skärmen om det inte finns någon överordnad container).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – Avståndet mellan kontrollens övre kant och den överordnade containerns övre kant (skärmen om det inte finns någon överordnad container).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

Filter( DataSource; Formula )Filter( DataSource; Formula )

ExempelExamples

Visa och filtrera dataShow and filter data

Hämta data från användarenGet data from the user

Riktlinjer för hjälpmedelAccessibility guidelines

FärgkontrastColor contrast

Om klickning någonstans i ett galleriobjekt är till för att välja det, måste det finnas tillräckligt färgkontrast mellan:If clicking anywhere in a gallery item is meant to select it, there must be adequate color contrast between:

  • BorderColor och färg utanför galleriet (om det finns en kantlinje)BorderColor and the color outside the gallery (if there is a border)
  • Fyllning och färg utanför galleriet (om det inte finns en kantlinje)Fill and the color outside the gallery (if there is no border)

Stöd för skärmläsarenScreen reader support

  • AccessibleLabel måste finnas.AccessibleLabel must be present.

    Anteckning

    Skärm läsare meddelar när objekt i galleriet ändras.Screen readers will announce when items in the gallery change. AccessibleLabel anges också.The AccessibleLabel is also mentioned. Detta ger kontext till meddelandet och är även viktigare när det finns flera gallerier på samma skärm.This gives context to the announcement and is even more important when there are multiple galleries on the same screen.

  • När ett galleri objekt innehåller flera kontroller använder du ItemAccessibleLabel för att sammanfatta Galleri objektets innehåll.When a gallery item contains multiple controls, use ItemAccessibleLabel to summarize the gallery item's contents.

  • Ange värdet för Selectable till True om du vill att användarna ska välja ett galleri objekt.Set the value of Selectable to true if you want users to select a gallery item. Annars anger du värdet till falskt.Otherwise, set that value to false.

  • När ett galleri objekt innehåller flera kontroller, använder du ItemAccessibleLabel för att ange en sammanfattning av Galleri objektets innehåll.When a gallery item contains multiple controls, use ItemAccessibleLabel to provide a summary of the gallery item's contents.

  • Selectable ska ställas in på rätt sätt, beroende på om användarna är avsedda att välja ett galleri objekt.Selectable should be set appropriately, depending on whether users are meant to select a gallery item.

TangentbordsstödKeyboard support

  • Överväg att ställa in ShowScrollbar till SANT.Consider setting ShowScrollbar to true. Rullningslisten visas inte på de flesta pekskärmsenheter förrän du börjar rulla.On most touch screen devices, the scrollbar will not show until scrolling begins.

  • Om klickning någonstans i ett galleriobjekt är avsett för att välja det, måste det också finnas ett sätt för tangentbordsanvändare att välja galleriobjektet.If clicking anywhere in a gallery item is meant to select it, there must also be way for keyboard users to select the gallery item. Till exempel att lägga till en Knapp som har sin OnSelect-egenskap inställd på Select(Parent) .For example, adding a Button that has its OnSelect property set to Select(Parent).

    Anteckning

    Kontroller utanför galleriet beaktas inte i ordningen för tangentbordsnavigeringen i galleriet.Controls outside the gallery are not considered in the keyboard navigation order within the gallery. TabIndex för kontroller i ett galleri är begränsade.TabIndex of controls inside a gallery are scoped. Läs mer i egenskaper för hjälpmedel.See accessibility properties to learn more.