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: stringOptional -
The id for the fieldset id attribute. If the prop is not set a random value will be generated.
Default:
() => ElementIdService.generateElementId() -
name: stringOptional -
Name provided to child content as
sharedNamefor 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: stringOptional -
The CSS classes for the label, description and error-message slot.
Default:
"" -
contentClass: stringOptional -
The CSS classes for the default slot.
Default:
"" -
horizontal: booleanOptional -
Aligns underlying items horizontally. Supported by radiobuttons and chip layout.
-
chip: booleanOptional -
Displays radio and checkbox content with chip layout.
-
border: booleanOptional -
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
FLabelfor 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: anyTypeOptional -
Current value selected in the radio button group. The radio button is checked when this value strictly equals the
valueprop.Default:
() => undefined
Props
-
disabled: booleanOptional -
Disables the radio button.
-
id: stringOptional -
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: anyTypeOptional -
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.