Note non-standard behavior of view transitions for forms set to post

[knpwrs]

Description (required)

This PR adds a note about the non-standard behavior of Astro view transitions for forms with method set to post.

Related issues & labels (optional)

For Astro release: 4.0.7. See astro [#9466](PR withastro/astro#9466).

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
docs	🛑 Canceled (Inspect)			Dec 21, 2023 3:57pm

1 Ignored Deployment

Name	Status	Preview	Comments	Updated (UTC)
docs-i18n	⬜️ Ignored (Inspect)	Visit Preview		Dec 21, 2023 3:57pm

[astrobot-houston]

Hello! Thank you for opening your first PR to Astro’s Docs! 🎉

Here’s what will happen next:

1. Our GitHub bots will run to check your changes.
   If they spot any broken links you will see some error messages on this PR.
   Don’t hesitate to ask any questions if you’re not sure what these mean!

2. In a few minutes, you’ll be able to see a preview of your changes on Netlify 🥳

3. One or more of our maintainers will take a look and may ask you to make changes.
   We try to be responsive, but don’t worry if this takes a few days.

[OliverSpeir]

Good catch! I agree this non standard behavior should be documented

Anyone can see the behavior in the console logs when submitting the forms here:
https://stackblitz.com/edit/github-fluv9b-sagjcv?file=src%2Fpages%2Findex.astro

[martrapp]

@OliverSpeir Cool Page! 👍🏼

Anyone can see the behavior in the console logs when submitting the forms here:
https://stackblitz.com/edit/github-fluv9b-sagjcv?file=src%2Fpages%2Findex.astro

You might want to add

  <hr>
  <form method="POST" action="/form"  enctype="application/x-www-form-urlencoded">
    <button>Submit with Transitions and enctype</button>
  </form>

[martrapp]

correct in content, can't comment on wording ;-)

[martrapp]

For future Astro release: 4.x.x. See astro [#9466](PR withastro/astro#9466).

The "future" release was 4.0.7

[knpwrs]

I've updated the PR description to match.

[sarah11918]

Thanks for confirming this is safe to merge now!

@martrapp @knpwrs - can you please confirm whether post should be lower-case or upper case here?

[sarah11918]

Thank you for contributing this, @knpwrs !

I will just need us to confirm the case of POST (I suspect it should be all caps?), and I streamlined the wording a little bit to match our concise tone in docs (and have fewer words for our translators to wrangle). See what you think of the suggestion, and whether it still captures the proper nuance. Then we'll get this into docs right away! 🙌

[sarah11918]

Thanks, I'm going off of this:

We may have missed some in our v4 docs roundup!

[knpwrs]

@sarah11918 I think that's for exported API route handlers, not for form method verbs.

EDIT: I say that because the browser doesn't care, whereas I know Astro supports exporting verb handlers.

[sarah11918]

Gotcha. If it is a stylistic choice, it probably makes sense for us to converge with all caps, just for consistency and having one nice rule for contributors!

[sarah11918]

This looks great now, thank you so much and welcome to Team Docs! 🥳