Använd multi-select när användaren kan välja mer än ett av minst åtta alternativ.
Hjälptexten ska hjälpa användaren att fylla i rätt information i fältet.
I första hand ska du använda en så pass tydlig etikett så att en hjälptext inte behövs. Behöver du använda en hjälptext kan du välja mellan två varianter. Du ska använda samma variant i hela systemet och alltså inte blanda dem. Varianterna är:
Behöver du en hjälptext ska du i första hand välja den statiska hjälptexten. Hjälptexten ska vara trevlig men inte pratig. Texten ska vara kort men tillräckligt informativ för att användaren ska bli hjälpt av den. Meningarna i hjälptexten ska börja med stor bokstav och sluta med punkt. För att kunna skriva en bra hjälptext behöver du också förstå användarens behov.
Komponenten driftsattes första gången i version 6.0.0. Denna komponent kräver Javascript för att fungera.
Egenskap | Attribut | Beskrivning | Typ | Förvalt värde | |
---|---|---|---|---|---|
disabled | disabled | Is multi-select disabled? | boolean | false | |
errorText | error-text | Feltext i multi-select. | string | - | |
errorTextRef | error-text-ref | Referens till en feltext som visas ifall "valid" är satt till "false". | string | - | |
helpTextRef | help-text-ref | Reference till hjälptext i multi-select. | string | - | |
extraClass | extra-class | Lägg till extra klasser i parent elementet string t.ex. extra-class="classnamn1 classnamn2" | string | - | |
inputId | input-id | Id på komponenten. | string | - | |
label | label | label text. | string | - | |
open | open | Är multiselect open? | boolean | - | |
options | options | Lista av valbar alternativ. Om du skickar in en objektlista så förväntas det finnas ett attribut value som är det som visas i multi-selecten. Obs. måste föjla json format. | Object[] | string | string[] | - | |
optionsDisplayAttribute | options-display-attribute | Specificerar vilket attribut i options som ska visas upp i listan med valbara alternativ. OBS. endast aktuell om options är en lista med objekt. Om options är en lista med stängar kommer värdet på detta attribut att ignoreras. | string | 'value' | |
required | required | Är multiselect required? | boolean | false | |
size | size | Storlek på komponenten, möjliga storlekar small och medium. | string | 'medium' | |
valid | valid | Är multiselect valid? | boolean | true | |
value | value | Lista med alla valda alternativ. Obs. måste föjla json format. | Object[] | string | string[] |
|
För att få multi-select att fungera med Angular FormControl och ngModel behöver du lägga in attributet ngDefaultControl som berättar för Angular att multi-select kan ses som en vanligt <input> element och kan då användas med ngModel och formControlName. Obs! Glöm inte att importera FormsModule eller ReactiveFormsModule när du använder ngModel resp. Formcontrol i din Angular modul.
<jv-multi-select ngDefaultControl formControlName="<Your formcontrolname>"
[options]="<Your options>" [value]="<Your formcontrol model>"
label="<Your label>">
</jv-multi-select>
<jv-multi-select options='[{"value":"Norge"},
{"value":"Danmark"},
{"value":"Finland"},
{"value":"Tyskland"},
{"value":"Frankrike"},
{"value":"Ryssland"},
{"value":"Polen"},
{"value":"Italien"},
{"value":"Storbritannien"},
{"value":"Spanien"},
{"value":"Ukraina"},
{"value":"Nederländerna"},
{"value":"Belgien"},
{"value":"Grekland"},
{"value":"Irland"},
{"value":"Portugal"},
{"value":"Island"}]' label="Vilka länder har du besökt det senaste året?">
</jv-multi-select>
<jv-multi-select size="small" options='[{"value":"Norge"},
{"value":"Danmark"},
{"value":"Finland"},
{"value":"Tyskland"},
{"value":"Frankrike"},
{"value":"Ryssland"},
{"value":"Polen"},
{"value":"Italien"},
{"value":"Storbritannien"},
{"value":"Spanien"},
{"value":"Ukraina"},
{"value":"Nederländerna"},
{"value":"Belgien"},
{"value":"Grekland"},
{"value":"Irland"},
{"value":"Portugal"},
{"value":"Island"}]' label="Vilka länder har du besökt det senaste året?">
</jv-multi-select>
<jv-multi-select required="true" options='[{"value":"Norge"},
{"value":"Danmark"},
{"value":"Finland"},
{"value":"Tyskland"},
{"value":"Frankrike"},
{"value":"Ryssland"},
{"value":"Polen"},
{"value":"Italien"},
{"value":"Storbritannien"},
{"value":"Spanien"},
{"value":"Ukraina"},
{"value":"Nederländerna"},
{"value":"Belgien"},
{"value":"Grekland"},
{"value":"Irland"},
{"value":"Portugal"},
{"value":"Island"}]' label="Vilka länder har du besökt det senaste året?">
</jv-multi-select>
<jv-multi-select required="true" valid="false" label="Vilka länder har du besökt det senaste året?" error-text="Välj minst ett land i listan" options='[{"value":"Norge"},
{"value":"Danmark"},
{"value":"Finland"},
{"value":"Tyskland"},
{"value":"Frankrike"},
{"value":"Ryssland"},
{"value":"Polen"},
{"value":"Italien"},
{"value":"Storbritannien"},
{"value":"Spanien"},
{"value":"Ukraina"},
{"value":"Nederländerna"},
{"value":"Belgien"},
{"value":"Grekland"},
{"value":"Irland"},
{"value":"Portugal"},
{"value":"Island"}]'>
</jv-multi-select>
<jv-multi-select help-text-ref="helptext" options='[{"value":"Norge"},
{"value":"Danmark"},
{"value":"Finland"},
{"value":"Tyskland"},
{"value":"Frankrike"},
{"value":"Ryssland"},
{"value":"Polen"},
{"value":"Italien"},
{"value":"Storbritannien"},
{"value":"Spanien"},
{"value":"Ukraina"},
{"value":"Nederländerna"},
{"value":"Belgien"},
{"value":"Grekland"},
{"value":"Irland"},
{"value":"Portugal"},
{"value":"Island"}]' label="Vilka länder har du besökt det senaste året?">
<span slot="helptext" class="label__description">
Lite text med beskrivning för hur du ska besvara denna fråga och för att testa hur en lång
beskrivning ser ut tillsammans med ett felmeddelande ifall man fyllt i fel eller inte alls.
</span>
</jv-multi-select>
<jv-multi-select help-text-ref="helptext" options='[{"value":"Norge"},
{"value":"Danmark"},
{"value":"Finland"},
{"value":"Tyskland"},
{"value":"Frankrike"},
{"value":"Ryssland"},
{"value":"Polen"},
{"value":"Italien"},
{"value":"Storbritannien"},
{"value":"Spanien"},
{"value":"Ukraina"},
{"value":"Nederländerna"},
{"value":"Belgien"},
{"value":"Grekland"},
{"value":"Irland"},
{"value":"Portugal"},
{"value":"Island"}]' label="Vilka länder har du besökt det senaste året?">
<jv-help-text slot="helptext"><span>Lite text med beskrivning för hur du ska besvara denna fråga och för
att testa hur en
lång beskrivning ser ut tillsammans med ett felmeddelande ifall man fyllt i fel eller inte alls.
</span>
</jv-help-text>
</jv-multi-select>
<jv-multi-select disabled="true" help-text-ref="helptext3" label="Vilka länder har du besökt det senaste året?" options='[{"value":"Norge"},
{"value":"Danmark"},
{"value":"Finland"},
{"value":"Tyskland"},
{"value":"Frankrike"},
{"value":"Ryssland"},
{"value":"Polen"},
{"value":"Italien"},
{"value":"Storbritannien"},
{"value":"Spanien"},
{"value":"Ukraina"},
{"value":"Nederländerna"},
{"value":"Belgien"},
{"value":"Grekland"},
{"value":"Irland"},
{"value":"Portugal"},
{"value":"Island"}]' value='["Norge"]'>
<jv-help-text slot="helptext3">
<span>
Lite text med beskrivning för hur du ska besvara denna fråga och för att testa hur en lång beskrivning
ser ut tillsammans med ett felmeddelande ifall man fyllt i fel eller inte alls.
</span>
</jv-help-text>
</jv-multi-select>
Senast publicerad
Sidansvarig för sidan är Styleguide