layui/docs/form/radio.md

title	toc
单选框	true

单选框

单选框组件是对 <input type="radio"> 元素的美化替代。

普通单选框

  <div class="layui-form">
  <input type="radio" name="AAA" value="1" title="默认">
  <input type="radio" name="AAA" value="2" title="选中" checked> 
  <input type="radio" name="AAA" value="3" title="禁用" disabled> 
</div>

<!-- import layui -->
  

• 属性 title 可设置单选框标题
• 属性 checked 可设置默认选中
• 属性 disabled 可设置禁用状态
• 属性 value 可设置值，否则选中时返回的默认值为 on（浏览器默认机制）。同组单选框一般设置相同值。
• 属性 lay-skin 可设置单选框风格，可选值：none(无样式)^2.9.8+ 默认风格可不填

自定义标题模板

在 radio 元素后的相邻元素设置特定属性 lay-radio，可以与 radio 标题进行绑定。

  <div class="layui-form">
  <input type="radio" name="AAA" value="0" title="默认">
  <div lay-radio>
    <span style="color: blue;">自定义模板 ♂</span>
  </div>
  <input type="radio" name="AAA" value="1" title="默认">
  <div lay-radio>
    <span style="color: pink;">自定义模板 ♀</span>
  </div>
</div>

<!-- import layui -->
  

自定义任意风格 ^2.9.8+

通过对 radio 元素设置 lay-skin="none" 属性禁用默认样式，从而实现任意风格的单选组件。
注： 这意味着你需要掌握一定的 CSS 技能，以下示例中的样式均为外部自主实现，并非 Layui 内置。

  {{- d.include("/form/examples/radio.skin.md") }}
  

单选框事件

form.on('radio(filter)', callback);

• radio 为单选框事件固定名称
• filter 为单选框元素对应的 lay-filter 属性值

该事件在单选框被点击或选中时触发。

  <div class="layui-form">
  <div class="layui-form-item">
    <input type="radio" name="AAA" value="1" title="选项1" lay-filter="demo-radio-filter" checked>
    <input type="radio" name="AAA" value="2" lay-filter="demo-radio-filter" title="选项2"> 
    <input type="radio" name="AAA" value="3" lay-filter="demo-radio-filter" title="选项3"> 
  </div>
  <div class="layui-form-item">
    <button class="layui-btn" lay-submit lay-filter="demo-radio-submit">确认</button>
  </div>
</div>

<!-- import layui --> 
<script>
layui.use(function(){
  var form = layui.form;
  var layer = layui.layer;

  // radio 事件
  form.on('radio(demo-radio-filter)', function(data){
    var elem = data.elem; // 获得 radio 原始 DOM 对象
    var checked = elem.checked; // 获得 radio 选中状态
    var value = elem.value; // 获得 radio 值
    var othis = data.othis; // 获得 radio 元素被替换后的 jQuery 对象
    
    layer.msg(['value: '+ value, 'checked: '+ checked].join('<br>'));
  });

  // 通过表单提交事件，演示 radio 不同状态下的字段结果
  form.on('submit(demo-radio-submit)', function(data){
    var field = data.field; // 获取表单字段值
    // 显示填写结果，仅作演示用
    layer.alert(JSON.stringify(field), {
      title: '当前填写的字段值'
    });
    // 此处可执行 Ajax 等操作
    // …
    return false; // 阻止默认 form 跳转
  });
});
</script>