Add fontWidth() and clarify textWidth vs fontWidth docs in attributes.js #8088
+605
−0
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.
Resolves #7745
This pull request introduces a new user-facing function,
fontWidth()
, to the p5.js library and updates the documentation to clearly distinguish between advance width and tight bounding box measurements for text. All changes are made insrc/typography/attributes.js
.Changes
fontWidth()
returns the advance width (loose measurement) of a string, including all leading and trailing whitespace, as measured by the browser'smeasureText().width
.fontWidth()
.textWidth()
documentation to clarify that it returns the tight bounding box width, which may ignore leading/trailing whitespace.p5.Font.js
:attributes.js
as per maintainer feedback.Motivation
textWidth()
and the newfontWidth()
regarding whitespace handling.attributes.js
.Example Usage
Related Issues
Checklist
fontWidth()
attributes.js
p5.Font.js
dev-2.0
branchThis PR ensures p5.js 2.0 users have clear, accurate, and maintainers-aligned documentation for text measurement functions.
PR Checklist
npm run lint
passes