Skip to content

Architectuur: ViewField en DisplayField — overlappende semantiek verduidelijken #138

Description

@ginkelsoft-development

Probleem

ViewField en DisplayField lijken beide read-only weergave-fields. Het onderscheid is niet duidelijk uit naming:

  • ViewField accepteert een Blade view path
  • DisplayField accepteert een callable of statische waarde

Beide eindigen met arbitrary HTML in dezelfde slot. Consumers weten niet welke ze moeten kiezen.

Onderzoek + voorstel

Optie A: Verduidelijken

  • Hernoemen naar BladeViewField en ComputedField (of CallbackField)
  • Docs uitbreiden met use-cases

Optie B: Consolideren

  • Eén DisplayField met builder methods:
    DisplayField::make('status')->view('buildora::cells.status'); // blade
    DisplayField::make('total')->value(fn(\$r) => \$r->total * 1.21); // callable
  • ViewField blijft als deprecated alias

Acceptatiecriteria

  • Eén duidelijke API
  • Migratiepad voor bestaande consumers
  • Documentatie met use-cases

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions