Memanipulasi Record Setelah Dikeluarkan di Aplikasi Web dari PHPMaker

Di artikel sebelumnya kita sudah membahas bagaimana cara menyisipkan kode saat baris Record akan atau sedang ditampilkan ke Aplikasi Web yang di-generate oleh PHPMaker dengan menggunakan server event Row_Rendering. Di artikel yang ini kita akan membahas bagaimana cara memanipulasi Record setelah baris Record sudah selesai di-render atau ditampilkan dengan menggunakan server event Row_Rendered.

Lokasi dari server event Row_Rendered berada di bawah Server Events -> Table-Specific -> Common di dalam project PHPMaker Anda. Pastikan sebelumnya Anda sudah memilih salah satu Table yang Anda inginkan dari panel Database di sebelah kiri dari project PHPMaker Anda, untuk memastikan Anda menambahkan kode di server event pada Table yang tepat.

Server event Row_Rendered akan dipanggil setelah me-render atau mengeluarkan sebuah Record. Hal ini berguna untuk memformat tampilan sesuai dengan kondisi tertentu. Anda sebagai Web Developer dapat melakukan banyak hal di dalam server event ini, seperti misalnya mengganti warna huruf, mengganti style atau gaya huruf, mengganti warna latar belakang (background) huruf, warna latar belakang cell, dan masih banyak lagi. Semuanya dapat mudah dilakukan dengan mengganti nilai properties dari class Table atau Field di event yang sesuai dengan nilai field.

Class Table memiliki property RowAttrs yang merupakan array dari atribut HTML untuk baris di tabel. Class Field memiliki properties CellAttrs, ViewAttrs, dan EditAttrs untuk cell Table, View Tag, dan Edit Tag dari masing-masing Field. Kunci dari array ini haruslah merupakan atribut HTML yang valid untuk tag HTML. Selalu gunakan huruf kecil untuk kuncinya. Nilai attribute akan dikeluarkan sebagai atribut yang diapit dengan petik ganda. Jadi, jika Anda memiliki karakter petik ganda di dalam nilai tersebut, cobalah menggunakan petik tunggal sedapat mungkin, atau gunakan

"""

Untuk melihat properties dari class Field untuk proses development atau debugging, Anda dapat menggunakan function PHP yang bernama var_dump di dalam server event Row_Rendered:

var_dump($this->RowAttrs);
var_dump($this->Trademark);
var_dump($this->Trademark->CellAttrs);
var_dump($this->Trademark->EditAttrs);
var_dump($this->Trademark->ViewAttrs); 

Klik node Cars di panel Database, pilih [Server Events/Client Scripts], dan klik [Table Specific] – > [Common] – > server event [Row_Rendered]. Standar kode Row_Rendered ditampilkan seperti berikut:

function Row_Rendered() { 
     // Ganti warna baris di halaman List
     if ($this->Trademark->ViewValue == "BMW") {
         $this->RowAttrs["style"] = "color: red; background-color: #ccffcc";
     }

     // Ganti warna cell 
     if ($this->Cyl->CurrentValue == 4) {
         $this->Cyl->CellAttrs["style"] = "background-color: #ffcccc";
     } elseif ($this->Cyl->CurrentValue == 6) {
         $this->Cyl->CellAttrs["style"] = "background-color: #ffcc99";
     } elseif ($this->Cyl->CurrentValue == 8) {
         $this->Cyl->CellAttrs["style"] = "background-color: #ffccff";
     }

    // Ganti style text
     if ($this->Category->CurrentValue == "SPORTS") {
         $this->Category->ViewAttrs["style"] = "color: #00cc00; font-weight: bold; background-color: #ffff99";
     }
}

Saya sarankan agar Anda banyak berlatih dengan cara mengekspos properties yang terdapat di server event ini supaya dapat mengoptimalkannya di Aplikasi Web yang Anda bangun dengan PHPMaker.

Luar biasa memang kehebatan dan kefleksibelan yang sudah disediakan oleh PHPMaker. 🙂