Switch

Definition

<cst-switch>
<sub-theme/>
<sub-font/>
<sub-style/>
<sub-access/>
<sub-lr-label/>
<sub-lr-label/>
<sub-lr-icon/>
<sub-lr-icon/>
<sub-help-icon/>
<sub-feature-flag/>
</cst-switch>

Example

<cst-switch id="" value="">
<sub-theme name="" clr-var1="" clr-var2=""/>
<sub-font name="" font-var1="" font-var2=""/>
<sub-style name="" width="" height=""/>
<sub-access can-view="" can-modify=""/>
<sub-lr-label text="" position="right"/>
<sub-lr-label text="" position=""/>
<sub-lr-icon name="" position="" title="" link=""/>
<sub-lr-icon name="" position="" title="" link=""/>
<sub-help-icon name="" position="" title="" link="">
<sub-feature-flag char-count-hide="">
</cst-switch>

OR

<cst-element name="switch" schema="" schema-prop="" value=""/>

Attributes

AttributeValueDescription
idstring typeIdentifier for component.
valueboolean typeSpecifies the value for component.(two way bind attribute)
classSpecifies class to be applied(Multiple classes can be given with space).

sub-theme

object typeSpecifies theme to be used for component.

sub-font

object typeSpecifies fonts to be used for component.

sub-style

object typeSpecifies style to be applied to component.

sub-lr-labels

array type

Specifies fixed text to be displayed in text field. Ref

sub-lr-icons

array typeSpecifies icons to be displayed.

sub-help-icon

object typeSpecifies help icon to be displayed.

sub-feature-flag

objectSpecifies what features to enable/disable.
otherany typeAny other info.
schemaobject type Specifies JSON schema.
schema-propstring typeSpecifies property to be used to pick schema.

Sub element attributes

sub-theme

PropertyValueDescription
nameprimary(default)/secondary/customName of the theme.
clr-labelstring typeIf custom then specific/ named color variables

sub-font

PropertyValueDescription
nameroboto (default)/customName of the font
font-textstring typeIf custom then specific/ named font variables.
font-labelstring type
font-errorstring type

sub-style

PropertyValueDescription
namematerial/skeuomorphic(standard/filled/shaped-filled/outlined/shaped-outlined)Name of design to be used.
widthpercentage/pixels/string(x-small,small,medium,large,x-large)Gives width/any other prop value

sub-lr-labels

(a.k.a left right labels)

PropertyValueDescription
textstring typeLabel text.
positionleft/rightPosition of the label.

sub-help-icon

PropertyValueDescription
namestring typeIcon name.
positionleft/rightPosition of the icon.
titlestring typeIcon tooltip
linkstring typeLink to be opened on click.

sub-feature-flag

PropertyValueDescription

Schema Examples

Full schema

Fetch appropriate based on schemaProp

let schema = {
type: "object",
properties: {
onOffSwitch: {
type: "boolean",
title:"Click",//= label
cstAttr: {
raw:{ //loop & add to element
disabled : true,
class:'outline cst-class1'
},
others:{
},
subStyle:{ //loop & add to element style
name: '',
width:'',
height:'',
fontSize:''
},
subLrLabels: [{
text: '',
position: ''
}],
subLrIcons:[{
name:'',
position:'',
title:''
}],
subHelpIcon: {
name: '',
position: '',
title:'',
link:''
},
subFeatureFlag: {
},
subTheme:{
name:'',
clrLabel:''
},
subFont:{
name:'',
fontText:'',
fontLabel:'',
fontError:''
}
}
}
}
}
let schemaProp = 'onOffSwitch';
let value = true
let finalSchema = schemaProp ? schema.properties[schemaProp] : schema;

Exact schema

let schema = {
type: "boolean",
title: "Click", //= label
cstAttr: {
}
}
let schemaProp = '';
let value = false
let finalSchema = schemaProp ? schema.properties[schemaProp] : schema;

Nested object

Nested object schemaProp

let schema = {};
let schemaProp = 'EMDDetails.onOffSwitch';
let value = false
var finalSchema = schema;
let schemaPropSplits = schemaProp.split('.');
for(let prop of schemaPropSplits){
finalSchema = finalSchema.properties[schemaProp];
}

Events

AttributeDescription
onchangeFires when the value gets changed.

Event Method signature

method(parentRefObj, evtObj, elm, others)

Parameters description

ParameterValueDescription
parentRefObj
parentRefObj = {
parentContext,
loopParentContext,
doubleLoopParentContext
}
Parent Context references
evtObjobjectEvent object
elmobjectElement value
othersanyOther value

OverRidable Classes

  • cst-ovr-switch-elm
  • cst-ovr-switch
  • cst-ovr-switch-label

Unit Test Screenshots

Responsiveness Test Screenshots

Design Images

Demo link

Points

  • It will display toggle switch button
  • Click on switch, value will be change