Komponen Boleh Diakses: Penomboran

Hari ini kita akan melihat cara membuat penomboran dari awal dan menjadikannya boleh diakses dan boleh digunakan semula. Saya harap ia membantu anda dan tinggalkan saya komen anda di penghujung siaran!

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

Cangkuk tersuai untuk mengambil data

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. Kami akan menghasilkan cangkuk tersuai dengan jenis generik. Ini akan membolehkan kami menentukan jenis data yang dijangkakan apabila menggunakan cangkuk ini
2. Mari kita tunggu 3 parameter. Satu untuk url di mana kami akan mengambil data, currentPage iaitu halaman di mana kami berada dan secara lalai ialah 0 dan pageSize iaitu nombor daripada item yang Kami akan memilikinya setiap halaman dan secara lalai ialah 20 (anda boleh menukar nilai ini).
3. Dalam keadaan const [data, setData] = useState(null); Kami memberikannya jenis generik T kerana apabila kami menggunakannya untuk permintaan data yang berbeza, kami akan menjangkakan jenis data yang berbeza.

penomboran

Untuk halaman boleh diakses, kita mesti mengambil kira perkara berikut:

• Tumpuan mesti bergerak melalui semua elemen interaktif halaman dan mempunyai penunjuk yang boleh dilihat
• untuk memastikan interaksi yang baik dengan pembaca skrin kita mesti menggunakan wilayah, sifat dan keadaan dengan betul
• Halaman itu mesti dikumpulkan dalam teg dan mengandungi label aria yang mengenal pasti halaman itu sebagai halaman per se.
• Setiap item dalam penomboran mesti mengandungi saiz set aria dan set titik aria. Sekarang, untuk apa mereka? Nah, aria-setsize digunakan untuk mengira jumlah bilangan item dalam senarai penomboran. Pembaca skrin akan mengumumkannya seperti berikut:

aria-pointset digunakan untuk mengira kedudukan item dalam semua item pada halaman. Pembaca skrin akan mengumumkannya seperti berikut:

• Setiap item mesti mempunyai label aria untuk dapat mengenal pasti halaman mana yang kita akan pergi jika kita mengklik butang itu.
• Ada butang untuk pergi ke elemen seterusnya/sebelumnya dan setiap butang ini mesti mempunyai label aria yang sepadan
• Jika penomboran kami mengandungi elipsis, ia mesti ditanda dengan betul dengan label aria
• Setiap kali kita pergi ke halaman baharu, pembaca skrin mesti mengumumkan halaman mana kita berada dan berapa banyak item baharu yang terdapat seperti berikut.

Untuk mencapai ini, kami akan kodkannya seperti berikut:

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,
  }
};

Apabila halaman berhenti dimuatkan, kami akan menetapkan mesej baharu dengan Halaman semasa kami dan panjang tatasusunan baharu yang kami muatkan.

Sekarang ya! Mari lihat bagaimana kod itu distrukturkan dalam fail penomboran.tsx

Komponen memerlukan lima prop

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 akan merujuk kepada halaman semasa. Kami akan mengendalikan ini dengan berada dalam komponen di mana kami ingin menggunakan penomboran seperti berikut: const [currentPage, setCurrentPage] = useState(1);
• totalPages merujuk kepada jumlah bilangan item yang akan dipaparkan yang mengandungi API
.
• nextPage fungsi ini akan membolehkan kami pergi ke halaman seterusnya dan mengemas kini keadaan Halaman semasa kami seperti berikut:

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

• prevPage fungsi ini akan membolehkan kami pergi ke halaman sebelumnya ke halaman semasa kami dan mengemas kini keadaan Halaman semasa kami

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

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

• goToPage fungsi ini memerlukan parameter berangka dan ia adalah fungsi yang setiap item perlu pergi ke halaman yang dikehendaki. Mari kita buat ia berfungsi seperti berikut:

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

Untuk penomboran kami menjadi hidup, kami memerlukan satu langkah lagi, mencipta tatasusunan yang akan kami ulangi dalam senarai kami! Untuk itu kita mesti ikuti langkah berikut:

1. Buat fungsi, dalam kes ini saya akan memanggilnya getPageNumbers
2. Buat pembolehubah untuk item pertama dan terakhir dalam senarai.
3. Buat pembolehubah untuk elipsis di sebelah kiri. Dengan keputusan saya sendiri, elipsis saya akan ditempatkan selepas elemen keempat senarai.
4. Buat pembolehubah untuk elipsis di sebelah kanan. Dengan keputusan saya sendiri, elipsis saya akan diletakkan sebelum tiga item dalam senarai.
5. Buat fungsi yang mengembalikan tatasusunan di mana 5 item sentiasa dipusatkan, halaman semasa, dua item sebelumnya dan dua item seterusnya. Jika perlu, kami akan mengecualikan halaman pertama dan terakhir const pagesAroundCurrent = [currentPage - 2, currentPage - 1, currentPage, currentPage 1, currentPage 2].penapis(halaman => halaman > firstPage && page < lastPage);
6. Untuk pembolehubah terakhir kami, kami akan mencipta tatasusunan yang mengandungi semua pembolehubah yang dibuat sebelum ini.
7. Akhir sekali, kami akan menapis elemen nol dan mengembalikan tatasusunan.

Tatasusunan ini adalah yang akan kami lalui untuk mendapatkan senarai item dalam halaman kami seperti berikut:

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,
  }
};

Dan inilah cara untuk membuat penomboran yang boleh diguna semula dan boleh diakses! Secara peribadi, saya belajar cara membuat halaman dari awal kerana saya terpaksa melaksanakannya dalam pengekodan langsung. Saya harap pengalaman saya akan membantu kerjaya anda dan anda boleh melaksanakan dan juga memperbaikinya!

Salam,
Mica<3

Atas ialah kandungan terperinci Komponen Boleh Diakses: Penomboran. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!