Zugängliche Komponenten: Paginierung

Heute werden wir sehen, wie man eine Paginierung von Grund auf erstellt und sie zugänglich und wiederverwendbar macht. Ich hoffe, es hilft dir und hinterlasse mir deine Kommentare am Ende des Beitrags!

Github: https://github.com/micaavigliano/accessible-pagination
Projekt: https://accessible-pagination.vercel.app/

Benutzerdefinierter Hook zum Abrufen von Daten

const useFetch = <T,>(url: string, currentPage: number = 0, pageSize: number = 20) => {
  const [data, setData] = useState<T | null>(null);
  const [loading, setLoading] = useState<boolean>(true);
  const [error, setError] = useState<boolean>(false);

  useEffect(() => {
    const fetchData = async() => {
      setLoading(true);
      setError(false);

      try {
        const response = await fetch(url);
        if (!response.ok) {
          throw new Error('network response failed')
        }
        const result: T = await response.json() as T;
        setData(result)
      } catch (error) {
        setError(true)
      } finally {
        setLoading(false);
      }
    };

    fetchData()
  }, [url, currentPage, pageSize]);

  return {
    data,
    loading,
    error,
  }
};

1. Wir werden einen benutzerdefinierten Hook mit einem generischen Typ generieren. Dadurch können wir die Art der Daten angeben, die bei Verwendung dieses Hooks erwartet werden
2. Warten wir auf 3 Parameter. Eine für url, wo wir die Daten abrufen werden, currentPage, die die Seite ist, auf der wir uns befinden und standardmäßig 0 ist, und pageSize, die die Zahl ist von Elementen, die Wir werden es pro Seite haben und standardmäßig sind es 20 (Sie können diesen Wert ändern).
3. In unserem Zustand const [data, setData] = useState(null); Wir übergeben ihm den generischen Typ T, da wir bei der Verwendung für verschiedene Datenanfragen unterschiedliche Datentypen erwarten.

Pagination

Damit eine Seite zugänglich ist, müssen wir die folgenden Punkte berücksichtigen:

• Der Fokus muss sich durch alle interaktiven Elemente der Seite bewegen und einen sichtbaren Indikator haben
• Um eine gute Interaktion mit Screenreadern zu gewährleisten, müssen wir Regionen, Eigenschaften und Zustände korrekt verwenden
• Die Seite muss innerhalb eines Tags gruppiert sein und ein Aria-Label enthalten, das sie als Seite per se identifiziert.
• Jedes Element innerhalb der Paginierung muss eine Aria-Setsize und ein Aria-Pointset enthalten. Nun, wozu dienen sie? Nun, aria-setsize wird verwendet, um die Gesamtzahl der Elemente in der Paginierungsliste zu berechnen. Der Screenreader kündigt es wie folgt an:

aria-pointset wird verwendet, um die Position des Elements innerhalb aller Elemente auf der Seite zu berechnen. Der Screenreader kündigt es wie folgt an:

• Jedes Element muss über ein Aria-Label verfügen, um identifizieren zu können, zu welcher Seite wir gehen, wenn wir auf diese Schaltfläche klicken.
• Verfügen über Schaltflächen, um zum nächsten/vorherigen Element zu wechseln, und jede dieser Schaltflächen muss über eine entsprechende Arienbezeichnung verfügen
• Wenn unsere Paginierung Auslassungspunkte enthält, muss diese korrekt mit einem Arien-Label gekennzeichnet sein
• Jedes Mal, wenn wir eine neue Seite aufrufen, muss der Screenreader wie folgt ankündigen, auf welcher Seite wir uns befinden und wie viele neue Elemente es gibt.

Um dorthin zu gelangen, werden wir es wie folgt codieren:

const useFetch = <T,>(url: string, currentPage: number = 0, pageSize: number = 20) => {
  const [data, setData] = useState<T | null>(null);
  const [loading, setLoading] = useState<boolean>(true);
  const [error, setError] = useState<boolean>(false);

  useEffect(() => {
    const fetchData = async() => {
      setLoading(true);
      setError(false);

      try {
        const response = await fetch(url);
        if (!response.ok) {
          throw new Error('network response failed')
        }
        const result: T = await response.json() as T;
        setData(result)
      } catch (error) {
        setError(true)
      } finally {
        setLoading(false);
      }
    };

    fetchData()
  }, [url, currentPage, pageSize]);

  return {
    data,
    loading,
    error,
  }
};

Wenn die Seite nicht mehr geladen wird, legen wir eine neue Nachricht mit unserer aktuellen Seite und der Länge des neuen Arrays fest, das wir laden.

Jetzt ja! Schauen wir uns an, wie der Code in der Datei pagination.tsx

aufgebaut ist

Für die Komponente sind fünf Requisiten erforderlich

const [statusMessage, setStatusMessage] = useState<string>("");

useEffect(() => {
    window.scrollTo({ top: 0, behavior: 'smooth' });
    if (!loading) {
      setStatusMessage(`Page ${currentPage} loaded. Displaying ${data?.near_earth_objects.length || 0} items.`);
    }
  }, [currentPage, loading]);

• currentPage verweist auf die aktuelle Seite. Wir werden dies umgehen, indem wir uns in der Komponente befinden, in der wir die Paginierung wie folgt verwenden möchten: const [currentPage, setCurrentPage] = useState(1);
• totalPages bezieht sich auf die Gesamtzahl der anzuzeigenden Elemente, die die API
enthält.
• nextPage Mit dieser Funktion können wir zur nächsten Seite gehen und unseren aktuellen Seitenstatus wie folgt aktualisieren:

interface PaginationProps {
  currentPage: number;
  totalPages: number;
  nextPage: () => void;
  prevPage: () => void;
  goToPage: (page: number) => void;
}

• prevPage Mit dieser Funktion können wir zur Seite vor unserer aktuellen Seite wechseln und unseren aktuellen Seitenstatus aktualisieren

const handlePageChange = (newPage: number) => {
    setCurrentPage(newPage); 
  };

  const nextPage = () => {
    if (currentPage < totalPages) {
      handlePageChange(currentPage + 1);
    }
  };

• goToPage Diese Funktion benötigt einen numerischen Parameter und es ist die Funktion, die jedes Element benötigt, um zur gewünschten Seite zu gelangen. Lassen Sie es wie folgt funktionieren:

const prevPage = () => {
    if (currentPage > 1) {
      handlePageChange(currentPage - 1);
    }
  };

Damit unsere Paginierung zum Leben erweckt wird, benötigen wir noch einen weiteren Schritt: die Erstellung des Arrays, das wir in unserer Liste iterieren werden! Dazu müssen wir die folgenden Schritte befolgen:

1. Erstellen Sie eine Funktion, in diesem Fall nenne ich sie getPageNumbers
2. Erstellen Sie Variablen für das erste und letzte Element in der Liste.
3. Erstellen Sie eine Variable für die Auslassungspunkte auf der linken Seite. Nach meiner eigenen Entscheidung werden meine Auslassungspunkte nach dem vierten Element der Liste platziert.
4. Erstellen Sie eine Variable für die Auslassungspunkte auf der rechten Seite. Nach meiner eigenen Entscheidung werden meine Auslassungspunkte vor drei Elementen in der Liste platziert.
5. Erstellen Sie eine Funktion, die ein Array zurückgibt, in dem immer 5 Elemente zentriert sind, die aktuelle Seite, zwei vorherige Elemente und zwei nachfolgende Elemente. Bei Bedarf schließen wir die erste und letzte Seite aus const seitenAroundCurrent = [currentPage - 2, currentPage - 1, currentPage, currentPage 1, currentPage 2].filter(page => page > firstPage && page < lastPage);
6. Für unsere letzte Variable erstellen wir ein Array, das alle zuvor erstellten Variablen enthält.
7. Zuletzt werden wir die Nullelemente herausfiltern und das Array zurückgeben.

Dieses Array werden wir durchgehen, um die Liste der Elemente auf unserer Seite wie folgt zu erhalten:

const useFetch = <T,>(url: string, currentPage: number = 0, pageSize: number = 20) => {
  const [data, setData] = useState<T | null>(null);
  const [loading, setLoading] = useState<boolean>(true);
  const [error, setError] = useState<boolean>(false);

  useEffect(() => {
    const fetchData = async() => {
      setLoading(true);
      setError(false);

      try {
        const response = await fetch(url);
        if (!response.ok) {
          throw new Error('network response failed')
        }
        const result: T = await response.json() as T;
        setData(result)
      } catch (error) {
        setError(true)
      } finally {
        setLoading(false);
      }
    };

    fetchData()
  }, [url, currentPage, pageSize]);

  return {
    data,
    loading,
    error,
  }
};

Und so erstellen Sie eine wiederverwendbare und zugängliche Paginierung! Ich persönlich habe gelernt, wie man eine Seite von Grund auf erstellt, weil ich sie in Live-Codierung umsetzen musste. Ich hoffe, dass meine Erfahrung für Ihre Karriere hilfreich sein wird und Sie sie umsetzen und sogar verbessern können!

Grüße,
Glimmer<3

Das obige ist der detaillierte Inhalt vonZugängliche Komponenten: Paginierung. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!