CmsLink
Facilita a persistência dos searchParams
relacionados ao CMS na URL durante a navegação no site.
Descrição
Quando acessamos o nosso site no modo de edição dentro do iframe do CMS, o CMS adiciona alguns parâmetros à URL para que o site saiba que está no modo de edição. Esses parâmetros são:
cms=true
workspace=nome_do_workspace
O CmsLink
é um componente que torna mais fácil a persistência desses parâmetros na URL à medida que o usuário navega pelo site. Ele é uma extensão do componente Link
do NextJS e mantém os parâmetros do CMS na URL (se existirem) enquanto o usuário navega pelo site.
Nos bastidores, é o mesmo componente Link
do NextJS; todas as propriedades permanecem as mesmas, com a única diferença de que ele mantém os parâmetros do CMS na URL enquanto o usuário navega pelo site através do CMS.
Exemplo
Uso basico
import { CmsLink } from "@m3cms/nextjs"
export default function Home() {
return (
<div>
<CmsLink href="/about">
Sobre
</CmsLink>
</div>
)
}
Migrando o next/link
Voce so precisa trocar o import a importação do Link
do NextJS para o CmsLink
do @m3cms/nextjs
.
import Link from "next/link" // antes
import { CmsLink: Link } from "@m3cms/nextjs" // depois
export default function Home() {
return (
<div>
<Link href="/about">
Sobre
</Link>
</div>
)
}