Kontrol peringkat
Kontrol peringkat memungkinkan pengguna untuk melihat dan mengatur peringkat yang mencerminkan tingkat kepuasan terhadap konten dan layanan. Pengguna dapat berinteraksi dengan kontrol peringkat dengan sentuhan, pena, mouse, gamepad, atau keyboard. Panduan berikut menunjukkan cara menggunakan fitur kontrol peringkat untuk memberikan fleksibilitas dan kustomisasi.
Gambaran Umum
Kontrol peringkat dapat digunakan untuk memasukkan peringkat, atau dibuat baca-saja untuk menampilkan peringkat.
Peringkat yang dapat diedit dengan nilai tempat penampung
Mungkin cara paling umum untuk menggunakan kontrol peringkat adalah dengan menampilkan peringkat rata-rata sambil tetap memungkinkan pengguna memasukkan nilai peringkat mereka sendiri. Dalam skenario ini, kontrol peringkat awalnya diatur untuk mencerminkan peringkat kepuasan rata-rata semua pengguna layanan atau jenis konten tertentu (seperti musik, video, buku, dll.). Ini tetap dalam status ini sampai pengguna berinteraksi dengan kontrol dengan tujuan memberi peringkat satu item secara individual. Interaksi ini mengubah status kontrol peringkat untuk mencerminkan peringkat kepuasan pribadi pengguna.
Status peringkat rata-rata awal
Representasi peringkat pengguna setelah ditetapkan
Mode peringkat baca-saja
Terkadang Anda perlu menampilkan peringkat konten sekunder, seperti yang ditampilkan dalam konten yang direkomendasikan atau saat menampilkan daftar komentar dan peringkat yang sesuai. Dalam hal ini, pengguna seharusnya tidak dapat mengedit peringkat, sehingga Anda dapat membuat kontrol baca-saja. Mode baca saja juga merupakan cara yang direkomendasikan untuk menggunakan kontrol peringkat ketika digunakan dalam daftar konten virtual yang sangat besar, baik untuk desain UI maupun alasan performa.
UWP dan WinUI 2
Penting
Informasi dan contoh dalam artikel ini dioptimalkan untuk aplikasi yang menggunakan SDK Aplikasi Windows dan WinUI 3, tetapi umumnya berlaku untuk aplikasi UWP yang menggunakan WinUI 2. Lihat referensi API UWP untuk informasi dan contoh spesifik platform.
Bagian ini berisi informasi yang Anda butuhkan untuk menggunakan kontrol di aplikasi UWP atau WinUI 2.
RatingControl untuk aplikasi UWP disertakan sebagai bagian dari WinUI 2. Untuk informasi selengkapnya, termasuk instruksi penginstalan, lihat WinUI 2. API untuk kontrol ini ada di namespace Windows.UI.Xaml.Controls dan Microsoft.UI.Xaml.Controls .
- API UWP: Kelas RatingControl
- WinUI 2 Apis: Kelas RatingControl
- Buka aplikasi Galeri WinUI 2 dan lihat RatingControl beraksi. Aplikasi Galeri WinUI 2 mencakup contoh interaktif dari sebagian besar kontrol, fitur, dan fungsi WinUI 2. Dapatkan aplikasi dari Microsoft Store atau dapatkan kode sumber di GitHub.
Sebaiknya gunakan WinUI 2 terbaru untuk mendapatkan gaya, templat, dan fitur terbaru untuk semua kontrol.
Untuk menggunakan kode dalam artikel ini dengan WinUI 2, gunakan alias di XAML (kami menggunakan muxc
) untuk mewakili API Pustaka Windows UI yang disertakan dalam proyek Anda. Lihat Mulai menggunakan WinUI 2 untuk informasi selengkapnya.
xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
<muxc:RatingControl />
Membuat kontrol peringkat
- API Penting: Kelas RatingControl
Aplikasi Galeri WinUI 3 mencakup contoh interaktif dari sebagian besar kontrol, fitur, dan fungsi WinUI 3. Dapatkan aplikasi dari Microsoft Store atau dapatkan kode sumber di GitHub
Kontrol peringkat yang dapat diedit
Kode ini menunjukkan cara membuat kontrol peringkat yang dapat diedit dengan nilai tempat penampung.
<RatingControl x:Name="MyRating" ValueChanged="RatingChanged"/>
private void RatingChanged(RatingControl sender, object args)
{
if (sender.Value == null)
{
MyRating.Caption = "(" + SomeWebService.HowManyPreviousRatings() + ")";
}
else
{
MyRating.Caption = "Your rating";
}
}
Kontrol peringkat baca-saja
Kode ini menunjukkan cara membuat kontrol peringkat baca-saja.
<RatingControl IsReadOnly="True"/>
Fungsionalitas tambahan
Kontrol peringkat memiliki banyak fitur tambahan yang dapat digunakan. Detail untuk menggunakan fitur-fitur ini dapat ditemukan dalam dokumentasi referensi kami. Berikut adalah daftar fungsionalitas tambahan yang tidak komprehensif:
- Performa daftar panjang yang bagus
- Ukuran ringkas untuk skenario UI yang ketat
- Pengisian dan peringkat nilai berkelanjutan
- Penyesuaian spasi
- Menonaktifkan animasi pertumbuhan
- Kustomisasi jumlah bintang
Mendapatkan kode sampel
- Sampel Galeri WinUI - Lihat semua kontrol XAML dalam format interaktif.
Windows developer