Pivot ตัวควบคุม

ตัวควบคุมที่ใช้ในการนำทาง

หมายเหตุ

รหัสแหล่งที่มาของส่วนประกอบและข้อมูลเพิ่มเติมใน ที่เก็บส่วนประกอบของโค้ด GitHub

Description

การควบคุม Pivot และแท็บที่เกี่ยวข้องใช้สำหรับการนำทางหมวดหมู่เนื้อหาที่แตกต่างกันซึ่งเข้าถึงบ่อย Pivot ช่วยให้สามารถนำทางไปมาระหว่างมุมมองเนื้อหาตั้งแต่สองมุมมองขึ้นไป และอาศัยส่วนหัวของข้อความเพื่อกำหนดส่วนต่างๆ ของเนื้อหาให้ชัดเจน

ส่วนประกอบของโค้ดนี้จัดเตรียมแรปเปอร์รอบตัวควบคุม Fluent UI Pivot เพื่อใช้ในแอปพื้นที่ทำงานและหน้าแบบกำหนดเอง

คุณสมบัติ

คุณสมบัติที่สำคัญ

คุณสมบัติ	Description
RenderType	ชนิดของตัวควบคุมที่จะแสดงผลเป็น
SelectedKey	คีย์ที่จะเลือก สิ่งนี้จะได้รับการอัปเดตผ่านทางเหตุการณ์ OnChange เมื่อผู้ใช้โต้ตอบกับตัวควบคุม
Items	รายการการดำเนินการที่จะแสดง

Itemsคุณสมบัติ

แต่ละรายการใช้สคีมาต่อไปนี้ เพื่อแสดงภาพข้อมูลในองค์ประกอบ

Name	Description
ItemDisplayName	ชื่อที่แสดงของรายการ nav
ItemKey	คีย์ที่ใช้ระบุรายการที่เลือก และเมื่อเพิ่มรายการย่อย คีย์ต้องไม่ซ้ำกัน
ItemEnabled	ตั้งค่าเป็นเท็จ หากปิดใช้งานตัวเลือก
ItemVisible	ตั้งค่าเป็นเท็จ หากตัวเลือกไม่ปรากฎ
ItemChecked	ตั้งค่าเป็นจริง หากเลือกตัวเลือกนี้ (เช่น ปุ่มแยกในแถบคำสั่ง)
ItemIconName	ไอคอน Fluent UI ที่จะใช้ (ดู ไอคอน Fluent UI)
ItemCount	แสดงจำนวนรายการบนลิงก์รายการ Pivot

ตัวอย่าง:

Table(
  {
      ItemKey: "tabFile",
      ItemDisplayName: "File"
  },
  {
      ItemKey: "tabHome",
      ItemDisplayName: "Home"
  },
  {
      ItemKey: "tabView",
      ItemDisplayName: "View"
  },
  {
      ItemKey: "tabAction",
      ItemDisplayName: "Action"
  }
)

คุณสมบัติ Style

คุณสมบัติ	Description
Theme	ยอมรับสตริง JSON ที่สร้างขึ้นโดยใช้ ตัวออกแบบธีม Fluent UI (windows.net) การเว้นว่างไว้จะใช้ธีมเริ่มต้นที่กำหนดโดย Power Apps ดูที่ ชุดรูปแบบ สำหรับความช่วยเหลือเกี่ยวกับวิธีกำหนดค่า
RenderSize	ตัวควบคุม pivot สามารถแสดงผลได้สองขนาด (ใหญ่/ปกติ)
AccessibilityLabel	ป้ายชื่อ aria สำหรับโปรแกรมอ่านหน้าจอ

คุณสมบัติ Event

คุณสมบัติ	Description
InputEvent	เหตุการณ์ที่ส่งตัวควบคุม เช่น SetFocus ดูด้านล่างนี้

พฤติกรรม

รองรับ SetFocus เป็น InputEvent

กำหนดค่าลักษณะการทำงานของแท็บ

ประสานงานหน้าแท็บ โดยเชื่อมโยงคุณสมบัติ Visible ของส่วนประกอบที่ขึ้นต่อกันในแอปของคุณ (เช่น คอนเทนเนอร์ที่แสดงหน้า) ที่มีค่า Pivot1.Selected.ItemKey

คุณสมบัติ Visible ของการควบคุมที่ขึ้นต่อกัน ที่แสดงเมื่อ tabFile itemKey ถูกเลือก:

Pivot1.Selected.ItemKey = "tabFile"

ข้อจำกัด

ส่วนประกอบโค้ดนี้ใช้ได้เฉพาะในแอปพื้นที่ทำงานและหน้าที่กำหนดเองเท่านั้น

ดูหมายเหตุข้อจำกัดเพิ่มเติมในส่วน ความท้าทายในการออกแบบ ของคู่มือ GitHub