Komponen Kustom

Ikhtisar semua komponen kustom berbasis Sätteri yang tersedia di website ini.

Komponen kustom adalah fitur yang memungkinkan kamu menulis konten Markdown dengan sintaks sederhana yang otomatis berubah menjadi elemen HTML yang kaya dan interaktif.

Apa Itu Custom Directives?

Custom directives adalah ekstensi sintaks Markdown yang dimulai dengan:

  • Block directives: ::: atau :: (di baris sendiri)
  • Inline directives: : (di dalam paragraf)

Saat konten di-render, Sätteri akan mengubah directive tersebut menjadi komponen HTML yang sudah dilengkapi dengan styling dan fungsionalitas.

Kelebihan

  • Markdown murni — tidak perlu HTML atau JSX
  • Tanpa import — tidak perlu import komponen di setiap file
  • Konsisten — semua komponen memiliki tampilan yang seragam
  • Cepat — diproses di build time, tidak ada JavaScript di sisi klien
  • Fleksibel — bisa digunakan di file .md dan .mdx

Daftar Komponen

Block Components (::: / ::)

Komponen yang berdiri sendiri di level blok.

Komponen Sintaks Fungsi Halaman
Callout > [!NOTE] Menyorot informasi penting Callout
Steps :::steps Panduan langkah-demi-langkah Steps
Tabs ::::tabs Konten dalam tab Tabs
Filetree :::filetree Struktur folder dan file Filetree
Accordion :::details Konten yang bisa dilipat Accordion
Video ::video[...] Embed video Video
Card :::card Kotak informasi dengan ikon dan link Card

Inline Components (:)

Komponen yang bisa digunakan di dalam paragraf atau teks.

Komponen Sintaks Fungsi Halaman
User :user[...] Profil pengguna dengan avatar User
Badge :badge[...] Label kecil dengan warna Badge
Button :button[...] Tombol dengan ikon Button
Icon :icon[...] Ikon SVG dengan berbagai ukuran Icon

Media Components

Komponen Sintaks Fungsi Halaman
Figure ![alt](url){caption} Gambar dengan caption Figure

Mulai Menggunakan

Pilih salah satu komponen dari daftar di atas untuk mulai belajar. Berikut beberapa rekomendasi untuk memulai:

Callout

Mulai dengan Callout untuk menyorot informasi penting.

Steps

Gunakan Steps untuk membuat panduan langkah-demi-langkah.

Tabs

Pelajari Tabs untuk menampilkan konten dalam tab.

Icon

Tambahkan ikon ke dalam konten dengan Icon.

Card

Pelajari cara membuat Card untuk menampilkan informasi.