Radio 單選框

Radio 單選框

在一組備選項中進行單選

¶基礎用法

因爲選項默承認見，不宜過多，若選項過多，建議使用 Select 選擇器。

 

要使用 Radio 組件，只須要設置v-model綁定變量，選中意味着變量的值爲相應 Radio label屬性的值，label能夠是String、Number或Boolean。

<template> <el-radio v-model="radio" label="1">備選項</el-radio> <el-radio v-model="radio" label="2">備選項</el-radio> </template> <script> export default { data () { return { radio: '1' }; } } </script> 

 

¶禁用狀態

單選框不可用的狀態。

 

只要在el-radio元素中設置disabled屬性便可，它接受一個Boolean，true爲禁用。

<template> <el-radio disabled v-model="radio1" label="禁用">備選項</el-radio> <el-radio disabled v-model="radio1" label="選中且禁用">備選項</el-radio> </template> <script> export default { data () { return { radio1: '選中且禁用' }; } } </script> 

 

¶單選框組

適用於在多個互斥的選項中選擇的場景

 

結合el-radio-group元素和子元素el-radio能夠實現單選組，在el-radio-group中綁定v-model，在el-radio中設置好label便可，無需再給每個el-radio綁定變量，另外，還提供了change事件來響應變化，它會傳入一個參數value。

<template> <el-radio-group v-model="radio2"> <el-radio :label="3">備選項</el-radio> <el-radio :label="6">備選項</el-radio> <el-radio :label="9">備選項</el-radio> </el-radio-group> </template> <script> export default { data () { return { radio2: 3 }; } } </script> 

 

¶按鈕樣式

按鈕樣式的單選組合。

 

只須要把el-radio元素換成el-radio-button元素便可，此外，Element 還提供了size屬性。

<template> <div> <el-radio-group v-model="radio3"> <el-radio-button label="上海"></el-radio-button> <el-radio-button label="北京"></el-radio-button> <el-radio-button label="廣州"></el-radio-button> <el-radio-button label="深圳"></el-radio-button> </el-radio-group> </div> <div style="margin-top: 20px"> <el-radio-group v-model="radio4" size="medium"> <el-radio-button label="上海" ></el-radio-button> <el-radio-button label="北京"></el-radio-button> <el-radio-button label="廣州"></el-radio-button> <el-radio-button label="深圳"></el-radio-button> </el-radio-group> </div> <div style="margin-top: 20px"> <el-radio-group v-model="radio5" size="small"> <el-radio-button label="上海"></el-radio-button> <el-radio-button label="北京" disabled ></el-radio-button> <el-radio-button label="廣州"></el-radio-button> <el-radio-button label="深圳"></el-radio-button> </el-radio-group> </div> <div style="margin-top: 20px"> <el-radio-group v-model="radio6" disabled size="mini"> <el-radio-button label="上海"></el-radio-button> <el-radio-button label="北京"></el-radio-button> <el-radio-button label="廣州"></el-radio-button> <el-radio-button label="深圳"></el-radio-button> </el-radio-group> </div> </template> <script> export default { data () { return { radio3: '上海', radio4: '上海', radio5: '上海', radio6: '上海' }; } } </script> 

 

¶帶有邊框

 

設置border屬性能夠渲染爲帶有邊框的單選框。

<template> <div> <el-radio v-model="radio7" label="1" border>備選項1</el-radio> <el-radio v-model="radio7" label="2" border>備選項2</el-radio> </div> <div style="margin-top: 20px"> <el-radio v-model="radio8" label="1" border size="medium">備選項1</el-radio> <el-radio v-model="radio8" label="2" border size="medium">備選項2</el-radio> </div> <div style="margin-top: 20px"> <el-radio-group v-model="radio9" size="small"> <el-radio label="1" border>備選項1</el-radio> <el-radio label="2" border disabled>備選項2</el-radio> </el-radio-group> </div> <div style="margin-top: 20px"> <el-radio-group v-model="radio10" size="mini" disabled> <el-radio label="1" border>備選項1</el-radio> <el-radio label="2" border>備選項2</el-radio> </el-radio-group> </div> </template> <script> export default { data () { return { radio7: '1', radio8: '1', radio9: '1', radio10: '1' }; } } </script> 

 

¶Radio Attributes

參數	說明	類型	可選值	默認值
label	Radio 的 value	string / number / boolean	—	—
disabled	是否禁用	boolean	—	false
border	是否顯示邊框	boolean	—	false
size	Radio 的尺寸，僅在 border 爲真時有效	string	medium / small / mini	—
name	原生 name 屬性	string	—	—

¶Radio Events

事件名稱	說明	回調參數
change	綁定值變化時觸發的事件	選中的 Radio label 值

¶Radio-group Attributes

參數	說明	類型	可選值	默認值
size	單選框組尺寸，僅對按鈕形式的 Radio 或帶有邊框的 Radio 有效	string	medium / small / mini	—
disabled	是否禁用	boolean	—	false
text-color	按鈕形式的 Radio 激活時的文本顏色	string	—	#ffffff
fill	按鈕形式的 Radio 激活時的填充色和邊框色	string	—	#409EFF

¶Radio-group Events

事件名稱	說明	回調參數
change	綁定值變化時觸發的事件	選中的 Radio label 值

¶Radio-button Attributes

參數	說明	類型	可選值	默認值
label	Radio 的 value	string / number	—	—
disabled	是否禁用	boolean	—	false
name	原生 name 屬性	string	—	—