แชร์ผ่าน


Pivot ตัวควบคุม

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

หมายเหตุ

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

การควบคุม Pivot

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