@fpkit/acss 3.8.0 → 3.9.0
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.
- package/libs/components/form/checkbox.css +1 -0
- package/libs/components/form/checkbox.css.map +1 -0
- package/libs/components/form/checkbox.min.css +3 -0
- package/libs/components/form/form.css +1 -1
- package/libs/components/form/form.css.map +1 -1
- package/libs/components/form/form.min.css +2 -2
- package/libs/index.cjs +25 -25
- package/libs/index.cjs.map +1 -1
- package/libs/index.css +1 -1
- package/libs/index.css.map +1 -1
- package/libs/index.d.cts +142 -292
- package/libs/index.d.ts +142 -292
- package/libs/index.js +6 -5
- package/libs/index.js.map +1 -1
- package/package.json +2 -2
- package/src/components/form/checkbox.scss +129 -0
- package/src/components/form/checkbox.tsx +302 -0
- package/src/components/form/form.scss +59 -20
- package/src/components/form/form.types.ts +6 -0
- package/src/components/form/input.stories.tsx +258 -1
- package/src/index.scss +1 -1
- package/src/index.ts +13 -8
- package/src/styles/form/checkbox.css +97 -0
- package/src/styles/form/checkbox.css.map +1 -0
- package/src/styles/form/form.css +138 -22
- package/src/styles/form/form.css.map +1 -1
- package/src/styles/index.css +138 -393
- package/src/styles/index.css.map +1 -1
- package/libs/components/checkbox/checkbox.css +0 -1
- package/libs/components/checkbox/checkbox.css.map +0 -1
- package/libs/components/checkbox/checkbox.min.css +0 -3
- package/src/components/checkbox/README.mdx +0 -263
- package/src/components/checkbox/STYLES.mdx +0 -434
- package/src/components/checkbox/checkbox.scss +0 -432
- package/src/components/checkbox/checkbox.stories.tsx +0 -607
- package/src/components/checkbox/checkbox.test.tsx +0 -535
- package/src/components/checkbox/checkbox.tsx +0 -575
- package/src/styles/checkbox/checkbox.css +0 -372
|
@@ -1 +0,0 @@
|
|
|
1
|
-
:root{--checkbox-size-sm: 1rem;--checkbox-size-md: 1.25rem;--checkbox-size-lg: 1.5rem;--checkbox-size: var(--checkbox-size-md);--checkbox-bg: #ffffff;--checkbox-border: 0.125rem solid #6b7280;--checkbox-border-color: #6b7280;--checkbox-radius: 0.25rem;--checkbox-cursor: pointer;--checkbox-transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);--checkbox-checkmark-color: #ffffff;--checkbox-checkmark-opacity: 0;--checkbox-checkmark-transform: scale(0.7);--checkbox-label-gap: 0.5rem;--checkbox-label-fs: 1rem;--checkbox-label-color: inherit;--checkbox-label-cursor: pointer;--checkbox-label-fw: 400;--checkbox-description-fs: 0.875rem;--checkbox-description-color: #6b7280;--checkbox-description-margin-block-start: 0.25rem;--checkbox-description-padding-inline-start: calc( var(--checkbox-size) + var(--checkbox-label-gap) );--checkbox-error-fs: 0.875rem;--checkbox-error-color: #dc2626;--checkbox-error-margin-block-start: 0.25rem;--checkbox-error-padding-inline-start: calc( var(--checkbox-size) + var(--checkbox-label-gap) );--checkbox-required-color: #dc2626;--checkbox-required-fw: 600;--checkbox-primary-checked-bg: #2563eb;--checkbox-primary-checked-border: #2563eb;--checkbox-primary-hover-border: #3b82f6;--checkbox-primary-focus-outline-color: #93c5fd;--checkbox-secondary-checked-bg: #4b5563;--checkbox-secondary-checked-border: #4b5563;--checkbox-secondary-hover-border: #6b7280;--checkbox-secondary-focus-outline-color: #9ca3af;--checkbox-error-checked-bg: #dc2626;--checkbox-error-checked-border: #dc2626;--checkbox-error-hover-border: #ef4444;--checkbox-error-focus-outline-color: #fca5a5;--checkbox-success-checked-bg: #16a34a;--checkbox-success-checked-border: #16a34a;--checkbox-success-hover-border: #22c55e;--checkbox-success-focus-outline-color: #86efac;--checkbox-hover-border-color: #9ca3af;--checkbox-hover-bg: #f9fafb;--checkbox-focus-outline: 0.125rem solid;--checkbox-focus-outline-offset: 0.125rem;--checkbox-focus-outline-color: var(--checkbox-primary-focus-outline-color);--checkbox-checked-bg: var(--checkbox-primary-checked-bg);--checkbox-checked-border: var(--checkbox-primary-checked-border);--checkbox-checked-checkmark-opacity: 1;--checkbox-checked-checkmark-transform: scale(1);--checkbox-indeterminate-bg: var(--checkbox-primary-checked-bg);--checkbox-indeterminate-border: var(--checkbox-primary-checked-border);--checkbox-indeterminate-dash-width: 0.625rem;--checkbox-indeterminate-dash-height: 0.125rem;--checkbox-indeterminate-dash-opacity: 1;--checkbox-disabled-bg: #f3f4f6;--checkbox-disabled-border-color: #d1d5db;--checkbox-disabled-opacity: 0.6;--checkbox-disabled-cursor: not-allowed;--checkbox-invalid-border-color: #dc2626;--checkbox-invalid-focus-outline-color: #fca5a5}[data-checkbox]{display:inline-flex;flex-direction:column;gap:var(--checkbox-label-gap)}[data-checkbox][data-checkbox~=sm]{--checkbox-size: var(--checkbox-size-sm);--checkbox-label-fs: 0.875rem}[data-checkbox][data-checkbox~=md]{--checkbox-size: var(--checkbox-size-md);--checkbox-label-fs: 1rem}[data-checkbox][data-checkbox~=lg]{--checkbox-size: var(--checkbox-size-lg);--checkbox-label-fs: 1.125rem}[data-checkbox][data-checkbox~=primary]{--checkbox-checked-bg: var(--checkbox-primary-checked-bg);--checkbox-checked-border: var(--checkbox-primary-checked-border);--checkbox-hover-border-color: var(--checkbox-primary-hover-border);--checkbox-focus-outline-color: var(--checkbox-primary-focus-outline-color);--checkbox-indeterminate-bg: var(--checkbox-primary-checked-bg);--checkbox-indeterminate-border: var(--checkbox-primary-checked-border)}[data-checkbox][data-checkbox~=secondary]{--checkbox-checked-bg: var(--checkbox-secondary-checked-bg);--checkbox-checked-border: var(--checkbox-secondary-checked-border);--checkbox-hover-border-color: var(--checkbox-secondary-hover-border);--checkbox-focus-outline-color: var( --checkbox-secondary-focus-outline-color );--checkbox-indeterminate-bg: var(--checkbox-secondary-checked-bg);--checkbox-indeterminate-border: var(--checkbox-secondary-checked-border)}[data-checkbox][data-checkbox~=error]{--checkbox-checked-bg: var(--checkbox-error-checked-bg);--checkbox-checked-border: var(--checkbox-error-checked-border);--checkbox-hover-border-color: var(--checkbox-error-hover-border);--checkbox-focus-outline-color: var(--checkbox-error-focus-outline-color);--checkbox-indeterminate-bg: var(--checkbox-error-checked-bg);--checkbox-indeterminate-border: var(--checkbox-error-checked-border)}[data-checkbox][data-checkbox~=success]{--checkbox-checked-bg: var(--checkbox-success-checked-bg);--checkbox-checked-border: var(--checkbox-success-checked-border);--checkbox-hover-border-color: var(--checkbox-success-hover-border);--checkbox-focus-outline-color: var( --checkbox-success-focus-outline-color );--checkbox-indeterminate-bg: var(--checkbox-success-checked-bg);--checkbox-indeterminate-border: var(--checkbox-success-checked-border)}.checkbox-container{display:inline-flex;align-items:flex-start;gap:var(--checkbox-label-gap);cursor:var(--checkbox-cursor)}.checkbox-input-wrapper{position:relative;display:inline-flex;align-items:center;justify-content:center;flex-shrink:0}.checkbox-input{position:absolute;opacity:0;width:var(--checkbox-size);height:var(--checkbox-size);margin:0;cursor:var(--checkbox-cursor);z-index:1}.checkbox-input:focus-visible+.checkbox-indicator{outline:var(--checkbox-focus-outline);outline-color:var(--checkbox-focus-outline-color);outline-offset:var(--checkbox-focus-outline-offset)}.checkbox-input:hover:not(:disabled):not([aria-disabled=true])+.checkbox-indicator{background-color:var(--checkbox-hover-bg);border-color:var(--checkbox-hover-border-color)}.checkbox-input:checked+.checkbox-indicator{background-color:var(--checkbox-checked-bg);border-color:var(--checkbox-checked-border)}.checkbox-input:checked+.checkbox-indicator .checkbox-checkmark{opacity:var(--checkbox-checked-checkmark-opacity);transform:var(--checkbox-checked-checkmark-transform)}.checkbox-input:checked+.checkbox-indicator .checkbox-indeterminate-dash{opacity:0}.checkbox-input:indeterminate+.checkbox-indicator{background-color:var(--checkbox-indeterminate-bg);border-color:var(--checkbox-indeterminate-border)}.checkbox-input:indeterminate+.checkbox-indicator .checkbox-checkmark{opacity:0}.checkbox-input:indeterminate+.checkbox-indicator .checkbox-indeterminate-dash{opacity:var(--checkbox-indeterminate-dash-opacity)}.checkbox-input:disabled,.checkbox-input[aria-disabled=true]{cursor:var(--checkbox-disabled-cursor)}.checkbox-input:disabled+.checkbox-indicator,.checkbox-input[aria-disabled=true]+.checkbox-indicator{background-color:var(--checkbox-disabled-bg);border-color:var(--checkbox-disabled-border-color);opacity:var(--checkbox-disabled-opacity);cursor:var(--checkbox-disabled-cursor)}.checkbox-input[aria-invalid=true]:not(:checked):not(:indeterminate)+.checkbox-indicator{border-color:var(--checkbox-invalid-border-color)}.checkbox-input[aria-invalid=true]:focus-visible+.checkbox-indicator{outline-color:var(--checkbox-invalid-focus-outline-color)}.checkbox-indicator{position:relative;display:inline-flex;align-items:center;justify-content:center;width:var(--checkbox-size);height:var(--checkbox-size);min-width:var(--checkbox-size);min-height:var(--checkbox-size);background-color:var(--checkbox-bg);border:var(--checkbox-border);border-radius:var(--checkbox-radius);transition:var(--checkbox-transition);pointer-events:none}.checkbox-checkmark{width:75%;height:75%;color:var(--checkbox-checkmark-color);opacity:var(--checkbox-checkmark-opacity);transform:var(--checkbox-checkmark-transform);transition:var(--checkbox-transition);pointer-events:none}.checkbox-indeterminate-dash{position:absolute;width:var(--checkbox-indeterminate-dash-width);height:var(--checkbox-indeterminate-dash-height);background-color:var(--checkbox-checkmark-color);border-radius:calc(var(--checkbox-indeterminate-dash-height)/2);opacity:0;transition:var(--checkbox-transition);pointer-events:none}.checkbox-label{display:inline-flex;align-items:flex-start;font-size:var(--checkbox-label-fs);font-weight:var(--checkbox-label-fw);color:var(--checkbox-label-color);cursor:var(--checkbox-label-cursor);user-select:none;line-height:1.5;padding-block-start:calc((var(--checkbox-size) - var(--checkbox-label-fs)*1.5)/2)}.checkbox-required{color:var(--checkbox-required-color);font-weight:var(--checkbox-required-fw)}.checkbox-description{font-size:var(--checkbox-description-fs);color:var(--checkbox-description-color);margin-block-start:var(--checkbox-description-margin-block-start);padding-inline-start:var(--checkbox-description-padding-inline-start);line-height:1.5}.checkbox-error{font-size:var(--checkbox-error-fs);color:var(--checkbox-error-color);margin-block-start:var(--checkbox-error-margin-block-start);padding-inline-start:var(--checkbox-error-padding-inline-start);line-height:1.5}[data-checkbox].is-disabled .checkbox-label{cursor:var(--checkbox-disabled-cursor);opacity:var(--checkbox-disabled-opacity)}[data-checkbox].is-disabled .checkbox-container{cursor:var(--checkbox-disabled-cursor)}[data-checkbox].is-disabled .checkbox-description,[data-checkbox].is-disabled .checkbox-error{opacity:var(--checkbox-disabled-opacity)}/*# sourceMappingURL=checkbox.css.map */
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sourceRoot":"","sources":["../../../src/components/checkbox/checkbox.scss"],"names":[],"mappings":"AAeA,MAKE,yBACA,4BACA,2BAMA,yCACA,uBACA,0CACA,iCACA,2BACA,2BACA,6DAMA,oCACA,gCACA,2CAMA,6BACA,0BACA,gCACA,iCACA,yBAMA,oCACA,sCACA,mDACA,sGAQA,8BACA,gCACA,6CACA,gGAQA,mCACA,4BAOA,uCACA,2CACA,yCACA,gDAGA,yCACA,6CACA,2CACA,kDAGA,qCACA,yCACA,uCACA,8CAGA,uCACA,2CACA,yCACA,gDAOA,uCACA,6BAGA,yCACA,0CACA,4EAGA,0DACA,kEACA,wCACA,iDAGA,gEACA,wEACA,8CACA,+CACA,yCAGA,gCACA,0CACA,iCACA,wCAGA,yCACA,gDAOF,gBACE,oBACA,sBACA,8BAGA,mCACE,yCACA,8BAGF,mCACE,yCACA,0BAGF,mCACE,yCACA,8BAIF,wCACE,0DACA,kEACA,oEACA,4EACA,gEACA,wEAGF,0CACE,4DACA,oEACA,sEACA,gFAGA,kEACA,0EAGF,sCACE,wDACA,gEACA,kEACA,0EACA,8DACA,sEAGF,wCACE,0DACA,kEACA,oEACA,8EAGA,gEACA,wEAQJ,oBACE,oBACA,uBACA,8BACA,8BAOF,wBACE,kBACA,oBACA,mBACA,uBACA,cAOF,gBACE,kBACA,UACA,2BACA,4BACA,SACA,8BACA,UAGA,kDACE,sCACA,kDACA,oDAIF,mFACE,0CACA,gDAIF,4CACE,4CACA,4CAEA,gEACE,kDACA,sDAGF,yEACE,UAKJ,kDACE,kDACA,kDAEA,sEACE,UAGF,+EACE,mDAKJ,6DAEE,uCAEA,qGACE,6CACA,mDACA,yCACA,uCAKJ,yFACE,kDAGF,qEACE,0DAQJ,oBACE,kBACA,oBACA,mBACA,uBACA,2BACA,4BACA,+BACA,gCACA,oCACA,8BACA,qCACA,sCACA,oBAOF,oBACE,UACA,WACA,sCACA,0CACA,8CACA,sCACA,oBAOF,6BACE,kBACA,+CACA,iDACA,iDACA,gEACA,UACA,sCACA,oBAOF,gBACE,oBACA,uBACA,mCACA,qCACA,kCACA,oCACA,iBACA,gBAGA,kFAIF,mBACE,qCACA,wCAOF,sBACE,yCACA,wCACA,kEACA,sEACA,gBAOF,gBACE,mCACA,kCACA,4DACA,gEACA,gBAQA,4CACE,uCACA,yCAGF,gDACE,uCAGF,8FAEE","file":"checkbox.css"}
|
|
@@ -1,3 +0,0 @@
|
|
|
1
|
-
:root{--checkbox-size-sm: 1rem;--checkbox-size-md: 1.25rem;--checkbox-size-lg: 1.5rem;--checkbox-size: var(--checkbox-size-md);--checkbox-bg: #ffffff;--checkbox-border: 0.125rem solid #6b7280;--checkbox-border-color: #6b7280;--checkbox-radius: 0.25rem;--checkbox-cursor: pointer;--checkbox-transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);--checkbox-checkmark-color: #ffffff;--checkbox-checkmark-opacity: 0;--checkbox-checkmark-transform: scale(0.7);--checkbox-label-gap: 0.5rem;--checkbox-label-fs: 1rem;--checkbox-label-color: inherit;--checkbox-label-cursor: pointer;--checkbox-label-fw: 400;--checkbox-description-fs: 0.875rem;--checkbox-description-color: #6b7280;--checkbox-description-margin-block-start: 0.25rem;--checkbox-description-padding-inline-start: calc( var(--checkbox-size) + var(--checkbox-label-gap) );--checkbox-error-fs: 0.875rem;--checkbox-error-color: #dc2626;--checkbox-error-margin-block-start: 0.25rem;--checkbox-error-padding-inline-start: calc( var(--checkbox-size) + var(--checkbox-label-gap) );--checkbox-required-color: #dc2626;--checkbox-required-fw: 600;--checkbox-primary-checked-bg: #2563eb;--checkbox-primary-checked-border: #2563eb;--checkbox-primary-hover-border: #3b82f6;--checkbox-primary-focus-outline-color: #93c5fd;--checkbox-secondary-checked-bg: #4b5563;--checkbox-secondary-checked-border: #4b5563;--checkbox-secondary-hover-border: #6b7280;--checkbox-secondary-focus-outline-color: #9ca3af;--checkbox-error-checked-bg: #dc2626;--checkbox-error-checked-border: #dc2626;--checkbox-error-hover-border: #ef4444;--checkbox-error-focus-outline-color: #fca5a5;--checkbox-success-checked-bg: #16a34a;--checkbox-success-checked-border: #16a34a;--checkbox-success-hover-border: #22c55e;--checkbox-success-focus-outline-color: #86efac;--checkbox-hover-border-color: #9ca3af;--checkbox-hover-bg: #f9fafb;--checkbox-focus-outline: 0.125rem solid;--checkbox-focus-outline-offset: 0.125rem;--checkbox-focus-outline-color: var(--checkbox-primary-focus-outline-color);--checkbox-checked-bg: var(--checkbox-primary-checked-bg);--checkbox-checked-border: var(--checkbox-primary-checked-border);--checkbox-checked-checkmark-opacity: 1;--checkbox-checked-checkmark-transform: scale(1);--checkbox-indeterminate-bg: var(--checkbox-primary-checked-bg);--checkbox-indeterminate-border: var(--checkbox-primary-checked-border);--checkbox-indeterminate-dash-width: 0.625rem;--checkbox-indeterminate-dash-height: 0.125rem;--checkbox-indeterminate-dash-opacity: 1;--checkbox-disabled-bg: #f3f4f6;--checkbox-disabled-border-color: #d1d5db;--checkbox-disabled-opacity: 0.6;--checkbox-disabled-cursor: not-allowed;--checkbox-invalid-border-color: #dc2626;--checkbox-invalid-focus-outline-color: #fca5a5}[data-checkbox]{display:inline-flex;flex-direction:column;gap:var(--checkbox-label-gap)}[data-checkbox][data-checkbox~=sm]{--checkbox-size: var(--checkbox-size-sm);--checkbox-label-fs: 0.875rem}[data-checkbox][data-checkbox~=md]{--checkbox-size: var(--checkbox-size-md);--checkbox-label-fs: 1rem}[data-checkbox][data-checkbox~=lg]{--checkbox-size: var(--checkbox-size-lg);--checkbox-label-fs: 1.125rem}[data-checkbox][data-checkbox~=primary]{--checkbox-checked-bg: var(--checkbox-primary-checked-bg);--checkbox-checked-border: var(--checkbox-primary-checked-border);--checkbox-hover-border-color: var(--checkbox-primary-hover-border);--checkbox-focus-outline-color: var(--checkbox-primary-focus-outline-color);--checkbox-indeterminate-bg: var(--checkbox-primary-checked-bg);--checkbox-indeterminate-border: var(--checkbox-primary-checked-border)}[data-checkbox][data-checkbox~=secondary]{--checkbox-checked-bg: var(--checkbox-secondary-checked-bg);--checkbox-checked-border: var(--checkbox-secondary-checked-border);--checkbox-hover-border-color: var(--checkbox-secondary-hover-border);--checkbox-focus-outline-color: var( --checkbox-secondary-focus-outline-color );--checkbox-indeterminate-bg: var(--checkbox-secondary-checked-bg);--checkbox-indeterminate-border: var(--checkbox-secondary-checked-border)}[data-checkbox][data-checkbox~=error]{--checkbox-checked-bg: var(--checkbox-error-checked-bg);--checkbox-checked-border: var(--checkbox-error-checked-border);--checkbox-hover-border-color: var(--checkbox-error-hover-border);--checkbox-focus-outline-color: var(--checkbox-error-focus-outline-color);--checkbox-indeterminate-bg: var(--checkbox-error-checked-bg);--checkbox-indeterminate-border: var(--checkbox-error-checked-border)}[data-checkbox][data-checkbox~=success]{--checkbox-checked-bg: var(--checkbox-success-checked-bg);--checkbox-checked-border: var(--checkbox-success-checked-border);--checkbox-hover-border-color: var(--checkbox-success-hover-border);--checkbox-focus-outline-color: var( --checkbox-success-focus-outline-color );--checkbox-indeterminate-bg: var(--checkbox-success-checked-bg);--checkbox-indeterminate-border: var(--checkbox-success-checked-border)}.checkbox-container{display:inline-flex;align-items:flex-start;gap:var(--checkbox-label-gap);cursor:var(--checkbox-cursor)}.checkbox-input-wrapper{position:relative;display:inline-flex;align-items:center;justify-content:center;flex-shrink:0}.checkbox-input{position:absolute;opacity:0;width:var(--checkbox-size);height:var(--checkbox-size);margin:0;cursor:var(--checkbox-cursor);z-index:1}.checkbox-input:focus-visible+.checkbox-indicator{outline:var(--checkbox-focus-outline);outline-color:var(--checkbox-focus-outline-color);outline-offset:var(--checkbox-focus-outline-offset)}.checkbox-input:hover:not(:disabled):not([aria-disabled=true])+.checkbox-indicator{background-color:var(--checkbox-hover-bg);border-color:var(--checkbox-hover-border-color)}.checkbox-input:checked+.checkbox-indicator{background-color:var(--checkbox-checked-bg);border-color:var(--checkbox-checked-border)}.checkbox-input:checked+.checkbox-indicator .checkbox-checkmark{opacity:var(--checkbox-checked-checkmark-opacity);transform:var(--checkbox-checked-checkmark-transform)}.checkbox-input:checked+.checkbox-indicator .checkbox-indeterminate-dash{opacity:0}.checkbox-input:indeterminate+.checkbox-indicator{background-color:var(--checkbox-indeterminate-bg);border-color:var(--checkbox-indeterminate-border)}.checkbox-input:indeterminate+.checkbox-indicator .checkbox-checkmark{opacity:0}.checkbox-input:indeterminate+.checkbox-indicator .checkbox-indeterminate-dash{opacity:var(--checkbox-indeterminate-dash-opacity)}.checkbox-input:disabled,.checkbox-input[aria-disabled=true]{cursor:var(--checkbox-disabled-cursor)}.checkbox-input:disabled+.checkbox-indicator,.checkbox-input[aria-disabled=true]+.checkbox-indicator{background-color:var(--checkbox-disabled-bg);border-color:var(--checkbox-disabled-border-color);opacity:var(--checkbox-disabled-opacity);cursor:var(--checkbox-disabled-cursor)}.checkbox-input[aria-invalid=true]:not(:checked):not(:indeterminate)+.checkbox-indicator{border-color:var(--checkbox-invalid-border-color)}.checkbox-input[aria-invalid=true]:focus-visible+.checkbox-indicator{outline-color:var(--checkbox-invalid-focus-outline-color)}.checkbox-indicator{position:relative;display:inline-flex;align-items:center;justify-content:center;width:var(--checkbox-size);height:var(--checkbox-size);min-width:var(--checkbox-size);min-height:var(--checkbox-size);background-color:var(--checkbox-bg);border:var(--checkbox-border);border-radius:var(--checkbox-radius);transition:var(--checkbox-transition);pointer-events:none}.checkbox-checkmark{width:75%;height:75%;color:var(--checkbox-checkmark-color);opacity:var(--checkbox-checkmark-opacity);transform:var(--checkbox-checkmark-transform);transition:var(--checkbox-transition);pointer-events:none}.checkbox-indeterminate-dash{position:absolute;width:var(--checkbox-indeterminate-dash-width);height:var(--checkbox-indeterminate-dash-height);background-color:var(--checkbox-checkmark-color);border-radius:calc(var(--checkbox-indeterminate-dash-height)/2);opacity:0;transition:var(--checkbox-transition);pointer-events:none}.checkbox-label{display:inline-flex;align-items:flex-start;font-size:var(--checkbox-label-fs);font-weight:var(--checkbox-label-fw);color:var(--checkbox-label-color);cursor:var(--checkbox-label-cursor);-webkit-user-select:none;-moz-user-select:none;user-select:none;line-height:1.5;padding-block-start:calc((var(--checkbox-size) - var(--checkbox-label-fs)*1.5)/2)}.checkbox-required{color:var(--checkbox-required-color);font-weight:var(--checkbox-required-fw)}.checkbox-description{font-size:var(--checkbox-description-fs);color:var(--checkbox-description-color);margin-block-start:var(--checkbox-description-margin-block-start);padding-inline-start:var(--checkbox-description-padding-inline-start);line-height:1.5}.checkbox-error{font-size:var(--checkbox-error-fs);color:var(--checkbox-error-color);margin-block-start:var(--checkbox-error-margin-block-start);padding-inline-start:var(--checkbox-error-padding-inline-start);line-height:1.5}[data-checkbox].is-disabled .checkbox-label{cursor:var(--checkbox-disabled-cursor);opacity:var(--checkbox-disabled-opacity)}[data-checkbox].is-disabled .checkbox-container{cursor:var(--checkbox-disabled-cursor)}[data-checkbox].is-disabled .checkbox-description,[data-checkbox].is-disabled .checkbox-error{opacity:var(--checkbox-disabled-opacity)}
|
|
2
|
-
|
|
3
|
-
/*# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jb21wb25lbnRzL2NoZWNrYm94L2NoZWNrYm94LnNjc3MiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBZUEsTUFLRSx3QkFBQSxDQUNBLDJCQUFBLENBQ0EsMEJBQUEsQ0FNQSx3Q0FBQSxDQUNBLHNCQUFBLENBQ0EseUNBQUEsQ0FDQSxnQ0FBQSxDQUNBLDBCQUFBLENBQ0EsMEJBQUEsQ0FDQSw0REFBQSxDQU1BLG1DQUFBLENBQ0EsK0JBQUEsQ0FDQSwwQ0FBQSxDQU1BLDRCQUFBLENBQ0EseUJBQUEsQ0FDQSwrQkFBQSxDQUNBLGdDQUFBLENBQ0Esd0JBQUEsQ0FNQSxtQ0FBQSxDQUNBLHFDQUFBLENBQ0Esa0RBQUEsQ0FDQSxxR0FBQSxDQVFBLDZCQUFBLENBQ0EsK0JBQUEsQ0FDQSw0Q0FBQSxDQUNBLCtGQUFBLENBUUEsa0NBQUEsQ0FDQSwyQkFBQSxDQU9BLHNDQUFBLENBQ0EsMENBQUEsQ0FDQSx3Q0FBQSxDQUNBLCtDQUFBLENBR0Esd0NBQUEsQ0FDQSw0Q0FBQSxDQUNBLDBDQUFBLENBQ0EsaURBQUEsQ0FHQSxvQ0FBQSxDQUNBLHdDQUFBLENBQ0Esc0NBQUEsQ0FDQSw2Q0FBQSxDQUdBLHNDQUFBLENBQ0EsMENBQUEsQ0FDQSx3Q0FBQSxDQUNBLCtDQUFBLENBT0Esc0NBQUEsQ0FDQSw0QkFBQSxDQUdBLHdDQUFBLENBQ0EseUNBQUEsQ0FDQSwyRUFBQSxDQUdBLHlEQUFBLENBQ0EsaUVBQUEsQ0FDQSx1Q0FBQSxDQUNBLGdEQUFBLENBR0EsK0RBQUEsQ0FDQSx1RUFBQSxDQUNBLDZDQUFBLENBQ0EsOENBQUEsQ0FDQSx3Q0FBQSxDQUdBLCtCQUFBLENBQ0EseUNBQUEsQ0FDQSxnQ0FBQSxDQUNBLHVDQUFBLENBR0Esd0NBQUEsQ0FDQSwrQ0FBQSxDQU9GLGdCQUNFLG1CQUFBLENBQ0EscUJBQUEsQ0FDQSw2QkFBQSxDQUdBLG1DQUNFLHdDQUFBLENBQ0EsNkJBQUEsQ0FHRixtQ0FDRSx3Q0FBQSxDQUNBLHlCQUFBLENBR0YsbUNBQ0Usd0NBQUEsQ0FDQSw2QkFBQSxDQUlGLHdDQUNFLHlEQUFBLENBQ0EsaUVBQUEsQ0FDQSxtRUFBQSxDQUNBLDJFQUFBLENBQ0EsK0RBQUEsQ0FDQSx1RUFBQSxDQUdGLDBDQUNFLDJEQUFBLENBQ0EsbUVBQUEsQ0FDQSxxRUFBQSxDQUNBLCtFQUFBLENBR0EsaUVBQUEsQ0FDQSx5RUFBQSxDQUdGLHNDQUNFLHVEQUFBLENBQ0EsK0RBQUEsQ0FDQSxpRUFBQSxDQUNBLHlFQUFBLENBQ0EsNkRBQUEsQ0FDQSxxRUFBQSxDQUdGLHdDQUNFLHlEQUFBLENBQ0EsaUVBQUEsQ0FDQSxtRUFBQSxDQUNBLDZFQUFBLENBR0EsK0RBQUEsQ0FDQSx1RUFBQSxDQVFKLG9CQUNFLG1CQUFBLENBQ0Esc0JBQUEsQ0FDQSw2QkFBQSxDQUNBLDZCQUFBLENBT0Ysd0JBQ0UsaUJBQUEsQ0FDQSxtQkFBQSxDQUNBLGtCQUFBLENBQ0Esc0JBQUEsQ0FDQSxhQUFBLENBT0YsZ0JBQ0UsaUJBQUEsQ0FDQSxTQUFBLENBQ0EsMEJBQUEsQ0FDQSwyQkFBQSxDQUNBLFFBQUEsQ0FDQSw2QkFBQSxDQUNBLFNBQUEsQ0FHQSxrREFDRSxxQ0FBQSxDQUNBLGlEQUFBLENBQ0EsbURBQUEsQ0FJRixtRkFDRSx5Q0FBQSxDQUNBLCtDQUFBLENBSUYsNENBQ0UsMkNBQUEsQ0FDQSwyQ0FBQSxDQUVBLGdFQUNFLGlEQUFBLENBQ0EscURBQUEsQ0FHRix5RUFDRSxTQUFBLENBS0osa0RBQ0UsaURBQUEsQ0FDQSxpREFBQSxDQUVBLHNFQUNFLFNBQUEsQ0FHRiwrRUFDRSxrREFBQSxDQUtKLDZEQUVFLHNDQUFBLENBRUEscUdBQ0UsNENBQUEsQ0FDQSxrREFBQSxDQUNBLHdDQUFBLENBQ0Esc0NBQUEsQ0FLSix5RkFDRSxpREFBQSxDQUdGLHFFQUNFLHlEQUFBLENBUUosb0JBQ0UsaUJBQUEsQ0FDQSxtQkFBQSxDQUNBLGtCQUFBLENBQ0Esc0JBQUEsQ0FDQSwwQkFBQSxDQUNBLDJCQUFBLENBQ0EsOEJBQUEsQ0FDQSwrQkFBQSxDQUNBLG1DQUFBLENBQ0EsNkJBQUEsQ0FDQSxvQ0FBQSxDQUNBLHFDQUFBLENBQ0EsbUJBQUEsQ0FPRixvQkFDRSxTQUFBLENBQ0EsVUFBQSxDQUNBLHFDQUFBLENBQ0EseUNBQUEsQ0FDQSw2Q0FBQSxDQUNBLHFDQUFBLENBQ0EsbUJBQUEsQ0FPRiw2QkFDRSxpQkFBQSxDQUNBLDhDQUFBLENBQ0EsZ0RBQUEsQ0FDQSxnREFBQSxDQUNBLCtEQUFBLENBQ0EsU0FBQSxDQUNBLHFDQUFBLENBQ0EsbUJBQUEsQ0FPRixnQkFDRSxtQkFBQSxDQUNBLHNCQUFBLENBQ0Esa0NBQUEsQ0FDQSxvQ0FBQSxDQUNBLGlDQUFBLENBQ0EsbUNBQUEsQ0FDQSx3QkFBQSxDQUFBLHFCQUFBLENBQUEsZ0JBQUEsQ0FDQSxlQUFBLENBR0EsaUZBQUEsQ0FJRixtQkFDRSxvQ0FBQSxDQUNBLHVDQUFBLENBT0Ysc0JBQ0Usd0NBQUEsQ0FDQSx1Q0FBQSxDQUNBLGlFQUFBLENBQ0EscUVBQUEsQ0FDQSxlQUFBLENBT0YsZ0JBQ0Usa0NBQUEsQ0FDQSxpQ0FBQSxDQUNBLDJEQUFBLENBQ0EsK0RBQUEsQ0FDQSxlQUFBLENBUUEsNENBQ0Usc0NBQUEsQ0FDQSx3Q0FBQSxDQUdGLGdEQUNFLHNDQUFBLENBR0YsOEZBRUUsd0NBQUEiLCJmaWxlIjoiY2hlY2tib3gubWluLmNzcyJ9 */
|
|
@@ -1,263 +0,0 @@
|
|
|
1
|
-
import { Meta } from "@storybook/addon-docs/blocks";
|
|
2
|
-
import * as CheckboxStories from "./checkbox.stories";
|
|
3
|
-
|
|
4
|
-
<Meta of={CheckboxStories} />
|
|
5
|
-
|
|
6
|
-
# Checkbox
|
|
7
|
-
|
|
8
|
-
Accessible checkbox component with size and color variants, validation support,
|
|
9
|
-
and comprehensive ARIA attributes.
|
|
10
|
-
|
|
11
|
-
## Features
|
|
12
|
-
|
|
13
|
-
- ✅ **WCAG 2.1 AA Compliant** - Meets accessibility standards
|
|
14
|
-
- ✅ **Controlled & Uncontrolled** - Flexible state management
|
|
15
|
-
- ✅ **Indeterminate State** - Three-state checkbox support
|
|
16
|
-
- ✅ **Validation** - Built-in error messaging
|
|
17
|
-
- ✅ **Size Variants** - sm, md, lg
|
|
18
|
-
- ✅ **Color Variants** - primary, secondary, error, success
|
|
19
|
-
- ✅ **Keyboard Navigation** - Full keyboard support
|
|
20
|
-
- ✅ **Custom Styling** - CSS custom properties
|
|
21
|
-
|
|
22
|
-
## Basic Usage
|
|
23
|
-
|
|
24
|
-
```tsx
|
|
25
|
-
import { Checkbox } from "@fpkit/acss";
|
|
26
|
-
|
|
27
|
-
function MyForm() {
|
|
28
|
-
return <Checkbox id="terms" label="I accept the terms and conditions" />;
|
|
29
|
-
}
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
## Controlled Mode
|
|
33
|
-
|
|
34
|
-
Use controlled mode when you need to manage checkbox state in your component:
|
|
35
|
-
|
|
36
|
-
```tsx
|
|
37
|
-
import { useState } from "react";
|
|
38
|
-
import { Checkbox } from "@fpkit/acss";
|
|
39
|
-
|
|
40
|
-
function ControlledExample() {
|
|
41
|
-
const [checked, setChecked] = useState(false);
|
|
42
|
-
|
|
43
|
-
return (
|
|
44
|
-
<Checkbox
|
|
45
|
-
id="newsletter"
|
|
46
|
-
label="Subscribe to newsletter"
|
|
47
|
-
checked={checked}
|
|
48
|
-
onChange={(e) => setChecked(e.target.checked)}
|
|
49
|
-
/>
|
|
50
|
-
);
|
|
51
|
-
}
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
## Uncontrolled Mode
|
|
55
|
-
|
|
56
|
-
Use uncontrolled mode for simple forms where you read the value on submission:
|
|
57
|
-
|
|
58
|
-
```tsx
|
|
59
|
-
import { Checkbox } from "@fpkit/acss";
|
|
60
|
-
|
|
61
|
-
function UncontrolledExample() {
|
|
62
|
-
const handleSubmit = (e) => {
|
|
63
|
-
const formData = new FormData(e.target);
|
|
64
|
-
console.log(formData.get("agree")); // "on" if checked
|
|
65
|
-
};
|
|
66
|
-
|
|
67
|
-
return (
|
|
68
|
-
<form onSubmit={handleSubmit}>
|
|
69
|
-
<Checkbox id="agree" name="agree" label="I agree" defaultChecked={true} />
|
|
70
|
-
<button type="submit">Submit</button>
|
|
71
|
-
</form>
|
|
72
|
-
);
|
|
73
|
-
}
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
## With Validation
|
|
77
|
-
|
|
78
|
-
Display validation errors and helper text:
|
|
79
|
-
|
|
80
|
-
```tsx
|
|
81
|
-
<Checkbox
|
|
82
|
-
id="required"
|
|
83
|
-
label="Required checkbox"
|
|
84
|
-
required
|
|
85
|
-
validationState="invalid"
|
|
86
|
-
errorMessage="This field is required"
|
|
87
|
-
description="You must check this box to continue"
|
|
88
|
-
/>
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
## Indeterminate State
|
|
92
|
-
|
|
93
|
-
Use for "select all" patterns where some but not all items are selected:
|
|
94
|
-
|
|
95
|
-
```tsx
|
|
96
|
-
import { useState } from "react";
|
|
97
|
-
import { Checkbox } from "@fpkit/acss";
|
|
98
|
-
|
|
99
|
-
function SelectAllExample() {
|
|
100
|
-
const [selectedItems, setSelectedItems] = useState([]);
|
|
101
|
-
const totalItems = 4;
|
|
102
|
-
|
|
103
|
-
const allSelected = selectedItems.length === totalItems;
|
|
104
|
-
const someSelected = selectedItems.length > 0 && !allSelected;
|
|
105
|
-
|
|
106
|
-
return (
|
|
107
|
-
<Checkbox
|
|
108
|
-
id="select-all"
|
|
109
|
-
label="Select all"
|
|
110
|
-
checked={allSelected}
|
|
111
|
-
indeterminate={someSelected}
|
|
112
|
-
onChange={(e) => {
|
|
113
|
-
if (e.target.checked) {
|
|
114
|
-
setSelectedItems([1, 2, 3, 4]);
|
|
115
|
-
} else {
|
|
116
|
-
setSelectedItems([]);
|
|
117
|
-
}
|
|
118
|
-
}}
|
|
119
|
-
/>
|
|
120
|
-
);
|
|
121
|
-
}
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
## Size Variants
|
|
125
|
-
|
|
126
|
-
Choose from three sizes:
|
|
127
|
-
|
|
128
|
-
```tsx
|
|
129
|
-
<Checkbox id="sm" label="Small" size="sm" />
|
|
130
|
-
<Checkbox id="md" label="Medium (default)" size="md" />
|
|
131
|
-
<Checkbox id="lg" label="Large" size="lg" />
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
## Color Variants
|
|
135
|
-
|
|
136
|
-
All colors meet WCAG 2.1 AA contrast requirements:
|
|
137
|
-
|
|
138
|
-
```tsx
|
|
139
|
-
<Checkbox id="primary" label="Primary (Blue)" color="primary" />
|
|
140
|
-
<Checkbox id="secondary" label="Secondary (Gray)" color="secondary" />
|
|
141
|
-
<Checkbox id="error" label="Error (Red)" color="error" />
|
|
142
|
-
<Checkbox id="success" label="Success (Green)" color="success" />
|
|
143
|
-
```
|
|
144
|
-
|
|
145
|
-
## Label Positioning
|
|
146
|
-
|
|
147
|
-
Position labels before or after the checkbox:
|
|
148
|
-
|
|
149
|
-
```tsx
|
|
150
|
-
<Checkbox id="left" label="Label on left" labelPosition="left" />
|
|
151
|
-
<Checkbox id="right" label="Label on right" labelPosition="right" />
|
|
152
|
-
```
|
|
153
|
-
|
|
154
|
-
## Custom Styling
|
|
155
|
-
|
|
156
|
-
Customize appearance using CSS custom properties:
|
|
157
|
-
|
|
158
|
-
```tsx
|
|
159
|
-
<Checkbox
|
|
160
|
-
id="custom"
|
|
161
|
-
label="Custom styled"
|
|
162
|
-
styles={{
|
|
163
|
-
"--checkbox-size": "2rem",
|
|
164
|
-
"--checkbox-checked-bg": "#7c3aed",
|
|
165
|
-
"--checkbox-radius": "0.5rem",
|
|
166
|
-
}}
|
|
167
|
-
/>
|
|
168
|
-
```
|
|
169
|
-
|
|
170
|
-
See [STYLES.mdx](./STYLES.mdx) for complete CSS variable reference.
|
|
171
|
-
|
|
172
|
-
## Accessibility
|
|
173
|
-
|
|
174
|
-
### WCAG 2.1 AA Compliance
|
|
175
|
-
|
|
176
|
-
The Checkbox component implements multiple WCAG success criteria:
|
|
177
|
-
|
|
178
|
-
- **3.2.2 On Input (Level A)** - Checking the box doesn't cause unexpected
|
|
179
|
-
context changes
|
|
180
|
-
- **4.1.2 Name, Role, Value (Level A)** - Proper ARIA attributes communicate
|
|
181
|
-
state
|
|
182
|
-
- **1.4.3 Contrast (Minimum) (Level AA)** - All color variants meet 4.5:1
|
|
183
|
-
contrast ratio
|
|
184
|
-
- **2.4.7 Focus Visible (Level AA)** - Clear focus indicators on keyboard
|
|
185
|
-
navigation
|
|
186
|
-
|
|
187
|
-
### Keyboard Support
|
|
188
|
-
|
|
189
|
-
- **Tab** - Move focus to/from checkbox
|
|
190
|
-
- **Space** - Toggle checkbox state
|
|
191
|
-
- **Shift+Tab** - Move focus backward
|
|
192
|
-
|
|
193
|
-
### Screen Reader Support
|
|
194
|
-
|
|
195
|
-
- Checkbox state announced (checked/unchecked/indeterminate)
|
|
196
|
-
- Label text announced
|
|
197
|
-
- Description text announced via `aria-describedby`
|
|
198
|
-
- Error messages announced via `aria-errormessage`
|
|
199
|
-
- Required state announced via `aria-required`
|
|
200
|
-
- Disabled state announced via `aria-disabled`
|
|
201
|
-
|
|
202
|
-
### Best Practices
|
|
203
|
-
|
|
204
|
-
1. **Always provide labels** - Use `label` or `children` prop for accessible
|
|
205
|
-
name
|
|
206
|
-
2. **Use semantic colors** - Use `error` variant for validation failures
|
|
207
|
-
3. **Provide descriptions** - Use `description` prop for additional context
|
|
208
|
-
4. **Group related checkboxes** - Use `<fieldset>` and `<legend>` for checkbox
|
|
209
|
-
groups
|
|
210
|
-
5. **Don't mix modes** - Use either controlled or uncontrolled, not both
|
|
211
|
-
|
|
212
|
-
## Props
|
|
213
|
-
|
|
214
|
-
See TypeScript types for complete prop reference with JSDoc documentation.
|
|
215
|
-
|
|
216
|
-
### Key Props
|
|
217
|
-
|
|
218
|
-
| Prop | Type | Default | Description |
|
|
219
|
-
| ----------------- | -------------------------------------------------- | ------------ | -------------------- |
|
|
220
|
-
| `id` | `string` | **required** | Unique identifier |
|
|
221
|
-
| `label` | `ReactNode` | - | Label text |
|
|
222
|
-
| `children` | `ReactNode` | - | Alternative to label |
|
|
223
|
-
| `size` | `"sm" \| "md" \| "lg"` | `"md"` | Size variant |
|
|
224
|
-
| `color` | `"primary" \| "secondary" \| "error" \| "success"` | `"primary"` | Color variant |
|
|
225
|
-
| `checked` | `boolean` | - | Controlled mode |
|
|
226
|
-
| `defaultChecked` | `boolean` | - | Uncontrolled mode |
|
|
227
|
-
| `indeterminate` | `boolean` | `false` | Indeterminate state |
|
|
228
|
-
| `disabled` | `boolean` | - | Disabled state |
|
|
229
|
-
| `required` | `boolean` | `false` | Required field |
|
|
230
|
-
| `validationState` | `"valid" \| "invalid" \| "none"` | `"none"` | Validation state |
|
|
231
|
-
| `errorMessage` | `string` | - | Error message |
|
|
232
|
-
| `description` | `string` | - | Helper text |
|
|
233
|
-
|
|
234
|
-
## Examples
|
|
235
|
-
|
|
236
|
-
See Storybook stories for interactive examples:
|
|
237
|
-
|
|
238
|
-
- **Basic** - Simple checkbox with label
|
|
239
|
-
- **Sizes** - All size variants
|
|
240
|
-
- **Colors** - All color variants
|
|
241
|
-
- **States** - Checked, unchecked, indeterminate, disabled
|
|
242
|
-
- **WithDescription** - Checkbox with helper text
|
|
243
|
-
- **WithError** - Checkbox with validation error
|
|
244
|
-
- **LabelPositions** - Left and right label positioning
|
|
245
|
-
- **Controlled** - Controlled mode example
|
|
246
|
-
- **Uncontrolled** - Uncontrolled mode example
|
|
247
|
-
- **Required** - Required field indicator
|
|
248
|
-
- **ComplexForm** - Complete form example
|
|
249
|
-
- **SelectAll** - Indeterminate "select all" pattern
|
|
250
|
-
- **CustomStyling** - CSS custom property examples
|
|
251
|
-
|
|
252
|
-
## Related Components
|
|
253
|
-
|
|
254
|
-
- **Form** - Form wrapper component
|
|
255
|
-
- **Field** - Form field with label and error handling
|
|
256
|
-
- **Input** - Text input component
|
|
257
|
-
- **Select** - Dropdown select component
|
|
258
|
-
|
|
259
|
-
## Resources
|
|
260
|
-
|
|
261
|
-
- [ARIA Checkbox Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/)
|
|
262
|
-
- [WCAG 2.1 Guidelines](https://www.w3.org/WAI/WCAG21/quickref/)
|
|
263
|
-
- [CSS Variables Reference](./STYLES.mdx)
|