Docs: Fix parameter type of `$feature` in `block_has_support()`

[Soean]

In the docs of block_has_support() the type of $feature is string. ​See on GitHub.

It should be an array, as you see in the ​tests and ​core.

For example block_has_support( $block_type, array( 'color', 'gradient' ) );.

In the docs of block_has_support() the type of $feature is string, should be array.

Trac ticket: https://core.trac.wordpress.org/ticket/56307

[audrasjb]

Good catch!

Introduced in #50761 (WP 5.8).

[audrasjb]

@Soean maybe replace
Path to the specific feature to check support for.
with:
Array of paths to specific features to check support for.

What do you think?

[Soean]

Only one $feature is checked at a time, this $feature can be nested, like for example:

block.json

{
    "apiVersion": 2,
    ...
    "supports": {
        "spacing": {
            "margin": true,
            "padding": false
        }
        "align": false
    }
}

$feature:
array( 'spacing', 'margin' ) --> true

array( 'spacing', 'padding' ) --> false

Or be at the highest level, like:

array( 'align' ) --> false

So maybe? Array of path to a specific feature to check support for. ?

[audrasjb]

Ok I see. Then Path to a specific feature to check support for. looks good for me :)

[audrasjb]

In 53799:

Docs: Fix $feature parameter type in block_has_support().

In block_has_support() docblock, the $feature parameter is an array, not a string.

Props Soean, audrasjb.
Fixes #56307.
See #55646.

Committed in https://core.trac.wordpress.org/changeset/53799