Typography Class

Typography pada Codeigniter menyediakan beberapa fungsi yang bisa digunakan untuk melakukan pemformatan text.

Seperti halnya class yang lain, class ini juga perlu diinisialisasi sebelum bisa digunakan. cara melakukan inisialisasi adalah sebagai berikut:

$this->load->library(‘typography’);

Setelah di-load, library ini bisa dipanggil dengan menggunakan fungsi

$this->typography.

3.22.1 auto_typography()

Fungsi ini akan memformat suatu text sehingga text tersebut benar secara semantik dan tipografi. Input dari fungsi ini berupa string dan akan menghasilkan (return value) string lain dengan format sebagai berikut:

• Suatu paragraf akan berada diantara tag <p></p> (Suatu double line break akan dideteksi untuk mengetahui adanya sebuah paragraf).
• Suatu single line break (baris baru satu kali) akan diubah menjadi tag <br /> kecuali jika diapit oleh tag <pre></pre>.
• tag seperti <div>  dan <span>, tidak dianggap sebagai sebuah paragraf.
• Tanda kutip akan dikonversikan menjadi tanda kutip keriting yang saling berhadapan.
• Tanda apostrof akan dikonversikan menjadi apostrof keriting.
• Tanda Kutip dua (Seperti like — this atau like–this), akan dikonversikan menjadi em—dashes.
• Jika ada tiga tanda titik berturut-turut, maka akan dikonversikan menjadi sebuah karakter pengganti.
• Dua buah spasi yang mengikuti sebuah kalimat akan dikonversikan menjadi non-breaking space untuk menandakan spasi ganda.

Contoh penggunaan dari fungsi ini :

$string = $this->typography->auto_typography($string);

3.22.2 Parameters

Pada fungsi auto_typography() terdapat sebuah parameter optional yang bisa ditentukan jika terdapat lebih dari dua line-break berturut-turut, apakah akan dikonversikan menjadi dua line-break saja atau tidak. Yaitu dengan menggunakan parameter boolean TRUE atau FALSE.

Secara default parameter yang digunakan adalah FALSE, artinya jika parameter kedua tidak didefinisikan maka sama saja parameter tersebut diset FALSE dan jika ada lebih dari dua line-break berturut-turut, line-break tidak akan di reduce.

$string = $this->typography->auto_typography($string, FALSE);

3.22.3 format_characters()

Fungsi ini hampir sama dengan fungsi auto_typography. Tetapi fungsi ini hanya melakukan pemformatan sebagai berikut:

• Tanda kutip akan dikonversikan menjadi tanda kutip keriting yang saling berhadapan.
• Tanda apostrof akan dikonversikan menjadi apostrof keriting.
• Tanda Kutip dua (Seperti like — this atau like–this), akan dikonversikan menjadi em—dashes.
• Jika ada tiga tanda titik berturut-turut, maka akan dikonversikan menjadi sebuah karakter pengganti.
• Dua buah spasi yang mengikuti sebuah kalimat akan dikonversikan menjadi non-breaking space untuk menandakan spasi ganda.

Jika dilihat ada beberapa pemformatan dari fungsi auto_typography() yang tidak ada pada fungsi format_characters().

Contoh penggunaan:

$string = $this->typography->format_characters($string);

3.22.4 nl2br_except_pre()

Fungsinya adalah untuk mengubah suatu garis baru (new lines) menjadi tag <br />. Fungsi ini tidak berlaku jika string tersebut mengandung tag <pre>. Fungsi ini hampir sama dengan fungsi nl2br() yang merupakan kunci bawaan pada php. Hanya saja fungsi nl2br() ini akan tetap menjalankan fungsinya meskipun stringyang dimaksud diapit oleh tag <pre>.

Contoh penggunaan :

$string = $this->typography->nl2br_except_pre($string);