Skip to content
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

feat(jsdoc): remove attr name for Object props #4680

Merged
merged 1 commit into from
Feb 2, 2022

Conversation

ilhan007
Copy link
Member

@ilhan007 ilhan007 commented Feb 1, 2022

With this change we enhance the JSDOC parser to automatically omit attribute names for properties of type "Object" or "object". The code literally checks if the type is equal to the "Object" and "object" strings.

/**
 * @type {object}
 * @public
 */

To complement the auto detection which only checks for the "Object" and "object" strings, we also introduce a new JSDOC tag, called "noattribute" to manually and explicitly tag a member for which the attribute counterpart should not be displayed in the API reference:

 /**
 * @noattribute
 * @public
 */

After this change the attribute counterpart of the following properties of type Object will be omitted (automatically detected):

  • Links
    accessibilityAttributes
  • ShellBar
    accessibilityTexts
  • FCL
    accessibilityRoles
    accessibilityTexts

FIXES: #4674

@ilhan007 ilhan007 merged commit 1741bd6 into master Feb 2, 2022
@ilhan007 ilhan007 deleted the feat-jsdoc-noattribute branch February 2, 2022 11:34
ilhan007 added a commit that referenced this pull request Feb 3, 2022
With this change we enhance the JSDOC parser to automatically omit attribute names for properties of type "Object" or "object". The code literally checks if the type is equal to the "Object" and "object" strings.
To complement the auto detection which only checks for the "Object" and "object" strings, we also introduce a new JSDOC tag, called "noattribute" to manually and explicitly tag a member for which the attribute counterpart should not be displayed in the API reference

FIXES: #4674
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

no attribute should be generated in docs for object type properties
2 participants