[doc] Add explicit types for slider callbacks #19867
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Closes #19739
When adding the
number | number[]
type to the param in Slider.js I discovered that union types and array types were not yet supported by the documentation generator, so I added some basic support for those types. The union type was straight-forward, although it required some recursive handling. The support I added for array types is quite brittle, but I think given the context in which this code is used it would be reasonable to add more sophisticated support when / if it is needed.There are a couple spurious changes to the API doc, though looking at the diff it looks like some fixes to latent issues.
P.S. This is the first pull request I submitted for open source development, so if there's anything I can improve / should do / should not do, please let me know!