Satu script, website beraksara Nusantara.

Ubah teks website, bukan database

SDK membaca teks yang terlihat di halaman, mentransliterasi menggunakan engine Merajut Indonesia, lalu menampilkan aksara yang dipilih. Pengunjung dapat kembali ke Latin kapan saja tanpa menghilangkan konten asli. Proses dilakukan di browser dan tidak memerlukan koneksi database website pengembang.

Coba transliterasi langsung

Demo hanya mengubah kotak teks di bawah, bukan seluruh halaman dokumentasi. Pilih aksara untuk melihat hasil engine yang sama dengan SDK integrasi.

Hanya satu baris script

Salin kode dan letakkan sebelum tag penutup </body> di website pengembang. Pilihan aksara dan posisi switcher cukup diatur melalui atribut data-*.

<script src="https://merajutindonesia.id/sdk/v3/merajut-auto-transliteration.js?v=1.2.0"
  data-scripts="bugis"
  data-default="latin"
  data-position="bottom-right"
  data-persist="true"></script>

Mode multi: hanya daftar aksara yang diizinkan yang muncul di switcher.

<script src="https://merajutindonesia.id/sdk/v3/merajut-auto-transliteration.js?v=1.2.0"
  data-scripts="jawa,bali,pegon,bugis"
  data-position="top-right"
  data-default="latin"
  data-persist="true"></script>

Gunakan data-scripts="all" untuk semua sembilan aksara. ID teknis pegon ditampilkan sebagai Arab Nusantara, sedangkan bugis sebagai Lontara Bugis.

Empat posisi atau tombol milik developer

Atribut data-position menentukan lokasi tombol mengambang. Jarak dari tepi dapat diatur dengan data-offset="24" (piksel). Gunakan data-position="custom" untuk tombol sendiri.

<button type="button" id="pilih-aksara">Pilih aksara</button>
<script src="https://merajutindonesia.id/sdk/v3/merajut-auto-transliteration.js?v=1.2.0"
  data-scripts="jawa,bali,pegon"
  data-position="custom"
  data-target="#pilih-aksara"
  data-custom-behavior="menu"
  data-persist="true"></script>

Untuk satu aksara, tombol custom dapat bergantian Latin ↔ aksara dengan data-custom-behavior="toggle". Gunakan cycle untuk berganti aksara secara berurutan atau data-switcher="false" bila seluruh UI ingin dikelola sendiri.

Pilihan pengunjung tidak hilang setelah refresh

Dengan data-persist="true" (default), SDK menyimpan ID aksara dalam localStorage browser. Saat halaman dimuat kembali atau pengunjung membuka halaman lain pada domain yang sama, aksara terakhir dipulihkan secara otomatis.

Ini bukan cookie HTTP dan tidak dikirim ke server. Jika storage diblokir, pergantian aksara tetap berfungsi namun pilihannya mungkin tidak tersimpan. Pada pemuatan awal, teks Latin bisa terlihat sesaat sebelum SDK aktif.

Gunakan UI sendiri (headless)

Developer dapat mengganti aksara dari navbar, pengaturan akun, ataupun komponen JavaScript aplikasi. SDK menyediakan API global setelah inisialisasi.

MerajutAutoTransliteration.ready.then(() => {
  MerajutAutoTransliteration.setScript('jawa');
  console.log(MerajutAutoTransliteration.getScript());
});
// Method lain: toggle(), cycle(), getAvailableScripts(),
// convert(text, script), refresh(), destroy().

Event yang tersedia: merajut:ready dan merajut:scriptchange. Gunakan data-root="#konten" bila transliterasi hanya boleh berjalan pada area tertentu.