w3c/csswg-drafts

[cssom-view] Expose inner border dimensions

Open

#1,129 opened on Mar 27, 2017

View on GitHub
 (4 comments) (0 reactions) (0 assignees)HTML (3,546 stars) (545 forks)batch import
Help Wantedcssom-view-1

Description

cf. https://github.com/jquery/jquery/issues/3589#issuecomment-289548410

There seems to be no good method for calculating the dimensions of an element's inner border edge (i.e., content area plus padding plus non-floating scrollbars). One can subtract computed border dimensions from offsetWidth or offsetHeight in the special case of a block-layout HTMLElement, but as far as I can tell it's otherwise impossible.

I think the Element interface should expose something for such calculations, e.g.

  • scrollGutterWidth/scrollGutterHeight (the space lost to scrollbars), or
  • scrollbarWidth/scrollbarHeight (the scrollbar width), along with a method for identifying non-floating scrollbars, or
  • fullClientWidth/fullClientHeight (the dimensions of an inner border edge).

The last one seems most consistent with the rest of CSSOM View.

Contributor guide

Tech stack
css
Domain
frontenddocumentation
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
5
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
over 1 week
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
None
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
10
Research direction
This issue proposes adding a method to expose inner border dimensions (content + padding + scrollbars) to the CSSOM View specification. First, review the CSSOM View spec and the referenced jQuery issue to understand the current limitations. Then, consider the proposed approaches (scrollGutterWidth, scrollbarWidth, or fullClientWidth) and evaluate which fits best with existing APIs. Discuss in the issue and potentially draft a concrete proposal for the spec.