Merge pull request #1551 from lucee/LDEV-5901-docs

7.0.1.66-SNAPSHOT update tag attribute groups

Author: zspitzer

.github/workflows/main.yml

@@ -41,7 +41,7 @@ jobs:
         with:
           webroot: ${{ github.workspace }}
           execute: /build-all.cfm
-          luceeVersion: 7.0.1.65-SNAPSHOT
+          luceeVersion: 7.0.1.66-SNAPSHOT
           # redis, chart, lucene, form. ajax, chart, argon2, websocket, ec2, json
           extensions: 60772C12-F179-D555-8E2CD2B4F7428718;version=3.0.0.54-SNAPSHOT,D46B46A9-A0E3-44E1-D972A04AC3A8DC10,EFDEB172-F52E-4D84-9CD1A1F561B3DFC8,FAD67145-E3AE-30F8-1C11A6CCF544F0B7,6E2CB28F-98FB-4B51-B6BE6C64ADF35473,DF28D0A4-6748-44B9-A2FDC12E4E2E4D38,7891D723-8F78-45F5-B7E333A22F8467CA,058215B3-5544-4392-A187A1649EB5CA90,261114AC-7372-4CA8-BA7090895E01682D,A03F4335-BDEF-44DE-946FB16C47802F96,3F9DFF32-B555-449D-B0EB5DB723044045
       - name: Upload Artifact

builders/html/templates/tag.cfm

@@ -158,6 +158,55 @@
 					</table>
 				</div>
 			</cfloop>
+
+			<!--- Collect and render unimplemented attributes (if any) --->
+			<cfset local.unimplementedAttribs = []>
+			<cfloop array="#local.tag.getAttributes()#" item="local.attrib">
+				<cfif local.attrib.status neq "implemented">
+					<cfset arrayAppend( local.unimplementedAttribs, local.attrib )>
+				</cfif>
+			</cfloop>
+			<cfif ArrayLen( local.unimplementedAttribs ) gt 0>
+				<h4>Unimplemented Attribute(s)</h4>
+				<div class="table-responsive">
+					<table class="table attributes">
+						<thead>
+							<tr>
+								<th>Attribute</th>
+								<th>Description</th>
+								<cfif local.attributesHaveDefaultValues><th>Default</th></cfif>
+							</tr>
+						</thead>
+						<tbody>
+							<cfloop array="#local.unimplementedAttribs#" item="local.attrib">
+								<tr>
+									<td translate="no">
+										<div class="attribute" id="attribute-#local.attrib.name#">#local.attrib.name#</div>
+										<sub>#local.attrib.type#, #( local.attrib.required ? 'required' : 'optional' )#</sub>
+									</td>
+									<td>
+										#getEditLink(path=local.tag.getSourceDir() & '_attributes/#local.attrib.name#.md', edit=args.edit)#
+										#_markdownToHtml( local.attrib.description ?: "" )#
+										<cfif structKeyExists(local.attrib, "aliases") && Arraylen(local.attrib.aliases) gt 0>
+											<p title="for compatibility, this attribute has the following alias(es)"><sub>Alias:
+											<span translate="no">#ArrayToList(local.attrib.aliases,", ")#</span></sub></p>
+										</cfif>
+										<cfif structKeyExists(local.attrib, "status") and local.attrib.status neq "implemented">
+											<em>* #local.attrib.status# *</em>
+										</cfif>
+										#showOriginalDescription(props=local.attrib, edit=args.edit, _markdownToHtml=_markdownToHtml)#
+									</td>
+									<cfif local.attributesHaveDefaultValues>
+										<td translate="no">
+											#_markdownToHtml( local.attrib.defaultValue ?: "" )#
+										</td>
+									</cfif>
+								</tr>
+							</cfloop>
+						</tbody>
+					</table>
+				</div>
+			</cfif>
 		<cfelse>
 			<!--- Render flat table as before (backwards compatible) --->
 			<div class="table-responsive">

builders/markdown/templates/tag.cfm

@@ -100,6 +100,29 @@
 				}
 				echo( chr(10) );
 			}
+
+			// Collect and render unimplemented attributes (if any)
+			local.unimplementedAttributes = [];
+			for ( local.attrib in local.tag.getAttributes() ) {
+				if ( local.attrib.status neq "implemented" ) {
+					arrayAppend( local.unimplementedAttributes, local.attrib );
+				}
+			}
+			if ( arrayLen( local.unimplementedAttributes ) gt 0 ) {
+				echo( "###### Unimplemented Attribute(s)" & chr(10) & chr(10) );
+				echo( "| Attribute | Type | Required | Description | Default |" & chr(10) );
+				echo( "|-----------|------|----------|-------------|---------|" & chr(10) );
+
+				for ( local.attrib in local.unimplementedAttributes ) {
+					echo( "| " & markdownTableCell( local.attrib.name ) );
+					echo( " | " & markdownTableCell( local.attrib.type ) );
+					echo( " | " & ( local.attrib.required ? 'Yes' : 'No' ) );
+					echo( " | " & markdownTableCell( ( local.attrib.description ?: "" ) & ( structKeyExists( local.attrib, "aliases" ) && ArrayLen( local.attrib.aliases ) gt 0 ? " *Alias: " & ArrayToList( local.attrib.aliases, ", " ) & "*" : "" ) & " *" & local.attrib.status & "*" ) );
+					echo( " | " & markdownTableCell( local.attrib.defaultValue ?: "" ) );
+					echo( " |" & chr(10) );
+				}
+				echo( chr(10) );
+			}
 		} else {
 			// Render flat table as before (backwards compatible)
 			echo( "## Attributes" & chr(10) & chr(10) );