Langkau ke kandungan

Butang Ikon ​

Butang bulatan yang memaparkan ikon menggantikan teks. Ikon berasal daripada set ikon SenangStart dan dirujuk melalui slug.

Komponen a-sxr-icon-button ​

Sifat ​

SifatPeneranganNilai Lalai
onPeristiwa yang mencetuskan tindakan onclickclick
font-colorWarna teks label butang#F1F5F9
border-colorWarna sempadan butang#1B1B1F
background-colorWarna latar belakang item#202127
hover-colorWarna latar belakang apabila penuding berada di atas butang#0EA5E9
active-colorWarna latar belakang apabila butang ditekan#2563EB
iconSlug ikon SenangStart, cth. check, play, cog-6-toothcheck
icon-activeSlug ikon untuk keadaan aktif''
icon-fontPilihan lama dikekalkan untuk keserasian''
icon-font-sizeSaiz ikon butang0.4
icon-occlusionBenarkan geometri adegan melindungi ikon (ujian kedalaman pilihan)false
keyKekunci pintasan teks yang mengaktifkan widget (cth. 'e')
key-codeKekunci pintasan angka lama (cth. 32 untuk Space)-1
toggleStatus suisfalse
toggle-stateTetapkan keadaan hidup/mati butang suisfalse
heightTinggi item1
widthLebar item1
marginMargin di sekeliling item0 0 0 0
html
<a-sxr-icon-button
	height="0.75"
	onclick="buttonActionFunction" key-code="32"
	icon="star"
	margin="0 0 0.05 0"
>
</a-sxr-icon-button>

Ikon ​

icon menerima slug daripada set ikon — 246 ikon tersedia (check, play, cog-6-tooth, sparkles, …). Slug yang tidak dikenali menggunakan glif ? sebagai gantian dan tidak menyebabkan kegagalan.

icon-active menukar ikon yang dipaparkan semasa butang ditekan, cara lazim untuk menunjukkan keadaan ditekan/disahkan:

html
<a-sxr-icon-button icon="play" icon-active="pause"></a-sxr-icon-button>

icon-font ialah pilihan lama yang dikekalkan untuk keserasian; adegan baharu patut menggunakan icon.

Mod suis ​

toggle="true" menjadikan butang kekal hidup atau mati selepas ditekan, dengan keadaan disimpan dalam toggle-state.

Oklusi ​

Ikon dipaparkan di hadapan geometri adegan secara lalai. Tetapkan icon-occlusion="true" untuk membenarkan geometri adegan melindungi ikon — lihat Oklusi.