respect-validation/docs/rules/Spaced.md
Henrique Moody 562d98d805
Refactor the NotEmpty rule
Since we have the ability to use `not` as a prefix, having rules that
validate negative behaviour makes them a bit inflexible, verbose, and
harder to understand.

This commit will refactor the `NotEmpty`, and rename it to `Falsy`. It
will no longer trim strings, because Blank does a much better job at it;
it only simulates the behaviour of PHP’s native `empty()` function.

Because `Falsy`, `Blank`, and `Undef` have similar behaviour, I created
a page to demonstrate the difference and show when the user should use
one or the other.

Assisted-by: Cursor (claude-4.5-opus-high)
2025-12-29 12:48:35 +01:00

1.5 KiB

Spaced

  • Spaced()

Validates if a string contains at least one whitespace (spaces, tabs, or line breaks);

v::spaced()->isValid('foo bar'); // true
v::spaced()->isValid("foo\nbar"); // true

This is most useful when inverting the validator as notSpaced(), and chaining with other validators such as Alnum or Alpha to ensure that a string contains no whitespace characters:

v::notSpaced()->alnum()->isValid('username'); // true
v::notSpaced()->alnum()->isValid('user name'); // false

Templates

Spaced::TEMPLATE_STANDARD

Mode Template
default {{subject}} must contain at least one whitespace
inverted {{subject}} must not contain whitespaces

Template placeholders

Placeholder Description
subject The validated input or the custom validator name (if specified).

Categorization

  • Strings

Changelog

Version Description
3.0.0 Renamed to Spaced and changed the behavior
0.3.9 Created as NoWhitespace

See also: