FastComments.com

Dodajte komentare u vašu React Native aplikaciju


Ovo je zvanični React Native SDK za FastComments.

Pristupite FastComments API-ju direktno iz vaše React Native aplikacije.

Repository

Pogledajte na GitHub


Instalacija Internal Link

npm

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

Snimci ekrana Internal Link

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
Živo komentarisanje, svetla tema
Tamna tema
Živo komentarisanje, tamna tema
Živi chat
Preset za živi chat

Rich Text Editor

This library uses react-native-enriched for rich text editing, which provides a powerful WYSIWYG editing experience. The same editor powers iOS, Android, and the web (via react-native-web), so the composer behaves consistently across every platform with a single implementation.

react-native-enriched requires the React Native New Architecture (Fabric) on native (the default since RN 0.76, opt-in on RN 0.72-0.75), and a bundler that resolves package exports conditions. This SDK is developed and tested against RN 0.81 / React 19. The same editor also runs on web through react-native-web; the enriched editor's web build is still marked experimental upstream.

Vidžeti

  • FastCommentsLiveCommenting - komentarisanje u nitima sa glasovima, odgovorima, paginacijom, spominjanjima, notifikacijama i živim ažuriranjima.
  • FastCommentsLiveChat - preset za chat na istom motoru: hronološke poruke sa novim na dnu, sastavljač ispod liste, živa traka zaglavlja (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 može biti prepisan putem config.
  • FastCommentsFeed - društveni feed sa sastavljačem postova, medijima, reakcijama, praćenjima i živim banerima za nove postove.
<FastCommentsLiveChat config=\{{ tenantId: 'demo', urlId: 'my-room' }}/>

Temiranje

The default look is generated from a set of semantic design tokens (FastCommentsTheme): colors, spacing, radius, font sizes, font weights, and avatar sizes. Pass partial token overrides (typed FastCommentsThemeOverrides) through the theme prop on any widget and the entire style tree restyles consistently:

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

Dark mode is one token set away:

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

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

The styles prop still accepts a raw IFastCommentsStyles tree for surgical control. When theme and styles are both provided, the explicit styles win over the themed tree; when only styles is provided, it replaces the defaults entirely (the original behavior, so existing integrations and skins are unaffected). setupDarkModeSkin is deprecated in favor of the theme prop.

Opcije Konfiguracije

This library aims to support all configuration options defined in fastcomments-typescript, just like the web implementation.

On top of those, React Native adds a few SDK-specific options via FastCommentsRNConfig:

  • hideTopBar - sakrij traku sa prijavljenim korisnikom / zvonce za notifikacije prikazanu iznad sastavljača.
  • usePressToEdit - pritisni i drži komentar da otvoriš njegov meni.
  • disableDownVoting - sakrij dugmad za negativno glasanje.
  • renderCommentInline - prikaži informacije o komentaru unutar istog HTML bloka kao sadržaj komentara.
  • renderLikesToRight - pomeri oblast glasova/like-ova desno od komentara umesto ispod njega.
  • renderDateBelowComment - prikaži datum ispod komentara.
  • showLiveStatus - prikaži traku zaglavlja u stilu četa "Live" + broj korisnika iznad komentara.
  • useInlineSubmitButton - prikaži dugme za slanje kao ikonu unutar sastavljača.
  • countAboveToggle - sa useShowCommentsToggle, koliko komentara se prikazuje iznad prekidača "Show Comments".
  • preserveFeedScrollPosition - FastCommentsFeed pamti svoj pomeraj skrolovanja kroz unmount/remount (podrazumevano true).

FastComments Koncepti

The main concepts to be aware of to get started are tenantId and urlId. tenantId is your FastComments.com account identifier. urlId is where comment threads will be tied to. This could be a page URL, or a product id, an article id, etc.

Lokalizacija

All user-facing text in these widgets (button labels, placeholders, empty states, relative dates like "5 minutes ago", error messages, etc.) is server-driven. The components do not hard-code English strings; they render the translations FastComments serves for the requested locale.

To request a locale, set locale in your config:

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

When no locale is set, FastComments serves the tenant's default language.

Editing the text: translations are managed in your FastComments dashboard, not in this SDK. To change wording, override the default copy, or add a language, edit the translations for your account in the dashboard - the change is picked up by the widgets automatically with no app release required. The SDK ships no English fallbacks, so any key you blank out in the dashboard renders empty; keep the keys populated for every locale you support.

Notifikacije Korisnika

FastComments supports notifications for many scenarios. Notifications are configurable, can be opted-out globally or at a notification/comment level, and supports page-level subscriptions so that users can subscribe to threads of a specific page or article.

For example, it is possible to use Secure SSO to authenticate the user and then periodically poll for unread notifications and push them to the user.

See the example AppNotificationSecureSSO for how to get and translate unread user notifications.

Gif Pregledač

By default, no image or gif selection is enabled. See example/src/AppCommentingImageSelection.tsx for how to support image and gif uploads. There is a Gif Browser that anonymizes searches and images provided in this library, you simply have to use it.

Performans

Please open a ticket with an example to reproduce, including device used, if you identify any performance problems. Performance is a first-class citizen of all FastComments libraries.

Trebate pomoć?

Ako naiđete na bilo kakve probleme ili imate pitanja u vezi sa React Native SDK-om, molimo:

Doprinosi

Doprinosi su dobrodošli! Posetite GitHub repozitorijum za smernice o doprinosu.