Merhaba Dünya
\"}\nMerhaba Dünya
\");\n ```\n\n #### `renderHTML()` Yardımcı Aracı\n\n Bileşenlerin dışında render yapmak için bağımsız yardımcı araç.\n\n ```tsx\n import { renderHTML } from \"react-intlayer/html\";\n\n const jsx = renderHTML(\"Merhaba
\", { components: { p: 'div' } });\n ```\n\nMerhaba Dünya
\")}\n ```\n\n #### `renderHTML()` Yardımcı Aracı\n\n ```svelte\n \n\n {@html renderHTML(\"Merhaba Dünya
\")}\n ```\n\nMerhaba Dünya
\"}\nMerhaba Dünya
\")}Merhaba Dünya
\")}Merhaba Dünya
\"}\nMerhaba Dünya
\")}Merhaba Dünya
\")}Sorunuzu sorun ve bu sayfaya ve seçtiğiniz AI sağlayıcısına referans vererek belgenin bir özetini alın
Sürüm Geçmişi
- "Add `intlayerHTML` plugin object; use `app.use(intlayerHTML)` instead of `app.use(installIntlayerHTML)`"v8.5.024.03.2026
- "İçeri aktarmalar {{framework}}-intlayer'dan {{framework}}-intlayer/html'e taşındı"v8.5.024.03.2026
- "HTMLRenderer / useHTMLRenderer / renderHTML yardımcı araçları eklendi"v8.0.022.01.2026
- "HTML ayrıştırma desteği eklendi"v8.0.020.01.2026
Bu sayfanın içeriği bir yapay zeka kullanılarak çevrildi.
Orijinal içeriğin İngilizce son sürümünü görüntüleyinBu dokümantasyonu geliştirmek için bir fikriniz varsa, lütfen GitHub'da bir çekme isteği göndererek katkıda bulunmaktan çekinmeyin.
Dokümantasyon için GitHub bağlantısıBelge Markdown'ını panoya kopyala
HTML İçeriği / Intlayer içinde HTML
Intlayer, sözlükleriniz içinde zengin, yapılandırılmış içerik gömmenize olanak tanıyan HTML içeriğini destekler. Bu içerik, standart HTML etiketleriyle render edilebilir veya çalışma zamanında özel bileşenlerle değiştirilebilir.
HTML İçeriğini Tanımlama
HTML içeriğini html fonksiyonunu kullanarak veya basitçe bir string olarak tanımlayabilirsiniz.
HTML içeriğini açıkça bildirmek için html fonksiyonunu kullanın. Bu, otomatik algılama devre dışı olsa bile standart etiketlerin doğru şekilde eşlenmesini sağlar.
Kodu panoya kopyala
import { html, type Dictionary } from "intlayer";const htmlDictionary = { key: "app", contentAutoTransformation: true, // yapılandırma dosyasında ayarlanabilir content: { myHtmlContent: html("<p>Merhaba <strong>Dünya</strong></p>"), },} satisfies Dictionary;export default htmlDictionary;html() Düğümü
html() fonksiyonu, Intlayer v8'de sözlüklerinizde HTML içeriğini açıkça tanımlamanıza olanak tanıyan yeni bir özelliktir. Intlayer genellikle HTML içeriğini otomatik olarak algılayabilse de, html() fonksiyonunu kullanmak birkaç avantaj sağlar:
- Tür Güvenliği:
html()fonksiyonu, özel bileşenler için beklenen propları tanımlamanıza olanak tanıyarak editörünüzde daha iyi otomatik tamamlama ve tür denetimi sağlar. - Açık Bildirim: Otomatik algılamayı tetikleyecek standart HTML etiketleri içermese bile bir dizenin her zaman HTML olarak değerlendirilmesini sağlar.
- Özel Bileşen Tanımlama: Özel bileşenleri ve beklenen prop türlerini tanımlamak için
html()fonksiyonuna ikinci bir argüman geçirebilirsiniz.
Kodu panoya kopyala
import { html } from "intlayer";const myContent = html( "<MyCustomComponent title='Merhaba'>Dünya</MyCustomComponent>", { MyCustomComponent: { title: "string", children: "node", }, });Bir HTML düğümü üzerinde .use() yöntemini kullanırken, sağladığınız bileşenler html() fonksiyonunda sağlanan tanıma (varsa) göre kontrol edilecektir.
HTML'i Render Etme
Render işlemi Intlayer'ın içerik sistemi tarafından otomatik olarak veya özel araçlar kullanılarak manuel olarak yapılabilir.
Otomatik Renderleme ( useIntlayer kullanarak)
useIntlayer aracılığıyla içeriğe eriştiğinizde, HTML düğümleri render için zaten hazırlanmıştır.
HTML düğümleri doğrudan JSX olarak render edilebilir. Standart etiketler otomatik olarak çalışır.
Kodu panoya kopyala
import { useIntlayer } from "react-intlayer";const AppContent = () => { const { myHtmlContent } = useIntlayer("app"); return <div>{myHtmlContent}</div>;};Özelleştirilmiş bileşen sağlamak veya etiketleri geçersiz kılmak için .use() metodunu kullanın:
Kodu panoya kopyala
{myHtmlContent.use({ p: (props) => <p className="prose" {...props} />, CustomLink: ({ children }) => <a href="/details">{children}</a>,})}HTMLProvider ile Genel Yapılandırma
HTML render'lamasını tüm uygulamanız için global olarak yapılandırabilirsiniz. Bu, tüm HTML içeriğinde kullanılabilir olması gereken özel bileşenleri tanımlamak için idealdir.
Kodu panoya kopyala
import { HTMLProvider } from "react-intlayer/html";export const AppProvider = ({ children }) => ( <HTMLProvider components={{ p: (props) => <p className="prose" {...props} />, CustomLink: ({ children }) => <a href="/details">{children}</a>, }} > {children} </HTMLProvider>);Kendi HTML oluşturucunuzu da kullanabilirsiniz:
Kodu panoya kopyala
import { HTMLProvider } from "react-intlayer/html";export const AppProvider = ({ children }) => ( <HTMLProvider renderHTML={async (html) => { const { renderHTML } = await import('react-intlayer/html'); return renderHTML(html); }} > {children} </HTMLProvider>);HTML oluşturucunuzu dinamik olarak içe aktarmak, uygulamanızın paket boyutunu azaltmanın iyi bir yoludur.
Manuel Renderlama ve Gelişmiş Araçlar
Ham HTML string'lerini render etmeniz gerekiyorsa veya bileşen eşlemesinde daha fazla kontrole ihtiyacınız varsa, aşağıdaki araçları kullanın.
<HTMLRenderer /> Bileşeni
Kodu panoya kopyala
import { HTMLRenderer } from "react-intlayer/html";<HTMLRenderer components={{ p: MyCustomP }}> {"<p>Merhaba Dünya</p>"}</HTMLRenderer>useHTMLRenderer() Hook
Ön yapılandırılmış bir renderer fonksiyonu alın.
Kodu panoya kopyala
import { useHTMLRenderer } from "react-intlayer/html";const renderHTML = useHTMLRenderer({ components: { strong: (props) => <strong {...props} className="text-red-500" /> }});return renderHTML("<p>Merhaba <strong>Dünya</strong></p>");renderHTML() Yardımcı Aracı
Bileşenlerin dışında render yapmak için bağımsız yardımcı araç.
Kodu panoya kopyala
import { renderHTML } from "react-intlayer/html";const jsx = renderHTML("<p>Merhaba</p>", { components: { p: 'div' } });Seçenekler Referansı
Bu seçenekler HTMLProvider, HTMLRenderer, useHTMLRenderer ve renderHTML'e iletilebilir.
Tüm veri içeriğini net bir şekilde görmek için tabloyu modalde açın
| Seçenek | Tür | Varsayılan | Açıklama |
|---|---|---|---|
components | Record<string, any> | {} | HTML etiketlerini veya özel bileşen isimlerini bileşenlere eşleyen bir harita. |
renderHTML | Function | null | Varsayılan HTML ayrıştırıcısını tamamen değiştirmek için özel bir render fonksiyonu (Sadece Vue/Svelte sağlayıcıları için). |
Not: React ve Preact için standart HTML etiketleri otomatik olarak sağlanır. Bunları geçersiz kılmak veya özel bileşenler eklemek istiyorsanız yalnızca components prop'unu geçirmeniz yeterlidir.