README

生成段落的可重用方法。

安装

composer require silverstripe/segment-field

用法

use SilverStripe\Forms\SegmentField;
use SilverStripe\Forms\SegmentFieldModifier\SlugSegmentFieldModifier;
use SilverStripe\Forms\SegmentFieldModifier\IDSegmentFieldModifier;

SegmentField::create('PageName')->setModifiers(array(
    SlugSegmentFieldModifier::create()->setDefault('page'),
    array('-', ''),
    IDSegmentFieldModifier::create(),
))->setPreview($this->PageDisplayName)

以 "My New Page!" 为值开始。
该值通过 SlugSegmentFieldModifier 传递。
预览值变为 "My-New-Page"，输入值变为 "My-New-Page"。
该值通过 array('-', '') 传递。
预览值变为 "My-New-Page-"，输入值变为 "My-New-Page"。
该值通过 IDSegmentFieldModifier 传递。
预览值变为 "My-New-Page-1"（包含 DataObject ID），输入值变为 "My-New-Page"。

您可以在修饰符列表中传递任何类似结构的数组或 SilverStripe\Forms\SegmentFieldModifier 的实现。

在前端使用

此字段主要设计用于 Silverstripe CMS 内部。如果您想在前端使用它，请确保您已经包含了您自己的 jQuery 版本和随 silverstripe/admin 模块一起提供的 jQuery entwine 库，例如

Requirements::javascript('//code.jqueryjs.cn/jquery-3.3.1.min.js');
Requirements::javascript('silverstripe/admin:thirdparty/jquery-entwine/dist/jquery.entwine-dist.js');

当在 CMS 中使用此字段时，默认包含这些依赖项。

版本控制

此库遵循 Semver。根据 Semver，您将能够升级到此库的任何次要或补丁版本，而无需对公共 API 进行任何破坏性更改。Semver 还要求我们明确定义此库的公共 API。

所有具有 public 可见性的方法都是公共 API 的一部分。所有其他方法都不是公共 API 的一部分。尽可能保持 protected 方法的向后兼容性，但在升级之前，如果您正在重写方法，请测试您的作品。

感谢

我想感谢 SilverStripe 允许我从事这样的有趣项目。请随意与我讨论使用框架和 CMS 或在 SilverStripe 工作。

silverstripe / segment-field

维护者

详细信息

README

安装

用法

在前端使用

版本控制

感谢