- جمعه 1 آبان 1405 ساعت 18:00
- 3.1.9
- کامل شده
- منقضی شده
HTML Table Class ساخت جدول HTML را از آرایه داده‌ها ساده می‌کند. به‌جای اتصال رشته‌های HTML در Controller، می‌توانید Headerها و ردیف‌ها را به کلاس بدهید و خروجی جدول را تولید کنید.
ساختار و API اصلی
set_heading() سرستون‌ها را تعیین می‌کند، add_row() ردیف جدید می‌افزاید، generate() جدول را می‌سازد، set_template() قالب HTML را تغییر می‌دهد، make_columns() آرایه را به چند ستون تقسیم می‌کند و clear() داده‌های قبلی را پاک می‌کند.
نمونه استفاده
$this->load->library('table');
$this->table->set_heading('کد', 'محصول', 'موجودی');
$this->table->add_row(101, 'ماوس', 12);
$this->table->add_row(102, 'کیبورد', 7);
echo $this->table->generate();نکته مهم
خروجی جدول را از نظر Escape شدن داده‌ها بررسی کنید. اگر جدول برای داده‌های حساس یا رابط عمومی است، ساختار Responsive و کلاس‌های CSS را در قالب خروجی تعریف کنید.
مطالعه مرتبط
برای ادامه مطالعه، MVC، کوئری، ترنزکشن را ببینید.
متدهای Table Class
| متد یا مفهوم | کاربرد |
|---|---|
set_heading() | تعیین سرستون‌ها. |
add_row() | افزودن ردیف. |
generate() | تولید HTML جدول. |
set_template() | تغییر قالب جدول. |
make_columns() | تقسیم داده‌ها در چند ستون. |
clear() | پاک کردن ردیف‌ها و Headerهای قبلی. |
نحوه استفاده و عیب‌یابی
در یک Controller ابتدا Library را با Loader بارگذاری کنید، سپس تنظیمات محیطی را به آن بدهید و عملیات را اجرا کنید. نتیجه را از مسیر مشخص دریافت کنید و در صورت شکست، پیام خطا را در Log ثبت کنید. اگر Library به Driver خارجی وابسته است، وجود افزونه PHP یا برنامه موردنیاز را روی سرور بررسی کنید.
در محیط توسعه، مسیر موفق و مسیر خطا را جداگانه آزمایش کنید. ورودی خالی، مقدار نامعتبر، فایل بزرگ، Timeout سرویس خارجی و نبود مجوز نوشتن از سناریوهایی هستند که باید بررسی شوند. منابعی مانند اتصال شبکه و فایل‌های موقت را پس از پایان عملیات آزاد کنید.
در بازبینی کد، ترتیب و نتیجه متدهای set_heading()، add_row()، generate()، set_template() را بررسی کنید. نام متد به‌تنهایی تضمین نمی‌کند ورودی معتبر یا خروجی امن باشد، بنابراین رفتار هر متد را با تست و مستندات همان نسخه کنترل کنید.