Pagination v3

Pagination คือ class หรือส่วนเสริมสำหรับ PHP ที่จะใช้ในการแบ่งหน้าเมื่อต้องแสดงผลของข้อมูลจำนวนมากๆ โดยที่ไม่ต้องแสดงข้อมูลเหล่านั้นในทีเดียว แต่เอามาแบ่งหน้าแสดง.

ดาวน์โหลด หรือติดตั้งผ่าน Composer
เอกสารอ้างอิง API

License: MIT

ส่วนประกอบต่างๆ

ส่วนประกอบต่างๆใน Pagination นี้ อ้างอิงจากรูปด้านบน

• before unavailable คือเลขหน้าที่จะแสดงก่อนแสดงหน้าที่ขาดช่วงไป (unavailable). คุณสามารถกำหนดค่าจำนวนของมันได้ที่ property unavailable_before เช่น $Pagination->unavailable_before = 1;
• unavailable คือตำแหน่งที่เลขหน้าขาดช่วงไประหว่างเลขหน้าที่แสดงก่อน และเลขหน้าที่อยู่รอบๆหน้าปัจจุบัน. คุณสามารถกำหนดค่าตัวอักษรที่จะแสดงตรงนี้ได้ที่ property unavailable_text เช่น $Pagination->unavailable_text = '..';
• adjacent pages คือเลขหน้าที่อยู่รอบๆหน้าปัจจุบัน. คุณสามารถกำหนดค่าจำนวนของมันได้ที่ property number_adjacent_pages เช่น $Pagination->number_adjacent_pages = 3;
• after unavailable ก็เหมือน before unavailable แต่เป็นเลขหน้าที่แสดงหลังจากหน้าที่ขาดช่วงไป (unavailable). คุณสามารถกำหนดค่าจำนวนของมันได้ที่ property unavailable_after เช่น $Pagination->unavailable_after = 3;

เมื่อทราบส่วนประกอบต่างๆแล้ว การกำหนดค่าเพื่อให้มันแสดงผลตามที่ต้องการก็จะทำได้ดั่งใจมากขึ้น. ขอได้โปรดดูค่า property ต่างๆในตารางต่อไปนี้

Properties

การใช้งาน

เมื่อกำหนดค่าการแสดงผลต่างๆผ่าน property ได้แล้ว ให้เรียก method createLinks() เพื่อแสดงผลการแบ่งหน้า

$Pagination = new \Rundiz\Pagination\Pagination();
$Pagination->base_url = 'http://domain.tld/my-category?page=%PAGENUMBER%';
$Pagination->total_records = 1000;
$Pagination->page_number_value = (isset($_GET['page']) ? intval($_GET['page']) : 0);
echo $Pagination->createLinks();

ในการเรียก createLinks() เพื่อแสดงผลการแบ่งหน้านั้น ยังสามารถกำหนดตำแหน่งแทนที่ได้อีก เช่น :current_page_number_displaying จะแทนที่หน้าที่กำลังแสดง, :total_pages จะแทนที่หน้าทั้งหมดที่มี, :pagination จะแทนที่การแบ่งหน้า

ตัวอย่าง

$Pagination->createLinks('Displaying :current_page_number_displaying/:total_pages<br>:pagination');

การแสดงผลการแบ่งหน้าที่กำหนดเอง

คุณสามารถเรียกไปยัง method getPaginationData() เพื่อสร้างการแบ่งหน้าแล้วรับค่าเป็น array จากนั้นนำค่า array นั้นมาออกแบบการแบ่งหน้าเอาเองได้ตามที่ต้องการ ไม่ว่าจะเป็นแบบ select box, method POST, ajax, และอื่นๆ ฯลฯ

$pagination_data = $Pagination->getPaginationData();
if (is_array($pagination_data) && array_key_exists('generated_pages', $pagination_data)) {
    echo '<form id="pagination-method-post-form" method="post" action="'.str_replace(array('start=%PAGENUMBER%&amp;', 'start=%PAGENUMBER%'), '', $base_url).'">'."\n";
    echo '<input type="hidden" id="method-post-start-value" name="start" value="">'."\n";
    foreach ($pagination_data['generated_pages'] as $page_key => $page_item) {
        if (!is_string($page_key) && is_array($page_item)) {
            if (array_key_exists('link', $page_item) && array_key_exists('page_value', $page_item) && array_key_exists('text', $page_item)) {
                echo '<button type="button" class="button btn';
                if (isset($start) && $start == $page_item['page_value']) {
                    echo ' btn-primary';
                } else {
                    echo ' btn-default';
                }
                echo '"';
                echo ' name="start"';
                echo ' value="'.$page_item['page_value'].'"';
                echo '>';
                echo $page_item['text'];
                echo '</button> '."\n";
            }
        }
    }// endforeach;
    unset($page_item, $page_key);
    echo '</form>'."\n";
}
unset($pagination_data);