From 91481fe4b9ac1e145221b430127e0d69c5bc59ac Mon Sep 17 00:00:00 2001 From: Matt Westcott Date: Tue, 27 Jan 2015 23:23:13 +0000 Subject: [PATCH] Updated StreamField blocks API (markdown) --- StreamField-blocks-API.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/StreamField-blocks-API.md b/StreamField-blocks-API.md index e3b798e..e903cbc 100644 --- a/StreamField-blocks-API.md +++ b/StreamField-blocks-API.md @@ -1,6 +1,6 @@ # Shopping list: a worked example of the blocks API -A core aim for the StreamField development is to allow content blocks to be nested to any depth. To achieve this, each block will implement a common API that defines how that block is inserted into the edit page, along with any Javascript or other resources that it depends on. Basic block types such as text fields and image choosers will implement this; this then opens up the possibility of creating 'structural' block types such as StructBlock - which embeds a collection of sub-blocks and presents them as a single block - ListBlock, which allows a sub-block to repeated any number of times - and StreamBlock, which provides the main mechanic of StreamField by embedding a collection of sub-blocks that can be repeated and mixed freely. +A core aim for the StreamField development is to allow content blocks to be nested to any depth. To achieve this, each block will implement a common API that defines how that block is inserted into the edit page, along with any Javascript or other resources that it depends on. Basic block types such as text fields and image choosers will implement this; this then opens up the possibility of creating 'structural' block types such as StructBlock (which embeds a collection of sub-blocks and presents them as a single block), ListBlock (which allows a sub-block to repeated any number of times) and StreamBlock (which provides the main mechanic of StreamField by embedding a collection of sub-blocks that can be repeated and mixed freely). As long as these structural types accept any kind of sub-block that conforms to the blocks API, and expose the blocks API themselves, it's possible to nest these structures to any depth.