mirror of
https://github.com/angular/angular
synced 2026-05-24 09:28:37 +00:00
8bdd98ef41
Block entries (@if, @defer, @for,@let, @switch) were falling back to the generic DocsReference template, causing the description to appear twice - once in the header section and once in the main content area. This commit adds a dedicated rendering path for block entries: - Creates BlockEntryRenderable type and associated transforms - Adds BlockReference template that uses RawHtml directly - Modifies HeaderApi to accept hideDescription prop - Updates processing and rendering pipelines to handle blocks The fix ensures block documentation displays only one description section while preserving the existing behavior for all other API entry types. Update adev/shared-docs/pipeline/api-gen/rendering/transforms/block-transforms.mts Co-authored-by: Matthieu Riegler <kyro38@gmail.com>
23 lines
742 B
TypeScript
23 lines
742 B
TypeScript
/*!
|
|
* @license
|
|
* Copyright Google LLC All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
* found in the LICENSE file at https://angular.dev/license
|
|
*/
|
|
|
|
import {h} from 'preact';
|
|
import {BlockEntryRenderable} from '../entities/renderables.mjs';
|
|
import {HeaderApi} from './header-api';
|
|
import {RawHtml} from './raw-html';
|
|
import {API_REFERENCE_CONTAINER} from '../styling/css-classes.mjs';
|
|
|
|
/** Component to render a block API reference document. */
|
|
export function BlockReference(entry: BlockEntryRenderable) {
|
|
return (
|
|
<div className={API_REFERENCE_CONTAINER}>
|
|
<HeaderApi entry={entry} hideDescription={true} />
|
|
<RawHtml value={entry.htmlDescription} />
|
|
</div>
|
|
);
|
|
}
|