Radio

KRadio - KRadio is a wrapper around a Kong styled radio input.

BooleanStringObject AObject B

Selected: true

<template>
  <KRadio name="test" :selected-value="true" v-model="radio">Boolean</KRadio>
  <KRadio name="test" selected-value="string" v-model="radio">String</KRadio>
  <KRadio name="test" :selected-value="objA" v-model="radio">Object A</KRadio>
  <KRadio name="test" :selected-value="objB" v-model="radio">Object B</KRadio>
  <div class="mt-3">Selected: {{ radio }}</div>
</template>

<script lang="ts">
import { defineComponent, reactive, toRefs } from 'vue'

export default defineComponent({
  setup() {
    const data = reactive({
      objA: { name: 'a' },
      objB: { name: 'b' },
      radio: true,
    })

    return {
      ...toRefs(data),
    }
  }
})
</script>

Props

v-model - required

Use v-model to bind the checked state of the underlying <input />. The v-model binds to the modelValue prop of the component and sets the current checked state of the input. You can read more about passing values via v-model here.

selectedValue

The value of the KRadio option that will be emitted by the change and update:modelValue events.

HTML attributes

Any valid attribute will be added to the input. You can read more about $attrs here.

<KRadio v-model="checked" :selected-value="true" disabled>Disabled radio</KRadio>

Disabled radio

Slots

• default - Anything passed in to the default slot will replace the label prop text

Label goes here. The radio is not selected

<KRadio v-model="selected" :selected-value="true">
  Label goes here. The radio is {{ selected ? 'selected' : 'not selected' }}
</KRadio>

Events

KRadio has a couple of natural event bindings that all emit the same data when a radio option is selected.

• change - Fired on change, returns the checked status of the radio.
• update:modelValue - Fired on change, returns the checked status of the radio.

Theming

Variable	Purpose
--KRadioPrimary	Radio primary background & border color
--KRadioDisabled	Radio disabled background color

An Example of changing the background color of KRadio to lime might look like:

Note: We are scoping the overrides to a wrapper in this example

<template>
  <div class="KRadio-wrapper">
    <KRadio v-model="selected" :selected-value="true" />
  </div>
</template>

<style>
.KRadio-wrapper {
  --KRadioPrimary: lime;
}
</style>