Pseudo-classes
Referensi properti ASS

Jenis data properti ASS

Saat menggunakan lembar gaya Unity (USS), Anda dapat menentukan nilai untuk sifat VisualElement dalam file ASS. Anda juga dapat menetapkan nilai properti di C#, menggunakan properti C# dari VisualElement. Nilai yang ditetapkan dalam nilai override C# dari file USS.

Anda dapat memperluas USS dengan sifat kustom. Properti USS khusus memerlukan awalan --.

Halaman ini memperkenalkan jenis data yang didukung.

Jenis data AS menentukan nilai dan kata kunci yang diterima oleh properti ASS.

Property Description
<length> Mewakili nilai jarak.
<number> Mewakili baik bilangan bulat atau nomor dengan komponen fraksional.
<integer> Mewakili seluruh nomor.
<color> Mewakili warna. Anda dapat mendefinisikan warna dengan kode #hexadecimal, fungsi rgb() atau rgba(), atau kata kunci warna (misalnya, blue atau transparent).
<resource> Mewakili aset dalam folder Resources.
<url> Mewakili aset yang ditentukan oleh jalan. Anda dapat mengekspresikannya sebagai jalan relatif atau jalan absolut.
<length>{1,4} Mewakili satu ke empat pilihan untuk properti yang sharthand untuk -top-, -bottom-, -left-, dan sifat -right-, seperti padding-top, atau border-top-width.
1 panjang Berlaku untuk semua empat properti.
2 panjang Yang pertama berlaku untuk -top- dan -bottom-. Kedua berlaku untuk -left- dan -right-.
3 panjang Yang pertama berlaku untuk -top-. Kedua berlaku untuk -left dan -right-. Ketiga diterapkan pada -bottom-.
4 panjang Berlaku untuk pesanan ini: -top-, -right, -bottom-, -left-%

Length

UI Toolkit mendukung pixelsUnit terkecil dalam gambar komputer. Ukuran piksel tergantung pada resolusi layar Anda. Pencahayaan pixel dihitung pada setiap piksel layar. More info
Lihat di Glossary
(px) dan persentase (%) sebagai unit pengukuran untuk panjang. Nilai piksel absolut, sementara persentase biasanya relatif terhadap induk elemen.

Contoh:

  • width:200px; mengekspresikan lebar 200 piksel.
  • width:50%; mengekspresikan lebar setengah dari lebar elemen induk.

Penting untuk menentukan unit pengukuran. Jika Anda tidak menentukan unit pengukuran, UI(User Interface) Memungkinkan pengguna untuk berinteraksi dengan aplikasi Anda. Unity saat ini mendukung tiga sistem UI. More info
Lihat di Glossary
Toolkit menganggap bahwa nilai properti dinyatakan dalam pixel.

Note: 0 adalah nilai khusus yang tidak memerlukan unit pengukuran.

Numeric

Nilai numerik dinyatakan sebagai poin mengambang atau literal integer. Sebagai contoh, flex:1.0.

Keywords

Kata kunci spesifik didukung untuk beberapa sifat bawaan. Kata kunci memberikan nama deskriptif bukan nomor. Contohnya: position:absolute. Semua properti mendukung kata kunci global initial yang mengatur ulang properti dengan nilai defaultnya. Lihat Properti USS untuk daftar kata kunci.

Color

UI Toolkit mendukung nilai dan fungsi warna literal berikut:

  • Nilai Hexadecimal: #FFFF00 (rgba satu byte per saluran), #0F0 (rgb)
  • Fungsi RGB: rgb(255, 255, 0)% ruang
  • Fungsi RGBA: rgba(255, 255, 0, 1.0)
  • Kata kunci warna: blue, transparent

Assets

Anda dapat merujuk aset proyek seperti font dan tekstur dari file USS Anda. Misalnya, Anda mungkin merujuk tekstur untuk digunakan sebagai gambar latar belakang untuk elemen.

Untuk merujuk aset, Anda dapat menggunakan fungsi url() atau fungsi resource(). Aset Referensi diselesaikan ketika lembaran gaya diimpor.

Misalnya, deklarasi gaya di bawah ini menggunakan fungsi resource() untuk merujuk aset tekstur bernama img.png di direktori Images, dan tentukannya sebagai gambar latar belakang.

`background-image: resource("Images/img.png");

Unity merekomendasikan menggunakan fungsi url() dalam kebanyakan kasus. Namun, fungsi resource() mendukung secara otomatis memuat berbagai versi aset gambar untuk kepadatan layar yang berbeda.

Aset referensi dengan fungsi url

Ketika Anda merujuk aset dengan fungsi url(), jalur yang Anda tentukan dapat relatif atau absolut:

  • Jalur relatif harus relatif terhadap folder yang berisi file USS yang merujuk aset.
  • Jalur mutlak relatif terhadap proyek.

Jalan harus mencakup ekstensi file.

Misalnya, katakanlah proyek Anda memiliki folder USS yang berisi semua lembar gaya Anda, dan folder Sumber Daya yang berisi semua aset gambar Anda.

Assets
  └─ Editor
      └─ Resources
      └─ USS

Untuk merujuk gambar bernama thumb.png, Anda dapat menggunakan salah satu jalur berikut:

Jalur relatif Jalur Absolute
url("../Resources/thumb.png") url("/Assets/Editor/Resources/thumb.png")

url("project:/Assets/Editor/Resources/thumb.png")

url("project:///Assets/Editor/Resources/thumb.png")

Aset referensi dengan fungsi sumber daya

Fungsi resource() dapat merujuk aset di folder sumber daya Unity (Resources dan Editor Default Resources). Anda merujuk aset berdasarkan nama.

  • Jika file berada di folder Editor Default Resources Resources, Anda harus menyertakan ekstensi file.
  • Jika file berada di folder Resources, Anda tidak boleh menyertakan ekstensi file.

Contoh:

Path to file Sintaks referensi
Assets/Resources/Images/my-image.png resource("Images/my-image")
Assets/Editor Default Resources/Images/my-image.png resource("Images/default-image.png")

Aset gambar referensi untuk layar DPI / Retina Tinggi

Jika Anda perlu mendukung layar dengan kepadatan layar yang berbeda (DPI), fungsi resource() memungkinkan Anda untuk memuat versi yang benar dari aset tekstur secara otomatis.

Anda harus:

  • Pastikan bahwa versi DPI tinggi dari tekstur Anda memiliki suffix @2x dalam nama file mereka. Contoh versi DPI tinggi myimage.png harus myimage@2x.png
  • Tempatkan versi DPI reguler dan tinggi dari aset tekstur di folder proyek yang sama.

Ketika Unity memuat aset, secara otomatis memilih versi yang benar untuk layar saat ini DPI.

Misalnya, jika Anda menggunakan resource("myimage") di USS, beban Unity baik Resources/myimage.png atau Resources/myimage@2x.png.

Strings

Gunakan kutipan untuk menentukan nilai string. Contohnya: --my-property: "foo".

Pseudo-classes
Referensi properti ASS