Udostępnij przez


Omówienie elementu struktury

Rozszerzenia Fabric są tworzone wokół podstawowej koncepcji elementów. Każde obciążenie w usłudze Microsoft Fabric składa się z co najmniej jednego typu elementów, które użytkownicy mogą tworzyć, konfigurować i z którymi mogą wchodzić w interakcję za pośrednictwem standardowych edytorów.

Architektura oparta na elementach

Wszystkie zadania w Fabric korzystają ze spójnej struktury opartej na pojedynczych elementach:

  • Elementy to podstawowe bloki konstrukcyjne tworzone przez użytkowników i zarządzane w obszarach roboczych
  • Edytory udostępniają interfejs umożliwiający użytkownikom konfigurowanie elementów i pracę z elementami
  • Składniki to ustandaryzowane bloki konstrukcyjne tworzące edytory

Struktura elementów

Każdy element sieci fabric składa się z pięciu kluczowych składników:

- Model elementów (ItemModel.ts)

Definiuje strukturę danych i właściwości reprezentujące konfigurację i stan elementu, który jest przechowywany w Fabric.

- Edytor elementów (ItemEditor.tsx)

Główny interfejs, w którym użytkownicy wchodzą w interakcję z elementem. Zbudowany przy użyciu domyślnych składników Fabric w celu zapewnienia spójności.

- Pusty widok (ItemEditorEmpty.tsx)

Początkowe doświadczenie podczas pierwszego tworzenia elementu przez użytkowników, zapewniając wskazówki dotyczące wdrażania i konfigurowania.

- Widok szczegółów (ItemEditorDetail.tsx)

Udostępnia nawigację zagłębiającą się oraz szczegółowe widoki dla złożonych konfiguracji elementów oraz hierarchicznej zawartości.

- Akcje wstążki (ItemEditorRibbon.tsx)

Akcje paska narzędzi, które użytkownicy mogą wykonywać na elemencie, takie jak zapisywanie, ustawienia i operacje niestandardowe.

Domyślne składniki edytora

Sieć szkieletowa udostępnia ustandaryzowane składniki, które zapewniają spójność we wszystkich obciążeniach:

Podstawowe składniki edytora

  • ItemEditor: kontener główny z automatycznym zarządzaniem układem
  • ItemEditorDefaultView: układy dwóch paneli z rozdzielaczami z możliwością zmiany rozmiaru
  • ItemEditorDetailView: nawigacja w scenariuszach przechodzenia do szczegółów
  • ItemEditorEmptyView: ustandaryzowane doświadczenie pierwszego uruchomienia

System paneli

  • Lewy panel: nawigacja, eksploratory plików, widoki OneLake
  • Panel środkowy: główny obszar zawartości z automatycznym przewijaniem
  • Panele zwijane: dynamiczne układy z obsługą ułatwień dostępu

System wstążki

  • Pasek narzędzi strony głównej: standardowe akcje, takie jak zapisywanie i ustawienia
  • Dodatkowe paski narzędzi: akcje niestandardowe specyficzne dla typu elementu
  • Integracja podpowiedzi: spójne wzorce doświadczenia użytkownika

Zalety struktury elementów

Spójność: użytkownicy uzyskują znane środowisko we wszystkich obciążeniach Fabric.

Ułatwienia dostępu: wbudowana obsługa nawigacji za pomocą klawiatury i czytników zawartości ekranu

Dynamiczny projekt: automatyczne korekty układu dla różnych rozmiarów ekranu

Integracja: bezproblemowe połączenie z funkcjami platformy Fabric, takimi jak OneLake, przeszłość danych i uprawnienia

Podejście programistyczne

Podczas budowania rozszerzeń Fabric:

  • Zacznij od modelu elementów — zdefiniuj dane, które będą przechowywane przez element
  • Używanie domyślnych składników — Wykorzystaj standardowe składniki edytora Fabric
  • Postępuj zgodnie z ustalonymi wzorcami — spójnie implementuj akcje wstążki, układy panelu i nawigację
  • Dostosowywanie zawartości — wypełnij ustandaryzowaną strukturę przy użyciu funkcji specyficznych dla obciążenia

Najważniejsze zasady

  • Ponowne użycie komponentów: użyj domyślnych komponentów Fabric zamiast tworzenia niestandardowych interfejsów
  • Wzorce standardowe: postępuj zgodnie z ustalonymi wzorcami nawigacji, układu i interakcji
  • Integracja platformy: wykorzystywanie wbudowanych funkcji Fabric do magazynowania, zabezpieczeń i zarządzania
  • Znajomość użytkownika: zachowanie spójności z szerszym środowiskiem użytkownika sieci szkieletowej

Dalsze kroki

Aby zaimplementować pozycje w swoim obciążeniu:

Aby uzyskać szczegółową dokumentację składników, zobacz dokumentację ItemEditor.