Salta al contingut
Yuva discussions hooksMenú

Yuva discussions hooks

A React provider and hooks over the useyuva headless client: discussions of a page, one thread, reader sign-in, the channel's discussion mode and page ratings. Labels with English defaults.

readersigned out

Loading

La vista prèvia fa servir dades d'exemple. No necessita xarxa ni canal.

Instal·lació

Executa això en un projecte de shadcn. Els fitxers es copien al teu propi codi.

Shell
npx shadcn@latest add https://useyuva.com/r/use-yuva-discussions.json

Ús

tsx
import { useDiscussions, YuvaDiscussionsProvider } from "@/hooks/use-yuva-discussions"

const { discussions, loading } = useDiscussions(page, "top")

Props

YuvaDiscussionsProviderProps

PropTipus
server?string
channel?string
identityToken?IdentityTokenSource | null
client?YuvaClient
labels?Partial<YuvaDiscussionsLabels>
locale?string
children?React.ReactNode

DiscussionsResult

PropTipus
discussionsDiscussion[]
loadingboolean
errorunknown
hasMoreboolean
loadMore() => Promise<void>
reload() => Promise<void>
start(input: Omit<ClientDiscussionCreate, "page_url"> & { page_url?: string }) => Promise<Discussion>

DiscussionResult

PropTipus
discussionDiscussion | null
openingDiscussionPost | null
postsDiscussionPost[]
loadingboolean
errorunknown
reload() => Promise<void>
reply(body: string, parentPostId?: string) => Promise<DiscussionPost>
vote(post: DiscussionPost) => Promise<void>
follow(following: boolean) => Promise<void>
accept(postId: string | null) => Promise<void>
edit(postId: string, input: ClientDiscussionPostUpdate) => Promise<void>
remove(postId: string) => Promise<boolean>

YuvaReaderState

PropTipus
readerReaderSession | null
writerYuvaWriter
readyboolean
signIn() => Promise<ReaderSession>
signOut() => Promise<void>

Etiquetes

Cada etiqueta té un valor per defecte en anglès. Passa un objecte labels parcial per canviar-les o traduir-les.

EtiquetaPer defecte
heading"Discussions"
sortNew"New"
sortTop"Top"
sortUnanswered"Unanswered"
newDiscussion"New discussion"
empty"No discussions on this page yet. Start the first one."
emptyUnanswered"Every discussion on this page has an answer."
loadMore"Load more"
loadError"Discussions could not be loaded."
retry"Try again"
back"All discussions"
replies(count) => (count === 1 ? "1 reply" : `${count} replies`)
votes(count) => (count === 1 ? "1 vote" : `${count} votes`)
answered"Answered"
acceptedAnswer"Accepted answer"
markAnswer"Mark as answer"
unmarkAnswer"Unmark as answer"
locked"Locked"
lockedNote"This discussion is locked. It takes no new replies."
pending"Awaiting approval"
pendingNote"Only you can see this until a moderator approves it."
upvote"Upvote"
removeUpvote"Remove upvote"
reply"Reply"
follow"Follow"
unfollow"Unfollow"
edit"Edit"
save"Save"
cancel"Cancel"
delete"Delete"
deleteConfirm"Delete this post?"
edited"edited"
deletedPost"This post was deleted."
deletedAuthor"Deleted reader"
deletedMember"Deleted member"
anonymous"Anonymous"
team"Team"
signIn"Sign in"
signInHint"Sign in to start a discussion, reply and vote."
signOut"Sign out"
signedInAs(name) => `Signed in as ${name}`
titleLabel"Title"
titlePlaceholder"What is your question or idea?"
bodyLabel"Message"
bodyPlaceholder"Add the details. Markdown works."
replyPlaceholder"Write a reply. Markdown works."
write"Write"
preview"Preview"
previewEmpty"Nothing to preview."
markdownHint"Markdown is supported."
startDiscussion"Start discussion"
postReply"Reply"
errorSignIn"Sign in to post."
errorLocked"This discussion is locked."
errorEditWindow"Posts can be edited for 30 minutes after posting."
errorRateLimited"Too many posts. Wait a minute and try again."
errorPopupBlocked"Allow pop-ups for this site to sign in."
errorOff"Discussions are turned off."
errorGeneric"Something went wrong. Try again."
feedbackQuestion"Was this page helpful?"
feedbackYes"Yes"
feedbackNo"No"
feedbackThanks"Thanks for your feedback."

Dependències

Instal·lar aquest element també afegeix el següent.

Paquets npm