Додајте коментаре у вашу React Native апликацију

npm install fastcomments-react-native-sdk --save

Live threaded commenting with avatars, nested replies, votes, and the built-in rich-text composer, plus a dark theme and a live-chat preset (shown here rendered via react-native-web):

Živo komentarisanje

Tamna tema

Živi chat

Uređivač bogatog teksta

Ova biblioteka koristi react-native-enriched za uređivanje bogatog teksta, što pruža moćno WYSIWYG iskustvo uređivanja. Isti editor pokreće iOS, Android i web (preko react-native-web), tako da se komponovanje ponaša dosledno na svim platformama uz jednu implementaciju.

react-native-enriched zahteva React Native New Architecture (Fabric) na native (podrazumevano od RN 0.76, opcionalno na RN 0.72‑0.75), i bundler koji razrešava uslove exports paketa. Ovaj SDK je razvijen i testiran protiv RN 0.81 / React 19. Isti editor takođe radi na webu preko react-native-web; web verzija enriched editora i dalje je označena kao eksperimentalna u upstream-u.

Vidžeti

• FastCommentsLiveCommenting – komentarisanje u nitima sa glasovima, odgovorima, paginacijom, spominjanjima, obaveštenjima i živim ažuriranjima.
• FastCommentsLiveChat – preset za chat zasnovan na istom motoru: hronološke poruke sa novim na dnu, komponovanje ispod liste, traka zaglavlja uživo (tačka veze + broj korisnika), beskonačna istorija učitana skrolovanjem nagore, automatsko skrolovanje do novih poruka, bez glasova ili ugnježdenih odgovora. Svaki preset se može prepisati putem config.
• FastCommentsFeed – društveni feed sa komponovanjem postova, medijima, reakcijama, praćenjima i trakom za nove postove u realnom vremenu.

<FastCommentsLiveChat config=\{{ tenantId: 'demo', urlId: 'my-room' }}/>

Temiranje

Podrazumevani izgled se generiše iz skupa semantičkih dizajn tokena (FastCommentsTheme): boje, razmaci, radijusi, veličine fontova, debljine fontova i veličine avatara. Prosledite parcijalna prepisivanja tokena (tipa FastCommentsThemeOverrides) kroz prop theme na bilo kom vidžetu i čitavo stablo stilova će se dosledno preoblikovati:

<FastCommentsLiveCommenting config={config} theme=\{{ colors: { primary: '#FF5500' } }}/>

Tamni režim je samo jedan set tokena udaljen:

import { getDarkTheme } from 'fastcomments-react-native-sdk';

    <FastCommentsLiveCommenting config={config} theme={getDarkTheme()}/>

styles prop i dalje prihvata sirovo IFastCommentsStyles stablo za preciznu kontrolu. Kada su theme i styles oba prosleđena, eksplicitni stilovi imaju prednost nad tematskim stablom; kada je prosleđen samo styles, on potpuno zamenjuje podrazumevane vrednosti (originalno ponašanje, tako da postojeće integracije i skinovi nisu pogođeni). setupDarkModeSkin je zastareo u korist theme prop-a.

Opcije konfiguracije

Ova biblioteka ima za cilj da podrži sve opcije konfiguracije definisane u fastcomments-typescript, baš kao i web implementacija.

Pored toga, React Native dodaje nekoliko SDK‑specifičnih opcija putem FastCommentsRNConfig:

• hideTopBar – sakriva traku sa prijavljenim korisnikom / zvonce za obaveštenja koje se prikazuje iznad kompozitora.
• usePressToEdit – pritisni i drži komentar da otvoriš njegov meni.
• disableDownVoting – sakriva dugmad za negativno glasanje.
• renderCommentInline – renderuje informacije o komentaru unutar istog HTML bloka kao i sadržaj komentara.
• renderLikesToRight – pomera oblast glasova/like‑ova na desnu stranu komentara umesto ispod njega.
• renderDateBelowComment – prikazuje datum ispod komentara.
• showLiveStatus – prikazuje traku zaglavlja u stilu četa „Live“ + broj korisnika iznad komentara.
• useInlineSubmitButton – renderuje dugme za slanje kao ikonu unutar kompozitora.
• countAboveToggle – uz useShowCommentsToggle, koliko komentara se renderuje iznad prekidača „Show Comments“.
• preserveFeedScrollPosition – FastCommentsFeed pamti svoj pomeraj skrolovanja kroz unmount/remount (podrazumevano true).

FastComments koncepti

Glavni koncepti o kojima treba da budete svesni da biste započeli su tenantId i urlId. tenantId je identifikator vašeg FastComments.com naloga. urlId je mesto na koje će se vezivati niti komentara. To može biti URL stranice, ID proizvoda, ID članka, itd.

Lokalizacija

Sav tekst koji se prikazuje korisniku u ovim vidžetima (oznake dugmadi, placeholder‑i, prazna stanja, relativni datumi poput „pre 5 minuta“, poruke o greškama, itd.) je vođen sa servera. Komponente ne sadrže hard‑kodirane engleske stringove; one renderuju prevode koje FastComments pruža za traženi jezik.

Da biste zatražili jezik, postavite locale u vašoj konfiguraciji:

const config = {
    tenantId: 'your-tenant-id',
    urlId: 'some-page',
    locale: 'de_de', // de_de, fr_fr, ja_jp, es_es, etc.
};

Kada locale nije postavljen, FastComments koristi podrazumevani jezik zakupca.

Uređivanje teksta: prevodi se upravljaju u vašem FastComments kontrolnom panelu, a ne u ovom SDK‑u. Da biste promenili formulaciju, prepišite podrazumevani tekst ili dodajte jezik, izmenite prevode za vaš nalog u kontrolnom panelu – promena se automatski preuzima u vidžetima bez potrebe za novim izdanjem aplikacije. SDK ne isporučuje engleske rezervne vrednosti, tako da bilo koji ključ koji ostavite praznim u kontrolnom panelu prikazuje prazan sadržaj; održavajte ključeve popunjene za svaki jezik koji podržavate.

Obaveštenja korisnika

FastComments podržava obaveštenja za mnogo scenarija. Obaveštenja su konfigurisana, mogu se globalno isključiti ili na nivou obaveštenja/komentara, i podržavaju pretplate na nivou stranice tako da korisnici mogu da se pretplate na niti određene stranice ili članka.

Na primer, moguće je koristiti Secure SSO za autentifikaciju korisnika, a zatim periodično proveravati nepročitana obaveštenja i slati ih korisniku.

Pogledajte primer AppNotificationSecureSSO za to kako dobiti i prevesti nepročitana obaveštenja korisnika.

Gif pretraživač

Podrazumevano, nijedan odabir slike ili gif‑a nije omogućen. Pogledajte example/src/AppCommentingImageSelection.tsx za to kako da podržite otpremanje slika i gif‑ova. Postoji Gif pretraživač koji anonimno pretražuje i pruža slike u ovoj biblioteci, jednostavno ga koristite.

Performanse

Molimo otvorite tiket sa primerom za reprodukciju, uključujući korišćeni uređaj, ako uočite bilo kakve probleme sa performansama. Performanse su prioritetni aspekt svih FastComments biblioteka.