Skip to content

Commit 0ec1d63

Browse files
committed
8253117: Replace HTML tables in javadoc summaries with CSS grid elements
Reviewed-by: jjg
1 parent 54bbe76 commit 0ec1d63

File tree

61 files changed

+1828
-2224
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

61 files changed

+1828
-2224
lines changed

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/AbstractMemberWriter.java

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -313,9 +313,8 @@ protected void addUseInfo(List<? extends Element> members, Content heading, Cont
313313
return;
314314
}
315315
boolean printedUseTableHeader = false;
316-
Table useTable = new Table(HtmlStyle.useSummary, HtmlStyle.summaryTable)
316+
Table useTable = new Table(HtmlStyle.summaryTable)
317317
.setCaption(heading)
318-
.setRowScopeColumn(1)
319318
.setColumnStyles(HtmlStyle.colFirst, HtmlStyle.colSecond, HtmlStyle.colLast);
320319
for (Element element : members) {
321320
TypeElement te = (typeElement == null)

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/AllClassesIndexWriter.java

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -120,9 +120,8 @@ protected void buildAllClassesFile() throws DocFileIOException {
120120
* @param content HtmlTree content to which the links will be added
121121
*/
122122
protected void addContents(Content content) {
123-
Table table = new Table(HtmlStyle.typeSummary, HtmlStyle.summaryTable)
123+
Table table = new Table(HtmlStyle.summaryTable)
124124
.setHeader(new TableHeader(contents.classLabel, contents.descriptionLabel))
125-
.setRowScopeColumn(1)
126125
.setColumnStyles(HtmlStyle.colFirst, HtmlStyle.colLast)
127126
.setId("all-classes-table")
128127
.setDefaultTab(resources.getText("doclet.All_Classes"))
@@ -131,8 +130,7 @@ protected void addContents(Content content) {
131130
.addTab(resources.enumSummary, utils::isEnum)
132131
.addTab(resources.exceptionSummary, e -> utils.isException((TypeElement)e))
133132
.addTab(resources.errorSummary, e -> utils.isError((TypeElement)e))
134-
.addTab(resources.annotationTypeSummary, utils::isAnnotationType)
135-
.setTabScript(i -> "show(" + i + ");");
133+
.addTab(resources.annotationTypeSummary, utils::isAnnotationType);
136134
for (Character unicode : indexBuilder.getFirstCharacters()) {
137135
for (IndexItem indexItem : indexBuilder.getItems(unicode)) {
138136
TypeElement typeElement = (TypeElement) indexItem.getElement();

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/AllPackagesIndexWriter.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ protected void buildAllPackagesFile() throws DocFileIOException {
104104
* @param content HtmlTree content to which the links will be added
105105
*/
106106
protected void addPackages(Content content) {
107-
Table table = new Table(HtmlStyle.packagesSummary, HtmlStyle.summaryTable)
107+
Table table = new Table(HtmlStyle.summaryTable)
108108
.setCaption(new StringContent(resources.packageSummary))
109109
.setHeader(new TableHeader(contents.packageLabel, contents.descriptionLabel))
110110
.setColumnStyles(HtmlStyle.colFirst, HtmlStyle.colLast);

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/AnnotationTypeRequiredMemberWriterImpl.java

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -164,10 +164,9 @@ public TableHeader getSummaryTableHeader(Element member) {
164164

165165
@Override
166166
protected Table createSummaryTable() {
167-
return new Table(HtmlStyle.memberSummary, HtmlStyle.summaryTable)
167+
return new Table(HtmlStyle.summaryTable)
168168
.setCaption(getCaption())
169169
.setHeader(getSummaryTableHeader(typeElement))
170-
.setRowScopeColumn(1)
171170
.setColumnStyles(HtmlStyle.colFirst, HtmlStyle.colSecond, HtmlStyle.colLast);
172171
}
173172

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/ClassUseWriter.java

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,7 @@ public ClassUseWriter(HtmlConfiguration configuration,
144144

145145
methodSubWriter = new MethodWriterImpl(this);
146146
constrSubWriter = new ConstructorWriterImpl(this);
147+
constrSubWriter.setFoundNonPubConstructor(true);
147148
fieldSubWriter = new FieldWriterImpl(this);
148149
classSubWriter = new NestedClassWriterImpl(this);
149150
this.navBar = new Navigation(typeElement, configuration, PageMode.USE, path);
@@ -261,7 +262,7 @@ protected void addPackageList(Content contentTree) {
261262
"doclet.ClassUse_Packages.that.use.0",
262263
getLink(new LinkInfoImpl(configuration,
263264
LinkInfoImpl.Kind.CLASS_USE_HEADER, typeElement)));
264-
Table table = new Table(HtmlStyle.useSummary, HtmlStyle.summaryTable)
265+
Table table = new Table(HtmlStyle.summaryTable)
265266
.setCaption(caption)
266267
.setHeader(getPackageTableHeader())
267268
.setColumnStyles(HtmlStyle.colFirst, HtmlStyle.colLast);
@@ -287,7 +288,7 @@ protected void addPackageAnnotationList(Content contentTree) {
287288
getLink(new LinkInfoImpl(configuration,
288289
LinkInfoImpl.Kind.CLASS_USE_HEADER, typeElement)));
289290

290-
Table table = new Table(HtmlStyle.useSummary, HtmlStyle.summaryTable)
291+
Table table = new Table(HtmlStyle.summaryTable)
291292
.setCaption(caption)
292293
.setHeader(getPackageTableHeader())
293294
.setColumnStyles(HtmlStyle.colFirst, HtmlStyle.colLast);

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/ConstantsSummaryWriterImpl.java

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -205,10 +205,9 @@ public void addConstantMembers(TypeElement typeElement, Collection<VariableEleme
205205
}
206206
caption.add(classlink);
207207

208-
Table table = new Table(HtmlStyle.constantsSummary, HtmlStyle.summaryTable)
208+
Table table = new Table(HtmlStyle.summaryTable)
209209
.setCaption(caption)
210210
.setHeader(constantsTableHeader)
211-
.setRowScopeColumn(1)
212211
.setColumnStyles(HtmlStyle.colFirst, HtmlStyle.colSecond, HtmlStyle.colLast);
213212

214213
for (VariableElement field : fields) {

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/ConstructorWriterImpl.java

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -185,21 +185,18 @@ public TableHeader getSummaryTableHeader(Element member) {
185185
@Override
186186
protected Table createSummaryTable() {
187187
List<HtmlStyle> bodyRowStyles;
188-
int rowScopeColumn;
189188

190189
if (foundNonPubConstructor) {
191190
bodyRowStyles = Arrays.asList(HtmlStyle.colFirst, HtmlStyle.colConstructorName,
192191
HtmlStyle.colLast);
193-
rowScopeColumn = 1;
194192
} else {
195193
bodyRowStyles = Arrays.asList(HtmlStyle.colConstructorName, HtmlStyle.colLast);
196-
rowScopeColumn = 0;
197194
}
198195

199-
return new Table(HtmlStyle.memberSummary, HtmlStyle.summaryTable)
196+
return new Table(
197+
HtmlStyle.summaryTable)
200198
.setCaption(contents.constructors)
201199
.setHeader(getSummaryTableHeader(typeElement))
202-
.setRowScopeColumn(rowScopeColumn)
203200
.setColumnStyles(bodyRowStyles);
204201
}
205202

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/DeprecatedListWriter.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -370,7 +370,7 @@ protected void addDeprecatedAPI(SortedSet<Element> deprList, String id, String h
370370
String tableSummary, TableHeader tableHeader, Content contentTree) {
371371
if (deprList.size() > 0) {
372372
Content caption = contents.getContent(headingKey);
373-
Table table = new Table(HtmlStyle.deprecatedSummary, HtmlStyle.summaryTable)
373+
Table table = new Table(HtmlStyle.summaryTable)
374374
.setCaption(caption)
375375
.setHeader(tableHeader)
376376
.setId(id)

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/EnumConstantWriterImpl.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,7 @@ public TableHeader getSummaryTableHeader(Element member) {
142142

143143
@Override
144144
protected Table createSummaryTable() {
145-
return new Table(HtmlStyle.memberSummary, HtmlStyle.summaryTable)
145+
return new Table(HtmlStyle.summaryTable)
146146
.setCaption(contents.getContent("doclet.Enum_Constants"))
147147
.setHeader(getSummaryTableHeader(typeElement))
148148
.setColumnStyles(HtmlStyle.colFirst, HtmlStyle.colLast);

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/FieldWriterImpl.java

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -147,10 +147,9 @@ protected Table createSummaryTable() {
147147
List<HtmlStyle> bodyRowStyles = Arrays.asList(HtmlStyle.colFirst, HtmlStyle.colSecond,
148148
HtmlStyle.colLast);
149149

150-
return new Table(HtmlStyle.memberSummary, HtmlStyle.summaryTable)
150+
return new Table(HtmlStyle.summaryTable)
151151
.setCaption(contents.fields)
152152
.setHeader(getSummaryTableHeader(typeElement))
153-
.setRowScopeColumn(1)
154153
.setColumnStyles(bodyRowStyles);
155154
}
156155

0 commit comments

Comments
 (0)