Widget de ranking e mural de usuários
Less than 1 minute...
O Waline permite exibir o ranking de usuários ou o mural de usuários por widget, o que facilita mostrar as informações de quem comenta na barra lateral do blog.
Opções do componente
O widget de ranking/mural de usuários se chama UserList e tem seis opções:
el(opcional): o elemento onde o widget será montadoserverURL: link do servidorcounta quantidade de usuários a obtermode:listsignifica ranking de usuários ewallsignifica mural de usuárioslang: suporte a i18n; veja i18n para mais detalheslocale: personaliza o idioma; veja i18n para mais detalhes
O formato de dados retornado pelo componente é Promise<{ users: WalineUser[], destroy: () => void }>.
- propriedade
users: um array com a lista de usuários, exatamente na quantidade decount - método
destroy: uma função que destrói o widget
Uso básico
Ranking de usuários
<div id="waline-users"></div>
<script type="module">
import { UserList } from 'https://cdn.jsdelivr.net/npm/@waline/client@v3/dist/waline.js';
UserList({
el: '#waline-users',
serverURL: 'http://waline.vercel.app',
count: 10,
});
</script>Mural de usuários
<div id="waline-users"></div>
<script type="module">
import { UserList } from 'https://cdn.jsdelivr.net/npm/@waline/client@v3/dist/waline.js';
UserList({
el: '#waline-users',
serverURL: 'http://waline.vercel.app',
count: 50,
mode: 'wall',
});
</script>Uso avançado
Se você não gostar do formato de saída padrão, pode chamar o componente omitindo a opção el para obter os dados e renderizá-los você mesmo.
Exemplo:
<div id="waline-users"></div>
<script type="module">
import { UserList } from 'https://cdn.jsdelivr.net/npm/@waline/client@v3/dist/waline.js';
UserList({ serverURL: 'http://waline.vercel.app', count: 10 }).then(({ users }) => {
document.getElementById('waline-users').innerHTML = users.map(
(user) => `<a href="${user.link}">${user.nick}</a>`,
);
});
</script>TIPS: A área de comentários é apenas para demonstração. Se você tiver alguma dúvida, vá para Github Discussion para perguntar.
