dotnet / dotnet/docfx

[Feature Request] Supports MPA View Transition

Open
#9,952 0 comments 2 reactions 0 assignees View on GitHub
template
Dominant language
C#
Stars
4.4k
Forks
890
Avg merge
2h 11m
Merged PRs (30d)
10

Description

**Is your feature request related to a problem? Please describe.**

Chrome 126 or later supports MPA(Multi-Page-Application) View Transition by default.
And it'll be expected to be supported by other browser by [CSS View Transitions Module Level 2](https://www.w3.org/TR/css-view-transitions-2) standard.

**Auto** view transition feature is enabled by PR #9909.

But by implementing **Custom** view transitions.
Some of known issues relating page navigation can be resolved.

- It takes time to display TOC/Nav on large docs site. (e.g. https://doc.stride3d.net/4.2/en/)
- https://github.com/dotnet/docfx/issues/1898
- https://github.com/dotnet/docfx/issues/2412
- https://github.com/dotnet/docfx/issues/2384

**Describe the solution you'd like**
Implement **custom** view transition.
Following sequence is expected.

- Save TOC HTML DOM on `pageswap` event
- Restore TOC DOM on `pagereveal` event (If referenced TOC is not changed)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.