Radioknapp

Komponent
Status
Produktionsklar
Innehåll

Använd radioknappar när användaren ska välja endast ett alternativ från en lista med flera svarsalternativ. Radioknappar har en gemensam etikett som beskriver vad användaren ska ta ställning till.

Användning

Radioknappar eller dropplista

Radioknappar tar mer plats än en dropplista eftersom alla svarsalternativ visas direkt. Det gör det lättare att överblicka och jämföra alternativen. En dropplista passar bättre när alternativen är många eller när antalet kan variera och bli stort.

Placering

Visa radioknappar vertikalt som standard. Horisontell placering kan användas när det finns två korta svarsalternativ, till exempel ja och nej. På mindre skärmar visas alternativen alltid vertikalt.

-<f-fieldset name="arbete-annat-land">
+<f-fieldset name="arbete-annat-land" horizontal>

Förvalt alternativ

Undvik att markera ett alternativ från början. Låt användaren i stället göra ett aktivt val. Då minskar risken för att frågan missas eller att användaren skickar in ett svar som inte stämmer.

När inget alternativ passar

När användaren har valt ett alternativ går det inte att återställa en grupp med radioknappar till att inget alternativ är valt. Om användaren ska kunna svara att inget alternativ passar behöver det finnas ett särskilt svarsalternativ, till exempel ”Inget av alternativen ovan”. Placera det sist i listan. Detta gäller både obligatoriska och frivilliga frågor.

Utvidgad text

Använd utvidgad text när ett alternativ behöver förklaras eller förtydligas. Håll alternativets huvudsakliga text kort. Den utvidgade texten visas på en egen rad, vilket gör alternativen lättare att överblicka och skapar en tydlig visuell hierarki mellan alternativet och den kompletterande informationen.

Texten ska vara kort och beskriva det enskilda alternativet. Information som gäller hela frågan ska i stället placeras som hjälptext vid frågan.

-<f-fieldset name="care-reason">
+<f-fieldset name="care-reason" show-details="always">

Inramade alternativ med expanderbar text

Använd inramade alternativ med expanderbar text när varje val behöver framträda som en egen tydlig och klickbar yta och den kompletterande informationen blir relevant först efter valet. Ramen gör det tydligare vilken text som hör till respektive alternativ när innehållet visas.

Dölj inte information som användaren behöver för att kunna välja.

-<f-fieldset name="payment-plan">
+<f-fieldset name="payment-plan" border show-details="when-selected">

Kod och API

Här visas möjliga inställningar för komponenten. Vissa kombinationer bör undvikas. Se användningsråden ovan för rekommenderade sätt att använda komponenten.

Migrera från FRadioGroup

FRadioGroup och FRadioGroupField har tagits bort och ersatts av FFieldset respektive FRadioField. Se migreringsguiden för information om hur du uppdaterar din kod.

Validering

Om användaren måste välja ett alternativ ska radioknappsgruppen valideras som obligatorisk. Lägg v-validation.required på FFieldset.

-<f-fieldset name="arbete-annat-land">
+<f-fieldset v-validation.required name="arbete-annat-land">

Läs mer om validering och felhantering.

FFieldset

Props

id: string Optional

The id for the fieldset id attribute. If the prop is not set a random value will be generated.

Default: () => ElementIdService.generateElementId()

name: string Optional

Name provided to child content as sharedName for optional usage (it will not be set on the fieldset element). For radio inputs this is a shortcut to specify the shared name attribute at one place, instead of repeatedly setting the name attribute on each radio input.

Default: undefined

labelClass: string Optional

The CSS classes for the label, description and error-message slot.

Default: ""

contentClass: string Optional

The CSS classes for the default slot.

Default: ""

horizontal: boolean Optional

Aligns underlying items horizontally. Supported by radiobuttons and chip layout.

chip: boolean Optional

Displays radio and checkbox content with chip layout.

border: boolean Optional

Displays a box with border around radiobuttons and checkboxes.

showDetails: "never" | "when-selected" | "always" Optional

Sets visibility behaviour for details slot in selectable child items. By default details slot is not rendered.

  • never (default) - Never show item details.
  • when-selected - Show item details when selected.
  • always - Always show item details.

Default: "never"

Slots

label

Slot for label content. This slot is required.

description

Optional slot for description. See FLabel for details.

Bindings:

  • description-class: string[] — CSS classes for primary description content.
  • format-description-class: string[] — CSS classes for format description.
error-message

Optional slot for displaying one or more error messages.

Bindings:

  • hasError: boolean — Set to true when a validation error is present.
  • validationMessage: string — Descriptive validation error message for the current error.
tooltip

Slot for tooltip.

default

Slot for fieldset content.

FRadioField

Models

v-model: anyType Optional

Current value selected in the radio button group. The radio button is checked when this value strictly equals the value prop.

Default: () => undefined

Props

disabled: boolean Optional

Disables the radio button.

id: string Optional

The id for the input id attribute. The id for the label for attribute. If the prop is not set a random value will be generated.

Default: () => ElementIdService.generateElementId()

value: anyType Optional

The value represented by this radio button.

Default: () => undefined

Events

change

Emitted when the radio button is selected.

Arguments:

  • value: anyType — Value of the selected radio button.

Slots

default

Slot for label content.

details

Slot for additional information about the option.

Bindings:

  • height: number — The height of the expanded details content.

Sök

Esc för att stänga Pil upp/ner för att navigera Enter för att välja

Välj version

Var god vänta, laddar versionsdata...