This looks to me as a website related issue, not sure why this has been moved to core.

The API docs are built as part of the releases. All the tooling to do that is in the core repository. The View another version dropdown is generated with this code:

node/tools/doc/html.js

Lines 394 to 422 in f4f856b

    
           async function altDocs(filename, docCreated) { 
        
             const [, docCreatedMajor, docCreatedMinor] = docCreated.map(Number); 
        
             const host = 'https://nodejs.org'; 
        
             const versions = await getVersions.versions(); 
        
             const getHref = (versionNum) => 
        
               `${host}/docs/latest-v${versionNum}/api/${filename}.html`; 
        
             const wrapInListItem = (version) => 
        
               `<li><a href="${getHref(version.num)}">${version.num}` + 
        
               `${version.lts ? ' <b>LTS</b>' : ''}</a></li>`; 
        
             function isDocInVersion(version) { 
        
               const [versionMajor, versionMinor] = version.num.split('.').map(Number); 
        
               if (docCreatedMajor > versionMajor) return false; 
        
               if (docCreatedMajor < versionMajor) return true; 
        
               if (Number.isNaN(versionMinor)) return true; 
        
               return docCreatedMinor <= versionMinor; 
        
             } 
        
             const list = versions.filter(isDocInVersion).map(wrapInListItem).join('\n'); 
        
             return list ? ` 
        
               <li class="version-picker"> 
        
                 <a href="#">View another version <span>&#x25bc;</span></a> 
        
                 <ol class="version-picker">${list}</ol> 
        
               </li> 
        
             ` : ''; 
        
           }

Speculatively it could be an issue with the style sheet:

node/doc/api_assets/style.css

Lines 112 to 158 in ce49f90

    
           li.version-picker { 
        
             position: relative; 
        
           } 
        
           li.version-picker:hover > a { 
        
             border-radius: 2px 2px 0 0; 
        
           } 
        
           li.version-picker:hover > ol { 
        
             display: block; 
        
             z-index: 1; 
        
           } 
        
           li.version-picker a span { 
        
             font-size: .7rem; 
        
           } 
        
           ol.version-picker { 
        
             background-color: #fff; 
        
             border: 1px solid #43853d; 
        
             border-radius: 0 0 2px 2px; 
        
             display: none; 
        
             list-style: none; 
        
             position: absolute; 
        
             right: 0; 
        
             top: 1.25rem; 
        
             width: 100%; 
        
           } 
        
           #gtoc ol.version-picker li { 
        
             display: block; 
        
             border-right: 0; 
        
             margin-right: 0; 
        
           } 
        
           ol.version-picker li a { 
        
             border-radius: 0; 
        
             display: block; 
        
             margin: 0; 
        
             padding: .1rem; 
        
             padding-left: 1rem; 
        
           } 
        
           ol.version-picker li:last-child a { 
        
             border-bottom-right-radius: 1px; 
        
             border-bottom-left-radius: 1px; 
        
           }

	async function altDocs(filename, docCreated) {
	const [, docCreatedMajor, docCreatedMinor] = docCreated.map(Number);
	const host = 'https://nodejs.org';
	const versions = await getVersions.versions();

	const getHref = (versionNum) =>
	`${host}/docs/latest-v${versionNum}/api/${filename}.html`;

	const wrapInListItem = (version) =>
	`<li><a href="${getHref(version.num)}">${version.num}` +
	`${version.lts ? ' <b>LTS</b>' : ''}</a></li>`;

	function isDocInVersion(version) {
	const [versionMajor, versionMinor] = version.num.split('.').map(Number);
	if (docCreatedMajor > versionMajor) return false;
	if (docCreatedMajor < versionMajor) return true;
	if (Number.isNaN(versionMinor)) return true;
	return docCreatedMinor <= versionMinor;
	}

	const list = versions.filter(isDocInVersion).map(wrapInListItem).join('\n');

	return list ? `
	<li class="version-picker">
	<a href="#">View another version <span>▼</span></a>
	<ol class="version-picker">${list}</ol>
	</li>
	` : '';
	}

	li.version-picker {
	position: relative;
	}

	li.version-picker:hover > a {
	border-radius: 2px 2px 0 0;
	}

	li.version-picker:hover > ol {
	display: block;
	z-index: 1;
	}

	li.version-picker a span {
	font-size: .7rem;
	}

	ol.version-picker {
	background-color: #fff;
	border: 1px solid #43853d;
	border-radius: 0 0 2px 2px;
	display: none;
	list-style: none;
	position: absolute;
	right: 0;
	top: 1.25rem;
	width: 100%;
	}

	#gtoc ol.version-picker li {
	display: block;
	border-right: 0;
	margin-right: 0;
	}

	ol.version-picker li a {
	border-radius: 0;
	display: block;
	margin: 0;
	padding: .1rem;
	padding-left: 1rem;
	}

	ol.version-picker li:last-child a {
	border-bottom-right-radius: 1px;
	border-bottom-left-radius: 1px;
	}

Uh oh!

Select another version dropdown bug #30969

Description

Activity

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions