. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Elements; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Tree; use function view; /** * MULTIMEDIA_FILE_REFERENCE := {Size=1:30} * A complete local or remote file reference to the auxiliary data to be linked * to the GEDCOM context. Remote reference would include a network address * where the multimedia data may be obtained. */ class MultimediaFileReference extends AbstractElement { protected const array SUBTAGS = [ 'FORM' => '0:1', 'TITL' => '0:1', ]; /** * Convert a value to a canonical form. * * @param string $value * * @return string */ public function canonical(string $value): string { // Leading/trailing/multiple spaces are valid in filenames. return strtr($value, ["\t" => '', "\r" => '', "\n" => '']); } /** * Should we collapse the children of this element when editing? * * @return bool */ public function collapseChildren(): bool { return true; } /** * An edit control for this data. * * @param string $id * @param string $name * @param string $value * @param Tree $tree * * @return string */ public function edit(string $id, string $name, string $value, Tree $tree): string { $icon = view('icons/warning'); $warning = I18N::translate('If you modify the filename, you should also rename the file.'); return parent::edit($id, $name, $value, $tree) . '
' . $icon . ' ' . $warning . '
'; } /** * Display the value of this type of element. * * @param string $value * @param Tree $tree * * @return string */ public function value(string $value, Tree $tree): string { return $this->valueLink($value); } }