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- % |
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.
Nilai numerik dinyatakan sebagai poin mengambang atau literal integer. Sebagai contoh, flex:1.0
.
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.
UI Toolkit mendukung nilai dan fungsi warna literal berikut:
#FFFF00
(rgba satu byte per saluran), #0F0
(rgb)rgb(255, 255, 0)
% ruangrgba(255, 255, 0, 1.0)
blue
, transparent
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.
Ketika Anda merujuk aset dengan fungsi url()
, jalur yang Anda tentukan dapat relatif atau absolut:
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") |
Fungsi resource()
dapat merujuk aset di folder sumber daya Unity (Resources
dan Editor Default Resources
). Anda merujuk aset berdasarkan nama.
Editor Default Resources Resources
, Anda harus menyertakan ekstensi file.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") |
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:
@2x
dalam nama file mereka. Contoh versi DPI tinggi myimage.png
harus myimage@2x.png
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
.
Gunakan kutipan untuk menentukan nilai string. Contohnya: --my-property: "foo"
.