# Dialog Cards (H5P.Dialogcards)

Flash cards: a prompt on the front, the answer on the back, turned by the learner. Not scored.

- Each item of `dialogs` is a card: `text` on the front, `answer` on the back, optionally an `image` with its `imageAltText`, an `audio` track and `tips`.
- `mode: "repetition"` brings back the cards a learner got wrong, until they know them all.

## Example

```json
{
  "type": "H5P.Dialogcards",
  "params": {
    "title": "Rivers in German",
    "dialogs": [
      { "text": "the river", "answer": "der Fluss", "image": { "path": "river.png" }, "imageAltText": "A river between hills" },
      { "text": "the bridge", "answer": "die Brücke", "tips": { "front": "It crosses the river." } }
    ]
  }
}
```

<!-- Generated by `h5p-author schema --markdown` from the pinned pack. Do not edit by hand. -->

## Fields of H5P.Dialogcards 1.9

The example is `type` and `params` alone, and `params` holds the fields below. A source also names its own `title`, `language`, `license` and `authors`, all four required: the build refuses a source that leaves out any of them. The author's name and the licence are the user's: ask for what they have not given. For a name they skip, write the one you know them by, or "Unknown"; for a licence they skip, `U`.

- `title` html: strong em code — Heading
- `mode` one of "normal" | "repetition" = "normal" — Mode: Mode of presenting the dialog cards
- `description` html: strong em code — Task description
- `dialogs` list 1+ of, required — Dialogs
  - `text` html: strong em code = "<p style=\"text-align: center;\"></p>" — Text: Hint for the first part of the dialogue
  - `answer` html: strong em code = "<p style=\"text-align: center;\"></p>" — Answer: Hint for the second part of the dialogue
  - `image` image file — Image
  - `imageAltText` text — Alternative text for the image
  - `audio` audio files — Audio files
  - `tips` group — Tips
    - `front` text — Tip for text: Tip for the first part of the dialogue
    - `back` text — Tip for answer: Tip for the second part of the dialogue
- `behaviour` group — Behavioural settings
  - `enableRetry` boolean = true — Enable "Retry" button
  - `disableBackwardsNavigation` boolean = false; only when mode is "normal" — Disable backwards navigation
  - `scaleTextNotCard` boolean = false — Scale the text to fit inside the card
  - `randomCards` boolean = false; only when mode is "normal" — Randomize cards
  - `maxProficiency` number 3–7 = 5; only when mode is "repetition" — Maximum proficiency level
  - `quickProgression` boolean = false; only when mode is "repetition" — Allow quick progression

28 interface texts are left out: they come from the libraries' translations. `h5p-author schema H5P.Dialogcards --all` lists them, for a source to set one.

<!-- End of the generated section. -->