filmstrip.rst 1.3 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. Film Strip
  2. ==========
  3. A long horizontal row of scrollable panels, similar to a reel of film.
  4. .. figure:: img/filmstrip_block.png
  5. :alt: The film strip block, with four panels (three fully visible).
  6. The film strip block, with four panels (three fully visible).
  7. Usage
  8. -----
  9. You define your film strips and their panels in the **Snippets > Film Strips** section of the admin. Once defined, any page with a body streamfield can show that film strip by selecting it with a :doc:`/features/blocks/contentblocks/filmstrip`.
  10. Fields
  11. ------
  12. Slider
  13. ~~~~~~
  14. **Name**: A unique name for your film strip. It can be anything, it is just used as a personal reference to easily tell them apart within Wagtail.
  15. Panels
  16. ~~~~~~
  17. To add a slide to your carousel, click the "Add Slides" button.
  18. **Background image**: An optional image that will fill the entire panel. May be cropped or scaled to fit.
  19. **Background color**: An optional color that will fill the entire panel.
  20. **Foreground color**: An optional color used for text in the panel.
  21. **Custom CSS class**: If you need to add a specific CSS class for this panel, add it here.
  22. **Custom ID**: If you need to add a specific ID for this panel, add it here.
  23. **Content**: A streamfield that contains the content blocks for the panel.
  24. .. versionadded:: 2.1
  25. You must be on Wagtail CRX version 2.1 or higher to use Film Strips.