Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Block: Section #4900

Closed
melchoyce opened this issue Feb 6, 2018 · 169 comments
Closed

Add Block: Section #4900

melchoyce opened this issue Feb 6, 2018 · 169 comments
Assignees
Projects
Milestone

Comments

@melchoyce
Copy link
Contributor

@melchoyce melchoyce commented Feb 6, 2018

Now that we have official support for nesting as of #3745, let's consider adding a Section block that can act as a generic block container.

section-block

This block would have the following settings:

  • Columns.
  • Background image, color, and color dimness (so you can overlay transparent colors over your image), along with a fixed background toggle.
  • Text color.
  • Wide or Full-Width block alignment.
@karmatosed
Copy link
Member

@karmatosed karmatosed commented Feb 6, 2018

I really like this idea! I also like fact it has a background setting to it.

@karmatosed karmatosed added this to the 2.3 milestone Feb 6, 2018
@motleydev
Copy link
Contributor

@motleydev motleydev commented Feb 7, 2018

Nice! What if the block allowed the three following 'advanced' settings:

  • Define a class-name to be serialized onto the children .child_class, .child_class_1
  • Add an optional first child class .child_class, .child_class_1, .child_class_first
  • Add an optional last child class .child_class, .child_class_n, .child_class_last

:nth-child selectors may be able to compensate for the last two, but I think adding a class to all children could be useful in certain contexts.

@tomusborne
Copy link

@tomusborne tomusborne commented Feb 8, 2018

Love this idea. If background and text colors can be altered, it might make sense to add link colors as well.

@munirkamal
Copy link
Contributor

@munirkamal munirkamal commented Feb 16, 2018

Excellent Idea. This will literally add much value to Gutenberg Editor.

@hedgefield
Copy link

@hedgefield hedgefield commented Feb 21, 2018

Much better than just the Columns block, which has a lot of issues. Cool!

@jvisick
Copy link
Contributor

@jvisick jvisick commented Feb 21, 2018

This is the first thing I set out to create when I saw that nesting was available. My version is similar except I envisioned that you would add the columns block into it.

screen shot 2018-02-21 at 11 06 55 am

Do you have code for this available?

@youknowriad
Copy link
Contributor

@youknowriad youknowriad commented Feb 22, 2018

If this block has "columns", we should just update the "columns" block. But it's still possible to use a columns block inside a section block and keep the section block columnless.

@hedgefield
Copy link

@hedgefield hedgefield commented Feb 22, 2018

As long as you can't put column blocks inside column blocks 😉

@jvisick
Copy link
Contributor

@jvisick jvisick commented Feb 23, 2018

A lot of site pages are broken up into sections that has mixed content with multiple rows of columns and often columns nested inside larger ones. This is a quick example:

screen shot 2018-02-23 at 12 47 53 pm

A section block that just acts like a bare wrapper I think would be the most flexible. (as would being able to nest column blocks!)

We've kicked off a new site project this week. Normally it would be built with with Advanced Custom Fields flexible content layouts but I'm going to see how far we can get using Gutenberg alone.

@melchoyce
Copy link
Contributor Author

@melchoyce melchoyce commented Feb 23, 2018

Yeah, I think multi-column sections like @jvisick's above example aren't uncommon. A container with background/text options that nests blocks would be the most flexible approach. Since we now have a functioning column block, we could even consider taking out the column option from this.

@aduth aduth modified the milestones: 2.3, 2.4 Mar 1, 2018
@fabianpimminger
Copy link
Contributor

@fabianpimminger fabianpimminger commented Mar 5, 2018

It would be great if there is an inner-container (div) in this block which then contains all the child blocks. This container could then be styled with max-width and margin-left/right: auto to center the child blocks and have a full-width background.

@jvisick
Copy link
Contributor

@jvisick jvisick commented Mar 6, 2018

Having a fullwidth section with the content contained to a narrower layout is a common design pattern. I'm wondering if it would be best controlled by the nested blocks rather than baked into the parent section block?

@ZebulanStanphill
Copy link
Member

@ZebulanStanphill ZebulanStanphill commented Apr 5, 2018

I think a section block would be very useful for... well, sections on a page, and I agree that columns should be a separate block (like the one that exists now) that can be nested in a section block. I think this is something that, along with the Columns block, should be included in the version of Gutenberg that is merged into WordPress 5.0. If you look at existing page builder plugins, sections are used a lot, as are columns (obviously), so including them in the initial core release is essential in my opinion.

(I also think it is important that the columns block gets features like variable-width columns and responsive columns, both for the sake of the core experience as well as making it easier for existing page builders to re-base themselves off of Gutenberg, but that is a separate issue.)

@coreysyms
Copy link

@coreysyms coreysyms commented Feb 15, 2019

Section blocks would be awesome, but please make it semantic mark-up only! Keeping things in semantic HTML structure would create the most agnostic code base.
<section>, <article>, <header> is way better <div class="wp-section"> or whatever.

@chrisvanpatten
Copy link
Member

@chrisvanpatten chrisvanpatten commented Feb 16, 2019

@talldan Sorry I missed your comment, but I am 100% okay with you taking this on 🙌 I'm sure you'll rock it!

@SchneiderSam
Copy link

@SchneiderSam SchneiderSam commented Feb 16, 2019

It would also be great to be able to use the focal point of the text & media block #10925. Of course this only makes sense if you have an image background.

A great thing, which, by the way, a lot of page builders also have. Or at least something like that:

screenshot_1

@melchoyce
Copy link
Contributor Author

@melchoyce melchoyce commented Feb 18, 2019

Agreed a focal point picker would be great here. It works really well in the cover block!

With that in mind, I've updated my earlier mockups for a section block. It acts purely as a container element with an adjustable background color and image.

Preview:

image

You can check out the prototype here.

@melchoyce
Copy link
Contributor Author

@melchoyce melchoyce commented Feb 19, 2019

Some additional notes:

  • I think we should launch it without background image to start, only background/text color. Once we push that out, we can build in background image next. This gets it out fast, using existing patterns, and should still cover a huge number of use-cases.
    • Once we merge the first version, we could potentially deprecate background and text color from the text block. Instead, we could have inline color options/highlight options in the paragraph block. This seems to be an overall better pattern for paragraph.
  • This block wouldn't contain any responsive settings, since it would always just be a container. The content inside of the container (like a column block) would provide the responsive behavior.
@karmatosed karmatosed moved this from To Do to Tighten Up in Phase 2 Feb 19, 2019
@dingo-d
Copy link
Member

@dingo-d dingo-d commented Feb 20, 2019

I agree, the background image can be added using css if needed for the time being 👍

@talldan talldan mentioned this issue Feb 20, 2019
15 of 15 tasks complete
@jasmussen
Copy link
Contributor

@jasmussen jasmussen commented Feb 20, 2019

Once we merge the first version, we could potentially deprecate background and text color from the text block. Instead, we could have inline color options/highlight options in the paragraph block. This seems to be an overall better pattern for paragraph.

One of the reasons to consider the section block the right place for block level colors is that otherwise we have to answer why the list, heading, and other basic text blocks don't have those color options. And since those are split at the block level, you'd never be able to have a background image that spanned all of those continuously, whereas a section block fixes that.

The way to deprecate these colors could potentially be to just remove the UI for it, but let existing blocks remain styled as the are.

@perandre
Copy link

@perandre perandre commented Feb 26, 2019

Nice! Would be useful to have small/medium/large classes for vertical padding.

@lkraav
Copy link

@lkraav lkraav commented Feb 26, 2019

Nice! Would be useful to have small/medium/large classes for vertical padding.

This dips into theme / framework-level, and I'm not sure if core has a place for anything like https://cdn.vaadin.com/vaadin-lumo-styles/1.4.1/demo/sizing-and-spacing.html

@getdave
Copy link
Contributor

@getdave getdave commented Feb 27, 2019

I think we should launch it without background image to start

Couldn't agree more. Get a v1 out and then v2 can add the more complex functionality.

This block wouldn't contain any responsive settings

Agreed - this Block should be as simple and unopinionated as possible.

I think we should merge this PR if possible.

@willdelphia
Copy link

@willdelphia willdelphia commented Mar 8, 2019

I took a whack at something like this... released as a plugin:

https://wordpress.org/plugins/magic-block/

@webdados
Copy link

@webdados webdados commented Mar 8, 2019

Please, no more plugins that will leave people depending on it. Just release the damned block already.

@rchipka
Copy link

@rchipka rchipka commented Mar 8, 2019

@webdados I second this.

Not to diminish anyone's work, but we really need this to be built-in at some level.

Especially in a world where there's this issue.

Should an adequate solution be found for #13391, then the existence of countless container block implementations would probably be fine.

@irishetcher
Copy link

@irishetcher irishetcher commented Mar 8, 2019

Until the new block builder cracks having a standard foundation for layout elements (containers, sections, rows columns) that third party plugins can extend, then it is at nothing and perpetuates the mess of switching on and off third party blocks, themes, builders (those trying to address the layout issue) and ending up losing content and page layout.

Phase 2 automation moved this from Tighten Up to Done Apr 1, 2019
@S-Simon
Copy link

@S-Simon S-Simon commented Apr 18, 2019

When can we expect this feature?

@ksere
Copy link

@ksere ksere commented Apr 18, 2019

Should already be in the latest version:
https://github.com/WordPress/gutenberg/releases/tag/v5.5.0

@strarsis
Copy link

@strarsis strarsis commented Apr 18, 2019

@ksere: I missed that probably because the changelog for v5.5.0 of the plugin is empty.

@nathansnelgrove
Copy link

@nathansnelgrove nathansnelgrove commented May 14, 2019

Really digging the implementation on this so far. I understand it was just released in 5.5, but I'm wondering when we might expect additions for background images (and their positioning), background colour opacity, etc. Is this something we should expect before late 2019, or are we talking more long-term than that?

@talldan
Copy link
Contributor

@talldan talldan commented May 15, 2019

@nathansnelgrove Thanks for the feedback. There are definitely some improvements coming to the group block, here are two already in progress:

  • Adding an inner container to make styling easier - #15210
  • Adding editor options for grouping/ungrouping a selection of blocks - #14908

I haven't seen the issues you mentioned about background images and opacity being tracked anywhere, it might be worth creating a separate issue for that if you have time as this issue is now closed.

@melchoyce
Copy link
Contributor Author

@melchoyce melchoyce commented May 15, 2019

Background images/colors/opacity are from the original proposal — I'll make a new issue for them.

@patrikhuber
Copy link

@patrikhuber patrikhuber commented Oct 14, 2019

I've just installed WordPress 5.2.4, and I can't find any "Section" or "Group" block. What's going on here?

@noisysocks
Copy link
Member

@noisysocks noisysocks commented Oct 15, 2019

@patrikhuber: This will be included in WordPress 5.3 which is currently planned to be released on November 12.

@patrikhuber
Copy link

@patrikhuber patrikhuber commented Oct 15, 2019

@noisysocks I see, thanks a lot!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Phase 2
  
Done
Linked pull requests

Successfully merging a pull request may close this issue.

You can’t perform that action at this time.