npm - @salesforce-ux/design-system - Versions diffs - 2.27.1 → 2.27.2 - Mend

@salesforce-ux/design-system 2.27.1 → 2.27.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (859) hide show

package/__internal/chunked/docs/ui/components/cards/docs.mdx.js CHANGED Viewed

	@@ -1 +1 @@
1	- var SLDS="object"==typeof SLDS?SLDS:{};SLDS["__internal/chunked/docs/./ui/components/cards/docs.mdx.js"]=function(e){function t(t){for(var n,c,r=t[0],i=t[1],d=t[2],m=0,u=[];m<r.length;m++)c=r[m],Object.prototype.hasOwnProperty.call(l,c)&&l[c]&&u.push(l[c][0]),l[c]=0;for(n in i)Object.prototype.hasOwnProperty.call(i,n)&&(e[n]=i[n]);for(o&&o(t);u.length;)u.shift()();return s.push.apply(s,d\|\|[]),a()}function a(){for(var e,t=0;t<s.length;t++){for(var a=s[t],n=!0,r=1;r<a.length;r++){var i=a[r];0!==l[i]&&(n=!1)}n&&(s.splice(t--,1),e=c(c.s=a[0]))}return e}var n={},l={14:0},s=[];function c(t){if(n[t])return n[t].exports;var a=n[t]={i:t,l:!1,exports:{}};return e[t].call(a.exports,a,a.exports,c),a.l=!0,a.exports}c.m=e,c.c=n,c.d=function(e,t,a){c.o(e,t)\|\|Object.defineProperty(e,t,{enumerable:!0,get:a})},c.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},c.t=function(e,t){if(1&t&&(e=c(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var a=Object.create(null);if(c.r(a),Object.defineProperty(a,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var n in e)c.d(a,n,function(t){return e[t]}.bind(null,n));return a},c.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return c.d(t,"a",t),t},c.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},c.p="/assets/scripts/bundle/";var r=this.webpackJsonpSLDS___internal_chunked_docs=this.webpackJsonpSLDS___internal_chunked_docs\|\|[],i=r.push.bind(r);r.push=t,r=r.slice();for(var d=0;d<r.length;d++)t(r[d]);var o=i;return s.push([731,0]),a()}({0:function(e,t){e.exports=React},20:function(e,t){e.exports=ReactDOM},22:function(e,t){e.exports=JSBeautify},731:function(e,t,a){"use strict";a.r(t),a.d(t,"getElement",(function(){return U})),a.d(t,"getContents",(function(){return X}));var n=a(0),l=a.n(n),s=a(4),c=a(2),r=(a(27),a(15)),i=a(14),d=a(13),o=a(152),m=a(82),u=a(35),h=a(6),b=a(57),E=a(65),f=a(33),p=l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New"),y=l.a.createElement(h.s,{isFixedLayout:!0,isBordered:!0,hasNoRowHover:!0,hasCellBuffer:!0,type:"advanced",ariaLabel:"Example table in a Card"},l.a.createElement(h.q,null,l.a.createElement(h.r,null,l.a.createElement(h.c,null,l.a.createElement(h.b,{columnName:"Name"})),l.a.createElement(h.c,null,l.a.createElement(h.b,{columnName:"Company"})),l.a.createElement(h.c,null,l.a.createElement(h.b,{columnName:"Title"})),l.a.createElement(h.c,null,l.a.createElement(h.b,{columnName:"Email"})))),l.a.createElement(h.o,null,l.a.createElement(h.p,null,l.a.createElement(h.m,null,l.a.createElement(h.j,{cellLink:!0,cellText:"Amy Choi"})),l.a.createElement(h.t,{type:"advanced"},l.a.createElement(h.j,{cellText:"Company One"})),l.a.createElement(h.t,{type:"advanced"},l.a.createElement(h.j,{cellText:"Director of Operations"})),l.a.createElement(h.t,{type:"advanced"},l.a.createElement(h.j,{cellText:"adam@company.com"}))))),g=l.a.createElement("ul",{className:"slds-grid slds-wrap slds-grid_pull-padded"},l.a.createElement("li",{className:"slds-p-horizontal_small slds-size_1-of-1 slds-medium-size_1-of-3"},l.a.createElement(m.a,{actions:!0,className:"slds-card__tile",media:l.a.createElement(u.a,{className:"slds-icon_small",symbol:"contact",assistiveText:"Contact"}),title:"Related Record Title 1"})),l.a.createElement("li",{className:"slds-p-horizontal_small slds-size_1-of-1 slds-medium-size_1-of-3"},l.a.createElement(m.a,{actions:!0,className:"slds-card__tile",media:l.a.createElement(u.a,{className:"slds-icon_small",symbol:"contact",assistiveText:"Contact"}),title:"Related Record Title 1"})),l.a.createElement("li",{className:"slds-p-horizontal_small slds-size_1-of-1 slds-medium-size_1-of-3"},l.a.createElement(m.a,{actions:!0,className:"slds-card__tile",media:l.a.createElement(u.a,{className:"slds-icon_small",symbol:"contact",assistiveText:"Contact"}),title:"Related Record Title 1"}))),w=function(e){return l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Contacts (1)",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,null,y),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts")))},v=function(e){return l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Contacts (3)",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,{hasPadding:!0},g),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts")))},_=function(e){return l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Outer Card Header",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,{hasPadding:!0},l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Contacts",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,{hasPadding:!0},"This is a card inside an `slds-card` to show how styling is removed when cards are nested inside each other."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts"))),l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Contacts",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,{hasPadding:!0},"This is a card inside an `slds-card` to show how styling is removed when cards are nested inside each other."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts"))),l.a.createElement(d.d,{hasCardBoundary:!0},l.a.createElement(d.c,{title:"Contacts",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,{hasPadding:!0},"This is a card inside an `slds-card` to illustrate how `slds-card_boundary` adds a rounded border when desired."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts"))),l.a.createElement(d.d,{hasCardBoundary:!0},l.a.createElement(d.c,{title:"Contacts",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,{hasPadding:!0},"This is a card inside an `slds-card` to illustrate how `slds-card_boundary` adds a rounded border when desired."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts")))))},O=[{id:"default",label:"Default",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Accounts",href:!0,symbol:"account",action:l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New")}),l.a.createElement(d.a,{hasPadding:!0},"Anything can go into the card body"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))}],j=[{id:"empty",label:"Empty",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Card Header",href:!0,symbol:"contact",action:l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New")}),l.a.createElement(d.a,null),l.a.createElement(d.b,null))},{id:"empty-illustration",label:"Empty with illustration",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Tasks",href:!0,symbol:"task"}),l.a.createElement(d.a,{hasPadding:!0},l.a.createElement(f.a,null,l.a.createElement(E.d,null),l.a.createElement(f.c,{heading:"No new tasks",message:"Nothing needs your attention right now. Check back later."}))))},{id:"loading",label:"Loading",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Tasks",href:!0,symbol:"task"}),l.a.createElement(d.a,{hasPadding:!0},l.a.createElement(b.a,{className:"slds-spinner_small"})))}],N=[{id:"related-list-table",label:"With data-table",element:l.a.createElement(w,null)},{id:"related-list-tiles",label:"With tiles",element:l.a.createElement(v,null)},{id:"nested-cards",label:"Nested cards",element:l.a.createElement(_,null)},{id:"with-no-header",label:"With no header",element:l.a.createElement(d.d,null,l.a.createElement(d.a,{hasPadding:!0},"Anything can go into the card body"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))},{id:"visibly-hidden-card-header",label:"Visibly hidden card header",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Card Header",href:!0,className:"slds-assistive-text"}),l.a.createElement(d.a,{hasPadding:!0},"Anything can go into the card body"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))},{id:"body-has-no-padding",label:"Body with no padding",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Accounts",href:!0,symbol:"account"}),l.a.createElement(d.a,null,"Card Body"))},{id:"body-has-padding",label:"Body with padding",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Accounts",href:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},"Card Body with Padding"))},{id:"has-no-footer",label:"No footer",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Accounts",href:!0,showIcon:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},"Card Body"),l.a.createElement(d.b,null))},{id:"has-footer",label:"Has footer",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Accounts",href:!0,showIcon:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},"Card Body"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))},{id:"nested-no-boundary",label:"Nested with no boundary",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Outer Card Header",href:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Card Header",href:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},"This is a nested card with no styling (default)"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))},{id:"nested-with-boundary",label:"Nested with boundary",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Outer Card Header",href:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},l.a.createElement(d.d,{hasCardBoundary:!0},l.a.createElement(d.c,{title:"Card Header",href:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},"This is a card inside an `slds-card` to illustrate how `slds-card_boundary` adds a rounded border when desired."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))},{id:"with-long-truncated-title",label:"With long truncated title",demoStyles:"max-width: 360px;",storybookStyles:!0,element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Card Header Title With Exceptionally Long Title",href:!0,symbol:"account",action:l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New")}),l.a.createElement(d.a,{hasPadding:!0},"Anything can go into the card body"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))},{id:"styling-hooks",label:"Styling Hooks",demoStyles:"\n --slds-c-card-color-background: #f3f3f3;\n --slds-c-card-radius-border: 8px;\n --slds-c-card-shadow: rgba(0,0,0,.15) 0 4px 8px, rgba(0,0,0,.05) 0 2px 4px;\n --slds-c-card-spacing-block-start: 1.5rem;\n --slds-c-card-spacing-block-end: 0.5rem;\n --slds-c-card-spacing-inline: 1rem;\n --slds-c-card-title-font-size: 1.5rem;\n --slds-c-card-header-spacing-block-start: 0;\n --slds-c-card-header-spacing-inline-start: 1.5rem;\n --slds-c-card-header-spacing-inline-end: 1.5rem;\n --slds-c-card-body-spacing-inline-start: 1.5rem;\n --slds-c-card-body-spacing-inline-end: 1.5rem;\n --slds-c-card-body-spacing-block-end: 1rem;\n --slds-c-card-footer-spacing-block-start: 0.5rem;\n --slds-c-card-footer-spacing-block-end: 0;\n --slds-c-card-footer-spacing-inline-start: 1.5rem;\n --slds-c-card-footer-spacing-inline-end: 1.5rem;\n --slds-c-card-footer-font-size: 0.75rem;\n --slds-c-card-footer-text-align: right;\n ",storybookStyles:!0,element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Accounts",href:!0,symbol:"account",action:l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New")}),l.a.createElement(d.a,null,"Anything can go into the card body"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))}],x=a(9),C=a(7),A=a(60),T=a(5),k=a.n(T),S=function(e){return l.a.createElement("div",{className:"slds-einstein-header__actions"},l.a.createElement(A.a,null,l.a.createElement(C.b,{className:"slds-button_icon-border-filled",symbol:"email",assistiveText:"Email",title:"Email","aria-pressed":"false"}),l.a.createElement(C.b,{className:"slds-button_icon-border-filled",symbol:"edit",assistiveText:"Edit",title:"Edit","aria-pressed":"false"})))},W=function(e){return l.a.createElement("div",{className:k()("slds-grid slds-einstein-header",e.className)},e.closeButton?l.a.createElement(C.b,{className:k()("slds-button_icon-small slds-float_right slds-popover__close",e.inverse?"slds-button_icon-inverse":"slds-button_icon"),symbol:"close",assistiveText:"Close dialog",title:"Close dialog"}):null,l.a.createElement("header",{className:k()("slds-media slds-media_center slds-has-flexi-truncate")},l.a.createElement("div",{className:"slds-grid slds-grid_vertical-align-center slds-size_3-of-4 slds-medium-size_2-of-3"},e.symbol?l.a.createElement("div",{className:"slds-media__figure"},l.a.createElement("span",{className:"slds-icon_container slds-icon-utility-"+e.symbol},l.a.createElement(x.a,{className:"slds-icon slds-icon_small slds-icon-text-default",sprite:"utility",symbol:e.symbol}))):null,l.a.createElement("div",{className:"slds-media__body"},l.a.createElement("h2",{className:"slds-truncate",id:e.headingId,title:e.headerTitle\|\|"Einstein"},e.hasLink?l.a.createElement("a",{href:"#",className:"slds-card__header-link",title:e.headerTitle\|\|"Einstein",onClick:function(e){return e.preventDefault()}},l.a.createElement("span",{className:"slds-text-heading_small"},e.headerTitle\|\|"Einstein")):l.a.createElement("span",{className:"slds-text-heading_small"},e.headerTitle\|\|"Einstein")))),l.a.createElement("div",{className:"slds-einstein-header__figure slds-size_1-of-4 slds-medium-size_1-of-3"})),e.actions&&l.a.createElement(S,null))},P=function(e){return l.a.createElement(d.d,null,l.a.createElement(W,{className:"slds-card__header",headerTitle:"Einstein (10+)",hasLink:!0,actions:e.hasActions,symbol:e.hasIcon&&"salesforce1"}),l.a.createElement(d.a,{hasPadding:!0},"Card Body"),l.a.createElement(d.b,null,"View All"," ",l.a.createElement("span",{className:"slds-assistive-text"},"Einstein Recommendations")))},D=l.a.createElement(P,null),V=[{id:"einstein-with-icon",label:"Einstein card - with icon",element:l.a.createElement(P,{hasIcon:!0})},{id:"einstein-with-icon-and-actions",label:"Einstein card - with icon and actions",element:l.a.createElement(P,{hasIcon:!0,hasActions:!0})}],B=a(31),I=[{id:"default",label:"Default",element:l.a.createElement("div",{className:"slds-card-wrapper"},l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Contacts",href:!0,symbol:"contact",action:l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New")}),l.a.createElement(d.a,null,"This is a card inside an `slds-card-wrapper` to show how styling is removed when cards are nested inside."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts"))),l.a.createElement(d.d,{hasCardBoundary:!0},l.a.createElement(d.c,{title:"Contacts",href:!0,symbol:"contact",action:l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New")}),l.a.createElement(d.a,{hasPadding:!0},"This is a card inside an `slds-card-wrapper` to illustrate how `slds-card_boundary` adds a rounded border when desired."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts"))))}],L=(B.a,B.a.Item,d.d,d.c,d.a,d.b,d.d,d.c,d.a,d.b,B.a.Item,B.a.Item,B.a,B.a.Item,d.d,d.c,d.a,d.b,d.d,d.c,d.a,d.b,B.a.Item,B.a.Item,a(1)),z=a(39),H=a(40),M=s.c.a,R=s.c.code,F=s.c.em,J=s.c.h2,q=s.c.h3,Y=s.c.h4,G=s.c.h5,K=s.c.p,Q=s.c.strong,U=function(){return Object(n.createElement)(s.b,{},Object(n.createElement)("div",{className:"lead doc"},"Cards are used to apply a container around a related grouping of information."),Object(n.createElement)(c.a,{exampleOnly:!0},Object(L.f)(O)),J({id:"About-Cards"},"About Cards"),K({},"To initialize a card, apply the ",R({},"slds-card")," class to an ",R({},"<article>")," element."),q({id:"Accessibility"},"Accessibility"),K({},"Cards should use an underlying ",R({},"<article>")," element to maintain usability for some screen reader users."),K({},"If the card header icon is redundant with the card header text, the assistive text is not needed."),K({},"The card heading level should follow the DOM structure of the page. We are using ",R({},"h2")," as the default heading level for examples, but real world use will dictate the correct level based on the surrounding elements."),q({id:"Mobile"},"Mobile"),Object(n.createElement)(z.a,{patternSpecificText:"cards will have bolded header title text, no top border, and no rounded corners"}),Object(n.createElement)(c.a,{frameOnly:!0,frameTitle:"Example mobile styles for cards"},Object(L.f)(O)),J({id:"Base-Card-Structure"},"Base Card Structure"),K({},"A card is made up of 3 sections, a header, a body, and a footer. The header and footer have limitations, but the body section can accommodate any layout of related information."),Object(n.createElement)(c.a,null,Object(L.f)(O)),q({id:"Header"},"Header"),K({},"The card header can have an icon, a title and actions. The icon and title are located on the left, while the actions row is located on the right side of the card header."),Object(n.createElement)(r.a,{title:"Cards Header"},Object(n.createElement)(c.a,null,Object(n.createElement)(d.d,null,Object(n.createElement)(d.c,{title:"Accounts",href:"#",onClick:function(e){return e.preventDefault()},symbol:"account"})))),Y({id:"With-no-header"},"With no header"),K({},"The card header can be removed from the HTML to prevent the card header from displaying."),Object(n.createElement)(c.a,null,Object(L.f)(N,"with-no-header")),K({},"Alternatively, the card header can be visually hidden but still accessible to screen readers by applying ",R({},"slds-assistive-text")," to the ",R({},"slds-card__header")," element."),Object(n.createElement)(c.a,null,Object(L.f)(N,"visibly-hidden-card-header")),Y({id:"Actions-row"},"Actions row"),K({},"The actions row of a card header typically accommodates a single action for the object a user is working with, such as creating, editing, or deleting. If there are more than one action, an action overflow menu would be used instead."),G({id:"Single-action"},"Single action"),Object(n.createElement)(r.a,{title:"Cards Single Action"},Object(n.createElement)(c.a,null,Object(n.createElement)(d.d,null,Object(n.createElement)(d.c,{title:"Accounts",href:"#",onClick:function(e){return e.preventDefault()},symbol:"account",action:Object(n.createElement)("button",{className:"slds-button slds-button_neutral"},"New")})))),G({id:"Multiple-actions"},"Multiple actions"),Object(n.createElement)(r.a,{title:"Cards Multiple Actions"},Object(n.createElement)(c.a,{demoStyles:"height: 10rem;"},Object(n.createElement)(d.d,null,Object(n.createElement)(d.c,{title:"Accounts",href:"#",onClick:function(e){return e.preventDefault()},symbol:"account",action:Object(n.createElement)(o.a,{position:"right"})})))),q({id:"Body"},"Body"),K({},"The card body accommodates any layout or design, as long as its a grouping of related information."),Object(n.createElement)(i.a,{type:"note",header:"Styling Note"},Object(n.createElement)("p",null,"By default, the body of a card does not have padding. Components inside the card will be flush to the left and right edges of the card. If you need to add padding, use the ",Object(n.createElement)("code",null,"slds-card__body_inner")," class on the ",Object(n.createElement)("code",null,"slds-card__body")," element.")),Y({id:"Default-without-padding"},"Default without padding"),K({},"For an example of when to use the default behavior, see the ",M({href:"/components/cards/#With-a-Data-Table"},"Data Table example"),"."),Object(n.createElement)(c.a,null,Object(L.f)(N,"body-has-no-padding")),Y({id:"With-padding"},"With padding"),K({},"For an example of when to use the ",R({},"slds-card__body_inner")," class, see the ",M({href:"/components/cards/#With-Tiles"},"Tiles example"),"."),Object(n.createElement)(c.a,null,Object(L.f)(N,"body-has-padding")),q({id:"Footer"},"Footer"),K({},"The card footer is optional and should ",F({},Q({},"only")),' have a "View All" link that takes a user to the object list view.'),Object(n.createElement)(i.a,{type:"a11y",header:"Accessibility Note"},Object(n.createElement)("p",null,"When present, the footer includes hidden assistive text to give screen reader users context about which entity they will be viewing.")),Object(n.createElement)(i.a,{type:"note",header:"Implementation Note"},Object(n.createElement)("p",null,"The examples in this documentation use the ",Object(n.createElement)("code",null,"slds-card__footer-action")," class on the footer link ",Object(n.createElement)("code",null,"<a>")," to force the footer's click target to span the entire width of the card. Simply remove this class if not needed.")),Y({id:"With-no-footer"},"With no footer"),Object(n.createElement)(c.a,null,Object(L.f)(N,"has-no-footer")),Y({id:"With-a-footer"},"With a footer"),Object(n.createElement)(c.a,null,Object(L.f)(N,"has-footer")),J({id:"Examples"},"Examples"),q({id:"Empty"},"Empty"),K({},"When a card doesn't have any data, it is represented with the body and footer collapsed by default."),Y({id:"Collapsed"},"Collapsed"),Object(n.createElement)(c.a,null,Object(L.f)(j,"empty")),Y({id:"With-Illustration"},"With Illustration"),K({},"Alternatively, a card can be represented with no data by using an ",M({href:"/components/illustration"},"illustration")," in the card body."),Object(n.createElement)(c.a,null,Object(L.f)(j,"empty-illustration")),q({id:"Loading"},"Loading"),K({},"When a card instantiates and is loading, we want to provide feedback to the user by display a spinner. Once the data has loaded, the spinner can be removed from the card component."),Object(n.createElement)(c.a,null,Object(L.f)(j,"loading")),q({id:"With-a-Data-Table"},"With a Data Table"),K({},"Placing a data table inside of an ",R({},"slds-card__body")," is an example of when to utilize the default behavior of a card body, since no padding is applied."),Object(n.createElement)(c.a,null,Object(L.f)(N,"related-list-table")),q({id:"With-Tiles"},"With Tiles"),K({},"Placing contact tiles inside of an ",R({},"slds-card__body")," is an example of using ",R({},"slds-card__body_inner")," to apply additional padding to the card body content."),Object(n.createElement)(c.a,null,Object(L.f)(N,"related-list-tiles")),Object(n.createElement)(z.b,{docsLink:"#Mobile",header:"Mobile context changes",elementName:"cards with tiles"}),Object(n.createElement)(c.a,{frameOnly:!0,frameTitle:"Example mobile styles for cards with tiles"},Object(L.f)(N,"related-list-tiles")),J({id:"Layout"},"Layout"),q({id:"Nested-Cards"},"Nested Cards"),K({},"When a card is located inside of another card body, we remove the drop shadow and border of the nested cards. You can opt into adding the border back by applying ",R({},"slds-card_boundary")," to the ",R({},"slds-card")," element."),Y({id:"No-styling"},"No styling"),Object(n.createElement)(c.a,null,Object(L.f)(N,"nested-no-boundary")),Y({id:"With-card-styling"},"With card styling"),K({},"Adding ",R({},"slds-card_boundary")," to the ",R({},"slds-card")," element will give you back the card styling."),Object(n.createElement)(c.a,null,Object(L.f)(N,"nested-with-boundary")),q({id:"Wrapped-Cards"},"Wrapped Cards"),K({},"To combine several cards into a single card look, wrap the cards using ",R({},"slds-card-wrapper"),". Similar to the nested cards, adding ",R({},"slds-card_boundary")," to the ",R({},"slds-card")," element will give you back the card styling."),Object(n.createElement)(c.a,null,Object(L.f)(I)),J({id:"Einstein-Theming"},"Einstein Theming"),K({},"For cards that contain Einstein related information, you can include an Einstein themed card header."),Object(n.createElement)(c.a,null,Object(L.f)(D)),q({id:"With-an-Icon"},"With an Icon"),Object(n.createElement)(c.a,null,Object(L.f)(V,"einstein-with-icon")),q({id:"With-Actions"},"With Actions"),Object(n.createElement)(c.a,null,Object(L.f)(V,"einstein-with-icon-and-actions")),Object(n.createElement)(z.b,{docsLink:"#Mobile",header:"Mobile context changes",elementName:"cards with Einstein theming and actions"}),Object(n.createElement)(c.a,{frameOnly:!0,frameTitle:"Example mobile styles for Einstein themed cards"},Object(L.f)(V,"einstein-with-icon-and-actions")),J({id:"Styling-Hooks-Overview"},"Styling Hooks Overview"),Object(n.createElement)(H.a,{name:"cards",type:"component"}))},X=function(){return Object(s.a)(U())}}});
1	+ var SLDS="object"==typeof SLDS?SLDS:{};SLDS["__internal/chunked/docs/./ui/components/cards/docs.mdx.js"]=function(e){function t(t){for(var n,c,r=t[0],i=t[1],d=t[2],m=0,u=[];m<r.length;m++)c=r[m],Object.prototype.hasOwnProperty.call(l,c)&&l[c]&&u.push(l[c][0]),l[c]=0;for(n in i)Object.prototype.hasOwnProperty.call(i,n)&&(e[n]=i[n]);for(o&&o(t);u.length;)u.shift()();return s.push.apply(s,d\|\|[]),a()}function a(){for(var e,t=0;t<s.length;t++){for(var a=s[t],n=!0,r=1;r<a.length;r++){var i=a[r];0!==l[i]&&(n=!1)}n&&(s.splice(t--,1),e=c(c.s=a[0]))}return e}var n={},l={14:0},s=[];function c(t){if(n[t])return n[t].exports;var a=n[t]={i:t,l:!1,exports:{}};return e[t].call(a.exports,a,a.exports,c),a.l=!0,a.exports}c.m=e,c.c=n,c.d=function(e,t,a){c.o(e,t)\|\|Object.defineProperty(e,t,{enumerable:!0,get:a})},c.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},c.t=function(e,t){if(1&t&&(e=c(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var a=Object.create(null);if(c.r(a),Object.defineProperty(a,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var n in e)c.d(a,n,function(t){return e[t]}.bind(null,n));return a},c.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return c.d(t,"a",t),t},c.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},c.p="/assets/scripts/bundle/";var r=this.webpackJsonpSLDS___internal_chunked_docs=this.webpackJsonpSLDS___internal_chunked_docs\|\|[],i=r.push.bind(r);r.push=t,r=r.slice();for(var d=0;d<r.length;d++)t(r[d]);var o=i;return s.push([732,0]),a()}({0:function(e,t){e.exports=React},20:function(e,t){e.exports=ReactDOM},22:function(e,t){e.exports=JSBeautify},732:function(e,t,a){"use strict";a.r(t),a.d(t,"getElement",(function(){return U})),a.d(t,"getContents",(function(){return X}));var n=a(0),l=a.n(n),s=a(4),c=a(2),r=(a(27),a(15)),i=a(13),d=a(14),o=a(153),m=a(83),u=a(35),h=a(6),b=a(57),E=a(65),f=a(33),p=l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New"),y=l.a.createElement(h.s,{isFixedLayout:!0,isBordered:!0,hasNoRowHover:!0,hasCellBuffer:!0,type:"advanced",ariaLabel:"Example table in a Card"},l.a.createElement(h.q,null,l.a.createElement(h.r,null,l.a.createElement(h.c,null,l.a.createElement(h.b,{columnName:"Name"})),l.a.createElement(h.c,null,l.a.createElement(h.b,{columnName:"Company"})),l.a.createElement(h.c,null,l.a.createElement(h.b,{columnName:"Title"})),l.a.createElement(h.c,null,l.a.createElement(h.b,{columnName:"Email"})))),l.a.createElement(h.o,null,l.a.createElement(h.p,null,l.a.createElement(h.m,null,l.a.createElement(h.j,{cellLink:!0,cellText:"Amy Choi"})),l.a.createElement(h.t,{type:"advanced"},l.a.createElement(h.j,{cellText:"Company One"})),l.a.createElement(h.t,{type:"advanced"},l.a.createElement(h.j,{cellText:"Director of Operations"})),l.a.createElement(h.t,{type:"advanced"},l.a.createElement(h.j,{cellText:"adam@company.com"}))))),g=l.a.createElement("ul",{className:"slds-grid slds-wrap slds-grid_pull-padded"},l.a.createElement("li",{className:"slds-p-horizontal_small slds-size_1-of-1 slds-medium-size_1-of-3"},l.a.createElement(m.a,{actions:!0,className:"slds-card__tile",media:l.a.createElement(u.a,{className:"slds-icon_small",symbol:"contact",assistiveText:"Contact"}),title:"Related Record Title 1"})),l.a.createElement("li",{className:"slds-p-horizontal_small slds-size_1-of-1 slds-medium-size_1-of-3"},l.a.createElement(m.a,{actions:!0,className:"slds-card__tile",media:l.a.createElement(u.a,{className:"slds-icon_small",symbol:"contact",assistiveText:"Contact"}),title:"Related Record Title 1"})),l.a.createElement("li",{className:"slds-p-horizontal_small slds-size_1-of-1 slds-medium-size_1-of-3"},l.a.createElement(m.a,{actions:!0,className:"slds-card__tile",media:l.a.createElement(u.a,{className:"slds-icon_small",symbol:"contact",assistiveText:"Contact"}),title:"Related Record Title 1"}))),w=function(e){return l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Contacts (1)",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,null,y),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts")))},v=function(e){return l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Contacts (3)",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,{hasPadding:!0},g),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts")))},_=function(e){return l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Outer Card Header",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,{hasPadding:!0},l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Contacts",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,{hasPadding:!0},"This is a card inside an `slds-card` to show how styling is removed when cards are nested inside each other."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts"))),l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Contacts",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,{hasPadding:!0},"This is a card inside an `slds-card` to show how styling is removed when cards are nested inside each other."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts"))),l.a.createElement(d.d,{hasCardBoundary:!0},l.a.createElement(d.c,{title:"Contacts",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,{hasPadding:!0},"This is a card inside an `slds-card` to illustrate how `slds-card_boundary` adds a rounded border when desired."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts"))),l.a.createElement(d.d,{hasCardBoundary:!0},l.a.createElement(d.c,{title:"Contacts",href:!0,symbol:"contact",action:p}),l.a.createElement(d.a,{hasPadding:!0},"This is a card inside an `slds-card` to illustrate how `slds-card_boundary` adds a rounded border when desired."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts")))))},O=[{id:"default",label:"Default",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Accounts",href:!0,symbol:"account",action:l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New")}),l.a.createElement(d.a,{hasPadding:!0},"Anything can go into the card body"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))}],j=[{id:"empty",label:"Empty",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Card Header",href:!0,symbol:"contact",action:l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New")}),l.a.createElement(d.a,null),l.a.createElement(d.b,null))},{id:"empty-illustration",label:"Empty with illustration",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Tasks",href:!0,symbol:"task"}),l.a.createElement(d.a,{hasPadding:!0},l.a.createElement(f.a,null,l.a.createElement(E.d,null),l.a.createElement(f.c,{heading:"No new tasks",message:"Nothing needs your attention right now. Check back later."}))))},{id:"loading",label:"Loading",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Tasks",href:!0,symbol:"task"}),l.a.createElement(d.a,{hasPadding:!0},l.a.createElement(b.a,{className:"slds-spinner_small"})))}],N=[{id:"related-list-table",label:"With data-table",element:l.a.createElement(w,null)},{id:"related-list-tiles",label:"With tiles",element:l.a.createElement(v,null)},{id:"nested-cards",label:"Nested cards",element:l.a.createElement(_,null)},{id:"with-no-header",label:"With no header",element:l.a.createElement(d.d,null,l.a.createElement(d.a,{hasPadding:!0},"Anything can go into the card body"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))},{id:"visibly-hidden-card-header",label:"Visibly hidden card header",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Card Header",href:!0,className:"slds-assistive-text"}),l.a.createElement(d.a,{hasPadding:!0},"Anything can go into the card body"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))},{id:"body-has-no-padding",label:"Body with no padding",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Accounts",href:!0,symbol:"account"}),l.a.createElement(d.a,null,"Card Body"))},{id:"body-has-padding",label:"Body with padding",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Accounts",href:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},"Card Body with Padding"))},{id:"has-no-footer",label:"No footer",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Accounts",href:!0,showIcon:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},"Card Body"),l.a.createElement(d.b,null))},{id:"has-footer",label:"Has footer",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Accounts",href:!0,showIcon:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},"Card Body"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))},{id:"nested-no-boundary",label:"Nested with no boundary",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Outer Card Header",href:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Card Header",href:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},"This is a nested card with no styling (default)"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))},{id:"nested-with-boundary",label:"Nested with boundary",element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Outer Card Header",href:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},l.a.createElement(d.d,{hasCardBoundary:!0},l.a.createElement(d.c,{title:"Card Header",href:!0,symbol:"account"}),l.a.createElement(d.a,{hasPadding:!0},"This is a card inside an `slds-card` to illustrate how `slds-card_boundary` adds a rounded border when desired."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))},{id:"with-long-truncated-title",label:"With long truncated title",demoStyles:"max-width: 360px;",storybookStyles:!0,element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Card Header Title With Exceptionally Long Title",href:!0,symbol:"account",action:l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New")}),l.a.createElement(d.a,{hasPadding:!0},"Anything can go into the card body"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))},{id:"styling-hooks",label:"Styling Hooks",demoStyles:"\n --slds-c-card-color-background: #f3f3f3;\n --slds-c-card-radius-border: 8px;\n --slds-c-card-shadow: rgba(0,0,0,.15) 0 4px 8px, rgba(0,0,0,.05) 0 2px 4px;\n --slds-c-card-spacing-block-start: 1.5rem;\n --slds-c-card-spacing-block-end: 0.5rem;\n --slds-c-card-spacing-inline: 1rem;\n --slds-c-card-title-font-size: 1.5rem;\n --slds-c-card-header-spacing-block-start: 0;\n --slds-c-card-header-spacing-inline-start: 1.5rem;\n --slds-c-card-header-spacing-inline-end: 1.5rem;\n --slds-c-card-body-spacing-inline-start: 1.5rem;\n --slds-c-card-body-spacing-inline-end: 1.5rem;\n --slds-c-card-body-spacing-block-end: 1rem;\n --slds-c-card-footer-spacing-block-start: 0.5rem;\n --slds-c-card-footer-spacing-block-end: 0;\n --slds-c-card-footer-spacing-inline-start: 1.5rem;\n --slds-c-card-footer-spacing-inline-end: 1.5rem;\n --slds-c-card-footer-font-size: 0.75rem;\n --slds-c-card-footer-text-align: right;\n ",storybookStyles:!0,element:l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Accounts",href:!0,symbol:"account",action:l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New")}),l.a.createElement(d.a,null,"Anything can go into the card body"),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Accounts")))}],x=a(9),C=a(7),A=a(60),T=a(5),k=a.n(T),S=function(e){return l.a.createElement("div",{className:"slds-einstein-header__actions"},l.a.createElement(A.a,null,l.a.createElement(C.b,{className:"slds-button_icon-border-filled",symbol:"email",assistiveText:"Email",title:"Email","aria-pressed":"false"}),l.a.createElement(C.b,{className:"slds-button_icon-border-filled",symbol:"edit",assistiveText:"Edit",title:"Edit","aria-pressed":"false"})))},W=function(e){return l.a.createElement("div",{className:k()("slds-grid slds-einstein-header",e.className)},e.closeButton?l.a.createElement(C.b,{className:k()("slds-button_icon-small slds-float_right slds-popover__close",e.inverse?"slds-button_icon-inverse":"slds-button_icon"),symbol:"close",assistiveText:"Close dialog",title:"Close dialog"}):null,l.a.createElement("header",{className:k()("slds-media slds-media_center slds-has-flexi-truncate")},l.a.createElement("div",{className:"slds-grid slds-grid_vertical-align-center slds-size_3-of-4 slds-medium-size_2-of-3"},e.symbol?l.a.createElement("div",{className:"slds-media__figure"},l.a.createElement("span",{className:"slds-icon_container slds-icon-utility-"+e.symbol},l.a.createElement(x.a,{className:"slds-icon slds-icon_small slds-icon-text-default",sprite:"utility",symbol:e.symbol}))):null,l.a.createElement("div",{className:"slds-media__body"},l.a.createElement("h2",{className:"slds-truncate",id:e.headingId,title:e.headerTitle\|\|"Einstein"},e.hasLink?l.a.createElement("a",{href:"#",className:"slds-card__header-link",title:e.headerTitle\|\|"Einstein",onClick:function(e){return e.preventDefault()}},l.a.createElement("span",{className:"slds-text-heading_small"},e.headerTitle\|\|"Einstein")):l.a.createElement("span",{className:"slds-text-heading_small"},e.headerTitle\|\|"Einstein")))),l.a.createElement("div",{className:"slds-einstein-header__figure slds-size_1-of-4 slds-medium-size_1-of-3"})),e.actions&&l.a.createElement(S,null))},P=function(e){return l.a.createElement(d.d,null,l.a.createElement(W,{className:"slds-card__header",headerTitle:"Einstein (10+)",hasLink:!0,actions:e.hasActions,symbol:e.hasIcon&&"salesforce1"}),l.a.createElement(d.a,{hasPadding:!0},"Card Body"),l.a.createElement(d.b,null,"View All"," ",l.a.createElement("span",{className:"slds-assistive-text"},"Einstein Recommendations")))},D=l.a.createElement(P,null),V=[{id:"einstein-with-icon",label:"Einstein card - with icon",element:l.a.createElement(P,{hasIcon:!0})},{id:"einstein-with-icon-and-actions",label:"Einstein card - with icon and actions",element:l.a.createElement(P,{hasIcon:!0,hasActions:!0})}],B=a(31),I=[{id:"default",label:"Default",element:l.a.createElement("div",{className:"slds-card-wrapper"},l.a.createElement(d.d,null,l.a.createElement(d.c,{title:"Contacts",href:!0,symbol:"contact",action:l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New")}),l.a.createElement(d.a,null,"This is a card inside an `slds-card-wrapper` to show how styling is removed when cards are nested inside."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts"))),l.a.createElement(d.d,{hasCardBoundary:!0},l.a.createElement(d.c,{title:"Contacts",href:!0,symbol:"contact",action:l.a.createElement("button",{className:"slds-button slds-button_neutral"},"New")}),l.a.createElement(d.a,{hasPadding:!0},"This is a card inside an `slds-card-wrapper` to illustrate how `slds-card_boundary` adds a rounded border when desired."),l.a.createElement(d.b,null,"View All ",l.a.createElement("span",{className:"slds-assistive-text"},"Contacts"))))}],L=(B.a,B.a.Item,d.d,d.c,d.a,d.b,d.d,d.c,d.a,d.b,B.a.Item,B.a.Item,B.a,B.a.Item,d.d,d.c,d.a,d.b,d.d,d.c,d.a,d.b,B.a.Item,B.a.Item,a(1)),z=a(39),H=a(40),M=s.c.a,R=s.c.code,F=s.c.em,J=s.c.h2,q=s.c.h3,Y=s.c.h4,G=s.c.h5,K=s.c.p,Q=s.c.strong,U=function(){return Object(n.createElement)(s.b,{},Object(n.createElement)("div",{className:"lead doc"},"Cards are used to apply a container around a related grouping of information."),Object(n.createElement)(c.a,{exampleOnly:!0},Object(L.f)(O)),J({id:"About-Cards"},"About Cards"),K({},"To initialize a card, apply the ",R({},"slds-card")," class to an ",R({},"<article>")," element."),q({id:"Accessibility"},"Accessibility"),K({},"Cards should use an underlying ",R({},"<article>")," element to maintain usability for some screen reader users."),K({},"If the card header icon is redundant with the card header text, the assistive text is not needed."),K({},"The card heading level should follow the DOM structure of the page. We are using ",R({},"h2")," as the default heading level for examples, but real world use will dictate the correct level based on the surrounding elements."),q({id:"Mobile"},"Mobile"),Object(n.createElement)(z.a,{patternSpecificText:"cards will have bolded header title text, no top border, and no rounded corners"}),Object(n.createElement)(c.a,{frameOnly:!0,frameTitle:"Example mobile styles for cards"},Object(L.f)(O)),J({id:"Base-Card-Structure"},"Base Card Structure"),K({},"A card is made up of 3 sections, a header, a body, and a footer. The header and footer have limitations, but the body section can accommodate any layout of related information."),Object(n.createElement)(c.a,null,Object(L.f)(O)),q({id:"Header"},"Header"),K({},"The card header can have an icon, a title and actions. The icon and title are located on the left, while the actions row is located on the right side of the card header."),Object(n.createElement)(r.a,{title:"Cards Header"},Object(n.createElement)(c.a,null,Object(n.createElement)(d.d,null,Object(n.createElement)(d.c,{title:"Accounts",href:"#",onClick:function(e){return e.preventDefault()},symbol:"account"})))),Y({id:"With-no-header"},"With no header"),K({},"The card header can be removed from the HTML to prevent the card header from displaying."),Object(n.createElement)(c.a,null,Object(L.f)(N,"with-no-header")),K({},"Alternatively, the card header can be visually hidden but still accessible to screen readers by applying ",R({},"slds-assistive-text")," to the ",R({},"slds-card__header")," element."),Object(n.createElement)(c.a,null,Object(L.f)(N,"visibly-hidden-card-header")),Y({id:"Actions-row"},"Actions row"),K({},"The actions row of a card header typically accommodates a single action for the object a user is working with, such as creating, editing, or deleting. If there are more than one action, an action overflow menu would be used instead."),G({id:"Single-action"},"Single action"),Object(n.createElement)(r.a,{title:"Cards Single Action"},Object(n.createElement)(c.a,null,Object(n.createElement)(d.d,null,Object(n.createElement)(d.c,{title:"Accounts",href:"#",onClick:function(e){return e.preventDefault()},symbol:"account",action:Object(n.createElement)("button",{className:"slds-button slds-button_neutral"},"New")})))),G({id:"Multiple-actions"},"Multiple actions"),Object(n.createElement)(r.a,{title:"Cards Multiple Actions"},Object(n.createElement)(c.a,{demoStyles:"height: 10rem;"},Object(n.createElement)(d.d,null,Object(n.createElement)(d.c,{title:"Accounts",href:"#",onClick:function(e){return e.preventDefault()},symbol:"account",action:Object(n.createElement)(o.a,{position:"right"})})))),q({id:"Body"},"Body"),K({},"The card body accommodates any layout or design, as long as its a grouping of related information."),Object(n.createElement)(i.a,{type:"note",header:"Styling Note"},Object(n.createElement)("p",null,"By default, the body of a card does not have padding. Components inside the card will be flush to the left and right edges of the card. If you need to add padding, use the ",Object(n.createElement)("code",null,"slds-card__body_inner")," class on the ",Object(n.createElement)("code",null,"slds-card__body")," element.")),Y({id:"Default-without-padding"},"Default without padding"),K({},"For an example of when to use the default behavior, see the ",M({href:"/components/cards/#With-a-Data-Table"},"Data Table example"),"."),Object(n.createElement)(c.a,null,Object(L.f)(N,"body-has-no-padding")),Y({id:"With-padding"},"With padding"),K({},"For an example of when to use the ",R({},"slds-card__body_inner")," class, see the ",M({href:"/components/cards/#With-Tiles"},"Tiles example"),"."),Object(n.createElement)(c.a,null,Object(L.f)(N,"body-has-padding")),q({id:"Footer"},"Footer"),K({},"The card footer is optional and should ",F({},Q({},"only")),' have a "View All" link that takes a user to the object list view.'),Object(n.createElement)(i.a,{type:"a11y",header:"Accessibility Note"},Object(n.createElement)("p",null,"When present, the footer includes hidden assistive text to give screen reader users context about which entity they will be viewing.")),Object(n.createElement)(i.a,{type:"note",header:"Implementation Note"},Object(n.createElement)("p",null,"The examples in this documentation use the ",Object(n.createElement)("code",null,"slds-card__footer-action")," class on the footer link ",Object(n.createElement)("code",null,"<a>")," to force the footer's click target to span the entire width of the card. Simply remove this class if not needed.")),Y({id:"With-no-footer"},"With no footer"),Object(n.createElement)(c.a,null,Object(L.f)(N,"has-no-footer")),Y({id:"With-a-footer"},"With a footer"),Object(n.createElement)(c.a,null,Object(L.f)(N,"has-footer")),J({id:"Examples"},"Examples"),q({id:"Empty"},"Empty"),K({},"When a card doesn't have any data, it is represented with the body and footer collapsed by default."),Y({id:"Collapsed"},"Collapsed"),Object(n.createElement)(c.a,null,Object(L.f)(j,"empty")),Y({id:"With-Illustration"},"With Illustration"),K({},"Alternatively, a card can be represented with no data by using an ",M({href:"/components/illustration"},"illustration")," in the card body."),Object(n.createElement)(c.a,null,Object(L.f)(j,"empty-illustration")),q({id:"Loading"},"Loading"),K({},"When a card instantiates and is loading, we want to provide feedback to the user by display a spinner. Once the data has loaded, the spinner can be removed from the card component."),Object(n.createElement)(c.a,null,Object(L.f)(j,"loading")),q({id:"With-a-Data-Table"},"With a Data Table"),K({},"Placing a data table inside of an ",R({},"slds-card__body")," is an example of when to utilize the default behavior of a card body, since no padding is applied."),Object(n.createElement)(c.a,null,Object(L.f)(N,"related-list-table")),q({id:"With-Tiles"},"With Tiles"),K({},"Placing contact tiles inside of an ",R({},"slds-card__body")," is an example of using ",R({},"slds-card__body_inner")," to apply additional padding to the card body content."),Object(n.createElement)(c.a,null,Object(L.f)(N,"related-list-tiles")),Object(n.createElement)(z.b,{docsLink:"#Mobile",header:"Mobile context changes",elementName:"cards with tiles"}),Object(n.createElement)(c.a,{frameOnly:!0,frameTitle:"Example mobile styles for cards with tiles"},Object(L.f)(N,"related-list-tiles")),J({id:"Layout"},"Layout"),q({id:"Nested-Cards"},"Nested Cards"),K({},"When a card is located inside of another card body, we remove the drop shadow and border of the nested cards. You can opt into adding the border back by applying ",R({},"slds-card_boundary")," to the ",R({},"slds-card")," element."),Y({id:"No-styling"},"No styling"),Object(n.createElement)(c.a,null,Object(L.f)(N,"nested-no-boundary")),Y({id:"With-card-styling"},"With card styling"),K({},"Adding ",R({},"slds-card_boundary")," to the ",R({},"slds-card")," element will give you back the card styling."),Object(n.createElement)(c.a,null,Object(L.f)(N,"nested-with-boundary")),q({id:"Wrapped-Cards"},"Wrapped Cards"),K({},"To combine several cards into a single card look, wrap the cards using ",R({},"slds-card-wrapper"),". Similar to the nested cards, adding ",R({},"slds-card_boundary")," to the ",R({},"slds-card")," element will give you back the card styling."),Object(n.createElement)(c.a,null,Object(L.f)(I)),J({id:"Einstein-Theming"},"Einstein Theming"),K({},"For cards that contain Einstein related information, you can include an Einstein themed card header."),Object(n.createElement)(c.a,null,Object(L.f)(D)),q({id:"With-an-Icon"},"With an Icon"),Object(n.createElement)(c.a,null,Object(L.f)(V,"einstein-with-icon")),q({id:"With-Actions"},"With Actions"),Object(n.createElement)(c.a,null,Object(L.f)(V,"einstein-with-icon-and-actions")),Object(n.createElement)(z.b,{docsLink:"#Mobile",header:"Mobile context changes",elementName:"cards with Einstein theming and actions"}),Object(n.createElement)(c.a,{frameOnly:!0,frameTitle:"Example mobile styles for Einstein themed cards"},Object(L.f)(V,"einstein-with-icon-and-actions")),J({id:"Styling-Hooks-Overview"},"Styling Hooks Overview"),Object(n.createElement)(H.a,{name:"cards",type:"component"}))},X=function(){return Object(s.a)(U())}}});

package/__internal/chunked/docs/ui/components/carousel/docs.mdx.js CHANGED Viewed

	@@ -1 +1 @@
1	- var SLDS="object"==typeof SLDS?SLDS:{};SLDS["__internal/chunked/docs/./ui/components/carousel/docs.mdx.js"]=function(e){function t(t){for(var n,r,i=t[0],o=t[1],c=t[2],d=0,p=[];d<i.length;d++)r=i[d],Object.prototype.hasOwnProperty.call(l,r)&&l[r]&&p.push(l[r][0]),l[r]=0;for(n in o)Object.prototype.hasOwnProperty.call(o,n)&&(e[n]=o[n]);for(u&&u(t);p.length;)p.shift()();return s.push.apply(s,c\|\|[]),a()}function a(){for(var e,t=0;t<s.length;t++){for(var a=s[t],n=!0,i=1;i<a.length;i++){var o=a[i];0!==l[o]&&(n=!1)}n&&(s.splice(t--,1),e=r(r.s=a[0]))}return e}var n={},l={15:0},s=[];function r(t){if(n[t])return n[t].exports;var a=n[t]={i:t,l:!1,exports:{}};return e[t].call(a.exports,a,a.exports,r),a.l=!0,a.exports}r.m=e,r.c=n,r.d=function(e,t,a){r.o(e,t)\|\|Object.defineProperty(e,t,{enumerable:!0,get:a})},r.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.t=function(e,t){if(1&t&&(e=r(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var a=Object.create(null);if(r.r(a),Object.defineProperty(a,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var n in e)r.d(a,n,function(t){return e[t]}.bind(null,n));return a},r.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return r.d(t,"a",t),t},r.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},r.p="/assets/scripts/bundle/";var i=this.webpackJsonpSLDS___internal_chunked_docs=this.webpackJsonpSLDS___internal_chunked_docs\|\|[],o=i.push.bind(i);i.push=t,i=i.slice();for(var c=0;c<i.length;c++)t(i[c]);var u=o;return s.push([795,0]),a()}({0:function(e,t){e.exports=React},20:function(e,t){e.exports=ReactDOM},22:function(e,t){e.exports=JSBeautify},795:function(e,t,a){"use strict";a.r(t),a.d(t,"getElement",(function(){return T})),a.d(t,"getContents",(function(){return D}));var n=a(0),l=a.n(n),s=a(4),r=a(2),i=a(27),o=a(14),c=a(15),u=a(7),d=a(5),p=a.n(d),b=a(25),h=a.n(b);function f(e){return(f="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e})(e)}function m(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function v(e,t){for(var a=0;a<t.length;a++){var n=t[a];n.enumerable=n.enumerable\|\|!1,n.configurable=!0,"value"in n&&(n.writable=!0),Object.defineProperty(e,n.key,n)}}function y(e,t){return(y=Object.setPrototypeOf\|\|function(e,t){return e.__proto__=t,e})(e,t)}function _(e){var t=function(){if("undefined"==typeof Reflect\|\|!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(e){return!1}}();return function(){var a,n=O(e);if(t){var l=O(this).constructor;a=Reflect.construct(n,arguments,l)}else a=n.apply(this,arguments);return E(this,a)}}function E(e,t){if(t&&("object"===f(t)\|\|"function"==typeof t))return t;if(void 0!==t)throw new TypeError("Derived constructors may only return object or undefined");return function(e){if(void 0===e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return e}(e)}function O(e){return(O=Object.setPrototypeOf?Object.getPrototypeOf:function(e){return e.__proto__\|\|Object.getPrototypeOf(e)})(e)}var j=function(e){return l.a.createElement("li",{className:"slds-carousel__indicator",role:"presentation"},l.a.createElement("a",{id:e.id,className:p()("slds-carousel__indicator-action",e.isActive&&"slds-is-active",e.className),href:"#",role:"tab",tabIndex:e.isActive?"0":"-1","aria-selected":e.isActive?"true":"false","aria-controls":e.contentId,title:e.title,onClick:function(e){return e.preventDefault()}},l.a.createElement("span",{className:"slds-assistive-text"},e.title)))},g=function(e){return l.a.createElement("div",{id:e.id,className:p()("slds-carousel__panel",e.className),role:"tabpanel",hidden:!e.isActive,"aria-labelledby":e.indicatorId},l.a.createElement("a",{href:"#",className:"slds-carousel__panel-action slds-text-link_reset",tabIndex:e.isActive?"0":"-1",onClick:function(e){return e.preventDefault()}},l.a.createElement("div",{className:"slds-carousel__image"},l.a.createElement("img",{src:e.src,alt:e.title})),l.a.createElement("div",{className:"slds-carousel__content"},l.a.createElement("h2",{className:"slds-carousel__content-title"},e.title),l.a.createElement("p",null,e.description))))},w=function(e){return l.a.createElement("span",{className:"slds-carousel__autoplay"},l.a.createElement(u.b,{className:"slds-button_icon-border-filled slds-button_icon-x-small",symbol:e.stop?"right":"pause","aria-controls":e["aria-controls"],"aria-pressed":e.stop,disabled:e.disabled,title:"Stop auto-play",assistiveText:"Stop auto-play"}))},x=function(e){!function(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function");e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,writable:!0,configurable:!0}}),Object.defineProperty(e,"prototype",{writable:!1}),t&&y(e,t)}(r,e);var t,a,n,s=_(r);function r(){return m(this,r),s.apply(this,arguments)}return t=r,(a=[{key:"render",value:function(){var e=h()("content-id-"),t=h()("content-id-"),a=h()("content-id-"),n=h()("indicator-id-"),s=h()("indicator-id-"),r=h()("indicator-id-");return l.a.createElement("div",{className:p()("slds-carousel",this.props.className)},l.a.createElement("div",{className:"slds-carousel__stage"},this.props.autoPlay&&l.a.createElement(w,{stop:"stop"===this.props.autoPlay}),l.a.createElement("div",{className:"slds-carousel__panels",style:{transform:"translateX(-".concat(100*(this.props.panelActive-3),"%)")}},l.a.createElement(g,{isActive:"1"===this.props.panelActive,id:e,indicatorId:n,title:"Visit App Exchange",description:"Extend Salesforce with the #1 business marketplace.",src:"/assets/images/carousel/carousel-01.jpg"}),l.a.createElement(g,{isActive:"2"===this.props.panelActive,id:t,indicatorId:s,title:"Click to Customize",description:"Use the Object Manager to add fields, build layouts, and more.",src:"/assets/images/carousel/carousel-02.jpg"}),l.a.createElement(g,{isActive:"3"===this.props.panelActive,id:a,indicatorId:r,title:"Download SalesforceA",description:"Get the mobile app that's just for Salesforce admins.",src:"/assets/images/carousel/carousel-03.jpg"})),l.a.createElement("ul",{className:"slds-carousel__indicators",role:"tablist"},l.a.createElement(j,{isActive:"1"===this.props.panelActive,id:n,contentId:e,title:"Visit App Exchange tab"}),l.a.createElement(j,{isActive:"2"===this.props.panelActive,id:s,contentId:t,title:"Click to Customize tab"}),l.a.createElement(j,{isActive:"3"===this.props.panelActive,id:r,contentId:a,title:"Download SalesforceA tab"}))))}}])&&v(t.prototype,a),n&&v(t,n),Object.defineProperty(t,"prototype",{writable:!1}),r}(n.Component),A=s.c.code,S=s.c.h2,N=s.c.h3,P=s.c.h4,k=s.c.li,C=s.c.p,I=s.c.ul,T=function(){return Object(n.createElement)(s.b,{},Object(n.createElement)("div",{className:"doc lead"},"A carousel allows multiple pieces of featured content to occupy an allocated amount of space."),Object(n.createElement)(r.a,{exampleOnly:!0,demoStyles:"width: 480px; max-width: 100%;"},Object(n.createElement)(x,{panelActive:"2",autoPlay:!0})),S({id:"About-Carousel"},"About Carousel"),C({},"A Carousel can accept a maximum number of 5 panels where only 1 panel is visible at a time."),N({id:"Accessibility"},"Accessibility"),C({},"A Carousel is built using a tabbed UI specification and requires the following to meet accessibility requirements:"),I({},k({},"The tab list, which should have ",A({},'role="tablist"')),k({},"The tabs in that list, which should each be an ",A({},'<a role="tab">')," anchor wrapped in a ",A({},'<li role="presentation">')," list item"),k({},"The tab panels, which display each tab’s content and should each have ",A({},'role="tabpanel"'))),P({id:"Markup"},"Markup"),I({},k({},"Selected tab’s anchor has ",A({},'aria-selected="true"'),", all other tabs’ anchors have ",A({},'aria-selected="false"')),k({},"Selected tab’s anchor has ",A({},'tabindex="0"'),", all other tabs have ",A({},'tabindex="-1"')),k({},"Each tab’s anchor has an ",A({},"aria-controls")," attribute whose value is the id of the associated ",A({},'<div role="tabpanel">')),k({},"Each tab panel has an ",A({},"aria-labelledby")," attribute whose value is the id of its associated ",A({},'<a role="tab">')),k({},"Each tab panel has an ",A({},"hidden")," attribute whose value is toggled based on which panel is visible"),k({},"When the Carousel is set to auto-play, the HTML for the pause button is required to precede the HTML of the tab set")),P({id:"Keyboard-Interactions"},"Keyboard Interactions"),I({},k({},"Arrow keys, when focus is on selected tab, cycle selection to the next or previous tab"),k({},"Tab key, when focus is before the tab list, moves focus to the selected tab panel"),k({},"Tab key, when focus is on selected tabpanel, moves focus into the selected tabpanel's associated tab or to the next focusable element on the page if that panel has no focusable elements"),k({},"Shift+Tab keys, when focus is on first element in a tab panel, move focus focus entirely from tabset")),S({id:"Base"},"Base"),Object(n.createElement)(c.a,{title:"carousel"},Object(n.createElement)(r.a,{demoStyles:"width: 480px; max-width: 100%;"},Object(n.createElement)(x,{panelActive:"1",autoPlay:!0}))),S({id:"Navigating-between-panels"},"Navigating between panels"),C({},"You are able to navigate between panels but interacting with the ",A({},"slds-carousel__indicator")," elements that sit below the panel."),N({id:"Panel-1-active"},"Panel 1 active"),Object(n.createElement)(c.a,{title:"carousel-panel-transition-panel-1"},Object(n.createElement)(r.a,{demoStyles:"width: 480px; max-width: 100%;"},Object(n.createElement)(x,{panelActive:"1",autoPlay:!0}))),N({id:"Panel-2-active"},"Panel 2 active"),Object(n.createElement)(c.a,{title:"carousel-panel-transition-panel-2"},Object(n.createElement)(r.a,{demoStyles:"width: 480px; max-width: 100%;"},Object(n.createElement)(x,{panelActive:"2",autoPlay:!0}))),Object(n.createElement)(i.a,{toggleCode:!1},Object(n.createElement)("div",{className:"slds-carousel"},Object(n.createElement)("div",{className:"slds-carousel__stage"},Object(n.createElement)("div",{className:"slds-carousel__panels",style:{transform:"translateX(-100%)"}},Object(n.createElement)("div",{id:"content-id-01",className:"slds-carousel__panel","aria-hidden":"false",role:"tabpanel","aria-labelledby":"indicator-id-01",tabIndex:"-1"},"..."),Object(n.createElement)("div",{id:"content-id-02",className:"slds-carousel__panel","aria-hidden":"true",role:"tabpanel","aria-labelledby":"indicator-id-02",tabIndex:"0"},"...")),Object(n.createElement)("ul",{className:"slds-carousel__indicators",role:"tablist"},Object(n.createElement)("li",{className:"slds-carousel__indicator",role:"presentation"},Object(n.createElement)("a",{id:"indicator-id-01",className:"slds-carousel__indicator-action",href:"#",onClick:function(e){return e.preventDefault()},role:"tab",tabIndex:"-1","aria-selected":"false","aria-controls":"content-id-01",title:"Visit App Exchange tab"},"...")),Object(n.createElement)("li",{className:"slds-carousel__indicator",role:"presentation"},Object(n.createElement)("a",{id:"indicator-id-02",className:"slds-carousel__indicator-action slds-is-active",href:"#",onClick:function(e){return e.preventDefault()},role:"tab",tabIndex:"0","aria-selected":"true","aria-controls":"content-id-02",title:"Click to Customize tab"},"...")))))),Object(n.createElement)(o.a,{header:"Accessibility",type:"a11y"},Object(n.createElement)("p",null,"A panel becomes visible by toggling the ",Object(n.createElement)("code",null,"aria-hidden")," attribute from ",Object(n.createElement)("code",null,"false")," to ",Object(n.createElement)("code",null,"true")," on the ",Object(n.createElement)("code",null,"slds-carousel__panel")," element. When a panel becomes active, the `tabindex` of the other non-visible panels should be set to -1 while the active panel remains at 0.")),C({},"When a panel becomes active, apply an inline style to ",A({},"slds-carousel__panel")," to move the panels left to right. We do this by updating the location of the panel on its Y axis using transforms. The first panel should be ",A({},"transform: translateX(0%)")," but when any preceding panel becomes active it can be subtracted by 100%, moving 100% of each panel to the left. For example, panel 1 would be visible at ",A({},"transform: translateX(0%)"),", while panel 3 would be visible at ",A({},"transform: translateX(-200%)"),"."),C({},"When making the ",A({},"slds-carousel__panel")," active, the indicator should be updated with the ",A({},"slds-is-active")," class. This provides visual feedback showing which carousel panel is active."),S({id:"Auto-play"},"Auto-play"),C({},"If the Carousel is set to auto-play, a pause button is required to be first in the HTML before the tab set."),Object(n.createElement)(o.a,{header:"Accessibility",type:"a11y"},Object(n.createElement)("p",null,"When that pause button is interacted with, the ",Object(n.createElement)("code",null,"aria-pressed")," role needs to be toggled to ",Object(n.createElement)("code",null,"true"),".")),Object(n.createElement)(c.a,{title:"carousel-autoplay"},Object(n.createElement)(i.a,{toggleCode:!1},Object(n.createElement)("div",{className:"slds-carousel"},Object(n.createElement)("div",{className:"slds-carousel__stage"},Object(n.createElement)(w,{stop:!0}),Object(n.createElement)("div",{className:"slds-carousel__panels"},"..."))))))},D=function(){return Object(s.a)(T())}}});
1	+ var SLDS="object"==typeof SLDS?SLDS:{};SLDS["__internal/chunked/docs/./ui/components/carousel/docs.mdx.js"]=function(e){function t(t){for(var n,r,i=t[0],o=t[1],c=t[2],d=0,p=[];d<i.length;d++)r=i[d],Object.prototype.hasOwnProperty.call(l,r)&&l[r]&&p.push(l[r][0]),l[r]=0;for(n in o)Object.prototype.hasOwnProperty.call(o,n)&&(e[n]=o[n]);for(u&&u(t);p.length;)p.shift()();return s.push.apply(s,c\|\|[]),a()}function a(){for(var e,t=0;t<s.length;t++){for(var a=s[t],n=!0,i=1;i<a.length;i++){var o=a[i];0!==l[o]&&(n=!1)}n&&(s.splice(t--,1),e=r(r.s=a[0]))}return e}var n={},l={15:0},s=[];function r(t){if(n[t])return n[t].exports;var a=n[t]={i:t,l:!1,exports:{}};return e[t].call(a.exports,a,a.exports,r),a.l=!0,a.exports}r.m=e,r.c=n,r.d=function(e,t,a){r.o(e,t)\|\|Object.defineProperty(e,t,{enumerable:!0,get:a})},r.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.t=function(e,t){if(1&t&&(e=r(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var a=Object.create(null);if(r.r(a),Object.defineProperty(a,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var n in e)r.d(a,n,function(t){return e[t]}.bind(null,n));return a},r.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return r.d(t,"a",t),t},r.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},r.p="/assets/scripts/bundle/";var i=this.webpackJsonpSLDS___internal_chunked_docs=this.webpackJsonpSLDS___internal_chunked_docs\|\|[],o=i.push.bind(i);i.push=t,i=i.slice();for(var c=0;c<i.length;c++)t(i[c]);var u=o;return s.push([796,0]),a()}({0:function(e,t){e.exports=React},20:function(e,t){e.exports=ReactDOM},22:function(e,t){e.exports=JSBeautify},796:function(e,t,a){"use strict";a.r(t),a.d(t,"getElement",(function(){return T})),a.d(t,"getContents",(function(){return D}));var n=a(0),l=a.n(n),s=a(4),r=a(2),i=a(27),o=a(13),c=a(15),u=a(7),d=a(5),p=a.n(d),b=a(25),h=a.n(b);function f(e){return(f="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e})(e)}function m(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function v(e,t){for(var a=0;a<t.length;a++){var n=t[a];n.enumerable=n.enumerable\|\|!1,n.configurable=!0,"value"in n&&(n.writable=!0),Object.defineProperty(e,n.key,n)}}function y(e,t){return(y=Object.setPrototypeOf\|\|function(e,t){return e.__proto__=t,e})(e,t)}function _(e){var t=function(){if("undefined"==typeof Reflect\|\|!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],(function(){}))),!0}catch(e){return!1}}();return function(){var a,n=O(e);if(t){var l=O(this).constructor;a=Reflect.construct(n,arguments,l)}else a=n.apply(this,arguments);return E(this,a)}}function E(e,t){if(t&&("object"===f(t)\|\|"function"==typeof t))return t;if(void 0!==t)throw new TypeError("Derived constructors may only return object or undefined");return function(e){if(void 0===e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return e}(e)}function O(e){return(O=Object.setPrototypeOf?Object.getPrototypeOf:function(e){return e.__proto__\|\|Object.getPrototypeOf(e)})(e)}var j=function(e){return l.a.createElement("li",{className:"slds-carousel__indicator",role:"presentation"},l.a.createElement("a",{id:e.id,className:p()("slds-carousel__indicator-action",e.isActive&&"slds-is-active",e.className),href:"#",role:"tab",tabIndex:e.isActive?"0":"-1","aria-selected":e.isActive?"true":"false","aria-controls":e.contentId,title:e.title,onClick:function(e){return e.preventDefault()}},l.a.createElement("span",{className:"slds-assistive-text"},e.title)))},g=function(e){return l.a.createElement("div",{id:e.id,className:p()("slds-carousel__panel",e.className),role:"tabpanel",hidden:!e.isActive,"aria-labelledby":e.indicatorId},l.a.createElement("a",{href:"#",className:"slds-carousel__panel-action slds-text-link_reset",tabIndex:e.isActive?"0":"-1",onClick:function(e){return e.preventDefault()}},l.a.createElement("div",{className:"slds-carousel__image"},l.a.createElement("img",{src:e.src,alt:e.title})),l.a.createElement("div",{className:"slds-carousel__content"},l.a.createElement("h2",{className:"slds-carousel__content-title"},e.title),l.a.createElement("p",null,e.description))))},w=function(e){return l.a.createElement("span",{className:"slds-carousel__autoplay"},l.a.createElement(u.b,{className:"slds-button_icon-border-filled slds-button_icon-x-small",symbol:e.stop?"right":"pause","aria-controls":e["aria-controls"],"aria-pressed":e.stop,disabled:e.disabled,title:"Stop auto-play",assistiveText:"Stop auto-play"}))},x=function(e){!function(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function");e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,writable:!0,configurable:!0}}),Object.defineProperty(e,"prototype",{writable:!1}),t&&y(e,t)}(r,e);var t,a,n,s=_(r);function r(){return m(this,r),s.apply(this,arguments)}return t=r,(a=[{key:"render",value:function(){var e=h()("content-id-"),t=h()("content-id-"),a=h()("content-id-"),n=h()("indicator-id-"),s=h()("indicator-id-"),r=h()("indicator-id-");return l.a.createElement("div",{className:p()("slds-carousel",this.props.className)},l.a.createElement("div",{className:"slds-carousel__stage"},this.props.autoPlay&&l.a.createElement(w,{stop:"stop"===this.props.autoPlay}),l.a.createElement("div",{className:"slds-carousel__panels",style:{transform:"translateX(-".concat(100*(this.props.panelActive-3),"%)")}},l.a.createElement(g,{isActive:"1"===this.props.panelActive,id:e,indicatorId:n,title:"Visit App Exchange",description:"Extend Salesforce with the #1 business marketplace.",src:"/assets/images/carousel/carousel-01.jpg"}),l.a.createElement(g,{isActive:"2"===this.props.panelActive,id:t,indicatorId:s,title:"Click to Customize",description:"Use the Object Manager to add fields, build layouts, and more.",src:"/assets/images/carousel/carousel-02.jpg"}),l.a.createElement(g,{isActive:"3"===this.props.panelActive,id:a,indicatorId:r,title:"Download SalesforceA",description:"Get the mobile app that's just for Salesforce admins.",src:"/assets/images/carousel/carousel-03.jpg"})),l.a.createElement("ul",{className:"slds-carousel__indicators",role:"tablist"},l.a.createElement(j,{isActive:"1"===this.props.panelActive,id:n,contentId:e,title:"Visit App Exchange tab"}),l.a.createElement(j,{isActive:"2"===this.props.panelActive,id:s,contentId:t,title:"Click to Customize tab"}),l.a.createElement(j,{isActive:"3"===this.props.panelActive,id:r,contentId:a,title:"Download SalesforceA tab"}))))}}])&&v(t.prototype,a),n&&v(t,n),Object.defineProperty(t,"prototype",{writable:!1}),r}(n.Component),A=s.c.code,S=s.c.h2,N=s.c.h3,P=s.c.h4,k=s.c.li,C=s.c.p,I=s.c.ul,T=function(){return Object(n.createElement)(s.b,{},Object(n.createElement)("div",{className:"doc lead"},"A carousel allows multiple pieces of featured content to occupy an allocated amount of space."),Object(n.createElement)(r.a,{exampleOnly:!0,demoStyles:"width: 480px; max-width: 100%;"},Object(n.createElement)(x,{panelActive:"2",autoPlay:!0})),S({id:"About-Carousel"},"About Carousel"),C({},"A Carousel can accept a maximum number of 5 panels where only 1 panel is visible at a time."),N({id:"Accessibility"},"Accessibility"),C({},"A Carousel is built using a tabbed UI specification and requires the following to meet accessibility requirements:"),I({},k({},"The tab list, which should have ",A({},'role="tablist"')),k({},"The tabs in that list, which should each be an ",A({},'<a role="tab">')," anchor wrapped in a ",A({},'<li role="presentation">')," list item"),k({},"The tab panels, which display each tab’s content and should each have ",A({},'role="tabpanel"'))),P({id:"Markup"},"Markup"),I({},k({},"Selected tab’s anchor has ",A({},'aria-selected="true"'),", all other tabs’ anchors have ",A({},'aria-selected="false"')),k({},"Selected tab’s anchor has ",A({},'tabindex="0"'),", all other tabs have ",A({},'tabindex="-1"')),k({},"Each tab’s anchor has an ",A({},"aria-controls")," attribute whose value is the id of the associated ",A({},'<div role="tabpanel">')),k({},"Each tab panel has an ",A({},"aria-labelledby")," attribute whose value is the id of its associated ",A({},'<a role="tab">')),k({},"Each tab panel has an ",A({},"hidden")," attribute whose value is toggled based on which panel is visible"),k({},"When the Carousel is set to auto-play, the HTML for the pause button is required to precede the HTML of the tab set")),P({id:"Keyboard-Interactions"},"Keyboard Interactions"),I({},k({},"Arrow keys, when focus is on selected tab, cycle selection to the next or previous tab"),k({},"Tab key, when focus is before the tab list, moves focus to the selected tab panel"),k({},"Tab key, when focus is on selected tabpanel, moves focus into the selected tabpanel's associated tab or to the next focusable element on the page if that panel has no focusable elements"),k({},"Shift+Tab keys, when focus is on first element in a tab panel, move focus focus entirely from tabset")),S({id:"Base"},"Base"),Object(n.createElement)(c.a,{title:"carousel"},Object(n.createElement)(r.a,{demoStyles:"width: 480px; max-width: 100%;"},Object(n.createElement)(x,{panelActive:"1",autoPlay:!0}))),S({id:"Navigating-between-panels"},"Navigating between panels"),C({},"You are able to navigate between panels but interacting with the ",A({},"slds-carousel__indicator")," elements that sit below the panel."),N({id:"Panel-1-active"},"Panel 1 active"),Object(n.createElement)(c.a,{title:"carousel-panel-transition-panel-1"},Object(n.createElement)(r.a,{demoStyles:"width: 480px; max-width: 100%;"},Object(n.createElement)(x,{panelActive:"1",autoPlay:!0}))),N({id:"Panel-2-active"},"Panel 2 active"),Object(n.createElement)(c.a,{title:"carousel-panel-transition-panel-2"},Object(n.createElement)(r.a,{demoStyles:"width: 480px; max-width: 100%;"},Object(n.createElement)(x,{panelActive:"2",autoPlay:!0}))),Object(n.createElement)(i.a,{toggleCode:!1},Object(n.createElement)("div",{className:"slds-carousel"},Object(n.createElement)("div",{className:"slds-carousel__stage"},Object(n.createElement)("div",{className:"slds-carousel__panels",style:{transform:"translateX(-100%)"}},Object(n.createElement)("div",{id:"content-id-01",className:"slds-carousel__panel","aria-hidden":"false",role:"tabpanel","aria-labelledby":"indicator-id-01",tabIndex:"-1"},"..."),Object(n.createElement)("div",{id:"content-id-02",className:"slds-carousel__panel","aria-hidden":"true",role:"tabpanel","aria-labelledby":"indicator-id-02",tabIndex:"0"},"...")),Object(n.createElement)("ul",{className:"slds-carousel__indicators",role:"tablist"},Object(n.createElement)("li",{className:"slds-carousel__indicator",role:"presentation"},Object(n.createElement)("a",{id:"indicator-id-01",className:"slds-carousel__indicator-action",href:"#",onClick:function(e){return e.preventDefault()},role:"tab",tabIndex:"-1","aria-selected":"false","aria-controls":"content-id-01",title:"Visit App Exchange tab"},"...")),Object(n.createElement)("li",{className:"slds-carousel__indicator",role:"presentation"},Object(n.createElement)("a",{id:"indicator-id-02",className:"slds-carousel__indicator-action slds-is-active",href:"#",onClick:function(e){return e.preventDefault()},role:"tab",tabIndex:"0","aria-selected":"true","aria-controls":"content-id-02",title:"Click to Customize tab"},"...")))))),Object(n.createElement)(o.a,{header:"Accessibility",type:"a11y"},Object(n.createElement)("p",null,"A panel becomes visible by toggling the ",Object(n.createElement)("code",null,"aria-hidden")," attribute from ",Object(n.createElement)("code",null,"false")," to ",Object(n.createElement)("code",null,"true")," on the ",Object(n.createElement)("code",null,"slds-carousel__panel")," element. When a panel becomes active, the `tabindex` of the other non-visible panels should be set to -1 while the active panel remains at 0.")),C({},"When a panel becomes active, apply an inline style to ",A({},"slds-carousel__panel")," to move the panels left to right. We do this by updating the location of the panel on its Y axis using transforms. The first panel should be ",A({},"transform: translateX(0%)")," but when any preceding panel becomes active it can be subtracted by 100%, moving 100% of each panel to the left. For example, panel 1 would be visible at ",A({},"transform: translateX(0%)"),", while panel 3 would be visible at ",A({},"transform: translateX(-200%)"),"."),C({},"When making the ",A({},"slds-carousel__panel")," active, the indicator should be updated with the ",A({},"slds-is-active")," class. This provides visual feedback showing which carousel panel is active."),S({id:"Auto-play"},"Auto-play"),C({},"If the Carousel is set to auto-play, a pause button is required to be first in the HTML before the tab set."),Object(n.createElement)(o.a,{header:"Accessibility",type:"a11y"},Object(n.createElement)("p",null,"When that pause button is interacted with, the ",Object(n.createElement)("code",null,"aria-pressed")," role needs to be toggled to ",Object(n.createElement)("code",null,"true"),".")),Object(n.createElement)(c.a,{title:"carousel-autoplay"},Object(n.createElement)(i.a,{toggleCode:!1},Object(n.createElement)("div",{className:"slds-carousel"},Object(n.createElement)("div",{className:"slds-carousel__stage"},Object(n.createElement)(w,{stop:!0}),Object(n.createElement)("div",{className:"slds-carousel__panels"},"..."))))))},D=function(){return Object(s.a)(T())}}});

package/__internal/chunked/docs/ui/components/chat/docs.mdx.js CHANGED Viewed

package/__internal/chunked/docs/ui/components/checkbox/docs.mdx.js CHANGED Viewed

	@@ -1 +1 @@
1	- var SLDS="object"==typeof SLDS?SLDS:{};SLDS["__internal/chunked/docs/./ui/components/checkbox/docs.mdx.js"]=function(e){function t(t){for(var a,c,n=t[0],o=t[1],s=t[2],u=0,b=[];u<n.length;u++)c=n[u],Object.prototype.hasOwnProperty.call(r,c)&&r[c]&&b.push(r[c][0]),r[c]=0;for(a in o)Object.prototype.hasOwnProperty.call(o,a)&&(e[a]=o[a]);for(d&&d(t);b.length;)b.shift()();return i.push.apply(i,s\|\|[]),l()}function l(){for(var e,t=0;t<i.length;t++){for(var l=i[t],a=!0,n=1;n<l.length;n++){var o=l[n];0!==r[o]&&(a=!1)}a&&(i.splice(t--,1),e=c(c.s=l[0]))}return e}var a={},r={20:0},i=[];function c(t){if(a[t])return a[t].exports;var l=a[t]={i:t,l:!1,exports:{}};return e[t].call(l.exports,l,l.exports,c),l.l=!0,l.exports}c.m=e,c.c=a,c.d=function(e,t,l){c.o(e,t)\|\|Object.defineProperty(e,t,{enumerable:!0,get:l})},c.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},c.t=function(e,t){if(1&t&&(e=c(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var l=Object.create(null);if(c.r(l),Object.defineProperty(l,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var a in e)c.d(l,a,function(t){return e[t]}.bind(null,a));return l},c.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return c.d(t,"a",t),t},c.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},c.p="/assets/scripts/bundle/";var n=this.webpackJsonpSLDS___internal_chunked_docs=this.webpackJsonpSLDS___internal_chunked_docs\|\|[],o=n.push.bind(n);n.push=t,n=n.slice();for(var s=0;s<n.length;s++)t(n[s]);var d=o;return i.push([~~799~~,0]),l()}({0:function(e,t){e.exports=React},20:function(e,t){e.exports=ReactDOM},22:function(e,t){e.exports=JSBeautify},~~799~~:function(e,t,l){"use strict";l.r(t),l.d(t,"getElement",(function(){return v})),l.d(t,"getContents",(function(){return w}));var a=l(0),r=l.n(a),i=l(4),c=l(2),n=(l(27),l(14),l(40)),o=l(32),s=l(80),d=l(8),u=l(11),b=r.a.createElement(s.a,null),h=[{id:"checked",label:"Checked",element:r.a.createElement(s.a,{isChecked:!0})},{id:"disabled",label:"Disabled",element:r.a.createElement(s.a,{isDisabled:!0})},{id:"checked-disabled",label:"Checked and Disabled",element:r.a.createElement(s.a,{isChecked:!0,isDisabled:!0})},{id:"error",label:"Error",element:r.a.createElement(s.a,{isRequired:!0,hasError:!0,inlineMessage:"This field is required"})},{id:"required",label:"Required",element:r.a.createElement(s.a,{isRequired:!0})},{id:"view-mode-unchecked",label:"View mode - Unchecked",element:r.a.createElement(d.b,{labelContent:"Form Element Label",isViewMode:!0},r.a.createElement(u.a,{symbol:"steps",size:"x-small",useCurrentColor:!0,assistiveText:"False",title:"False"}))},{id:"view-mode-checked",label:"View mode - Checked",element:r.a.createElement(d.b,{labelContent:"Form Element Label",isViewMode:!0},r.a.createElement(u.a,{symbol:"check",size:"x-small",useCurrentColor:!0,assistiveText:"True",title:"True"}))}],m=[{id:"help-text-icon",label:"Help text icon",element:r.a.createElement(s.a,{hasTooltip:!0})},{id:"required-help-text-icon",label:"Required with Help text icon",element:r.a.createElement(s.a,{isRequired:!0,hasTooltip:!0})},{id:"required-help-text-icon-tooltip",label:"Required with Help text icon, showing tooltip",element:r.a.createElement("div",{style:{paddingTop:"3rem"}},r.a.createElement(s.a,{isRequired:!0,hasTooltip:!0,showTooltip:!0}))}],p=l(1),f=l(39),O=i.c.a,x=i.c.code,k=i.c.h2,j=i.c.h3,E=i.c.h4,y=i.c.h5,g=i.c.p,v=function(){return Object(a.createElement)(i.b,{},Object(a.createElement)("div",{className:"doc lead"},"A checkable input that communicates if an option is true, false or indeterminate"),Object(a.createElement)(c.a,{exampleOnly:!0},Object(p.f)(o.b)),k({id:"About-Checkbox"},"About Checkbox"),g({},"The ability to style checkboxes with CSS varies across browsers. To ensure that checkboxes look the same everywhere, we use a custom DOM. Pay close attention to the markup, because all elements must exist for the styles to work."),j({id:"Accessibility"},"Accessibility"),g({},"Groups of checkboxes should be marked up using the fieldset and legend element. This helps someone using assistive technology to understand the question they're answering with the group of checkboxes. The fieldset is placed around the whole group and the legend contains the question."),g({},"Custom checkboxes are created by applying the ",x({},".slds-checkbox")," class to a ",x({},"<label>")," element. To remain accessible to all user agents, place ",x({},"<input>")," with ",x({},'type="checkbox"')," inside the ",x({},"<label>")," element. The ",x({},"<input>")," is then visually hidden, and the styling is placed on a span with the ",x({},".slds-checkbox_faux")," class. The styling of the span changes based on whether the checkbox is selected or focused by using a pseudo-element. A second span with ",x({},".slds-form-element__label")," contains the label text."),g({},"When a single checkbox is required, ",x({},'<div class="slds-checkbox">')," should get ",x({},'<abbr class="required" title="required" aria-hidden="true"></abbr>')," added to the DOM, directly before the ",x({},'<input type="checkbox" />')," for visual indication that the checkbox is required."),g({},"When a checkbox group is required, the ",x({},"<fieldset>")," should receive the class ",x({},".slds-is-required"),". The ",x({},"<legend>")," should then get ",x({},'<abbr class="required" title="required" aria-hidden="true"></abbr>')," added to the DOM for visual indication that the checkbox group is required."),g({},"As SLDS checkboxes rely on the ",x({},":checked")," pseudo selector, and the indeterminate state is only accessible via JavaScript, the use of a CSS class on the input will be necessary to implement this in SLDS. Use JavaScript to add the class when the indeterminate property is set to true on the input."),j({id:"Mobile"},"Mobile"),Object(a.createElement)(f.a,{patternSpecificText:"checkboxes will have an increased size to accommodate tapping with a finger instead of the more precise mouse cursor, as well as having larger label text"}),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Example mobile styles for checkboxes"},Object(p.f)(o.b)),k({id:"Base"},"Base"),g({},"The base variant of a checkbox is a single boolean value. The base checkbox is consumed by both a grouped checkbox and a checkbox within a form element."),g({},"The ",O({href:"#Form-Element"},"form element variant")," accommodates a top level label and additional functionality such as like help text and read only mode. Help text is not supported on a single checkbox."),Object(a.createElement)(c.a,null,Object(p.f)(o.b)),j({id:"States"},"States"),E({id:"Required"},"Required"),Object(a.createElement)(c.a,null,Object(p.f)(o.d,"required")),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Required checkbox example"},Object(p.f)(o.d,"required")),E({id:"Error"},"Error"),Object(a.createElement)(c.a,null,Object(p.f)(o.d,"error")),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Checkbox in error state example"},Object(p.f)(o.d,"error")),E({id:"Disabled"},"Disabled"),Object(a.createElement)(c.a,null,Object(p.f)(o.d,"disabled")),y({id:"Checked-and-Disabled"},"Checked and Disabled"),Object(a.createElement)(c.a,null,Object(p.f)(o.d,"checked-and-disabled")),j({id:"Examples"},"Examples"),E({id:"Group"},"Group"),Object(a.createElement)(c.a,null,Object(p.f)(o.c,"group")),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Group checkbox example"},Object(p.f)(o.c,"group")),y({id:"Required-2"},"Required"),Object(a.createElement)(c.a,null,Object(p.f)(o.c,"group-required")),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Required group checkbox example"},Object(p.f)(o.c,"group-required")),y({id:"Error-2"},"Error"),Object(a.createElement)(c.a,null,Object(p.f)(o.c,"group-error")),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Group error checkbox example"},Object(p.f)(o.c,"group-error")),y({id:"Disabled-2"},"Disabled"),Object(a.createElement)(c.a,null,Object(p.f)(o.c,"group-disabled")),E({id:"RTL-(right-to-left-direction)"},"RTL (right to left direction)"),Object(a.createElement)(c.a,null,Object(p.f)(o.c,"rtl")),k({id:"Form-Element"},"Form Element"),Object(a.createElement)(c.a,null,Object(p.f)(b)),j({id:"States-2"},"States"),E({id:"Checked"},"Checked"),Object(a.createElement)(c.a,null,Object(p.f)(h,"checked")),E({id:"Disabled-3"},"Disabled"),Object(a.createElement)(c.a,null,Object(p.f)(h,"disabled")),E({id:"Checked-and-Disabled-2"},"Checked and Disabled"),Object(a.createElement)(c.a,null,Object(p.f)(h,"checked-disabled")),E({id:"Error-3"},"Error"),Object(a.createElement)(c.a,null,Object(p.f)(h,"error")),E({id:"Required-3"},"Required"),Object(a.createElement)(c.a,null,Object(p.f)(h,"required")),j({id:"View-mode"},"View mode"),g({},"View mode is the read only state of a checkbox form element."),E({id:"Unchecked"},"Unchecked"),Object(a.createElement)(c.a,null,Object(p.f)(h,"view-mode-unchecked")),E({id:"Checked-2"},"Checked"),Object(a.createElement)(c.a,null,Object(p.f)(h,"view-mode-checked")),j({id:"Examples-2"},"Examples"),E({id:"With-help-text"},"With help text"),Object(a.createElement)(c.a,null,Object(p.f)(m,"help-text-icon")),E({id:"Required-with-help-text"},"Required with help text"),Object(a.createElement)(c.a,null,Object(p.f)(m,"required-help-text-icon")),E({id:"Required-with-help-text-with-tooltip"},"Required with help text with tooltip"),Object(a.createElement)(c.a,null,Object(p.f)(m,"required-help-text-icon-tooltip")),k({id:"Styling-Hooks-Overview"},"Styling Hooks Overview"),Object(a.createElement)(n.a,{name:"checkbox",type:"component"}))},w=function(){return Object(i.a)(v())}}});
1	+ var SLDS="object"==typeof SLDS?SLDS:{};SLDS["__internal/chunked/docs/./ui/components/checkbox/docs.mdx.js"]=function(e){function t(t){for(var a,c,n=t[0],o=t[1],s=t[2],u=0,b=[];u<n.length;u++)c=n[u],Object.prototype.hasOwnProperty.call(r,c)&&r[c]&&b.push(r[c][0]),r[c]=0;for(a in o)Object.prototype.hasOwnProperty.call(o,a)&&(e[a]=o[a]);for(d&&d(t);b.length;)b.shift()();return i.push.apply(i,s\|\|[]),l()}function l(){for(var e,t=0;t<i.length;t++){for(var l=i[t],a=!0,n=1;n<l.length;n++){var o=l[n];0!==r[o]&&(a=!1)}a&&(i.splice(t--,1),e=c(c.s=l[0]))}return e}var a={},r={20:0},i=[];function c(t){if(a[t])return a[t].exports;var l=a[t]={i:t,l:!1,exports:{}};return e[t].call(l.exports,l,l.exports,c),l.l=!0,l.exports}c.m=e,c.c=a,c.d=function(e,t,l){c.o(e,t)\|\|Object.defineProperty(e,t,{enumerable:!0,get:l})},c.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},c.t=function(e,t){if(1&t&&(e=c(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var l=Object.create(null);if(c.r(l),Object.defineProperty(l,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var a in e)c.d(l,a,function(t){return e[t]}.bind(null,a));return l},c.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return c.d(t,"a",t),t},c.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},c.p="/assets/scripts/bundle/";var n=this.webpackJsonpSLDS___internal_chunked_docs=this.webpackJsonpSLDS___internal_chunked_docs\|\|[],o=n.push.bind(n);n.push=t,n=n.slice();for(var s=0;s<n.length;s++)t(n[s]);var d=o;return i.push([800,0]),l()}({0:function(e,t){e.exports=React},20:function(e,t){e.exports=ReactDOM},22:function(e,t){e.exports=JSBeautify},800:function(e,t,l){"use strict";l.r(t),l.d(t,"getElement",(function(){return w})),l.d(t,"getContents",(function(){return q}));var a=l(0),r=l.n(a),i=l(4),c=l(2),n=(l(27),l(13),l(40)),o=l(70),s=l(32),d=l(81),u=l(8),b=l(11),h=r.a.createElement(d.a,null),m=[{id:"checked",label:"Checked",element:r.a.createElement(d.a,{isChecked:!0})},{id:"disabled",label:"Disabled",element:r.a.createElement(d.a,{isDisabled:!0})},{id:"checked-disabled",label:"Checked and Disabled",element:r.a.createElement(d.a,{isChecked:!0,isDisabled:!0})},{id:"error",label:"Error",element:r.a.createElement(d.a,{isRequired:!0,hasError:!0,inlineMessage:"This field is required"})},{id:"required",label:"Required",element:r.a.createElement(d.a,{isRequired:!0})},{id:"view-mode-unchecked",label:"View mode - Unchecked",element:r.a.createElement(u.b,{labelContent:"Form Element Label",isViewMode:!0},r.a.createElement(b.a,{symbol:"steps",size:"x-small",useCurrentColor:!0,assistiveText:"False",title:"False"}))},{id:"view-mode-checked",label:"View mode - Checked",element:r.a.createElement(u.b,{labelContent:"Form Element Label",isViewMode:!0},r.a.createElement(b.a,{symbol:"check",size:"x-small",useCurrentColor:!0,assistiveText:"True",title:"True"}))}],p=[{id:"help-text-icon",label:"Help text icon",element:r.a.createElement(d.a,{hasTooltip:!0})},{id:"required-help-text-icon",label:"Required with Help text icon",element:r.a.createElement(d.a,{isRequired:!0,hasTooltip:!0})},{id:"required-help-text-icon-tooltip",label:"Required with Help text icon, showing tooltip",element:r.a.createElement("div",{style:{paddingTop:"3rem"}},r.a.createElement(d.a,{isRequired:!0,hasTooltip:!0,showTooltip:!0}))}],f=l(1),O=l(39),x=i.c.a,j=i.c.code,k=i.c.h2,E=i.c.h3,y=i.c.h4,g=i.c.h5,v=i.c.p,w=function(){return Object(a.createElement)(i.b,{},Object(a.createElement)("div",{className:"doc lead"},"A checkable input that communicates if an option is true, false or indeterminate"),Object(a.createElement)(c.a,{exampleOnly:!0},Object(f.f)(s.b)),k({id:"About-Checkbox"},"About Checkbox"),v({},"The ability to style checkboxes with CSS varies across browsers. To ensure that checkboxes look the same everywhere, we use a custom DOM. Pay close attention to the markup, because all elements must exist for the styles to work."),E({id:"Accessibility"},"Accessibility"),v({},"Groups of checkboxes should be marked up using the fieldset and legend element. This helps someone using assistive technology to understand the question they're answering with the group of checkboxes. The fieldset is placed around the whole group and the legend contains the question."),v({},"Custom checkboxes are created by applying the ",j({},".slds-checkbox")," class to a ",j({},"<label>")," element. To remain accessible to all user agents, place ",j({},"<input>")," with ",j({},'type="checkbox"')," inside the ",j({},"<label>")," element. The ",j({},"<input>")," is then visually hidden, and the styling is placed on a span with the ",j({},".slds-checkbox_faux")," class. The styling of the span changes based on whether the checkbox is selected or focused by using a pseudo-element. A second span with ",j({},".slds-form-element__label")," contains the label text."),v({},"When a single checkbox is required, ",j({},'<div class="slds-checkbox">')," should get ",j({},'<abbr class="required" title="required" aria-hidden="true"></abbr>')," added to the DOM, directly before the ",j({},'<input type="checkbox" />')," for visual indication that the checkbox is required."),v({},"When a checkbox group is required, the ",j({},"<fieldset>")," should receive the class ",j({},".slds-is-required"),". The ",j({},"<legend>")," should then get ",j({},'<abbr class="required" title="required" aria-hidden="true"></abbr>')," added to the DOM for visual indication that the checkbox group is required."),v({},"Example:\n",Object(a.createElement)(o.a,null)),v({},"As SLDS checkboxes rely on the ",j({},":checked")," pseudo selector, and the indeterminate state is only accessible via JavaScript, the use of a CSS class on the input will be necessary to implement this in SLDS. Use JavaScript to add the class when the indeterminate property is set to true on the input."),E({id:"Mobile"},"Mobile"),Object(a.createElement)(O.a,{patternSpecificText:"checkboxes will have an increased size to accommodate tapping with a finger instead of the more precise mouse cursor, as well as having larger label text"}),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Example mobile styles for checkboxes"},Object(f.f)(s.b)),k({id:"Base"},"Base"),v({},"The base variant of a checkbox is a single boolean value. The base checkbox is consumed by both a grouped checkbox and a checkbox within a form element."),v({},"The ",x({href:"#Form-Element"},"form element variant")," accommodates a top level label and additional functionality such as like help text and read only mode. Help text is not supported on a single checkbox."),Object(a.createElement)(c.a,null,Object(f.f)(s.b)),E({id:"States"},"States"),y({id:"Required"},"Required"),Object(a.createElement)(c.a,null,Object(f.f)(s.d,"required")),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Required checkbox example"},Object(f.f)(s.d,"required")),y({id:"Error"},"Error"),Object(a.createElement)(c.a,null,Object(f.f)(s.d,"error")),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Checkbox in error state example"},Object(f.f)(s.d,"error")),y({id:"Disabled"},"Disabled"),Object(a.createElement)(c.a,null,Object(f.f)(s.d,"disabled")),g({id:"Checked-and-Disabled"},"Checked and Disabled"),Object(a.createElement)(c.a,null,Object(f.f)(s.d,"checked-and-disabled")),E({id:"Examples"},"Examples"),y({id:"Group"},"Group"),Object(a.createElement)(c.a,null,Object(f.f)(s.c,"group")),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Group checkbox example"},Object(f.f)(s.c,"group")),g({id:"Required-2"},"Required"),Object(a.createElement)(c.a,null,Object(f.f)(s.c,"group-required")),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Required group checkbox example"},Object(f.f)(s.c,"group-required")),g({id:"Error-2"},"Error"),Object(a.createElement)(c.a,null,Object(f.f)(s.c,"group-error")),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Group error checkbox example"},Object(f.f)(s.c,"group-error")),g({id:"Disabled-2"},"Disabled"),Object(a.createElement)(c.a,null,Object(f.f)(s.c,"group-disabled")),y({id:"RTL-(right-to-left-direction)"},"RTL (right to left direction)"),Object(a.createElement)(c.a,null,Object(f.f)(s.c,"rtl")),k({id:"Form-Element"},"Form Element"),Object(a.createElement)(c.a,null,Object(f.f)(h)),E({id:"States-2"},"States"),y({id:"Checked"},"Checked"),Object(a.createElement)(c.a,null,Object(f.f)(m,"checked")),y({id:"Disabled-3"},"Disabled"),Object(a.createElement)(c.a,null,Object(f.f)(m,"disabled")),y({id:"Checked-and-Disabled-2"},"Checked and Disabled"),Object(a.createElement)(c.a,null,Object(f.f)(m,"checked-disabled")),y({id:"Error-3"},"Error"),Object(a.createElement)(c.a,null,Object(f.f)(m,"error")),y({id:"Required-3"},"Required"),Object(a.createElement)(c.a,null,Object(f.f)(m,"required")),E({id:"View-mode"},"View mode"),v({},"View mode is the read only state of a checkbox form element."),y({id:"Unchecked"},"Unchecked"),Object(a.createElement)(c.a,null,Object(f.f)(m,"view-mode-unchecked")),y({id:"Checked-2"},"Checked"),Object(a.createElement)(c.a,null,Object(f.f)(m,"view-mode-checked")),E({id:"Examples-2"},"Examples"),y({id:"With-help-text"},"With help text"),Object(a.createElement)(c.a,null,Object(f.f)(p,"help-text-icon")),y({id:"Required-with-help-text"},"Required with help text"),Object(a.createElement)(c.a,null,Object(f.f)(p,"required-help-text-icon")),y({id:"Required-with-help-text-with-tooltip"},"Required with help text with tooltip"),Object(a.createElement)(c.a,null,Object(f.f)(p,"required-help-text-icon-tooltip")),k({id:"Styling-Hooks-Overview"},"Styling Hooks Overview"),Object(a.createElement)(n.a,{name:"checkbox",type:"component"}))},q=function(){return Object(i.a)(w())}}});

package/__internal/chunked/docs/ui/components/checkbox-button/docs.mdx.js CHANGED Viewed

	@@ -1 +1 @@
1	- var SLDS="object"==typeof SLDS?SLDS:{};SLDS["__internal/chunked/docs/./ui/components/checkbox-button/docs.mdx.js"]=function(e){function t(t){for(var n,a,l=t[0],s=t[1],r=t[2],d=0,h=[];d<l.length;d++)a=l[d],Object.prototype.hasOwnProperty.call(i,a)&&i[a]&&h.push(i[a][0]),i[a]=0;for(n in s)Object.prototype.hasOwnProperty.call(s,n)&&(e[n]=s[n]);for(b&&b(t);h.length;)h.shift()();return o.push.apply(o,r\|\|[]),c()}function c(){for(var e,t=0;t<o.length;t++){for(var c=o[t],n=!0,l=1;l<c.length;l++){var s=c[l];0!==i[s]&&(n=!1)}n&&(o.splice(t--,1),e=a(a.s=c[0]))}return e}var n={},i={18:0},o=[];function a(t){if(n[t])return n[t].exports;var c=n[t]={i:t,l:!1,exports:{}};return e[t].call(c.exports,c,c.exports,a),c.l=!0,c.exports}a.m=e,a.c=n,a.d=function(e,t,c){a.o(e,t)\|\|Object.defineProperty(e,t,{enumerable:!0,get:c})},a.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},a.t=function(e,t){if(1&t&&(e=a(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var c=Object.create(null);if(a.r(c),Object.defineProperty(c,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var n in e)a.d(c,n,function(t){return e[t]}.bind(null,n));return c},a.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return a.d(t,"a",t),t},a.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},a.p="/assets/scripts/bundle/";var l=this.webpackJsonpSLDS___internal_chunked_docs=this.webpackJsonpSLDS___internal_chunked_docs\|\|[],s=l.push.bind(l);l.push=t,l=l.slice();for(var r=0;r<l.length;r++)t(l[r]);var b=s;return o.push([~~797~~,0]),c()}({0:function(e,t){e.exports=React},20:function(e,t){e.exports=ReactDOM},22:function(e,t){e.exports=JSBeautify},~~797~~:function(e,t,c){"use strict";c.r(t),c.d(t,"getElement",(function(){return E})),c.d(t,"getContents",(function(){return S}));var n=c(0),i=c.n(n),o=c(4),a=c(79),l=i.a.createElement(a.b,null),s=[{id:"checkbox-button-checked",label:"Checked",element:i.a.createElement(a.b,{isChecked:!0})},{id:"checkbox-button-disabled",label:"Disabled",element:i.a.createElement(a.b,{isDisabled:!0})},{id:"checkbox-button-checked-disabled",label:"Checked and Disabled",element:i.a.createElement(a.b,{isChecked:!0,isDisabled:!0})},{id:"checkbox-add-button-checked",label:"Deprecated - Checked",element:i.a.createElement(a.a,{checked:!0})},{id:"checkbox-add-button-disabled",label:"Deprecated - Disabled",element:i.a.createElement(a.a,{disabled:!0})},{id:"checkbox-add-button-checked-and-disabled",label:"Deprecated - Checked and Disabled",element:i.a.createElement(a.a,{checked:!0,disabled:!0})}],r=[{id:"checkbox-button-icon-symbol",label:"Different Icon",element:i.a.createElement(a.b,{iconUnchecked:"recycle_bin_empty",iconChecked:"recycle_bin_full"})},{id:"checkbox-button-checked-icon-symbol",label:"Different Icon - Checked",element:i.a.createElement(a.b,{iconUnchecked:"recycle_bin_empty",iconChecked:"recycle_bin_full",isChecked:!0})},{id:"checkbox-button-disabled-icon-symbol",label:"Different Icon - Disabled",element:i.a.createElement(a.b,{iconUnchecked:"recycle_bin_empty",isDisabled:!0})},{id:"checkbox-button-checked-disabled-icon-symbol",label:"Different Icon - Checked and Disabled",element:i.a.createElement(a.b,{iconChecked:"recycle_bin_full",isChecked:!0,isDisabled:!0})}],b=c(2),d=c(1),h=c(39),u=o.c.a,f=o.c.code,m=o.c.h2,p=o.c.h3,k=o.c.li,y=o.c.p,x=o.c.table,_=o.c.tbody,O=o.c.td,D=o.c.th,g=o.c.thead,j=o.c.tr,v=o.c.ul,E=function(){return Object(n.createElement)(o.b,{},Object(n.createElement)("div",{className:"doc lead"},"A styled checkable input that communicates if an option is being added to a group"),Object(n.createElement)(b.a,{exampleOnly:!0},Object(d.f)(l)),m({id:"About-Checkbox-Button"},"About Checkbox Button"),y({},"The checkbox button is similar to a checkbox in that it presents a user with a\nbinary choice for an item. However, the only action a user can take is to\nadd (or remove) an entity. When a user clicks the checkbox button, the entity is\nstored, similar to an ‘add to cart’ experience, until the user saves changes."),y({},"The checkbox button is useful for increasing clarity. Since the button only adds\nor removes entities, the user knows the action they will prompt upon click.\nThe checkbox button also provides a clear visual affordance and a large target to take this action."),y({},"Use the add button if the component you’re building:"),v({},k({},"Exists without other multi-select elements (i.e. checkboxes)"),k({},"Allows users to select multiple entities"),k({},"Semantically fits the add/remove model")),m({id:"Structure-and-Implementation"},"Structure and Implementation"),y({},"The checkbox ",f({},"<input>")," is visually hidden with ",f({},".slds-assistive-text")," and a faux checkbox is created using the ",u({href:"/components/icons"},"icon blueprint")," which allows the display of an icon instead of the standard checkbox."),y({},"Click and tap events are captured by a ",f({},"<label>")," that encases the entire blueprint. The ",f({},"for")," attribute of your ",f({},"<label>")," must match the ",f({},"id")," attribute of your ",f({},"<input>"),"."),y({},"The states of the checkbox button are styled with the following classes:"),x({},g({},j({},D({},"Class"),D({},"State"),D({},"Description"))),_({},j({},O({},f({},".slds-checkbox-button_is-checked")),O({},"checked"),O({},"The checked state when the checkbox button has been selected")),j({},O({},f({},".slds-checkbox-button_is-disabled")),O({},"disabled"),O({},"The disabled state when the checkbox button has been disabled")),j({},O({},f({},".slds-checkbox-button_is-focused")),O({},"focused"),O({},"The focused state when the checkbox button has focus; important for accessibility")))),y({},"When implementing this blueprint, monitor the state of the checkbox ",f({},"<input>")," and apply the appropriate state class listed in the above chart based on the current state of the checkbox ",f({},"<input>"),"."),y({},"It is possible to change the icon used within the checkbox button, see ",u({href:"#different-icon"},"Different Icons")," for more details."),p({id:"Mobile"},"Mobile"),Object(n.createElement)(h.a,{patternSpecificText:"checkbox buttons will have an increased size to accommodate tapping with a finger instead of the more precise mouse cursor"}),Object(n.createElement)(b.a,{frameOnly:!0,frameTitle:"Example mobile styles for checkbox buttons"},Object(d.f)(l)),m({id:"Base"},"Base"),Object(n.createElement)(b.a,null,Object(d.f)(l)),m({id:"States"},"States"),p({id:"Checked"},"Checked"),Object(n.createElement)(b.a,null,Object(d.f)(s,"checkbox-button-checked")),p({id:"Disabled"},"Disabled"),Object(n.createElement)(b.a,null,Object(d.f)(s,"checkbox-button-disabled")),p({id:"Checked-and-Disabled"},"Checked and Disabled"),Object(n.createElement)(b.a,null,Object(d.f)(s,"checkbox-button-checked-disabled")),m({id:"Examples"},"Examples"),p({id:"Different-Icon"},"Different Icon"),y({},"You may change the utility icon used by the checkbox button depending on the action you are communicating. Reference the ",u({href:"/icons/#utility"},"utility icon listing")," for all available options."),y({},"This example is using the ",f({},"recycle_bin_empty")," utility icon as its base state and the ",f({},"recycle_bin_full")," utility icon as its checked state."),Object(n.createElement)(b.a,null,Object(d.f)(r,"checkbox-button-icon-symbol")),Object(n.createElement)(b.a,null,Object(d.f)(r,"checkbox-button-checked-icon-symbol")))},S=function(){return Object(o.a)(E())}}});
1	+ var SLDS="object"==typeof SLDS?SLDS:{};SLDS["__internal/chunked/docs/./ui/components/checkbox-button/docs.mdx.js"]=function(e){function t(t){for(var n,a,l=t[0],s=t[1],r=t[2],d=0,h=[];d<l.length;d++)a=l[d],Object.prototype.hasOwnProperty.call(i,a)&&i[a]&&h.push(i[a][0]),i[a]=0;for(n in s)Object.prototype.hasOwnProperty.call(s,n)&&(e[n]=s[n]);for(b&&b(t);h.length;)h.shift()();return o.push.apply(o,r\|\|[]),c()}function c(){for(var e,t=0;t<o.length;t++){for(var c=o[t],n=!0,l=1;l<c.length;l++){var s=c[l];0!==i[s]&&(n=!1)}n&&(o.splice(t--,1),e=a(a.s=c[0]))}return e}var n={},i={18:0},o=[];function a(t){if(n[t])return n[t].exports;var c=n[t]={i:t,l:!1,exports:{}};return e[t].call(c.exports,c,c.exports,a),c.l=!0,c.exports}a.m=e,a.c=n,a.d=function(e,t,c){a.o(e,t)\|\|Object.defineProperty(e,t,{enumerable:!0,get:c})},a.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},a.t=function(e,t){if(1&t&&(e=a(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var c=Object.create(null);if(a.r(c),Object.defineProperty(c,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var n in e)a.d(c,n,function(t){return e[t]}.bind(null,n));return c},a.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return a.d(t,"a",t),t},a.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},a.p="/assets/scripts/bundle/";var l=this.webpackJsonpSLDS___internal_chunked_docs=this.webpackJsonpSLDS___internal_chunked_docs\|\|[],s=l.push.bind(l);l.push=t,l=l.slice();for(var r=0;r<l.length;r++)t(l[r]);var b=s;return o.push([798,0]),c()}({0:function(e,t){e.exports=React},20:function(e,t){e.exports=ReactDOM},22:function(e,t){e.exports=JSBeautify},798:function(e,t,c){"use strict";c.r(t),c.d(t,"getElement",(function(){return E})),c.d(t,"getContents",(function(){return S}));var n=c(0),i=c.n(n),o=c(4),a=c(80),l=i.a.createElement(a.b,null),s=[{id:"checkbox-button-checked",label:"Checked",element:i.a.createElement(a.b,{isChecked:!0})},{id:"checkbox-button-disabled",label:"Disabled",element:i.a.createElement(a.b,{isDisabled:!0})},{id:"checkbox-button-checked-disabled",label:"Checked and Disabled",element:i.a.createElement(a.b,{isChecked:!0,isDisabled:!0})},{id:"checkbox-add-button-checked",label:"Deprecated - Checked",element:i.a.createElement(a.a,{checked:!0})},{id:"checkbox-add-button-disabled",label:"Deprecated - Disabled",element:i.a.createElement(a.a,{disabled:!0})},{id:"checkbox-add-button-checked-and-disabled",label:"Deprecated - Checked and Disabled",element:i.a.createElement(a.a,{checked:!0,disabled:!0})}],r=[{id:"checkbox-button-icon-symbol",label:"Different Icon",element:i.a.createElement(a.b,{iconUnchecked:"recycle_bin_empty",iconChecked:"recycle_bin_full"})},{id:"checkbox-button-checked-icon-symbol",label:"Different Icon - Checked",element:i.a.createElement(a.b,{iconUnchecked:"recycle_bin_empty",iconChecked:"recycle_bin_full",isChecked:!0})},{id:"checkbox-button-disabled-icon-symbol",label:"Different Icon - Disabled",element:i.a.createElement(a.b,{iconUnchecked:"recycle_bin_empty",isDisabled:!0})},{id:"checkbox-button-checked-disabled-icon-symbol",label:"Different Icon - Checked and Disabled",element:i.a.createElement(a.b,{iconChecked:"recycle_bin_full",isChecked:!0,isDisabled:!0})}],b=c(2),d=c(1),h=c(39),u=o.c.a,f=o.c.code,m=o.c.h2,p=o.c.h3,k=o.c.li,y=o.c.p,x=o.c.table,_=o.c.tbody,O=o.c.td,D=o.c.th,g=o.c.thead,j=o.c.tr,v=o.c.ul,E=function(){return Object(n.createElement)(o.b,{},Object(n.createElement)("div",{className:"doc lead"},"A styled checkable input that communicates if an option is being added to a group"),Object(n.createElement)(b.a,{exampleOnly:!0},Object(d.f)(l)),m({id:"About-Checkbox-Button"},"About Checkbox Button"),y({},"The checkbox button is similar to a checkbox in that it presents a user with a\nbinary choice for an item. However, the only action a user can take is to\nadd (or remove) an entity. When a user clicks the checkbox button, the entity is\nstored, similar to an ‘add to cart’ experience, until the user saves changes."),y({},"The checkbox button is useful for increasing clarity. Since the button only adds\nor removes entities, the user knows the action they will prompt upon click.\nThe checkbox button also provides a clear visual affordance and a large target to take this action."),y({},"Use the add button if the component you’re building:"),v({},k({},"Exists without other multi-select elements (i.e. checkboxes)"),k({},"Allows users to select multiple entities"),k({},"Semantically fits the add/remove model")),m({id:"Structure-and-Implementation"},"Structure and Implementation"),y({},"The checkbox ",f({},"<input>")," is visually hidden with ",f({},".slds-assistive-text")," and a faux checkbox is created using the ",u({href:"/components/icons"},"icon blueprint")," which allows the display of an icon instead of the standard checkbox."),y({},"Click and tap events are captured by a ",f({},"<label>")," that encases the entire blueprint. The ",f({},"for")," attribute of your ",f({},"<label>")," must match the ",f({},"id")," attribute of your ",f({},"<input>"),"."),y({},"The states of the checkbox button are styled with the following classes:"),x({},g({},j({},D({},"Class"),D({},"State"),D({},"Description"))),_({},j({},O({},f({},".slds-checkbox-button_is-checked")),O({},"checked"),O({},"The checked state when the checkbox button has been selected")),j({},O({},f({},".slds-checkbox-button_is-disabled")),O({},"disabled"),O({},"The disabled state when the checkbox button has been disabled")),j({},O({},f({},".slds-checkbox-button_is-focused")),O({},"focused"),O({},"The focused state when the checkbox button has focus; important for accessibility")))),y({},"When implementing this blueprint, monitor the state of the checkbox ",f({},"<input>")," and apply the appropriate state class listed in the above chart based on the current state of the checkbox ",f({},"<input>"),"."),y({},"It is possible to change the icon used within the checkbox button, see ",u({href:"#different-icon"},"Different Icons")," for more details."),p({id:"Mobile"},"Mobile"),Object(n.createElement)(h.a,{patternSpecificText:"checkbox buttons will have an increased size to accommodate tapping with a finger instead of the more precise mouse cursor"}),Object(n.createElement)(b.a,{frameOnly:!0,frameTitle:"Example mobile styles for checkbox buttons"},Object(d.f)(l)),m({id:"Base"},"Base"),Object(n.createElement)(b.a,null,Object(d.f)(l)),m({id:"States"},"States"),p({id:"Checked"},"Checked"),Object(n.createElement)(b.a,null,Object(d.f)(s,"checkbox-button-checked")),p({id:"Disabled"},"Disabled"),Object(n.createElement)(b.a,null,Object(d.f)(s,"checkbox-button-disabled")),p({id:"Checked-and-Disabled"},"Checked and Disabled"),Object(n.createElement)(b.a,null,Object(d.f)(s,"checkbox-button-checked-disabled")),m({id:"Examples"},"Examples"),p({id:"Different-Icon"},"Different Icon"),y({},"You may change the utility icon used by the checkbox button depending on the action you are communicating. Reference the ",u({href:"/icons/#utility"},"utility icon listing")," for all available options."),y({},"This example is using the ",f({},"recycle_bin_empty")," utility icon as its base state and the ",f({},"recycle_bin_full")," utility icon as its checked state."),Object(n.createElement)(b.a,null,Object(d.f)(r,"checkbox-button-icon-symbol")),Object(n.createElement)(b.a,null,Object(d.f)(r,"checkbox-button-checked-icon-symbol")))},S=function(){return Object(o.a)(E())}}});

package/__internal/chunked/docs/ui/components/checkbox-button-group/docs.mdx.js CHANGED Viewed

	@@ -1 +1 @@
1	- var SLDS="object"==typeof SLDS?SLDS:{};SLDS["__internal/chunked/docs/./ui/components/checkbox-button-group/docs.mdx.js"]=function(e){function t(t){for(var a,c,o=t[0],s=t[1],d=t[2],u=0,m=[];u<o.length;u++)c=o[u],Object.prototype.hasOwnProperty.call(n,c)&&n[c]&&m.push(n[c][0]),n[c]=0;for(a in s)Object.prototype.hasOwnProperty.call(s,a)&&(e[a]=s[a]);for(i&&i(t);m.length;)m.shift()();return l.push.apply(l,d\|\|[]),r()}function r(){for(var e,t=0;t<l.length;t++){for(var r=l[t],a=!0,o=1;o<r.length;o++){var s=r[o];0!==n[s]&&(a=!1)}a&&(l.splice(t--,1),e=c(c.s=r[0]))}return e}var a={},n={17:0},l=[];function c(t){if(a[t])return a[t].exports;var r=a[t]={i:t,l:!1,exports:{}};return e[t].call(r.exports,r,r.exports,c),r.l=!0,r.exports}c.m=e,c.c=a,c.d=function(e,t,r){c.o(e,t)\|\|Object.defineProperty(e,t,{enumerable:!0,get:r})},c.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},c.t=function(e,t){if(1&t&&(e=c(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var r=Object.create(null);if(c.r(r),Object.defineProperty(r,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var a in e)c.d(r,a,function(t){return e[t]}.bind(null,a));return r},c.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return c.d(t,"a",t),t},c.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},c.p="/assets/scripts/bundle/";var o=this.webpackJsonpSLDS___internal_chunked_docs=this.webpackJsonpSLDS___internal_chunked_docs\|\|[],s=o.push.bind(o);o.push=t,o=o.slice();for(var d=0;d<o.length;d++)t(o[d]);var i=s;return l.push([~~773~~,0]),r()}({0:function(e,t){e.exports=React},20:function(e,t){e.exports=ReactDOM},22:function(e,t){e.exports=JSBeautify},~~773~~:function(e,t,r){"use strict";r.r(t),r.d(t,"getElement",(function(){return x})),r.d(t,"getContents",(function(){return g}));var a=r(0),n=r.n(a),l=r(4),c=r(2),o=(r(14),r(1)),s=r(39),d=r(5),i=r.n(d),u=function(e){return n.a.createElement("fieldset",{className:i()("slds-form-element",e.className)},n.a.createElement("legend",{className:"slds-form-element__legend slds-form-element__label"},"Scheduled Day(s)"),n.a.createElement("div",{className:"slds-form-element__control"},e.children))},m=function(e){return n.a.createElement("div",{className:i()("slds-checkbox_button-group",e.className)},e.children)},b=function(e){var t=o.d.uniqueId("unique-id-".concat(e.id,"-"));return n.a.createElement("span",{className:i()("slds-button slds-checkbox_button",e.className)},n.a.createElement("input",{"aria-describedby":e.errorId,disabled:e.disabled,defaultChecked:e.checked,id:t,value:t,name:"checkbox",type:"checkbox"}),n.a.createElement("label",{className:"slds-checkbox_button__label",htmlFor:t},n.a.createElement("span",{className:"slds-checkbox_faux"},e.children)))},f=[{id:"default",label:"Default",element:n.a.createElement(u,null,n.a.createElement(m,null,n.a.createElement(b,{id:"monday"},"Mon"),n.a.createElement(b,{id:"tuesday"},"Tue"),n.a.createElement(b,{id:"wednesday"},"Wed"),n.a.createElement(b,{id:"thursday"},"Thu"),n.a.createElement(b,{id:"friday"},"Fri")))}],p=[{id:"has-error",label:"Error",element:n.a.createElement(u,{className:"slds-has-error"},n.a.createElement(m,null,n.a.createElement(b,{errorId:"error_01",id:"monday"},"Mon"),n.a.createElement(b,{errorId:"error_01",id:"tuesday"},"Tue"),n.a.createElement(b,{errorId:"error_01",id:"wednesday"},"Wed"),n.a.createElement(b,{errorId:"error_01",id:"thursday"},"Thu"),n.a.createElement(b,{errorId:"error_01",id:"friday"},"Fri")),n.a.createElement("div",{id:"error_01",className:"slds-form-element__help"},"This field is required"))},{id:"disabled",label:"Disabled",element:n.a.createElement(u,null,n.a.createElement(m,null,n.a.createElement(b,{id:"monday",disabled:!0},"Mon"),n.a.createElement(b,{id:"tuesday",disabled:!0},"Tue"),n.a.createElement(b,{id:"wednesday",disabled:!0},"Wed"),n.a.createElement(b,{id:"thursday",disabled:!0},"Thu"),n.a.createElement(b,{id:"friday",disabled:!0},"Fri")))}],h=l.c.a,E=l.c.code,y=l.c.h2,_=l.c.h3,O=l.c.p,x=function(){return Object(a.createElement)(l.b,{},Object(a.createElement)("div",{className:"doc lead"},"A styled checkable input group that communicates if an option(s) are true, false or indeterminate"),Object(a.createElement)(c.a,{exampleOnly:!0},Object(o.f)(f)),y({id:"About-Checkbox-Button-Group"},"About Checkbox Button Group"),O({},"The checkbox-button-group is a set of ",h({href:"/components/checkbox-button"},"checkbox buttons")," wrapped in a fieldset that is also a ",h({href:"/components/form-element"},"form element"),". It is described by a legend with the classes ",E({},"slds-form-element__legend")," and ",E({},"slds-form-element__label")," applied to it."),_({id:"Mobile"},"Mobile"),Object(a.createElement)(s.a,{patternSpecificText:"buttons in the checkbox button group will have an increased size to accommodate tapping with a finger instead of the more precise mouse cursor, as well as become stacked"}),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Example mobile styles for checkbox button groups"},Object(o.f)(f)),y({id:"Base"},"Base"),Object(a.createElement)(c.a,null,Object(o.f)(f)),y({id:"States"},"States"),_({id:"Has-Error"},"Has Error"),Object(a.createElement)(c.a,null,Object(o.f)(p,"has-error")),_({id:"Disabled"},"Disabled"),Object(a.createElement)(c.a,null,Object(o.f)(p,"disabled")))},g=function(){return Object(l.a)(x())}}});
1	+ var SLDS="object"==typeof SLDS?SLDS:{};SLDS["__internal/chunked/docs/./ui/components/checkbox-button-group/docs.mdx.js"]=function(e){function t(t){for(var a,c,o=t[0],s=t[1],d=t[2],u=0,m=[];u<o.length;u++)c=o[u],Object.prototype.hasOwnProperty.call(n,c)&&n[c]&&m.push(n[c][0]),n[c]=0;for(a in s)Object.prototype.hasOwnProperty.call(s,a)&&(e[a]=s[a]);for(i&&i(t);m.length;)m.shift()();return l.push.apply(l,d\|\|[]),r()}function r(){for(var e,t=0;t<l.length;t++){for(var r=l[t],a=!0,o=1;o<r.length;o++){var s=r[o];0!==n[s]&&(a=!1)}a&&(l.splice(t--,1),e=c(c.s=r[0]))}return e}var a={},n={17:0},l=[];function c(t){if(a[t])return a[t].exports;var r=a[t]={i:t,l:!1,exports:{}};return e[t].call(r.exports,r,r.exports,c),r.l=!0,r.exports}c.m=e,c.c=a,c.d=function(e,t,r){c.o(e,t)\|\|Object.defineProperty(e,t,{enumerable:!0,get:r})},c.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},c.t=function(e,t){if(1&t&&(e=c(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var r=Object.create(null);if(c.r(r),Object.defineProperty(r,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var a in e)c.d(r,a,function(t){return e[t]}.bind(null,a));return r},c.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return c.d(t,"a",t),t},c.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},c.p="/assets/scripts/bundle/";var o=this.webpackJsonpSLDS___internal_chunked_docs=this.webpackJsonpSLDS___internal_chunked_docs\|\|[],s=o.push.bind(o);o.push=t,o=o.slice();for(var d=0;d<o.length;d++)t(o[d]);var i=s;return l.push([774,0]),r()}({0:function(e,t){e.exports=React},20:function(e,t){e.exports=ReactDOM},22:function(e,t){e.exports=JSBeautify},774:function(e,t,r){"use strict";r.r(t),r.d(t,"getElement",(function(){return x})),r.d(t,"getContents",(function(){return g}));var a=r(0),n=r.n(a),l=r(4),c=r(2),o=(r(13),r(1)),s=r(39),d=r(5),i=r.n(d),u=function(e){return n.a.createElement("fieldset",{className:i()("slds-form-element",e.className)},n.a.createElement("legend",{className:"slds-form-element__legend slds-form-element__label"},"Scheduled Day(s)"),n.a.createElement("div",{className:"slds-form-element__control"},e.children))},m=function(e){return n.a.createElement("div",{className:i()("slds-checkbox_button-group",e.className)},e.children)},b=function(e){var t=o.d.uniqueId("unique-id-".concat(e.id,"-"));return n.a.createElement("span",{className:i()("slds-button slds-checkbox_button",e.className)},n.a.createElement("input",{"aria-describedby":e.errorId,disabled:e.disabled,defaultChecked:e.checked,id:t,value:t,name:"checkbox",type:"checkbox"}),n.a.createElement("label",{className:"slds-checkbox_button__label",htmlFor:t},n.a.createElement("span",{className:"slds-checkbox_faux"},e.children)))},f=[{id:"default",label:"Default",element:n.a.createElement(u,null,n.a.createElement(m,null,n.a.createElement(b,{id:"monday"},"Mon"),n.a.createElement(b,{id:"tuesday"},"Tue"),n.a.createElement(b,{id:"wednesday"},"Wed"),n.a.createElement(b,{id:"thursday"},"Thu"),n.a.createElement(b,{id:"friday"},"Fri")))}],p=[{id:"has-error",label:"Error",element:n.a.createElement(u,{className:"slds-has-error"},n.a.createElement(m,null,n.a.createElement(b,{errorId:"error_01",id:"monday"},"Mon"),n.a.createElement(b,{errorId:"error_01",id:"tuesday"},"Tue"),n.a.createElement(b,{errorId:"error_01",id:"wednesday"},"Wed"),n.a.createElement(b,{errorId:"error_01",id:"thursday"},"Thu"),n.a.createElement(b,{errorId:"error_01",id:"friday"},"Fri")),n.a.createElement("div",{id:"error_01",className:"slds-form-element__help"},"This field is required"))},{id:"disabled",label:"Disabled",element:n.a.createElement(u,null,n.a.createElement(m,null,n.a.createElement(b,{id:"monday",disabled:!0},"Mon"),n.a.createElement(b,{id:"tuesday",disabled:!0},"Tue"),n.a.createElement(b,{id:"wednesday",disabled:!0},"Wed"),n.a.createElement(b,{id:"thursday",disabled:!0},"Thu"),n.a.createElement(b,{id:"friday",disabled:!0},"Fri")))}],h=l.c.a,E=l.c.code,y=l.c.h2,_=l.c.h3,O=l.c.p,x=function(){return Object(a.createElement)(l.b,{},Object(a.createElement)("div",{className:"doc lead"},"A styled checkable input group that communicates if an option(s) are true, false or indeterminate"),Object(a.createElement)(c.a,{exampleOnly:!0},Object(o.f)(f)),y({id:"About-Checkbox-Button-Group"},"About Checkbox Button Group"),O({},"The checkbox-button-group is a set of ",h({href:"/components/checkbox-button"},"checkbox buttons")," wrapped in a fieldset that is also a ",h({href:"/components/form-element"},"form element"),". It is described by a legend with the classes ",E({},"slds-form-element__legend")," and ",E({},"slds-form-element__label")," applied to it."),_({id:"Mobile"},"Mobile"),Object(a.createElement)(s.a,{patternSpecificText:"buttons in the checkbox button group will have an increased size to accommodate tapping with a finger instead of the more precise mouse cursor, as well as become stacked"}),Object(a.createElement)(c.a,{frameOnly:!0,frameTitle:"Example mobile styles for checkbox button groups"},Object(o.f)(f)),y({id:"Base"},"Base"),Object(a.createElement)(c.a,null,Object(o.f)(f)),y({id:"States"},"States"),_({id:"Has-Error"},"Has Error"),Object(a.createElement)(c.a,null,Object(o.f)(p,"has-error")),_({id:"Disabled"},"Disabled"),Object(a.createElement)(c.a,null,Object(o.f)(p,"disabled")))},g=function(){return Object(l.a)(x())}}});