-
Notifications
You must be signed in to change notification settings - Fork 79
docs(b and c components): consistent api description refs #8536
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
…into dit13711/7071-update-api-reference-descriptions
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice! ✨ 🧹 ✨
Have a few considerations for your review below.
calcite-design-system/packages/calcite-components/src/components/button/button.tsx
Line 153 in f018031
* Specifies the default behavior of the button. |
For consistency, we should rename any named components, something like:
Specifies the default behavior of the
buttoncomponent.
calcite-design-system/packages/calcite-components/src/components/chip-group/chip-group.tsx
Lines 52 to 56 in f018031
/** Specifies the selection mode of the component. */ | |
@Prop({ reflect: true }) selectionMode: Extract< | |
"multiple" | "single" | "single-persist" | "none", | |
SelectionMode | |
> = "none"; |
Could we add some context to the selection mode types, similar to list?
calcite-design-system/packages/calcite-components/src/components/checkbox/checkbox.tsx
Lines 87 to 88 in f018031
/** Specifies the name of the component on form submission. */ | |
@Prop({ reflect: true }) name: string; |
WDYT about adding in context to the name
prop, similar to combobox?
packages/calcite-components/src/components/block-section/block-section.tsx
Show resolved
Hide resolved
packages/calcite-components/src/components/color-picker/color-picker.tsx
Outdated
Show resolved
Hide resolved
packages/calcite-components/src/components/color-picker/color-picker.tsx
Outdated
Show resolved
Hide resolved
packages/calcite-components/src/components/color-picker/color-picker.tsx
Outdated
Show resolved
Hide resolved
packages/calcite-components/src/components/combobox/combobox.tsx
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for working through these! 🙌🏻 Two small considerations from some duplicative styling where the prop values are summarized.
packages/calcite-components/src/components/chip-group/chip-group.tsx
Outdated
Show resolved
Hide resolved
packages/calcite-components/src/components/combobox/combobox.tsx
Outdated
Show resolved
Hide resolved
…into dit13711/7071-update-api-reference-descriptions
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Awesome! 🥇
…-not-internal * origin/main: docs(d, f, g, and h-named components): update api description refs (#8540) docs(b and c components): consistent api description refs (#8536) ci(update-doc): build design tokens to prevent errors (#8542) docs: update component readmes (#8543) ci: consistent formatting across packages (#8534) refactor(list-item): Remove unnecessary code for rendering open caret (#8537) docs(tab-nav, table, tabs, tile-select, tree, value-list): consistent api description refs (#8535) chore: release next feat(list-item): Add dragSelected property and calciteListItemDragHandleChange event (#8524) chore: release next fix(input-date-picker): hard to reproduce numbering-system caching issue (#8518) feat(handle): add selected property and calciteHandleChange event. (#8484) docs(action-bar, action-group, action-pad, alert): consistent api decription refs (#8533)
…mber-infinity * origin/main: refactor: remove @ts-ignore needed for Stencil missing in JSX types (#8551) refactor(combobox): remove unused interface (#8552) fix(input-date-picker): ensure range icon toggles open corresponding date-picker (#8554) fix(button): avoid needlessly overwriting title (#8491) docs(d, f, g, and h-named components): update api description refs (#8540) docs(b and c components): consistent api description refs (#8536)
Related Issue: #7071
Summary
Updates doc consistency across b and c-named components defined in the above issue for props, events, methods, and css vars, including:
button
block
block-section
color-picker-hex-input
color-picker
combobox
cc @geospatialem