Passa al contenuto principale
Versione: 2.x

Moduli e richieste

In questo articolo, esamineremo alcuni strumenti di frontend che sono a nostra disposizione per la creazione e la gestione di moduli, nonché come inviare richieste HTTP tramite Flarum.

Componenti Form​

Come con qualsiasi sito interattivo, probabilmente vorrai includere moduli in alcune pagine. Flarum fornisce alcuni componenti per rendere più facile la costruzione (e lo styling!) these forms easier. Si prega di consultare la documentazione API collegata per per saperne di più sugli attributi accettati.

In genere vorrai assegnare la logica per reagire ai cambiamenti di input tramite Mithril e l'attributo on*, non listener esterni (come è comune con jQuery o semplice JS). Per esempio:

import Component from 'flarum/common/Component';
import Form from 'flarum/common/components/Form';
import FieldSet from 'flarum/common/components/FieldSet';
import Button from 'flarum/common/components/Button';
import Switch from 'flarum/common/components/Switch';

class FormComponent extends Component {
oninit(vnode) {
this.textInput = "";
this.booleanInput = false;
}

view() {
return (
<form onsubmit={this.onsubmit.bind(this)}>
<Form>
<FieldSet label={app.translator.trans('fake-extension.form.fieldset_label')}>
<input className="FormControl" value={this.textInput} oninput={e => this.textInput = e.target.value}>
</input>
<Switch state={this.booleanInput} onchange={val => this.booleanInput = val}>
</Switch>
</FieldSet>
<Button type="submit">{app.translator.trans('core.admin.basics.submit_button')}</Button>
</Form>
</form>
)
}

onsubmit() {
// Some form handling logic here
}
}

Don't forget to use translations!

Streams, bidi, e withAttr​

Flarum provides Mithril's Stream as flarum/common/utils/Stream. Questa è una struttura di dati molto potente, ma è più comunemente usata in Flarum come wrapper per i dati dei moduli form. Il suo utilizzo di base è:

import Stream from 'flarum/utils/Stream';


const value = Stream("hello!");
value() === "hello!"; // true
value("world!");
value() === "world!"; // true

Nei form di Flarum, i flussi sono spesso usati insieme all'attributo bidi. Bidi sta per associazione bidirezionale ed è un modello comune nei framework di frontend. Nei form di Flarum, i flussi sono spesso usati insieme all'attributo bidi. Questo astrae l'elaborazione degli input in Mithril. Per esempio:

import Stream from 'flarum/utils/Stream';

const value = Stream();

// Without bidi
<input type="text" value={value()} oninput={e => value(e.target.value)}></input>

// With bidi
<input type="text" bidi={value}></input>

You can also use the flarum/utils/withAttr util for simplified form processing. withAttr chiama un callable, fornendo come argomento qualche attr dell'elemento DOM legato al componente in questione:

import Stream from 'flarum/utils/Stream';
import withAttr from 'flarum/utils/withAttr';

const value = Stream();

// With a stream
<input type="text" value={value()} oninput={withAttr('value', value)}></input>

// With any callable
<input type="text" value={value()} oninput={withAttr('value', (currValue) => {
// Some custom logic here
})}></input>

FormGroup component​

The FormGroup component provides the same flexibility you get when registering admin settings. It allows you to pass an input type, with other information such as the label and help text, then uses the appropriate component to render the input.

import Component from 'flarum/common/Component';
import FormGroup from 'flarum/common/components/FormGroup';
import Stream from 'flarum/common/utils/Stream';

export default class MyComponent extends Component {
oninit(vnode) {
this.value = Stream(false);
}

view() {
return (
<div>
<FormGroup
key="acme.checkbox"
stream={this.value}
label={app.translator.trans('acme.forum.my_component.my_value')}
type="bool"
help={app.translator.trans('acme.forum.my_component.my_value')}
className="Setting-item"
/>
</div>
);
}
}

Effettuare richieste​

Nella nostra documentazione di modelli e dati, hai imparato come lavorare con i modelli e salvare la creazione del modello, le modifiche e l'eliminazione nel database tramite l'utilità Store, che è solo un wrapper attorno al sistema di richiesta di Flarum, che a sua volta è un altro wrapper Sistema di richieste Mithril.

Il sistema di richiesta di Flarum è disponibile a livello globale tramite app.request(options), e presenta le seguenti differenze rispetto a Mithril m.request(options):

  • Si legherà automaticamente all'header X-CSRF-Token.
  • Convertirà richieste PATCH e DELETE in richieste POST, e si legherà all'heder X-HTTP-Method-Override.
  • In caso di errore della richiesta, verrà visualizzato un avviso che, se in modalità debug, può essere cliccato per mostrare un modale di errore completo.
  • Puoi fornire anche l'opzione background: false, che eseguirà la richiesta in modo sincrono. Tuttavia, questo non dovrebbe quasi mai essere fatto.

Altrimenti, l'API per l'utilizzo app.request è la medesima di m.request.